watercolorBlocks.package
- ..
- .metadata188 B
- README.md3.1 KB
- block.yaml1.1 KB
This package holds more than this page lists. See all of its files in its world.
README.md
Edge darkening (styleBlock, Fill)
Pigment collected at the rim of each wash as it dried: a soft, darker gradient just inside the edge of the darker wash, not an outline, the hallmark of real watercolor painting.
Settings: amount (1.8), width (1.6), threshold (0.04), wobble (1). Low quality changes no setting; like every block it runs at half resolution there, and the soft field at half of that, so rims are a little wider and softer.
It reads the frame, the soft field, depth and the shared wobble. Rims belong to shapes, not texture: where the wash this pixel sits in (the soft field) is denser than the wash a ring wider (width) by more than threshold, the pixel is just inside a darker shape's edge, and pigment is added there (amount) as a soft gradient over the field's width, keeping the paint's own hue and never driving it to black. A mortar line or a seam is not a wash edge and gets no rim, and a light passage inside the edge keeps its paper. It sits near the end of the Fill chain (rank 70, stacking chain), so it darkens the rims of the washes, glazes and pools before it. The soft radius of the whole stack (StyleKit.options({ softRadius })) sets how wide rims are. Its material form is the rim inside wcPaint.shaderModule.
What it gives up in motion
Rims are found from the picture each frame, so they follow moving things exactly and never slide. Detailed textures under a thin wash show small rims of their own, which can shimmer under a pan; raise the wash's flatten and abstraction, or threshold here, to calm them.
How it treats content
- Opaque things: a soft darker band inside the edge of every darker wash.
- Transparent things (glass, water): the edge of a tinted pane against the wall behind it is an edge in the picture and gets a rim, which reads as a painted pane.
- Particles and smoke: the denser side of a smoke edge gets a soft rim; small sparks can gain a dark ring, so lower
amountor mask effects that must read exactly. - Sky: a skyline gets a rim on the darker side (usually the land), never a hard outline; the sky itself is rimmed only where its own washes differ.
- Fog: fog lowers differences, so far edges are rimmed less.
- Skinned characters: rims follow a moving body exactly; the soft field never smears the background onto it.
- Foliage: leaf masses gain soft rims against the sky, which reads as painted foliage.
- World text: dark text gains a rim and can thicken; exclude labels a player must read.
- Black stays black: it returns through
sk_finish, 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.