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):
# 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.
| Field | Meaning | Default |
|---|---|---|
shape | sphere, box, disc, ring or points | sphere |
position_m | Center (t). Keys move the source; a fast one leaves an unbroken trail, not a row of puffs. | [0, 0.5, 0] |
size_m | Radius for a sphere, disc or ring; half-extents for a box (t) | 0.5 |
rotation_deg | Turns the shape, its points and its direction about X, then Y, then Z (t) | [0, 0, 0] |
start_s, end_s | When it emits; end_s = 1000 for a steady source | 0, 0.2 |
fuel | Fuel added per second, as a 0 to 1 concentration (t) | 4.0 |
temperature_k | Temperature of what it emits (t) | 1800 |
smoke | Smoke added per second, independent of burning (t) | 0 |
dust | Dust added per second: heavy, cold, takes the ground color (t) | 0 |
velocity_mps | Speed of emitted gas (t). At 0 the source adds gas and leaves the air moving as it was. | 6 |
direction | radial, up, or a vector in the emitter's own frame (t) | radial |
spread_deg | Cone half-angle around direction (t) | 180 |
jitter | Random variation of speed and position, 0 to 1 (t) | 0.3 |
inherit_velocity | Share of a moving source's own speed given to what it emits: 0 leaves a trail, 1 throws it forward | 0 |
lumpiness | How uneven the source is, 0 to 1 (t); 0 starts a burst as a smooth dome | 0.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.