Wanderer.h

//
//  Wanderer.h
//  avara3d
//
//  Created by Morgan Davis on 8/12/26.
//  Copyright © 2026 Morgan K Davis. All rights reserved.
//
 
#ifndef AVARA3D_EXTENSION_WANDERER_H
#define AVARA3D_EXTENSION_WANDERER_H
 
#include <cstdint>
#include <memory>
#include <random>
 
#include "a3d/Math.h"
 
namespace a3d {
 
    class Node;
 
}
 
namespace a3d::ext {
 
    class Wanderer {
 
    public:
        // [Public Types]
 
        struct Config {
 
            math::vec3 halfExtents {
                1.0f, 1.0f,
                1.0f}; 
            double segmentDuration {
                3.0}; 
            std::uint32_t seed {0}; 
        };
 
        // [Public Lifecycle Functions]
 
        explicit Wanderer(const std::shared_ptr<Node>& node);
 
        Wanderer(const std::shared_ptr<Node>& node, const Config& config);
 
        // [Public Member Functions]
 
        const Config&     config() const;
 
        void              config(const Config& config);
 
        const math::vec3& center() const;
 
        void              update(double deltaTime);
 
        void              reset();
 
        void              recenter();
 
    private:
        // [Private Member Functions]
 
        void                initializePath();
        void                advancePath();
 
        math::vec3          randomPoint();
        math::vec3          randomOffset(float scale);
 
        // [Private Member Variables]
 
        std::weak_ptr<Node> _node;
 
        Config              _config;
        std::mt19937        _random;
 
        math::vec3          _center;
 
        math::vec3          _p0;
        math::vec3          _p1;
        math::vec3          _p2;
        math::vec3          _p3;
 
        double              _phase {0.0};
    };
 
}
 
#endif // AVARA3D_EXTENSION_WANDERER_H