EvenRingDistance
Generator. Emits particles evenly spaced along the path the emitter travels, like a ring of emission slots laid out on the distance instead of time. It is the distance counterpart of EvenRing and the exact, even alternative to GenApproxDistance — on GPU33 too.
The ring-on-the-path model. The emitter's whole capacity is spread over the Ring length: one shot of Burst particles every ring length / (Max. num. particles / Burst) units of travelled distance, slightly stretched (by about 2 %, as on EvenRing) so a slot is free again in time. Each slot fires once per ring length travelled, so a particle must die before the emitter travels one ring length — keep speed × particle life within the ring length. When the emitter is faster, a shot whose slot is still held by a live particle is lost (on every backend: each shot owns its own slots, as in a ring).
A still emitter emits nothing: the generator counts distance, not time. The only exception is the first shot when Start Phase is 1 and Start distance is 0 — it fires as soon as the emitter starts (or, for an attached emitter "On terminate", where its parent dies), moving or not. To emit while standing still, use a time generator (EvenRing, GenPeriodic).
An attached emitter "On terminate" keeps its parent only while it has particles (see Attached emitter). A dead parent does not move, so this generator fires there only its first shot, and only with Start distance 0 and Start Phase 1; once that particle dies, the parent is removed. With any other start it emits nothing, and the editor warns about it.
All properties must remain constant over time, otherwise generating glitches may occur.
What counts as travelled distance. The same distance as the EmitterTraveledDistance block: the sum of the straight steps between the emitter's positions frame by frame. Teleporting the emitter with resetPosition adds nothing. Between two frames a shot is placed on the straight line between the two positions, and its particle is born at the matching moment of the frame.
A frame longer than the ring. If the emitter moves more than one ring length in a single frame, each slot keeps only its latest shot (the shots nearest to the emitter); the earlier ones of that frame are lost, but still counted by Shots Made and by the shots limit.
Precision. The ring is computed from the travelled distance in single precision. Over a very long path (millions of units) the shots start to shift and, eventually, get lost. Restarting the effect resets the distance.
Shots on different backends. Every backend (GPU33, JavaScript 1.1, C# 1.2 and Unity) uses the same ring: a whole number of shots per ring, Max. num. particles divided by the whole part of Burst (for example 60 particles with Burst 7 make 8 shots per ring, 4 slots unused). The older exporters (JavaScript 1.0, C# 1.0 and 1.1) do not support this generator and report it on export.
The generator has no timeline visualizer and no rate, so the Emitter Guide's life link does not apply to it.
Properties & inputs:
- Ring length (input | property): The distance the emitter travels while the whole capacity is emitted once.
- Enable distance limit (property): Limits the generating to a travelled distance, counted from the emitter start including Start distance: only shots placed at or before the limit fire.
- Enable shots limit (property): Limits the total number of shots: only the first N fire, a fractional limit rounded up (2.5 allows three). A limit of 0 still lets the first shot fire, unless the distance limit stops it.
- Start distance (input | property): The distance the emitter travels before the generator starts.
- Start Phase (input | property): Value from 0 to 1. If 1, the first shot fires right at the start. If 0, the emitter first travels the distance of one shot.
- Burst (input | property): Number of particles per shot. A fraction is cut to its whole part.
- Burst pos mode (property): Controls how the Burst Pos. output is spread across the particles of one shot. Normalized (default) runs the first particle to 0 and the last to 1 (index / (burst − 1)). Linear runs the first particle to 0 and the last to 1 − 1/burst (index / burst).
Outputs:
- Burst Amount (float): Number of particles in the current burst.
- Burst Pos. (float): Position of a particle within the burst (0 for a burst of one particle).
- Shots Made (float): How many shots this generator had already completed when the particle was born — 0 for the very first shot. Lost shots count too. In the Emitter Guide the same value is available as the Number of shots value type.
In the Emitter Guide the generator is the EvenRing Distance mode of the Generation section.