CubeTypeRegistry.h

浏览该文件的文档.

#pragma once
 
// 方块类型注册表：定义有哪些 cube、各面材质、方向性与组合声明。
// 注册表在创建 world 时传入；网格化阶段用 resolveFaceTex 把“类型 id”解析为
// 各面“纹理 id”输出给渲染器。空注册表下行为退化为“类型 id == 纹理 id”，
// 与旧的体素语义完全一致。
 
#include "voxel/CubeType.h"
#include "voxel/FaceDir.h"
 
#include <cstdint>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::voxel {
 
class CubeTypeRegistry {
public:
    CubeTypeRegistry() = default;
 
    uint8_t add(const CubeType &type);
 
    int loadFromJson(const std::string &json, std::string *error = nullptr);
 
    const CubeType *find(const std::string &name) const;
    const CubeType *find(uint8_t id) const;
 
    uint8_t variantId(const std::string &name, int orientation) const;
 
    int count() const { return int(byName_.size()); }
    int variantCount() const { return int(types_.size()) - 1; }
 
    void clear();
 
    static const CubeTypeRegistry &empty();
 
private:
    std::unordered_map<std::string, uint8_t> byName_;  // name -> 0 度变体 id
    std::vector<CubeType> types_{CubeType{}};          // index 0 = 空气占位
};
 
inline uint8_t resolveFaceTex(const CubeTypeRegistry &types, uint8_t id, FaceDir dir) {
    const CubeType *t = types.find(id);
    if (!t) return id;
    return t->faceTex[int(dir)];
}
 
}  // namespace eve::voxel