bpy.ops.anim.channels_rename

该操作允许用户重命名动画通道名称。

参数

• name (string): 要被重命名的通道名称
• new_name (string): 新的通道名称

返回值

• {'FINISHED'}，操作成功完成。

示例

import bpy

# 选择要重命名的动画通道
channel = bpy.context.object.animation_data.action.groups[0]

# 重命名通道名称
bpy.ops.anim.channels_rename(name=channel.name, new_name="NewName")

异常

• RuntimeError - 如果没有指定动画数据或指定的名称无效时。

注意事项

• name 参数必须指定为有效的通道名称，否则会引发 RuntimeError。
• new_name 参数不能与另一个通道的名称相同，否则操作将失败。