bpy.ops.file.pack_libraries

描述

将外部文件库打包到 .blend 文件中。

参数

• directory_path (string, (可选)) – 包含库的目录。
• file_paths (string[], (可选)) – 要包含的文件的文件路径列表。
• check_existing (boolean, (可选)) – 如果文件已经存在是否询问覆盖。

返回

• {'FINISHED'} – 如果操作成功完成。

示例

import bpy

bpy.ops.file.pack_libraries(directory_path="/path/to/external/libraries", file_paths=["file1.blend", "file2.blend"], check_existing=True)

注意事项

• 对于未打包的来自外部目录的库，将显示一个警告。
• 如果文件路径是相对于当前文件的，可以在文件路径中使用 Blender 的特殊符号： "//"（即两个连续反斜杠），以表示当前文件所在目录。
• 如果库中的材质、纹理等链接到文件库中的图像文件，则必须在将库打包到 .blend 文件中之前将链接的文件手动移到包含库的目录中。

参考

• https://docs.blender.org/api/current/bpy.ops.file.html#bpy.ops.file.pack_libraries