Log inGet started
World

Procgen Effects Showcase

Branchmain
Branchesmain
Commit99ff90d12c

README.md

wf_particle

Waterfall particle card: mist, foam and droplet looks selected by mode, with sun forward-scatter and a view-dependent rainbow, premultiplied output and a soft depth fade. One shader draws the whole spray family:

  • Mode 0, mist: big soft camera-facing cards (zero_billboard). A four-octave fx_noise fBm, offset per particle and drifting with time, billows a round puff. It is lit by the ambient light and by the sun through a Henyey-Greenstein phase (g 0.62), so the mist glows when the sun is behind it. The rainbow lives in these cards: a band 42 degrees from the anti-solar point, about 1.7 degrees half-width, red outside and violet inside, scaled by rainbow.
  • Mode 1, foam: bright bubbly clumps on camera-facing cards. Worley cells drift through a ragged disc, lit by ambient and sun light.
  • Mode 2, droplet: a teardrop on a card turned onto its motion (zero_billboard_streak), with a fat head leading along +Y and a tail thinning to a hair, plus a sun glint on the head when the sun is behind it.
  • Mode 3, flat foam: the foam look on a card lying on the water, its right along world X and its up along world Z (zero_card_clip).

Every card dissolves into whatever is drawn behind it over depth_fade (zero_scene_depth_fade), so cards blend softly where they meet rock or water. The output is premultiplied: the colour, scaled by energy, carries its own coverage, and the rainbow and glint add on top.

Three graphs beside it in waterfall/ draw with it, all premultiplied with culling off and depth writes off, and in the Procgen Effects Showcase world the fx_falls scene places them: wf_mist (mode 0, opacity from its density input, default 0.7, energy 1.7, depth_fade 2.2, rainbow from its rainbow input, default 1.0), wf_foam (mode 1, depth_fade 0.9, rainbow 0) and wf_spray (mode 2, depth_fade 0.6, rainbow 0). Each writes data0 from a colour ramp over life and data1 as (particle id, life, 0).

The shader includes @builtin::shaderModules.billboard, fx_noise and zero::scene_depth.

Properties

PropertyTypeDefaultMeaning
modefloat0Look selector, range 0 to 3: mist, foam, droplet, flat foam.
opacityfloat1Multiplies the coverage (range 0 to 4).
energyfloat1Multiplies the lit colour (range 0 to 8).
depth_fadefloat1.2Distance over which a card fades into the surface behind it (range 0 to 10).
rainbowfloat0.6Strength of the rainbow in mist cards (range 0 to 4).
vertexBoundsDilationfloat11How far the vertex hook moves a vertex past the mesh, in world units: the culling bounds grow by it so a moved vertex stays inside them.

Lanes

LaneCarries
data0.rgbColour, multiplied by the lighting.
data0.aOpacity over life.
data1.xParticle id; its low 16 bits seed the per-card noise offsets.
data1.yLife, 0 to 1.
data1.zSpin phase, as the shader header names it; the graphs write 0.