bpy.ops.actions.keyframe_insert

描述

将选定的对象属性添加一个关键帧。

用法

bpy.ops.actions.keyframe_insert(type, confirm_success=True, option='DEFAULT')

参数

• type：关键帧插值类型。可以是以下之一：

  • DEFAULT：默认值，自动选择插值类型。
  • REPLACE_SEL：替换当前所选关键帧。
  • INSERT_NEXT：在下一个关键帧之前插入新的关键帧。
  • INSERT_PREV：在前一个关键帧之前插入新的关键帧。
  • ROTATION_MODE：旋转模式。
  • LOCATION：位置关键帧。
  • SCALE：缩放关键帧。
  • INSERTKEY_VISUAL：在可视关键帧编辑器中插入新的关键帧。
  • PROPAGATE：向下复制上一个关键帧。

• confirm_success：如果为 True，表示操作完成后会显示一个确认信息。默认为 True。

• option：选项类型，可以是以下之一：

  • DEFAULT：默认选项。
  • INSERTKEYS_FRAME：将新关键帧插入到当前帧。
  • INSERTKEYS_CONTENT：将新关键帧插入到当前帧以前的关键帧中。

返回值

• 如果操作成功，返回 {'FINISHED'}。
• 如果操作失 ​​败或取消，将返回 {'CANCELLED'}。

示例

# 在当前帧为10的位置添加一个位置关键帧
import bpy

bpy.ops.actions.keyframe_insert(type='LOCATION', option='INSERTKEYS_FRAME')

# 确认成功后打印消息
if {'FINISHED'} == bpy.context.active_operator.poll():     
    print("位置关键帧成功插入。")

已知问题

该操作与向下复制前一帧关键帧时的默认插值方式有关。 一些情况下，插值方式可能需要手动更改。