SceneInspect.hpp

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <glm/glm.hpp>
 
#include <string>
#include <vector>
 
namespace eve {
class IRenderCapture;
class ISceneQuery;
}  // namespace eve
 
namespace eve::dev {
 
struct EVENGINE_API InspectView {
    std::string name;   // "along_road" | "bird_eye" | "corner_close" | "vista"
    std::string kind;   // 中文说明：沿路平视 / 高空俯拍 / 拐角特写 / 远景视角
    glm::vec3   eye{0.f};
    glm::vec3   target{0.f};
    float       fovYDeg = 60.f;
};
 
struct EVENGINE_API InspectCapture {
    bool        ok = false;
    std::string error;
    std::string pngPath;   // 渲染帧 PNG 的磁盘路径（color buffer）
    std::string jsonPath;  // 配套三维几何快照 JSON 的磁盘路径
    int         width  = 0;
    int         height = 0;
    int         entityCount = 0;
    // 可选附加缓冲区（按需生成）。
    std::string depthPngPath;   // depth buffer PNG（GBuffer 线性深度）
    std::string normalPngPath;  // normal buffer PNG（GBuffer 世界法线）
    std::string idPngPath;      // 渲染 ID mask PNG（逐像素实体 ID 颜色）
    std::string idJsonPath;     // 渲染 ID mask 的 id→实体 映射 JSON
    std::vector<std::string> unsupported;  // 请求但当前后端不支持的缓冲区
};
 
class EVENGINE_API SceneInspect {
public:
    static SceneInspect& instance();
 
    SceneInspect(const SceneInspect&)            = delete;
    SceneInspect& operator=(const SceneInspect&) = delete;
 
    // ---------- 多机位自动采样 ----------
    static std::vector<InspectView> generateViews(const glm::vec3& center, float fov = 60.f);
 
    // ---------- 相机位姿 ----------
    bool setCameraPose(const glm::vec3& eye, const glm::vec3& rotYawPitch, float fov = 0.f);
    bool setCameraView(const InspectView& v);
 
    // ---------- 原子快照（渲染帧 + 几何 JSON） ----------
    InspectCapture capture(const std::string& outDir = {}, const std::string& tag = "frame",
                           const std::vector<std::string>& buffers = {});
 
    // ---------- 可见实体三维几何快照 ----------
    std::string visibleEntitiesJson(const glm::vec3* eye = nullptr,
                                    const glm::vec3* target = nullptr, float fov = 0.f);
    std::string currentPoseJson();
 
    // ---------- 快照持久化 / 临时缓存 ----------
    void setCacheDir(std::string dir) { cacheDir_ = std::move(dir); }
    const std::string& cacheDir() const { return cacheDir_; }
    std::string defaultCacheDir() const;
    const std::string& lastPngPath() const { return lastPngPath_; }
    const std::string& lastJsonPath() const { return lastJsonPath_; }
 
private:
    SceneInspect() = default;
 
    eve::IRenderCapture* captureIface();
    eve::ISceneQuery*    scene();
    bool                 ensureCamera();
 
    std::string cacheDir_;
    std::string lastPngPath_;
    std::string lastJsonPath_;
};
 
}  // namespace eve::dev