Log inGet started
Package

wcGlaze.styleBlock

README.md

Glazed layers (styleBlock, Fill)

Rebuilds the picture from a few transparent watercolor glazes laid one over another, slightly off register, so overlaps get darker and richer and each glaze keeps a faint dried edge: layered, glazed watercolor.

Settings: layers (3), amount (0.8), misregister (0.5), softness (0.18), edgeDark (0.35), patchSize (0.5), detail (0.2), wobble (1). Low quality draws 2 layers; like every block it runs at half resolution there, and the soft field at half of that.

It reads the frame, the soft field, depth and the shared wobble. The paint's density is split into layers slices that follow the large shapes (the soft field) rather than texture noise; each slice is laid with its own wandering edge (misregister, patchSize), so where glazes overlap the paint is darker and where one falls short it is lighter, and a faint rim (edgeDark) sits just inside each glaze's edge. The slices add back up to the same paint, so overall value is kept. Only a share of the render's own texture survives under them (detail, 0.2 by default): the glazes are the painting, not a filter over the picture. It sits after the wash and bleed in the Fill chain (rank 30, stacking chain).

What it gives up in motion

Glaze edges are thresholds of brightness, so a slow light change (a sunset, a cloud) sweeps them across a surface as moving steps instead of fading smoothly. The wander of each edge is laid on surfaces and stays put on still things under any camera move; on a moving character the glaze edges follow its shading each frame. With a Time block the edges tremble on the held clock.

How it treats content

  • Opaque things: rebuilt in glazes; smooth gradients become a few soft-edged layers.
  • Transparent things (glass, water): treated as part of the surface behind them; their colour is glazed with it.
  • Particles and smoke: no depth; a soft puff is cut into glaze steps by its brightness, which can show stepped rings on large smoke.
  • Sky: a sky gradient becomes a few glazes with soft wandering edges, the way a graded sky is laid in layers; lower amount on the sky with a depth mask if the steps are too strong.
  • Fog: fog's smooth falloff becomes stepped glazes; this reads well at 4 or more layers.
  • Skinned characters: shading on a moving body is glazed each frame, so steps follow the body's light; nothing slides, but the glaze edges move as the body turns.
  • Foliage: leaf masses take glazes by their large shapes; fine leaves are not cut into steps of their own.
  • World text: small text keeps its edges but can gain a dried rim; 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.