Values
Numbers
Section titled “Numbers”A number: a constant, a random range [min, max], an expression string, or a curve.
2: a constant.[1, 3]: random between 1 and 3, picked once per particle or effect."radius * 2 + sin(time * 4)": an expression, evaluated every frame.{ "keys": [[0, 0], [0.3, 1, "out_back"], [1, 0]] }: a curve.
Expression variables
Section titled “Expression variables”| Name | Meaning |
|---|---|
t / life |
0 to 1 over the track, or over the particle’s life inside particle |
time |
Seconds since the effect started |
age |
Seconds since the track or particle started |
rand |
A stable random number of the particle or instance, 0 to 1 |
index |
Particle index |
scale |
The effect’s scale |
pi, tau |
Constants |
| any param | Its current value |
Functions
Section titled “Functions”sin cos tan asin acos atan atan2 abs sign floor ceil round fract sqrt exp log pow min max clamp lerp mix step smoothstep saturate hash noise pulse, and every easing name as a one-argument function. Operators: + - * / % ^, comparisons, && || ! and cond ? a : b.
Curves
Section titled “Curves”Keyframes [time, value] or [time, value, easing]. over picks the input: t (default), time or age. A key may carry its own easing as a third item.
Vectors
Section titled “Vectors”[x, y, z] with any number form per component, a single number for all three, or a curve with [time, [x, y, z]] keys.
Colours
Section titled “Colours”“#rrggbb”, “#rrggbbaa”, [r, g, b, a] (values above 1 glow), “$param”, or a gradient.
Gradients take stops spread evenly (["#fff", "#f80", "#3000"]) or at positions ([[0, "#fff"], [0.2, "#f80"], [1, "#3000"]]). Colour channels above 1 feed bloom.
Easings
Section titled “Easings”linear, step, in_sine, out_sine, in_out_sine, in_quad, out_quad, in_out_quad, in_cubic, out_cubic, in_out_cubic, in_quart, out_quart, in_out_quart, in_expo, out_expo, in_out_expo, in_circ, out_circ, in_out_circ, in_back, out_back, in_out_back, in_elastic, out_elastic, in_out_elastic, in_bounce, out_bounce, in_out_bounce
