该操作用于删除动画键集按钮。
data_path
(string,可选) - 键集按钮所属数据路径。button_index
(int,可选) - 要删除的按钮索引。如果未指定 data_path
和 button_index
,则将删除选中对象的键集按钮。
{'FINISHED'}
- 操作成功执行。以下示例将删除指定对象上的键集按钮:
import bpy
# 获取选中对象的数据路径
data_path = bpy.context.object.data.shape_keys.path_from_id(bpy.context.object.active_shape_key_index)
# 要删除的按钮索引
button_index = 2
# 删除按钮
bpy.ops.anim.keyingset_button_remove(data_path=data_path, button_index=button_index)
以下示例将删除选中对象上当前选定的键集按钮:
import bpy
# 删除选定按钮
bpy.ops.anim.keyingset_button_remove()
RuntimeError
- 如果删除失败,将引发运行时错误。ValueError
- 如果无法识别指定的 data_path
,将引发 ValueError。