# driftCard (shader)
The surface shader every ambientDrift particle draws with: one small card per particle that looks
like a firefly glow, a notched cherry petal, an autumn leaf, a snow flake, a torn mist puff, a
drizzle streak, a four-pointed sparkle, a ragged ash flake, a dust or pollen mote, or a spray
droplet (`shape` 0..9).
- Cards face the camera, tumble in 3D (petals, leaves, ash) or stretch along the fall (drizzle).
- Lit sprites take the sun with its shadows, the sky's ambient and every lamp in reach, with light
through the back of thin petals and leaves and forward scattering on dust; glowing sprites add HDR
light the bloom catches; fireflies blink, embers flicker, spray shows a rainbow near 41 degrees
from the point opposite the sun.
- Wind, sway, bob, spin, the wrap-around inside the area box (or around the camera), the fade at the
box faces and the seeded density share all run in the vertex stage on the gameplay clock.
Each particle's seed and life ride in its instance scale (`size * (1, 1 + seed, 1 + life)`). Every
property is a float; a procedural graph hands it scalars. Used by the `airDrift` effect's
`parts/field`.
# field (procGraph part)
One field of drifting ambient particles, the part every ambientDrift style is built from. Outputs
`field`, an instanced population of soft cards drawn with `shaders/driftCard`, and `points`, the live
particles of the GPU solver.
Steered by: `count` and the area box (`areaX/Y/Z`, `centerX/Y/Z`, birth band `bandLow` / `bandHigh`),
`seed`; motion on the solver (`velocity`, `jitter`, `terminal` fall or rise speed, `pull`,
`lifeMin` / `lifeMax`, `sizeMin` / `sizeMax`); and the look and GPU drift handed to the shader
(`shape`, `facing`, `additive`, colours, `tintR/G/B` and `tintAmount`, `glow`, `lit`, `opacity`,
`blink`, `flicker`, `rainbow`, `density`, `windX/Y/Z`, `offsetX/Y/Z`, `swayAmp`, `bob`, `swayHz`,
`spin`, `sizeMul`, `grow`, `streak`, `aspect`, `follow`, `wrapY`, `blend`, `queue`).
# airDrift (effect)
Ambient drifting air particles, one entry per style, each a field that runs until stopped:
| entry | what it shows |
|---|---|
| `fireflies` | yellow-green lights rising from the grass, wandering and blinking, glowing for bloom |
| `cherryPetals` | pink notched sakura petals tumbling down, lit and translucent |
| `autumnLeaves` | red, orange, gold and brown leaves swinging down |
| `dustMotes` | tiny specks that show only where light falls |
| `pollen` | yellow and cream fluff floating up |
| `embers` | orange sparks rising, flickering, burning out |
| `snow` | soft white flakes falling and swaying |
| `mistWisps` | big soft fog puffs drifting low |
| `waterSpray` | fine droplets thrown up at a waterfall's foot, with rainbow sparkle |
| `ash` | ragged grey flakes falling, some smouldering |
| `glowSpores` | bioluminescent teal and green motes pulsing |
| `drizzle` | thin streaks of light rain |
| `sparkles` | twinkling four-pointed stars drifting up |
Every entry takes the same inputs, all numbers (a play keeps number inputs only): `count`
(particles at full density), `areaX` / `areaY` / `areaZ` (box size, m), `centerX` / `centerY` /
`centerZ` (world middle of the box), `follow` (1 wraps around the camera), `density` (0..1 share
shown), `windX` / `windY` / `windZ` (m/s), `offsetX` / `offsetY` / `offsetZ` (drift kept from earlier
winds), `tintR` / `tintG` / `tintB` and `tintAmount` (colour override), `swayScale` (mood),
`sizeScale`, `seed`.
Each graph under `graphs/` calls `parts/field`: particles born at seeded spots through the box on
`sim.particles`, pulled toward the style's fall or rise speed, carrying seed, life and size in their
instance scale. `shaders/driftCard` draws them: the sprite shape, camera-facing or 3D tumbling cards
or streaks, sun, shadow, ambient and lamp lighting, HDR glow, blink, flicker, rainbow, and on the GPU
the wind, sway, spin, wrap-around inside the box and the density fade.
The `Drift` component and `ambientDrift.api` play these entries for you.