DOCS // PYRO 0.4.1

Emitters

A spec has one or more [[emitters]] with no upper limit, each a sphere, box, disc, ring or points that adds fuel, heat, smoke or dust. Keys on position_m and rotation_deg move and turn an emitter during the clip.

Several emitters in one box

The impact example puts a short hot flash and a cold cone of thrown earth in one box (its third emitter, a ring, throws the skirt along the ground):

impact.pyro.toml (excerpt)
# The flash. Little fuel and a short burn, so its heat does not carry the dust up as a column.
[[emitters]]
shape = "sphere"
position_m = [0, 0.3, 0]
size_m = 0.4
start_s = 0.0
end_s = 0.06
fuel = 3
temperature_k = 1900
smoke = 2.0
velocity_mps = 6
direction = "radial"

# Earth thrown up and outward in a wide cone.
[[emitters]]
shape = "sphere"
position_m = [0, 0.25, 0]
size_m = 0.4
start_s = 0.0
end_s = 0.15
fuel = 0
temperature_k = 293
dust = 12
velocity_mps = 11
direction = "up"
spread_deg = 120
jitter = 0.6

Hot gas lifts whatever is in it, so keep a flash small and short when the dust should fall back.

Fields

Fields marked (t) take keys over time.

FieldMeaningDefault
shapesphere, box, disc, ring or pointssphere
position_mCenter (t). Keys move the source; a fast one leaves an unbroken trail, not a row of puffs.[0, 0.5, 0]
size_mRadius for a sphere, disc or ring; half-extents for a box (t)0.5
rotation_degTurns the shape, its points and its direction about X, then Y, then Z (t)[0, 0, 0]
start_s, end_sWhen it emits; end_s = 1000 for a steady source0, 0.2
fuelFuel added per second, as a 0 to 1 concentration (t)4.0
temperature_kTemperature of what it emits (t)1800
smokeSmoke added per second, independent of burning (t)0
dustDust added per second: heavy, cold, takes the ground color (t)0
velocity_mpsSpeed of emitted gas (t). At 0 the source adds gas and leaves the air moving as it was.6
directionradial, up, or a vector in the emitter's own frame (t)radial
spread_degCone half-angle around direction (t)180
jitterRandom variation of speed and position, 0 to 1 (t)0.3
inherit_velocityShare of a moving source's own speed given to what it emits: 0 leaves a trail, 1 throws it forward0
lumpinessHow uneven the source is, 0 to 1 (t); 0 starts a burst as a smooth dome0.5

Emitters and solids

Keep emitters clear of obstacles: an emitter fills its whole shape, so one that pokes through a wall also burns on the far side.