Ghost.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
// 鬼影预览：候选建筑姿态 + 最近一次校验结果，供 UI 着色与确认放置。
 
#include "building/BuildingTypes.h"
 
#include <string>
 
namespace eve::building {
 
class PlacementWorld;
 
class EVENGINE_API_WORLD Ghost {
public:
    Ghost() = default;
    ~Ghost() = default;
 
    void destroy();
 
    std::string getBuildingId() const { return buildingId_; }
    void setBuildingId(const std::string &id);
 
    int getCellX() const { return cellX_; }
    int getCellY() const { return cellY_; }
    void setCell(int cellX, int cellY);
 
    float getWorldX() const { return worldX_; }
    float getWorldY() const { return worldY_; }
    void setWorld(float worldX, float worldY);
    float getElevation() const { return elevation_; }
    void setElevation(float elevation);
 
    float getRotationDeg() const { return rotationDeg_; }
    void setRotationDeg(float deg);
    void rotateBy(float deltaDeg);
    std::string getPlacementKind() const { return placementKind_; }
    std::string getEdgeAxis() const;
    void setEdge(PlacementWorld *world, int cellX, int cellY, const std::string &direction);
    void setCorner(PlacementWorld *world, int vertexX, int vertexY);
    void setFree(PlacementWorld *world, float worldX, float worldY, float elevation = 0.f);
 
    bool isValid() const { return valid_; }
    std::string getReason() const { return reason_; }
    std::string getSurfaceId() const { return surfaceId_; }
    int64_t getSurfaceRevision() const { return static_cast<int64_t>(surfaceRevision_); }
    float getSurfaceNormalX() const { return surfaceNormalX_; }
    float getSurfaceNormalY() const { return surfaceNormalY_; }
    float getSurfaceNormalZ() const { return surfaceNormalZ_; }
    float getSurfaceTangentX() const { return surfaceTangentX_; }
    float getSurfaceTangentY() const { return surfaceTangentY_; }
    float getSurfaceTangentZ() const { return surfaceTangentZ_; }
    int getSurfaceSampleCount() const { return surfaceSampleCount_; }
    float getSurfaceMaxSlopeDegrees() const { return surfaceMaxSlopeDegrees_; }
    float getSurfaceHeightDelta() const { return surfaceHeightDelta_; }
 
    void setFromWorld(PlacementWorld *world, float worldX, float worldY);
    void setFromWorld3D(PlacementWorld *world, float worldX, float worldY, float worldZ);
    void setFromSurface(PlacementWorld *world, const std::string &surface, float x, float y);
    bool validate(PlacementWorld *world);
 
private:
    friend class PlacementSystem;
 
    std::string buildingId_;
    int cellX_ = 0;
    int cellY_ = 0;
    float worldX_ = 0.f;
    float worldY_ = 0.f;
    float elevation_ = 0.f;
    std::string surfaceId_;
    uint64_t surfaceRevision_ = 0;
    float surfaceNormalX_ = 0.f;
    float surfaceNormalY_ = 1.f;
    float surfaceNormalZ_ = 0.f;
    float surfaceTangentX_ = 1.f;
    float surfaceTangentY_ = 0.f;
    float surfaceTangentZ_ = 0.f;
    int surfaceSampleCount_ = 0;
    float surfaceMaxSlopeDegrees_ = 0.f;
    float surfaceHeightDelta_ = 0.f;
    std::string surfaceProviderName_;
    float surfaceInputX_ = 0.f;
    float surfaceInputY_ = 0.f;
    bool surfacePatchStale_ = false;
    bool          surfaceHitMissing_ = false;
    float rotationDeg_ = 0.f;
    std::string placementKind_ = "cell";
    EdgeAddress edge_;
    CornerAddress corner_;
    bool valid_ = false;
    std::string reason_;
};
 
}  // namespace eve::building