wcLightThin.styleBlock
- .metadata208 B
- README.md2.9 KB
- block.yaml1.1 KB
README.md
Thin light (styleBlock, Fill)
Paints lit areas with less pigment so they thin toward the white paper, and lays a little warm or cool light over them, the way a watercolor painter leaves the lights: glowing, warm-lit watercolor highlights.
Settings: threshold (0.85), softness (0.3), thin (0.25), temperature (0.4), shift (0.35). Low quality changes no setting; like every block it runs at half resolution there.
It reads the frame, depth, the base colour (albedo), the frame as rendered (rendered) and the scene's pigment set, and finds light the same way wcShadowPool does (the rendered frame against its base colour, averaged over five taps, so surface texture never reads as light). Above threshold the paint is diluted toward the paper (thin) and glazed with a warm or cool tint (temperature, shift); with a pigment set picked the tint is the set's light colour. It sits after the shadow pools in the Fill chain (rank 45, stacking chain). Its material form is the thinned light inside wcPaint.shaderModule.
What it gives up in motion
Light is read per pixel each frame, so the thinning follows moving lights and a turning sun exactly; nothing slides and nothing sticks to the screen. A fast light change (a lamp switched on, a flash) makes the lights brighten at once, with no painterly lag.
How it treats content
- Opaque things: lit faces thin toward the paper and take the light tint; shadowed faces are left as they came.
- Transparent things (glass, water): bright reflections on glass and water read as lit and thin toward the paper, which suits painted glints.
- Particles and smoke: bright particles read as lit and thin toward paper; a bright effect can lose some of its colour, so keep
shiftlow or mask effects that carry gameplay colour. - Sky: left alone; the sky is never thinned by this block (use
wcPaperFadefor the sky). - Fog: bright fog can read as lit and thin a little further toward the paper.
- Skinned characters: lit faces of a moving body thin and warm each frame, following its light exactly.
- Foliage: sunlit leaf tops thin and warm, which reads as light through the canopy.
- World text: light text can thin toward paper and lose contrast; exclude signs and labels a player must read.
- Black stays black: it returns through
sk_finish, and only lit pixels are thinned, so an unlit pixel stays black.
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.