Log inGet started
World

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

README.md

Rice paper (paperBlocks, Ground)

Thin, soft rice paper with long visible fibres: thirsty, so washes spread and feather and ink lines bleed into the fibres. A thin, soft sheet with long fibres running through it and a cloudy formation; very little tooth.

local StyleKit = require("~styleKit.StyleKit")
StyleKit.swap("paper", "paperRice")   -- replaces the stack's paper in one change

What it does to each kind of block

  • Watercolor: The wettest paper: the bleed runs much further, edges feather along the fibres, dried rims all but vanish; granulation is faint, there is little tooth to hold it.
  • Ink: Lines spread wider and feather at their edges, more where fibres run; ink wash painting looks its most natural here.
  • Lights: Lights are bare paper.

Its defaults

tint #f1ecdf, toothHeight 0.3, toothSharpness 0.15, toothSize 5, fibre 0.85, fibreLength 18, fibreTone 0.35, mottle 0.18, thirst 0.95, emboss 0.2, sheen 0, lights 0. Every other shared setting is at the shared default (no weave, ruling, foxing or dust).

How it moves and what it covers

  • Motion: the tooth, fibres, weave, blotches and spots are laid on the surfaces they cover (world position along each surface's main axis), so they stay on still things when the camera pans, dollies or zooms; each keeps about the same size in the picture by growing into the next octave rather than sliding, and anything finer than about two drawn pixels fades to its mean, so the distance never shimmers. On a moving prop or a skinned character the sheet slides across it (a full-frame pass has no per-object position).
  • Sky and fog: the sky gets the same sheet, laid on the view direction, so it stays put as you turn; fog is part of the picture and is laid on the paper like any other colour.
  • Transparent things and particles have no depth of their own, so the sheet under them is the sheet of the surface behind.
  • Foliage takes the sheet like any surface; very fine leaves read through its tooth.
  • World text and UI: the screen UI is drawn after the stack and stays readable; world labels take the paper unless they are left out (StyleKit.options({ exclude = { "LabelName" } }), ideally on a card of their own).
  • Black stays black: every pixel returns through styleKit's shared exit and the sheet only multiplies or is lit by the scene's own light, so with every light off the frame is black, never paper coloured.
  • Low quality: the same picture at half resolution; parts too fine for the smaller image are laid as their average instead of aliasing.

Swapping

Every paperBlocks paper shares the same settings, so StyleKit.swap("paper", "<other paper>") changes the sheet in one change and swapping back to the paper you had (inkPaper, wcColdPress, plainPaper or another paperBlocks paper) puts back exactly the settings it had. Keep your tuning across papers with StyleKit.swap("paper", "<other paper>", { keepSettings = true }).

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.