Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks
- ..
- .metadata17 B
- README.md3.0 KB
- block.yaml3.3 KB
README.md
Storybook fill (styleBlock, Fill)
A soft storybook underlayer: the picture lifted to warm, light pastel colour, laid with the side of a soft coloured pencil and rubbed smooth, so a pencil line and a light shade sit over it like the pages of a picture book. Keeps more of each thing's colour than sketchBlankFill. Black stays black.
Part of pencilBlocks. Runs the shared pencilFill shader and takes the same settings as sketchBlankFill and coloredPencilUnderlayFill, so it swaps with them in one change: StyleKit.swap("fill", "storybookFill"). Put a shade over it with settings = { over = 1 } so the strokes are laid over the colour. This variant's own defaults: keepColour (0.65), paleness (0.62), coverage (0.75), hardness (0.25), smudge (0.75), width (3.4), spacing (10), layers (2).
What it gives up in motion
Its strokes are laid on the world position of the surface under each pixel and kept at screen size by octaves blended by distance, so they stay put on still things while the camera pans, dollies, orbits or zooms, and grow into the next octave instead of sliding. boil redraws each patch a little only on the shared held clock, never per frame; the colour under it never changes with it.
How it treats content
- Opaque things: lifted toward the bare sheet by
paleness, keepingkeepColourof their colour; the underlayer's strokes are laid in each thing's material colour, greys getting only a little. - Transparent things, particles and smoke: lifted like everything else, pixel by pixel; strokes are laid on the surface behind them.
- Sky: lifted at least
skyBareof the way to the sheet; no strokes. - Fog: lifted with what is behind it, so foggy distance goes toward the bare sheet; past
fadeEndthe underlayer's strokes give way to a soft tone. - Foliage: alpha-tested leaves are in the depth and are treated like any surface; very fine foliage reads as tone.
- World text: exclude labels a player must read (
StyleKit.options({ exclude = { ... } })); the block leaves them as rendered. - Skinned characters: the blank is pixel by pixel and travels with them; the underlayer's strokes are laid on world positions, so keep it off a moving character with a group mask, or paint the character with
PencilHero.paint. - Dark sheets (black paper, the boards): the blank sinks toward the sheet instead of toward white.
- Black stays black: only what light reached is lifted, so with every light off the frame 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.