bpy.ops.anim.keying_set_path_remove

描述

使用指定的路径从当前场景或指定的对象中移除关键帧设置。

语法

bpy.ops.anim.keying_set_path_remove(data_path="", remove_type='KEYFRAME')

参数

• data_path (字符串，可选): 要移除的数据路径。默认值为空字符串。
• remove_type (字符串，可选): 要移除的关键帧类型。默认为 KEYFRAME。

返回值

• {'FINISHED'}：操作已成功完成。

示例

import bpy

# 从当前场景中移除位置关键帧
bpy.ops.anim.keying_set_path_remove(data_path="location")

备注

• 如果 data_path 参数为空字符串，则将从当前激活的对象中移除关键帧设置。
• 支持所有与动画相关的数据路径，如 location，rotation_euler，scale，pose.bones["boneName"].location，material_slots[#].material_diffuse_color。
• remove_type 类型可以是 KEYFRAME 或 BREAKDOWN。
• 要从动画中删除所有关键帧，请使用 bpy.ops.anim.keyframe_clear()。

异常

• RuntimeError：如果未选择任何对象或指定对象不存在，则会引发。
• ValueError：如果 remove_type 参数无效，则会引发。