数据结构与错误

BlockEntry

由 asset.entries() 返回的不可变目录项：section（4 字节 tag）、chunk_id（全局为 -1）、codec（0 RAW8 / 1 RLE8）、flags、offset、stored_length、raw_length、crc32。它只描述定位信息；读取载荷请使用 read_section()。

PaletteEntry

由 asset.palette() 返回，具有 index、symbol、red、green、blue。index 是 VOX0 中的非零字节值，RGB 范围为 0..255。

VfpError

继承 ValueError，表示 VFP/JSON/VOX 格式错误、区段缺失、CRC/hash 不一致或不支持的 Profile。文件系统问题则可能抛出 OSError。

from voxelkit import VfpError
try:
    asset.validate()
except VfpError as error:
    print(error)