Log inGet started
World

Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks

README.md

Two-tone poster fill (styleBlock, Fill)

A bold two-tone poster fill: every area flattened to one colour in a few poster values, cut hard into a lit tone and a deep shadow tone, like a screen print or a graphic comic.

Settings: flatten (1), radius (24), keepEdges (3), saturation (1.3), posterLevels (3), threshold (0.5), softness (0.006), shadowColour (#8c80bf), shadowLevel (0.42), litLevel (1), hueShift (0), shadowSaturation (1), lightWarmth (0), keepLight (0), shape (0.9), shadeLevel (0.3), castBelow (0.8), fullLight (1), keepLightColour (0.3). Low quality gathers colour from radius 10 with four taps per ring instead of eight.

It is the Cel fill (celFill) with other defaults: texture fully let go (flatten 1), colours more saturated and cut to three poster values, the light split exactly at half of full light with a very narrow edge, and the shadow tone a deep violet at 0.42 of the lit tone. The Thick sticker look pairs it with the Sticker border. It swaps with celFill and celHueShift in one change: StyleKit.swap("fill", "celPoster").

It needs the base colour copy: on the forward renderer, and on the sky and pure black surfaces, it leaves the frame as it is.

What it gives up in motion

As the Cel fill, with harder edges: flat areas hold still and stay on their surfaces under any camera move, and the split between the two tones follows the light, so it sweeps across a surface as the sun or a lamp moves, in small steps about once a second under a moving sun. With a very narrow edge the split is crisp, so a slow light change shows as a clean moving line rather than a fade. Poster values are cut from each area's gathered colour, so an area whose colour sits near a cut can switch value when a nearby colour edge moves across its taps.

How it treats content

  • Opaque things: one flat poster colour per area, two hard tones each.
  • Transparent things (glass, water): painted as the flat surface behind, the pane's tint and reflections counted only as light, so glass and water lose their own look. Leave them out by name where they matter.
  • Particles and smoke: painted as the surface behind, their brightness counted as light; smoke can flip a surface hard into its shadow tone where it crosses the split. Leave effects out by name to keep them soft.
  • Sky: never touched.
  • Fog: distant surfaces are painted in their own flat colours and the haze is painted out. A depth mask on the entry keeps far haze.
  • Skinned characters: flattened every frame into two hard tones that follow every pose; faces read graphic and bold.
  • Foliage: leaves become flat cut-outs; a far canopy with small leaves can keep speckle between the two tones.
  • World text: letters a clear colour away from their card stay; small text can merge into its card's poster value. Leave labels out by name: StyleKit.options({ exclude = { "labelName" } }).
  • Black stays black: no light stays no light and it returns through sk_finish, so with every light off the frame is 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.