#ParticleLayer

A ParticleLayer draws 2D particles over the UI: confetti for a win, sparkles on a reward, dust from a drill, or coins that fly from a chest to the coin counter. The layer fills its parent and ignores the pointer, so add it as the last child of the root. The ParticlesDemo example has rewards, a burst editor and emitters. The Driller game sends the ore to the cargo bar and the coins to the cash.

<tb:ParticleLayer name="particles" />

var layer = root.Q<ParticleLayer>("particles");

// Coins fly from the chest to the counter
layer.Burst(chestButton, new ParticleSettings
{
    Count = 20,
    Shape = ParticleShape.Circle,
    StartColor = gold, EndColor = gold, // no fade
    Target = coinCounter,
});

// The counter counts as the coins arrive, not before them
layer.Arrived += target =>
{
    if (target == coinCounter) coins += 5;
};

// A continuous source that follows an element
var dust = layer.Emit(drill, new ParticleSettings { Shape = ParticleShape.Square, Gravity = 300 }, rate: 40);
dust.Stop();

#ParticleLayer

#ParticleEmitter

#ParticleSettings

Each range is (minimum, maximum), and each particle takes a random value in it. Positions and sizes are in pixels; times are in seconds.

• The layer draws all particles in one mesh for each image, so thousands of particles cost a few draw calls.
• The timer of the layer runs only while particles are alive.
• In the UI Builder, the layer shows a dashed outline with its name, so you can find it. The outline does not show in Play mode or in a build.
• A long frame, for example a hitch, runs the simulation slower. The particles do not jump.

#Styling