0 Fork 0

Files

T

西风逍遥游 18205aabb9 docs: add 10 module chapters, voxel example, gallery links; fill script binding gaps

- New user docs: avatar, buildingfx, camera, database, dialogue, grid,
  housegen, sceneloader, stylize, virtualgeometry (all written against the
  actual addFunc surfaces; API quick-refs included). Wire them into MODULES.md.
- examples/voxel: streaming terrain + place/break demo (procedural atlas,
  setTerrain + streamAround, DDA raycast picking, orbit camera). Script logic
  verified locally (no script errors; 16 chunks / 3117 rects selected).
- README gallery links in both Readme.md and Readme.en.md.
- Script binding fixes discovered while writing the docs/examples:
  * Graphics.setCanvas accepts null (and Canvas instances) so canvas sessions
    can be ended from scripts; begin3DFrame/setMesh3DViewProj/setMesh3DView/
    setMesh3DCameraPos now exposed for script-driven 3D (voxel etc.).
  * SceneLoader.load/host exposed (previously only reload/status were bound).

2026-08-22 08:27:43 +08:00

1.4 KiB

Raw Permalink Blame History

统一网格（Grid）

脚本入口： 无（纯 C++ 库，被 map / building 等模块消费）

grid 是引擎共用的网格拓扑与投影层：定义格子尺寸/间距/原点/拓扑（orthogonal / isometric / staggered / hexagonal）以及"格子 ↔ 世界坐标"的换算，供 tilemap、建筑放置、寻路等模块复用，避免各模块各写一套坐标换算。

C++ API 快查

`GridConfig`（GridConfig.h）

cellW / cellH：格子宽高；cellGapX / cellGapY：格子间距。
originX / originY：原点偏移。
topology："orthogonal" / "isometric" / "staggered" / "hexagonal"。
axes：2D 平面（"xy" / "xz"）——3D 建筑放置用 xz，Y 为高度。

`GridProjection`（GridProjection.h）

cellToWorld(cfg, cx, cy, px, py)：格子 → 世界坐标。
cellToDepthY(cfg, cx, cy)：等距/交错地图的绘制深度（Y 排序）。
worldToCell(cfg, px, py, cx, cy, ...)：世界坐标 → 格子（含容差）。

生命周期

GridConfig 是值类型，随 map.TileLayer / building.PlacementWorld 持有；不建模块实例、不注册到 eve 表。
脚本侧通过 map（TileLayer）和 building（PlacementWorld.setGridPlane）间接使用本层；直接做网格运算的 C++ 模块按需 #include "grid/GridProjection.h"。

1.4 KiB Raw Permalink Blame History Unescape Escape