Example
The impact example: a hot flash and a cold cone of thrown earth (a third ring emitter throws the ground skirt):
# 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 dust, so keep a flash small and short when dust should fall.
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 it; fast moves leave an unbroken trail. | [0, 0.5, 0] |
size_m | Radius for a sphere, disc or ring; half-extents for a box (t) | 0.5 |
rotation_deg | Rotation 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). 0 adds gas without pushing air. | 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 the source’s speed passed on: 0 trails, 1 throws forward | 0 |
lumpiness | Unevenness, 0 to 1 (t); 0 is a smooth dome | 0.5 |
Obstacles
Keep emitters clear of obstacles. An emitter that pokes through a wall burns on both sides.
Questions
What shapes can a pyrofx emitter use?
An emitter can use sphere, box, disc, ring or points shapes to add fuel, heat, smoke or dust.
How do I keep dust from rising with a flash in pyrofx?
Keep the flash emitter small with little fuel and a short burn so its heat does not lift the dust.
What happens if a pyrofx emitter pokes through an obstacle?
An emitter that pokes through a wall burns on both sides, so keep emitters clear of obstacles.