Vfp 导出 API

export_json()

asset.export_json(output_path) -> dict[str, object]

从权威 VOX0/PAL0 生成 PixForge JSON。返回 input、output、gridSize、paletteCount、jsonBytes。若 PAL0 符号无法无歧义映射为 JSON colors，抛出 VfpError，避免静默丢失信息。

to_vox()

asset.to_vox(output_path) -> dict[str, object]

导出单模型 MagicaVoxel .vox，返回 gridSize、solidVoxelCount、voxBytes。它只使用权威数据，忽略 PRVW、THMB、SCNE 和缓存。

asset.export_json("asset.json")
asset.to_vox("asset.vox")