PlacementSession.h

浏览该文件的文档.

#pragma once
 
// 放置会话：封装「选择建筑 -> 跟随指针 -> 校验 -> 放置 / 拆除」的交互状态。
// 纯逻辑、不接输入设备；脚本每帧喂指针坐标 / 表面命中，会话内部驱动 Ghost。
 
#include <string>
 
namespace eve::building {
 
class PlacementWorld;
class Ghost;
 
class PlacementSession {
public:
    PlacementSession();
    ~PlacementSession() = default;
 
    PlacementSession(const PlacementSession &) = delete;
    PlacementSession &operator=(const PlacementSession &) = delete;
 
    void destroy();
 
    bool startPlacement(PlacementWorld *world, const std::string &buildingId);
    void stopPlacement();
    bool isActive() const { return active_; }
    PlacementWorld *getWorld() const { return world_; }
    std::string getBuildingId() const;
    Ghost *getGhost() const { return ghost_; }
 
    void setMode(const std::string &mode);
    std::string getMode() const { return mode_; }
 
    void setRotationDeg(float deg);
    void rotateBy(float deltaDeg);
    float getRotationDeg() const;
 
    bool updateFromWorld(PlacementWorld *world, float worldX, float worldY);
    bool updateFromWorld3D(PlacementWorld *world, float worldX, float worldY, float worldZ);
    bool updateFromSurface(PlacementWorld *world, const std::string &surface, float x, float y);
 
    bool isValid() const;
    std::string getReason() const;
 
    int execute();
 
private:
    void refreshValidate();
 
    PlacementWorld *world_ = nullptr;
    Ghost *ghost_ = nullptr;
    std::string mode_ = "place";
    bool active_ = false;
};
 
}  // namespace eve::building