跳到主要内容

Vfp 目录读取 API

section_tags()

asset.section_tags() -> tuple[str, ...]

按目录顺序返回唯一四字符 tag,例如 ("META", "PAL0", "VOX0", "THMB")。不读取 payload,适合快速能力探测。

entries(tag)

asset.entries(tag) -> tuple[BlockEntry, ...]

tag 必须是四个 ASCII 字符;不存在返回空元组。多 Chunk 的 VOX0 / MSH0 通常返回多项,全局段通常只返回 chunk_id=-1 一项。非法 tag 抛出 VfpError

read_section(tag, *, chunk_id=-1)

asset.read_section(tag, *, chunk_id=-1) -> bytes

读取恰好一个 tag/chunk 组合并执行 CRC 校验。缺失或重复均抛出 VfpError。读取 THMB 返回完整 PNG;读取压缩 VOX0 返回该区块的存储载荷,完整权威缓冲应改用 voxels()

png = asset.read_section("THMB")
meta = asset.read_section("META")