# fx_graph
Graph-building helpers shared by the Tidewater water-effect graphs (`effects/waterfx.effect`):
drawing particles as cards or low-poly chunks in one of the seven looks with the `fx_particle`
shader, writing the per-particle life/seed lane, and the look palettes.
# body
Big water splash (a person jumping in): crown, column, droplets, spray puffs, a foam patch and rings, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `body` entry of the waterfx effect.
# bow
Continuous boat bow spray: two sheets of droplets and spray thrown sideways off the bow, scaled by hull speed, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `bow` entry of the waterfx effect.
# bubbles
Continuous rising underwater bubbles that wobble up and stop at the surface, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `bubbles` entry of the waterfx effect.
# drips
Continuous drips falling from an edge, with tiny splashes and rings where they hit the water, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `drips` entry of the waterfx effect.
# droplets
A burst of water droplets thrown along a direction, falling under gravity, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `droplets` entry of the waterfx effect.
# fishJump
A fish leaping: a spray of beads where it leaves the water, then a plop and ring where it falls back in a little further on, in one of the five Tidewater looks.
# foam
A floating patch of foam flecks that drifts and slowly fades: churned water below a fall, an eddy behind a rock, the wash of a breaking wave. Runs until stopped.
# footstep
A foot landing in a puddle or the shallows: a low wide kick of droplets thrown forward and out, and a ring on the water, in one of the five Tidewater looks.
# mist
Continuous rising mist with optional sparkles (a waterfall's plunge pool), in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `mist` entry of the waterfx effect.
# plop
Small water splash (pebble): a crown of droplets, a centre jet and a spreading surface ring, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `plop` entry of the waterfx effect.
# rainSplash
One heavy raindrop: a tiny crown and a ring. For a rain kit that wants each drop on the water to show, and for drips landing in a puddle.
# ring
Ripple rings lying on the water: three concentric rings spreading and fading, sized by `size`.
`Fx.ripple` plays it so a ripple shows on any water, including water kits whose shaders do not
sample the Tidewater ripple field.
# spindrift
Continuous spindrift: fine spray blown downwind off wave crests in streamers, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `spindrift` entry of the waterfx effect.
# spray
A one-shot gust of white spray and fine droplets blown downwind, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `spray` entry of the waterfx effect.
# wake
Continuous wake: a V of foam patches laid on the water behind a mover, spreading and fading, with stern churn, in a chosen look.
Inputs are declared in `init.luau` (`look` picks one of the five Tidewater looks). Played as the `wake` entry of the waterfx effect.
# wakefoam
One segment of a boat or swimmer wake: foam patches on the water spreading outward in a V and fading, in a chosen look. Inputs: look, speed, width, fade. Laid out along its own +Z; the play's rotation turns it to the heading. Played as the `wakefoam` entry of the waterfx effect; the Fx wake emitter drops one every metre or two along a path.
# fx_particle
The one surface shader every Tidewater water effect draws its particles with. A unit card
(`mesh.plane`) is stood up in `vertex_clip`: facing the camera (`facing` 0), lying flat on the
water (1, rings and foam patches), or facing the camera stretched along the particle's velocity
(2, streaking spray and droplets). `facing` 3 leaves the mesh as it is, for the faceted low-poly
chunks.
`shape` picks what the card draws: a lit water droplet, a soft spray/mist puff, an expanding ring,
a dissolving foam patch, a bubble, a sparkle. `look_mode` draws it in one of the five Tidewater
looks: realistic (lit beads with sun glints, soft scattering puffs), painted (brush-wobbled dabs in
colour bands with paper grain), cartoon (solid white blobs with an inked outline and a hard
highlight), lowpoly (hexagonal faceted cards and flat-shaded octahedron chunks), pixel (square
pixels on the card, two tones, stepped fade).
Per-particle life (0..1) and a random seed arrive in `shader_data` lane 0 (`data0` on the
graph's points). Draw with `alphaBlend`, no depth write, no culling.