effect-motion
API Referenceeffect-motionNamespacesParticlesInterfaces

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

On this page