perlin_particle_punch.h

Go to the documentation of this file.

#pragma once

 
#include "fl/fx/fx1d.h"
#include "fl/gfx/colorutils.h"
#include "fl/math/fixed_point/s16x16.h"
#include "fl/stl/vector.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
 
FASTLED_SHARED_PTR(PerlinParticlePunch);
 
class PerlinParticlePunch : public Fx1d {
  public:
    PerlinParticlePunch(u16 num_leds) FL_NO_EXCEPT;
    ~PerlinParticlePunch() FL_NO_EXCEPT;
 
    void draw(DrawContext context) FL_NO_EXCEPT override;
    fl::string fxName() const FL_NO_EXCEPT override;
 
    // --- Particle spawning (called from sketch via detector callbacks) ---

    void spawnAmbient(float intensity = 0.5f) FL_NO_EXCEPT;

    void spawnMeteor(float intensity = 1.0f) FL_NO_EXCEPT;
 
    // --- Perlin noise layer control ---

    void setTimeMultiplier(float mult) FL_NO_EXCEPT;

    void setNoisePalette(const CRGBPalette16 &palette) FL_NO_EXCEPT;
 
    // --- Ambient control ---

    void setAmbientPalette(const CRGBPalette16 &palette) FL_NO_EXCEPT;
 
    // --- Meteor control ---

    void setMeteorGradient(CRGB headColor, CRGB midColor, CRGB tailColor) FL_NO_EXCEPT;
 
    // --- Physics tuning ---

    void setDrag(float drag) FL_NO_EXCEPT;

    void setSpeed(float speed) FL_NO_EXCEPT;
 
    // --- Trail control ---

    void setAmbientTrailIntensity(u8 intensity) FL_NO_EXCEPT;

    void setMeteorTrailIntensity(u8 intensity) FL_NO_EXCEPT;
 
    // --- Particle lifetime tuning ---

    void setAmbientBrightnessDecay(float decay) FL_NO_EXCEPT;

    void setMinVelocity(float minVel) FL_NO_EXCEPT;

    void setDebrisBrightnessDecay(float decay) FL_NO_EXCEPT;

    void setDebrisVelocityDecay(float decay) FL_NO_EXCEPT;
 
  private:
    struct AmbientParticle;
    struct MeteorParticle;
    struct DebrisParticle;
 
    // Perlin noise
    float mTimeMultiplier = 1.0f;
    CRGBPalette16 mNoisePalette;
 
    // Ambient
    CRGBPalette16 mAmbientPalette;
    float mDrag = 0.95f;
    float mSpeed = 1.0f;
    u8 mAmbientTrailIntensity = 200;
 
    // Meteor
    CRGB mMeteorHeadColor = CRGB(255, 255, 255);
    CRGB mMeteorMidColor = CRGB(140, 180, 255);
    CRGB mMeteorTailColor = CRGB(0, 40, 120);
    float mMeteorDrag = 0.92f;
    u8 mMeteorTrailIntensity = 220;
 
    // Particle lifetime
    float mAmbientBrightnessDecay = 0.97f;
    float mMinVelocity = 0.05f;
    float mDebrisBrightnessDecay = 0.90f;
    float mDebrisVelocityDecay = 0.95f;
 
    // Particle pools
    fl::vector<AmbientParticle> mAmbientParticles;
    fl::vector<MeteorParticle> mMeteorParticles;
    fl::vector<DebrisParticle> mDebrisParticles;
 
    // Trail buffer (persistent between frames)
    fl::vector<CRGB> mTrailBuffer;
 
    // Noise helpers (kept from original, using s16x16)
    static s16x16 mapf(s16x16 x, s16x16 in_min, s16x16 in_max, s16x16 out_min,
                        s16x16 out_max) FL_NO_EXCEPT;
    s16x16 circleNoiseGen(u32 now, s16x16 theta) const FL_NO_EXCEPT;
    void noiseCircleDraw(u32 now, fl::span<CRGB> dst) FL_NO_EXCEPT;
 
    // Particle helpers
    AmbientParticle *tryAllocateAmbient() FL_NO_EXCEPT;
    MeteorParticle *tryAllocateMeteor() FL_NO_EXCEPT;
    DebrisParticle *tryAllocateDebris() FL_NO_EXCEPT;
    void renderAmbient(const AmbientParticle &p) FL_NO_EXCEPT;
    void renderMeteor(const MeteorParticle &m) FL_NO_EXCEPT;
    void renderDebris(const DebrisParticle &d) FL_NO_EXCEPT;
    void spawnDebrisFromMeteor(MeteorParticle &m, u32 now) FL_NO_EXCEPT;
 
    static void writeMax(CRGB &dst, const CRGB &src) FL_NO_EXCEPT;
};
 
} // namespace fl