西风逍遥游
7820703cfa
对照 Unity Grid/Tilemap 与 Grid Placement System 架构补齐建筑放置能力： - 新增 grid 模块：GridConfig（rectangle/hexagon/isometric/staggered/iso-z-as-y、cellGap、stagger、XY/XZ 平面轴）+ 投影/占地旋转纯函数；map::TileProjection 委托复用，公开 API 不变。 - PlacementWorld 支持可选 GridConfig、多通道占用（channel）、bindTileLayer + GID 地形懒解析、XZ 平面 3D 放置、surface 表面接口（内置 plane）。 - BuildingDefinition 新增 channel/renderMode/visual2d/visual3d；rotationMode 支持 hex（60°）。 - 新增 buildingfx 渲染桥：按定义生成/同步 Renderable2D/3D、鬼影+占地光标、2D/3D 网格可视化。 - 新增 PlacementSession（放置/拆除/旋转/指针更新）。 - 测试：grid/building/buildingfx 新用例（REQUIRE 级）+ map/sceneloader 回归；示例 building-tilemap（等距/六角）、building-3d（XZ 地面）。 - 顺带修复 HEAD 上 sceneloader 未迁移 SceneLink 新 API 导致的编译失败（SceneLoader.cpp / test/sceneloader.cpp）。
47 lines
1.6 KiB
C++
47 lines
1.6 KiB
C++
#pragma once
|
|
|
|
// 统一网格抽象：与具体模块（building / map）解耦的纯数据结构。
|
|
// 布局/拓扑 + 单元尺寸/间距 + 原点 + stagger 参数 + 平面轴。
|
|
// 坐标换算全部是纯函数（GridProjection.h），本头文件零依赖。
|
|
|
|
#include <string>
|
|
|
|
namespace eve::grid {
|
|
|
|
enum class GridLayout { Rectangle, Hexagon, Isometric, Staggered, IsometricZAsY };
|
|
enum class StaggerAxis { X, Y };
|
|
enum class StaggerIndex { Odd, Even };
|
|
|
|
/**
|
|
* 放置平面轴：
|
|
* XY —— 网格第二轴映射到世界 Y（2D tilemap / 俯视 2D 场景，默认）。
|
|
* XZ —— 网格第二轴映射到世界 Z，世界 Y 为垂直高度（3D 场景地面网格）。
|
|
*/
|
|
enum class GridPlane { XY, XZ };
|
|
|
|
/** 网格配置：形状拓扑 + 尺寸 + 原点 + 平面轴。 */
|
|
struct GridConfig {
|
|
GridLayout layout = GridLayout::Rectangle;
|
|
GridPlane plane = GridPlane::XY;
|
|
float cellW = 32.f;
|
|
float cellH = 32.f;
|
|
float cellGapX = 0.f;
|
|
float cellGapY = 0.f;
|
|
float originX = 0.f;
|
|
float originY = 0.f;
|
|
StaggerAxis staggerAxis = StaggerAxis::Y;
|
|
StaggerIndex staggerIndex = StaggerIndex::Odd;
|
|
float hexSideLength = 0.f;
|
|
|
|
static const char *layoutName(GridLayout l);
|
|
static GridLayout layoutFromName(const std::string &name);
|
|
static const char *planeName(GridPlane p);
|
|
static GridPlane planeFromName(const std::string &name);
|
|
};
|
|
|
|
/** 单元有效间距（含 gap）。 */
|
|
inline float cellPitchX(const GridConfig &cfg) { return cfg.cellW + cfg.cellGapX; }
|
|
inline float cellPitchY(const GridConfig &cfg) { return cfg.cellH + cfg.cellGapY; }
|
|
|
|
} // namespace eve::grid
|