从旧包迁移
安装 voxelkit 0.7.2 后统一使用 from voxelkit import ...。迁移时应同时删除对历史 Reader/Compiler 文档中未公开 API 的调用。
| 不应继续使用 | 0.7.2 替代方式 |
|---|---|
Vfp.from_vox()、compile_vox_to_vfp() | 当前没有公开 VOX → VFP API |
inspect() | manifest()、section_tags()、entries() |
extract_thumbnail() | thumbnail() 返回 PNG bytes |
extract_glb() | read_section("PRVW") |
export_json() / to_vox() | 读取 voxels() + palette(),或使用专用转换器 |
rebuild_caches() | 从原始 JSON 调用 compile_vfp() |
现有 VFP 无需重编才可读取;但只有 VFP 1.3 是当前 Python SDK 的容器契约。GLTI 新流程使用 GltiExporter.export() 和 GltiPackageReader.extract_to_vfp();展示专用 GLTI 没有可恢复 VFP。