Expand description
.dgc(Deep Geometry Clusters)流式二进制格式:分块 + 父子索引 + 边界锁定。
完整字节级规格见 docs/dgc-format-spec.md;本模块是唯一权威读写实现。
设计目标:
- 全小端、段 payload 8 字节对齐,可直接映射到 typed array 视图;
- 每段独立 CRC32C 校验,文件尺寸自锁定(total_file_size);
- 保留字段必须为 0(读取即校验),为后续版本演进留护栏;
- 段 payload 可选 zlib(RFC 1950)压缩,压缩比记录在段头。
Structs§
- DgcWrite
Options - 序列化选项。
Constants§
- FILE_
HEADER_ SIZE - 文件头尺寸(字节)。
- FLAG_
ZLIB - flags bit0:段 payload 为 zlib 压缩。
- FORMAT_
VERSION - 当前格式版本。
- MAGIC
- 魔数
DGC1。 - NO_
PARENT - 无父簇哨兵(细簇在粗层无覆盖;对应 golden fixture 的 -1)。
- PAYLOAD_
ALIGNMENT - 段 payload 对齐(字节)。
- SECTION_
HEADER_ SIZE - 段头尺寸(字节)。
- SECTION_
KIND_ LEVEL - 段类型:level 几何块。
- SECTION_
KIND_ PARENTS - 段类型:parents 块(kind=1 时
level字段为细层号 k,连接 k 与 k+1)。