跳到主要内容

第 15 章:PRVW 区段

Directory Tag: PRVW · 作用范围: 全局 · 必须性: 可选 · 允许 Codec: RAW8

PRVW(Preview)提供通用 3D 兼容预览,不参与 VFP 的权威资产解释。它允许不支持体素渲染的环境显示一个近似或替代视图,但不得用于编辑、校验或反推 VOX0。若目标只是文件列表或资产卡片缩略图,应优先使用独立的 THMB 区段,避免启动 GLB / glTF 管线。

15.1 目录与 Payload​

PRVW 必须是全局 RAW8 区段:tag=PRVW、chunkId=-1、codec=0、flags=0。其 payload 就是完整、自包含的 GLB 2.0 文件字节,没有 VFP 私有预览头、MIME 字段、尺寸字段或内嵌 source hash。

GLB 载荷的前四个字节必须是 little-endian 0x46546C67(ASCII glTF)。目录的 length/rawLength/crc32 负责定位和完整性;Header featureFlags bit 0 只是提示,读取器必须以实际 DIR0 为准。

15.2 使用与安全​

读取器可在尚未加载 VOX0 时显示 PRVW,以改善列表和网络环境体验;一旦需编辑或确认内容,必须加载权威区段。PRVW 不携带单独的 source hash,因此它不能证明自己与当前 VOX0 同步。Writer 在权威体素、调色板或会影响外观的材质变化后必须重建或删除 PRVW。

实现对 GLB 解码时应实施大小、递归资源和外部 URI 限制。PRVW 不得包含对外部网络资源的强制依赖;GLB 预览应是自包含二进制。

15.3 验证与降级​

验证器检查唯一全局目录属性、范围、CRC 与 GLB magic;可选实现还应按自身 GLB 安全策略解析版本、JSON/BIN Chunk、资源大小和外部 URI。预览错误不影响资产有效性。读取器可以忽略缺失、损坏或不支持的 PRVW。


本章总结​

PRVW 用于“快速看见”,不能用于“确认真实内容”。真实资产始终由 VOX0 及其权威辅助区段定义。THMB 则为此提供更轻量的 PNG 读取路径。