Particle
A single particle's live state. Held in a flat buffer on the
Interface: Particle
Defined in: packages/motion/src/particles/Particle.ts:20
A single particle's live state. Held in a flat buffer on the
ParticleField instance — never its own entity/instance/fiber. Position
and velocity are integrated each frame; age counts up to life
(seconds), at which point the particle is dead and its slot is free.
size and color are the values DRAWN at birth (the particle's
baseline); over-life curves modulate them at render time as a function
of age/life and never mutate these fields.
rng is the particle's own generator state (see Prng). Tier-2 curves
never read it.
ponytail: reserved so a future Tier-3 fn(age, rng) per-property config
is purely additive — no buffer layout change. Drop it if Tier 3 is ruled
out for good.
Properties
age
age: number;Defined in: packages/motion/src/particles/Particle.ts:25
alive
alive: boolean;Defined in: packages/motion/src/particles/Particle.ts:33
false = dead slot, reusable by the next emission
color
color: Color;Defined in: packages/motion/src/particles/Particle.ts:30
life
life: number;Defined in: packages/motion/src/particles/Particle.ts:26
opacity
opacity: number;Defined in: packages/motion/src/particles/Particle.ts:29
baseline opacity drawn at birth; the over-life curve multiplies it
rng
rng: number;Defined in: packages/motion/src/particles/Particle.ts:31
size
size: number;Defined in: packages/motion/src/particles/Particle.ts:27
vx
vx: number;Defined in: packages/motion/src/particles/Particle.ts:23
vy
vy: number;Defined in: packages/motion/src/particles/Particle.ts:24
wrap
wrap: boolean;Defined in: packages/motion/src/particles/Particle.ts:39
true for fill-mode particles: they never age out and wrap around the
fill region's edges instead of dying, so the field stays evenly
populated forever. Emitter-mode particles leave this false.
x
x: number;Defined in: packages/motion/src/particles/Particle.ts:21
y
y: number;Defined in: packages/motion/src/particles/Particle.ts:22