watercolorBlocks.package
- ..
- .metadata189 B
- README.md2.7 KB
- block.yaml1.1 KB
This package holds more than this page lists. See all of its files in its world.
README.md
Backrun bloom (styleBlock, Fill)
Here and there a backrun (a bloom or cauliflower): water run back into a drying wash pushes the pigment outward into a paler bloom with a frilled, darker rim, inside flat washes only.
Settings: amount (0.6), frequency (0.015), size (1.2), frill (0.9), rimDark (0.3), flatOnly (0.8). Low quality changes no setting; like every block it runs at half resolution there, and the soft field at half of that.
It reads the frame, depth and the soft field. Surfaces are cut into patches size metres across, and a share of them (frequency) bloom: inside a lobed boundary bent by surface noise (frill) the paint is paler, and along it pigment gathers in a darker rim (rimDark). Blooms only form where the wash has paint in it and is even (flatOnly, read against the soft field), never on bare paper. It is the last block of the watercolor Fill chain (rank 80, stacking chain).
What it gives up in motion
Blooms are laid on surfaces in world position, so they stay put on still things under any camera move, and they never appear or vanish on their own (nothing is re-seeded over time). They slide across moving characters and props. A bloom near a surface's edge can be cut where the surface ends, since the patch belongs to the surface.
How it treats content
- Opaque things: a few pale blooms with frilled rims in flat, painted washes.
- Transparent things (glass, water): blooms are laid on the surface behind, so they can show through clear glass and still water.
- Particles and smoke: a bloom on the surface behind shows through soft smoke.
- Sky: never; a pale bloom in a thin sky wash reads as a hole, so the sky is left alone.
- Fog: lifted, pale distance carries little paint, so blooms there fade out by themselves.
- Skinned characters: blooms slide across a moving body; keep this block off characters with a group mask.
- Foliage: busy leaf masses are rarely flat enough to bloom, so foliage mostly stays clear of blooms.
- World text: a bloom over a sign can pale part of it; exclude labels a player must read.
- Black stays black: it returns through
sk_finish, and blooms need paint in the wash, so an unlit pixel is never lifted.
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.