bpy.ops.anim.keyframe_insert_by_name

该操作插入给定名称的动画关键帧。

参数

• data_path (字符串) - 数据路径，指定属性路径，例如“location”，“scale”等。必须是字符类型（即带引号），例如“location”。
• index (整数) - 索引，对于某些属性（例如顶点组），需要指定要设置 keyframe 的组的索引。
• frame (浮点数) - 帧数，指定将在哪个帧上插入关键帧。
• group (字符串) - 组名，用于将关键帧分配到的组。默认为“”。若指定，则必须是有效的组名称。

返回值

类型：{"FINISHED"}

操作完成后返回该字典。

示例

# 插入“location”属性的关键帧
bpy.ops.anim.keyframe_insert_by_name(
    data_path="location", frame=1.0)

# 插入第二个顶点组的关键帧
bpy.ops.anim.keyframe_insert_by_name(
    data_path="vertex_groups", index=1, frame=1.0)

# 将关键帧分配到组“groupA”
bpy.ops.anim.keyframe_insert_by_name(
    data_path="location", frame=1.0, group="groupA")

异常

• ValueError - 如果指定的 data_path 无效或不是字符串类型，则引发此异常。
• TypeError - 如果 data_path 无效或不是适当的属性路径（即包含点分隔符字符“.”），则引发此异常。