Method draw

src/fl/fx/1d/perlin_particle_punch.cpp.hpp:413–494

// ---------------------------------------------------------------------------

void PerlinParticlePunch::draw(DrawContext context) {
    fl::span<CRGB> leds = context.leds;
    if (leds.empty() || mNumLeds == 0) {
        return;
    }
    u32 now = context.now;

    // --- Layer 1: Perlin noise background (fresh each frame) ---
    noiseCircleDraw(now, leds);

    // --- Trail buffer decay ---
    // Use the larger of the two trail intensities for the shared buffer.
    // Higher intensity value = less fade per frame = longer trails.
    u8 trailIntensity = mAmbientTrailIntensity > mMeteorTrailIntensity
                            ? mAmbientTrailIntensity
                            : mMeteorTrailIntensity;
    u8 decayRate = 255 - trailIntensity;
    fadeToBlackBy(mTrailBuffer.data(), mNumLeds, decayRate);

    // --- Layer 2: Ambient particles ---
    for (u16 i = 0; i < (u16)mAmbientParticles.size(); ++i) {
        AmbientParticle &p = mAmbientParticles[i];
        if (!p.alive)
            continue;
        // Physics update
        p.velocity *= mDrag;
        p.position += p.velocity;
        p.brightness *= mAmbientBrightnessDecay;
        if (p.position >= float(mNumLeds) || p.position < 0.0f ||
            p.brightness < 8.0f || p.velocity < mMinVelocity) {
            p.alive = false;
            continue;
        }
        renderAmbient(p);
    }

    // --- Layer 3: Meteors ---
    for (u16 i = 0; i < (u16)mMeteorParticles.size(); ++i) {
        MeteorParticle &m = mMeteorParticles[i];
        if (!m.alive)
            continue;
        // Debris spawn check before physics update
        if (m.shouldSpawnDebris()) {
            spawnDebrisFromMeteor(m, now);
        }
        // Physics update
        m.velocity *= mMeteorDrag;
        m.position += m.velocity;
        m.frameCounter++;
        if (m.position >= float(mNumLeds) || m.velocity < mMinVelocity) {
            m.alive = false;
            continue;
        }
        renderMeteor(m);
    }

    // --- Debris ---
    for (u16 i = 0; i < (u16)mDebrisParticles.size(); ++i) {