跳到主要内容

Vfp 权威与可选数据

asset.manifest() -> dict[str, object]
asset.palette() -> tuple[PaletteEntry, ...]
asset.voxels() -> bytes
asset.validate() -> dict[str, object]
asset.materials() -> tuple[MaterialEntry, ...]
asset.rig() -> dict[str, object] | None
asset.extensions(extension_id: str | None = None) -> tuple[ExtensionEntry, ...]
asset.thumbnail() -> tuple[str, int, int, bytes] | None

manifest() 读 JSON META;palette() 读 PAL0;voxels() 从 VOX0 恢复完整 x-fastest 缓冲;validate() 才建立权威可信边界。materials、rig、extensions、thumbnail 都是可选数据,其中只有 MATL/Rig/XEXT 的绑定关系会参与相应格式验证,THMB 始终不是资产源。

asset.validate()
grid_size = asset.manifest()["objects"][0]["gridSize"][0]
value = asset.voxels()[(2 * grid_size + 1) * grid_size + 0]