跳到主要内容

第 18 章：编译器规范

合规 Writer 必须验证立方 gridSize=1..255、非空体素、PAL0、每 Chunk u16 非空计数以及 x-fastest 线性缓冲。标准流程为：

  1. 规范化源体素与 PAL0；
  2. 计算 sourceHash，并写入 Header/META；
  3. 为每 Chunk 写 VOX0：RAW8 或当 RLE 字节更短时 RLE8；
  4. 生成全局 GREEDY_FACE_V1，裁切为每 Chunk MSH0，再写 CHIX；
  5. 按需写 MATL、Rig、XEXT、SCNE 和 VBUF/PMSH/RND0/ANM0/PRVW/THMB；
  6. 写 DIR0、CRC 与 Footer。

当前 VoxelKit generation 0 的推荐物理顺序是 Header, META, PAL0, [MATL], [SKEL,VSKN,ANIM], [XEXT...], SCNE, [VBUF,PMSH], [RND0], [ANM0], VOX0/MSH0 pairs, CHIX, [PRVW], [THMB], DIR0, Footer。Reader 仍必须只依赖 DIR0。