---
title: "Pyro emitters: any number of sources that move, turn and emit fuel or smoke"
description: "Pyro [[emitters]]: shapes, fuel, heat, smoke and dust, speed and direction, and how keys move and turn an emitter during the clip. Any number per spec."
canonical: https://appliedmanifold.com/docs/pyro/emitters/
site: "Applied Manifold: The spatial compute cloud for 3D reality"
---

1.  [Home](https://appliedmanifold.com/)
2.  [Docs](https://appliedmanifold.com/docs/)
3.  [Pyro](https://appliedmanifold.com/docs/pyro/)
4.  Emitters

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](https://appliedmanifold.com/docs/pyro/values-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](https://appliedmanifold.com/docs/pyro/obstacles/): an emitter fills its whole shape, so one that pokes through a wall also burns on the far side.
