Log inGet started
World

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

README.md

Duotone (styleBlock, Colour)

Maps the picture onto two inks, a shadow colour and a light colour, like a two colour print or a tinted photograph.

Settings: shadowInk (deep blue), lightInk (warm cream), contrast (1.1), balance (0), keepColour (0.1). Colours are display colours as picked, written as "#1c2245" or { r, g, b }.

What it gives up in motion

Nothing extra: it maps each pixel on its own, so it adds no marks that could slide or flicker. What it gives up is hue: colour-coded gameplay (a red enemy, a green pickup) reads only by brightness, so raise keepColour or exclude those objects.

How it treats content

  • Opaque things: mapped by brightness onto the two inks.
  • Transparent things (glass, water): mapped as they appear, with what is behind them.
  • Particles and smoke: mapped; bright additive sparks become the light ink.
  • Sky: mapped; a blue sky turns to the middle of the two inks.
  • Fog: mapped; fog pulls distant things toward one ink, which reads as depth.
  • Skinned characters: mapped like any surface.
  • Foliage: mapped; leaf colour is lost, leaf shape stays.
  • World text: mapped; keep labels light on dark or dark on light so they keep their contrast, or exclude them.
  • Black stays black: a pixel with no light stays black even though the shadow ink is not 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.