Scatter a particle field
make_particlesFill a region with many small shapes (dots, rings, sparkles, stars, plus, cross, pills, squares, triangles, blobs) spread by a seed: no clumps, no grid, sizes leaning small, some out of focus for depth, colours from a palette, a box kept clear behind text. Motion: float, twinkle, burst (from a point), rain, rise, pop, or still. Sits behind the other layers unless front is set.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The group's layer name (default "Particles"). | |
| seed | No | Same seed, same field. | |
| size | No | Smallest and largest size, px (default 6 to 28). | |
| avoid | No | Keep this box clear (e.g. behind a headline): [x, y, width, height]. | |
| count | Yes | How many, 1 to 400. | |
| depth | No | Share of particles pushed out of focus (bigger, blurred, fainter) for depth, 0 to 1 (default 0.2). | |
| front | No | Put the field on top of everything (default: behind the other layers). | |
| start | No | Seconds: when the motion starts (default 0). | |
| until | No | Seconds: when floating stops (default start + duration + 4, so the field doesn't stretch a short scene). The scene timeline grows to it. | |
| intent | Yes | One short sentence: what you change and why. Kept in the design history. | |
| motion | No | ||
| origin | No | Burst: the point they fly out from, in the parent (default the region's centre). | |
| region | Yes | The area they live in (px in the parent): [x, y, width, height]. | |
| shapes | No | Which shapes, mixed (default dot, ring, sparkle). | |
| opacity | No | Lowest and highest opacity (default 0.5 to 1). | |
| page_id | Yes | The page to work on, as returned by create_design. | |
| palette | No | Series colours in order, as hex. Default: a built-in palette. | |
| duration | No | Seconds: how long the arrival takes (burst, rain, pop; default 1.2), or the whole drift (rise). | |
| strength | No | How far they drift, px (default 14). | |
| parent_id | No |