bpy.ops.ed.lib_id_fake_user_toggle

简介

添加或删除指定数据的虚拟用户标记。

参数

• idtype : [str] 数据类型。仅支持以下类型之一：MATERIAL、MESH、CAMERA、LAMP、VERTEX_PAINT、TEXTURE、CURVE、FONT、HDR、SPEAKER、ARMATURE、LATTICE、CAMERA_STEREO、GPENCIL_COLOR、GPENCIL_MATERIAL、GPENCIL_TEXTURE。
• id : [bpy.types.ID] 数据对象。
• force : [bool] 如果为 True，则始终为对象添加虚拟用户。

返回值

• {'FINISHED'}

抛出异常

• RuntimeError 如果数据类型无效。

示例

import bpy

material = bpy.data.materials.get("Material")
if material:
    bpy.ops.ed.lib_id_fake_user_toggle(idtype='MATERIAL', id=material, force=False)

脚本示例

代码示例：script_template.py。

注释

此函数为对象添加或删除虚拟用户标记。虚拟用户标记用于标记不使用的数据，确保删除不需要的数据时不会意外删除。设置虚拟用户是一种将数据链接到.blend文件的方法。数据链接通常出现在与现有对象的关系上。当您需要在其他场景中使用具有相同基础几何体的多个对象时，使用数据链接会节省内存和磁盘空间。

参考

bpy.types.ID