Log inGet started
Package

wcDryBrush.styleBlock

README.md

Dry brush (styleBlock, Fill)

Broken dry-brush strokes that skip over the peaks of the paper's tooth, leaving flecks of bare paper inside the wash in patches where the brush ran dry: rough, textured watercolor for walls, paving, bark and grass.

Settings: amount (0.45), coverage (0.25), strokePx (10), stretch (7), angle (0.35), bite (0.3), preferLight (0.6), wobble (1). Low quality changes no setting; like every block it runs at half resolution there, so strokes are softer.

It reads the frame, depth, the shared ground and the shared wobble. In patches a few metres across where the brush ran dry (coverage), strokes of strokePx reference pixels, stretch times as long as wide, dragged at angle, skip the tooth's peaks and leave bare paper (amount; bite, where higher is drier: 0 lets the paint reach nearly every peak, 1 leaves it only in the valleys), mostly in lighter passages (preferLight). The tooth comes from the shared ground, so it pairs with wcColdPress. It sits after the granulation in the Fill chain (rank 65, stacking chain). Its material form is the dry brush inside wcPaint.shaderModule.

What it gives up in motion

Strokes stay on surfaces and keep their size in the picture: walking closer they grow into the next size of stroke rather than sliding or zooming. Dry patches are laid on surfaces too, so both stay put on still things under any camera move. Both slide across moving characters and props, because they come from world position. With a Time block the strokes tremble on the held clock.

How it treats content

  • Opaque things: rough flecks of bare paper inside lighter washes, in dry patches.
  • Transparent things (glass, water): strokes are laid on the surface behind, so a window shows the dry brush of the wall behind it.
  • Particles and smoke: strokes from the surface behind show through soft smoke.
  • Sky: never dry brushed; the sky is skipped.
  • Fog: pale, lifted distance is lighter and so takes more dry brush by preferLight; lower coverage with a depth mask if far things sparkle too much.
  • Skinned characters: strokes slide across a moving body; keep this block off characters with a group mask, or use the hero material.
  • Foliage: broken strokes read well on grass and bark; fine leaves can lose small pieces to bare paper.
  • World text: bare-paper flecks can break small text; exclude labels a player must read.
  • Black stays black: it returns through sk_finish, so an unlit pixel is never lifted.

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.