Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks
- ..
- .metadata118 B
- README.md1.9 KB
- block.yaml809 B
README.md
Posterize (styleBlock, Colour)
Cuts the picture into a few flat tone steps, like a screen print or a poster printed with a small set of inks.
Settings: levels (5), byBrightness (1), softness (0.12), saturation (1.1). Low quality draws hard steps (softness 0).
What it gives up in motion
Smooth gradients become hard steps. When a light changes slowly, a step edge sweeps across a surface instead of the surface fading, and noisy content (fine textures, film grain) flickers between two steps. Keep softness above 0.05 where light moves. It holds no marks of its own, so nothing slides or sticks to the screen.
How it treats content
- Opaque things: stepped by brightness, hue kept.
- Transparent things (glass, water): stepped as they appear, with what is behind them.
- Particles and smoke: stepped like everything else; soft smoke turns into a few bands.
- Sky: stepped; a gradient sky becomes bands.
- Fog: stepped; distance fog becomes a few flat depth bands, which often reads well.
- Skinned characters: stepped like any surface, no extra cost.
- Foliage: stepped; moving leaves can flicker between steps.
- World text: stepped with the rest; light text on dark keeps its contrast. Exclude a label with
StyleKit.options({ exclude = { id } })to leave it untouched. - Black stays black: a pixel with no light 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.