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")