engine.h

Go to the documentation of this file.

#pragma once
 
// Engine: Standalone implementation for Animartrix2 animations.
// Extracted from animartrix_detail.hpp so it can be forward-declared
// and included independently by chasing_spirals implementations.
 
#include "fl/stl/compiler_control.h"
#include "fl/fx/2d/animartrix_detail/context.h"
#include "fl/fx/2d/animartrix_detail/core_types.h"
#include "fl/fx/2d/animartrix_detail/engine_core.h"
#include "fl/math/math.h"
#include "fl/stl/optional.h"
#include "fl/stl/stdint.h"
#include "fl/stl/vector.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
 
struct Engine {
    Context *mCtx;
 
    // Core ANIMartRIX state (extracted from animartrix_detail::ANIMartRIX)
    int num_x = 0;
    int num_y = 0;
    float speed_factor = 1;
    float radial_filter_radius = 23.0;
    bool serpentine = false;
 
    render_parameters animation;
    oscillators timings;
    modulators move;
    rgb pixel;
 
    fl::vector<fl::vector<float>> polar_theta;
    fl::vector<fl::vector<float>> distance;
 
    unsigned long a = 0;
    unsigned long b = 0;
    unsigned long c = 0;
 
    float show1 = 0.0f;
    float show2 = 0.0f;
    float show3 = 0.0f;
    float show4 = 0.0f;
    float show5 = 0.0f;
    float show6 = 0.0f;
    float show7 = 0.0f;
    float show8 = 0.0f;
    float show9 = 0.0f;
    float show0 = 0.0f;
 
    fl::optional<fl::u32> currentTime;
 
    Engine(Context *ctx) FL_NO_EXCEPT : mCtx(ctx) {}
    ~Engine() FL_NO_EXCEPT;
 
    void setTime(fl::u32 t) FL_NO_EXCEPT { currentTime = t; }
    fl::u32 getTime() FL_NO_EXCEPT { return currentTime.has_value() ? currentTime.value() : fl::millis(); }
 
    void init(int w, int h) FL_NO_EXCEPT {
        animation = render_parameters();
        timings = oscillators();
        move = modulators();
        pixel = rgb();
 
        this->num_x = w;
        this->num_y = h;
        this->radial_filter_radius = fl::min(w, h) * 0.65;
        render_polar_lookup_table(
            (num_x / 2) - 0.5,
            (num_y / 2) - 0.5,
            polar_theta,
            distance,
            num_x,
            num_y);
        timings.master_speed = 0.01;
    }
 
    void setSpeedFactor(float speed) FL_NO_EXCEPT { this->speed_factor = speed; }
 
    // Method wrappers that delegate to standalone functions
    void calculate_oscillators(oscillators &t) FL_NO_EXCEPT {
        fl::calculate_oscillators(t, move, getTime(), speed_factor);
    }
 
    void run_default_oscillators(float master_speed = 0.005) FL_NO_EXCEPT {
        fl::run_default_oscillators(timings, move, getTime(), speed_factor, master_speed);
    }
 
    FASTLED_FORCE_INLINE float render_value(render_parameters &anim) FL_NO_EXCEPT {
        return fl::render_value(anim);
    }
 
    FASTLED_FORCE_INLINE rgb rgb_sanity_check(rgb &p) FL_NO_EXCEPT {
        return fl::rgb_sanity_check(p);
    }
 
    void get_ready() FL_NO_EXCEPT {
        fl::get_ready(a, b);
    }
 
    void logOutput() FL_NO_EXCEPT {
        fl::logOutput(b);
    }
 
    void logFrame() FL_NO_EXCEPT {
        fl::logFrame(c);
    }
 
    // Color blend wrappers
    float subtract(float &x, float &y) FL_NO_EXCEPT { return fl::subtract(x, y); }
    float multiply(float &x, float &y) FL_NO_EXCEPT { return fl::multiply(x, y); }
    float add(float &x, float &y) FL_NO_EXCEPT { return fl::add(x, y); }
    float screen(float &x, float &y) FL_NO_EXCEPT { return fl::screen(x, y); }
    float colordodge(float &x, float &y) FL_NO_EXCEPT { return fl::colordodge(x, y); }
    float colorburn(float &x, float &y) FL_NO_EXCEPT { return fl::colorburn(x, y); }
 
    FASTLED_FORCE_INLINE void setPixelColorInternal(int x, int y, rgb pixel) FL_NO_EXCEPT {
        fl::u16 idx = mCtx->xyMapFn(x, y, mCtx->xyMapUserData);
        mCtx->leds[idx] = CRGB(pixel.red, pixel.green, pixel.blue);
    }
 
    FASTLED_FORCE_INLINE fl::u16 xyMap(fl::u16 x, fl::u16 y) FL_NO_EXCEPT {
        return mCtx->xyMapFn(x, y, mCtx->xyMapUserData);
    }
};
 
inline Engine::~Engine() FL_NO_EXCEPT = default;
 
inline Context::~Context() FL_NO_EXCEPT = default;
 
// Initialize context with grid dimensions
inline void init(Context &ctx, int w, int h) FL_NO_EXCEPT {
    if (!ctx.mEngine) {
        ctx.mEngine = fl::make_unique<Engine>(&ctx);
    }
    ctx.num_x = w;
    ctx.num_y = h;
    ctx.mEngine->init(w, h);
}
 
// Set time for deterministic rendering
inline void setTime(Context &ctx, fl::u32 t) FL_NO_EXCEPT {
    ctx.currentTime = t;
    if (ctx.mEngine) {
        ctx.mEngine->setTime(t);
    }
}
 
}  // namespace fl