bpy.ops.asset.catalog_new

描述

用于在资产浏览器中创建新的目录。

语法

bpy.ops.asset.catalog_new(name="", id_name="")

参数

• name (string, optional) - 新建目录的名称。如果未指定，则默认为“未命名目录”。

• id_name (string, optional) - 新目录的标识符名称。如果未指定，则默认为创建一个唯一的名称。

返回值

• {'FINISHED'} - 操作完成时返回。

示例

import bpy

# 创建一个名为 "my_catalog" 的新目录
bpy.ops.asset.catalog_new(name="my_catalog", id_name="my_unique_id")

# 创建一个未命名的新目录
bpy.ops.asset.catalog_new()

注意

• 如果未指定 id_name 参数，则为新目录创建一个唯一的标识符名称。

• 如果尝试使用和现有目录相同的名称创建新目录，则会向用户显示警告消息。

• 操作仅在资产浏览器中可用。

异常

• TypeError - 如果未指定的参数具有不正确的类型，则会引发此异常。

• ValueError - 如果 name 参数与现有目录的名称相同，则会引发此异常。

参考

• 开发文档 - bpy.ops.asset.catalog_new

• 官方文档 - 资产浏览器