Log inGet started
Package

wcColdPress.styleBlock

README.md

Cold-press paper (styleBlock, Ground)

Rough cold-press watercolor paper with a deep tooth of felt bumps and cotton fibre: the painting is laid on its warm white, and the shared ground carries the tooth so granulation and dry brush settle into it. The paper texture for watercolor looks.

Settings: paper (#f7f2e6), toothPx (6), roughness (0.75), emboss (0.25). Low quality changes no setting; the field and the pass run at half resolution there, so the finest tooth softens.

As the first Ground block it publishes the shared ground: its field pass (wcColdPressField) writes the paper colour and the tooth's height, which wcGranulation, wcDryBrush, depthLine's grain break and every other block that reads the ground use. Its full-frame pass multiplies the painting onto the paper colour and lights the tooth from the upper left (emboss). The tooth is irregular felt marks with fibre over them (roughness, 0 smooth hot-press to 1 rough), never a regular grid. Its material form is coldPress.shaderModule (wcp_paper_height), which the watercolorSurface shader includes, so a hero object is painted on the same paper.

What it gives up in motion

The tooth stays on surfaces in world position and keeps its size in the picture by blending two sizes of tooth with distance, so walking toward a wall the tooth grows into the next size rather than sliding or zooming. On the sky it is laid by view direction and stays put as the camera turns. It slides across moving characters and props; the hero material carries its own tooth on the object.

How it treats content

  • Opaque things: laid on the warm paper with a lit tooth; whites become the paper's own white.
  • Transparent things (glass, water): the tooth is the surface behind, so glass and water show the paper of what is behind them.
  • Particles and smoke: multiplied onto the paper like everything else, with the tooth of what is behind.
  • Sky: laid on the paper with the tooth by view direction; a bare sky reads as the sheet.
  • Fog: fogged distance is laid on the paper; with wcPaperFade it lifts to the paper's own colour.
  • Skinned characters: on paper like everything, but the tooth slides across a moving body.
  • Foliage: on paper like everything; the tooth is too fine to fight leaf detail.
  • World text: the tooth's emboss lightly textures text; exclude labels a player must read so they stay exact.
  • Black stays black: it multiplies onto the paper and returns through sk_finish, so an unlit pixel stays black, never paper white.

Known limits

  • It runs on the whole frame after antialiasing, so offscreen captures, mirrors and render-to-texture cameras do not show it (#17427).
  • Per-object settings (a style channel or a game role) reach it through the shared object mask, at most eight distinct settings a scene. A per-object value cannot reach a geometry pass, so a per-object look that needs one draws passes of its own (#24549).
  • Its passes are queued again every frame, even when nothing changed (#24548).

The package README's Known limits lists the rest.