Skip to content
Docs
Open Promoeyes

emitter

set 0× in templates and rigs

Seekable particles, each a closed-form function of its own age, drawn as camera-facing quads: `kind` picks hot streaking sparks, drifting embers, rolling smoke, twinkling stardust or tumbling debris, and any attribute overrides it.

emitter(buoyancy=1 burst=1 color-end=#ffffff)

Attributes

buoyancynumbermm/s² up.0×
burstnumberSeconds over which all of `count` leave, once; `0` emits continuously (sparks 0.06, debris 0.05, the rest 0).0×
color-endcolour #rrggbb0×
color-startcolour #rrggbbThe colour when born; `color-end` at death. On debris: its heat, then the cold rock.0×
corenumber0×
countnumberHow many particles at most, up to 20000.0×
curlnumberHow far the swirling wobble displaces them, mm; `curl-scale` is the size of its eddies, mm.0×
curl-scalenumber0×
direction"x y z"`x y z`, the axis of the cone they leave in (default up). Aim with this, not `rotation`: gravity is the node's -y.0×
dragnumberAir drag, 1/s.0×
durationnumberContinuous: seconds it emits; the last ones then live out (default no end).0×
everynumber0×
fade-innumber0×
fade-outnumber0×
flarenumber0×
flickernumberPer-particle twinkle, 0..1.0×
floornumberThe y of a flat floor to bounce on, in the node's own space: an emitter at y 300 over a floor at 0 says `-300` (default none).0×
frictionnumber0×
glownumberEmissive gain.0×
gravitynumbermm/s² down.0×
kindtext`sparks` (default), `embers`, `smoke`, `stardust` or `debris`: the defaults of everything else, the look included.0×
life-maxnumber0×
life-minnumberShortest life, seconds; `life-max` the longest.0×
looptrue / false`true` repeats it; `every` is its period in seconds.0×
opacitynumberOverall opacity; also × node opacity keys.0×
position"x y z"0×
prewarmnumberContinuous: seconds already elapsed at `start`, so it is already running.0×
radialnumber0×
ratenumberContinuous: particles a second, capped at count / life-max.0×
restitutionnumberBounce on the floor, 0..0.95; negative ignores it.0×
seednumberRolls different dice.0×
shapetextWhere they start: `point` (default), `sphere`, `disc`, `ring` (both on XZ) or `box`.0×
shape-sizenumberRadius in mm, or `w h d` for a box.0×
size-endnumber0×
size-pownumber0×
size-startnumberDiameter when born, mm; `size-end` at death.0×
size-varnumber0×
speednumberHow fast they leave, mm/s; `speed-var` is how much slower the slowest is, 0..1.0×
speed-varnumber0×
spinnumber0×
spreadnumberThe cone's half angle in degrees; 180 is every way.0×
startnumberWhen it starts, seconds.0×
stretchnumberSeconds of motion a streak spans; glow kinds only.0×