bpy.ops.file.unpack_libraries

描述

bpy.ops.file.unpack_libraries 用于将选择的 .blend 文件或目录中包含的所有库文件解压到指定目录中。

语法

bpy.ops.file.unpack_libraries(
    filepath='',
    directory='',
    relative_paths=True,
    unpack_depth=0,
    unpack_method='USE_LOCAL',
    id=''
)

参数

• filepath (字符串) - 要解包的 .blend 文件的文件路径。
• directory (字符串) - 库文件的目标目录。
• relative_paths (布尔值) - 是否使用相对路径。默认值为 True。
• unpack_depth (整数) - 应在解包文件之前解包的目录层数。默认值为 0。
• unpack_method (字符串) - 应该如何解包库文件。可以是 ‘USE_LOCAL’，‘USE_ORIGINAL’ 或 ‘COPY’。默认值为 ‘USE_LOCAL’。
• id (字符串) - 文件的标识符。

示例

import bpy

# 获取当前选择的文件或目录
selected_items = bpy.context.selected_files

# 设定目标解包路径
target_path = "/user/desktop/unpacked_libraries"

# 遍历所有选择的文件和目录并解包其包含的库文件
for item in selected_items:
    bpy.ops.file.unpack_libraries(filepath=item.filepath, directory=target_path)

异常

• RuntimeError - 如果无法解包库文件。