Log inGet started
Package

watercolorBlocks.package

This package holds more than this page lists. See all of its files in its world.

README.md

Wet-in-wet bleed (styleBlock, Fill)

Neighbouring watercolor washes run softly into each other with feathered fringes where the paper was wet: the soft wet-in-wet edges of a painting, without ever smearing the foreground over the background.

Settings: amount (0.75), wetness (0.6), patchSize (0.3), reach (16), feather (0.6), wobble (1). Low quality draws the bleed with reach 10; like every block it runs at half resolution there, and the soft field at half of that.

It reads the frame, the soft field, depth and the shared wobble. Wet and dry patches are laid on surfaces (wetness, patchSize); inside a wet patch, where the colour around differs from here, the colour of the soft field one ring wider (reach) is mixed in as pigment, a little to one side that turns with fine surface noise (feather). A tap that falls on a nearer surface is refused, so a dark character never bleeds into the bright wall behind it. It sits after the wash in the Fill chain (rank 20, stacking chain), so it bleeds the wash's colours, not the raw render's.

What it gives up in motion

The wet patches and the fringe direction are laid on surfaces, so they stay put on still things under any camera move. The bleed itself reads the screen-space soft field, so on a moving character the fringe moves with the character's edge every frame rather than sticking to a point: it softens the edge rather than smearing it. Fast motion of a high-contrast edge can show the fringe redrawing each frame as a soft shimmer. With a Time block the fringe trembles on the held clock.

How it treats content

  • Opaque things: colours run across edges where the paper was wet; dry patches keep crisp edges.
  • Transparent things (glass, water): not in the depth, so the bleed treats them as the surface behind and runs their colour into that surface's neighbours; a window edge can bleed into the wall.
  • Particles and smoke: no depth, so their colours run into the washes around them like any colour; that suits soft smoke and softens sharp sparks.
  • Sky: the sky bleeds into the skyline where its colour differs, a wet sky against hills; things in front of the sky never bleed into it.
  • Fog: fogged distance bleeds like any wash; since fog lowers colour differences, there is less bleed in fog.
  • Skinned characters: their edges soften where a wet patch reaches them; nothing from behind runs onto them, since nearer surfaces refuse taps. Keep the bleed off a hero with a group mask when the silhouette must stay crisp.
  • Foliage: leaf masses run into each other and into the sky, which reads as wet foliage; fine branches soften.
  • World text: text edges are colour edges and bleed: exclude signs and 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.