Syntax
This excerpt comes from the spec reference:
fuel = 4.0 # constant
fuel = [[0.0, 4.0], [0.5, 0.0]] # keys: [seconds, value]
position_m = [[0, -3, 1, 0], [2, 3, 1, 0]] # keys of a vector: [seconds, x, y, z]
fuel = { keys = [[0, 4], [0.5, 0]], ease = "smooth" } # ease: linear (default), smooth or step
- A key is
[seconds, value], or[seconds, x, y, z]for a vector. - The value blends between keys and holds before the first key and after the last. Key times must rise.
easeislinear(the default),smoothorstep.spatial-compiler schemamarks these fields"animatable": true.- Keys work on the command line too:
--set emitters.0.fuel=[[0,4],[0.5,0]].
Which fields take keys
| Section | Fields |
|---|---|
[[emitters]] | position_m, size_m, thickness_m, rotation_deg, fuel, temperature_k, smoke, dust, velocity_mps, direction, spread_deg, jitter, lumpiness |
[[forces]] | position_m, size_m, rotation_deg, falloff, strength, direction, max_speed_mps |
[[obstacles]] | position_m, size_m, height_m, rotation_deg |
[solver] | buoyancy, burn_rate, ignition_k, flame_k, expansion and more |
schema is the full list for the version you run.
Moving things
Keys on position_m move an emitter or an obstacle, and keys on rotation_deg turn it. A moving solid pushes the gas ahead of it, and a spinning one drags the gas at its surface.