跳到主要内容

Vfp.rebuild_caches()

asset.rebuild_caches(output_path, *, include_preview=None,
include_runtime_caches=True, include_render_cache=False,
include_animation_cache=True, include_thumbnail=None,
thumbnail_size=256, thumbnail_background="transparent") -> Vfp

从已验证的 VOX0/PAL0 创建 VFP,并重建派生缓存。不会覆盖源文件,也不会复制旧 MSH0、VBUF、PMSH、RND0、ANM0、PRVW 或 THMB;SCNE 原样保留。

参数默认值说明
output_path必填新 VFP 路径。
include_previewNoneNone 沿用输入 PRVW 是否存在。
include_runtime_cachesTrue重建 VBUF/PMSH。
include_render_cacheFalse重建 RND0。
include_animation_cacheTrue重建 ANM0。
include_thumbnailNoneNone 沿用输入 THMB 是否存在。
thumbnail_size256新 THMB 尺寸。
thumbnail_backgroundtransparent新 THMB 背景。

先重算并比较 Header 和 META source hash;不匹配时抛出 VfpError。成功返回新 Vfp