CameraController.h

浏览该文件的文档.

#pragma once
 
#include "common/Module.h"
 
#include <glm/glm.hpp>
 
#include <string>
#include <vector>
 
namespace eve::graphics {
class Camera3D;
}
 
namespace eve::camera {
 
class CameraController {
public:
    CameraController();
    ~CameraController() = default;
 
    // --- 绑定要驱动的摄像机 ---
    void setCamera(graphics::Camera3D *cam);
    graphics::Camera3D *getCamera() const;
 
    // --- 目标 / 观察锚点 ---
    void setTarget(float x, float y, float z);
    float getTargetX() const;
    float getTargetY() const;
    float getTargetZ() const;
    void setOffset(float x, float y, float z);
    void setLookAhead(float x, float y, float z);
 
    // --- 视角模式 ---
    void setMode(const std::string &mode);
    std::string getMode() const;
 
    // --- orbit / topdown 参数 ---
    void setRadius(float r);               // orbit 半径 / topdown 高度
    void setAzimuth(float deg);            // orbit 方位角
    void setElevation(float deg);          // orbit 仰角
    void setOrbitSpeed(float degPerSec);   // 自动盘旋转速
 
    // --- firstperson 参数 ---
    void setYaw(float deg);
    void setPitch(float deg);
 
    // --- 平滑 ---
    void setSmooth(float damping);         // 每秒指数阻尼，越大越跟手
    void setMaxSpeed(float unitsPerSec);   // 0 = 不限速
    void snap();                           // 立即应用当前目标视角
 
    // --- cinematic / 自动切换视角 ---
    void addView(const std::string &name, float ex, float ey, float ez,
                 float tx, float ty, float tz);
    bool switchTo(const std::string &name, float blendTime);
    void playSequence(float stepTime);     // 每隔 stepTime 秒切换到下一个 View
    void stopSequence();
    bool isPlaying() const;
 
    // --- 每帧驱动 ---
    void update(float dt);
 
private:
    struct View {
        std::string name;
        glm::vec3 eye{0.f};
        glm::vec3 target{0.f};
    };
 
    View desired() const;
    void applyView(const View &v);
    void easeToward(const View &v, float dt);
 
    graphics::Camera3D *cam_ = nullptr;
 
    std::string mode_ = "follow";
 
    glm::vec3 target_{0.f, 0.f, 0.f};
    glm::vec3 offset_{0.f, 2.f, 6.f};
    glm::vec3 lookAhead_{0.f, 0.f, 0.f};
 
    float radius_ = 10.f;
    float azimuthDeg_ = 45.f;
    float elevationDeg_ = 30.f;
    float orbitSpeedDeg_ = 20.f;
 
    float yawDeg_ = 0.f;
    float pitchDeg_ = 0.f;
 
    float smooth_ = 6.f;
    float maxSpeed_ = 0.f;
    bool  initialized_ = false;
    View  cur_{};
 
    // cinematic
    std::vector<View> views_;
    int   viewIndex_ = -1;
    bool  playing_ = false;
    float stepTime_ = 3.f;
    float timer_ = 0.f;
    bool  blending_ = false;
    View  blendFrom_{};
    View  blendTo_{};
    float blendT_ = 0.f;
    float blendDur_ = 1.f;
};
 
class Camera : public Module {
public:
    Module_REG(Camera);
    Camera() = default;
    ~Camera() override = default;
};
 
}  // namespace eve::camera