bpy.ops.anim.stash

描述

bpy.ops.anim.stash根据选定的对象和属性将动画数据存储在堆栈中。

语法

bpy.ops.anim.stash(stash_mode='ADD', frame_start=0, frame_end=0, step=1, include_pose=False, include_scale=False, include_visual_keying=False, include_all_actions=False, include_property=False)

参数

• stash_mode - 存储模式。默认值为 'ADD'。可选值包括：'ADD'，'REPLACE'和'OVERWRITE'。
• frame_start - 存储动画数据的开始帧。如果为0则使用当前帧。默认值为0。
• frame_end - 存储动画数据的结束帧。如果为0则使用当前帧。默认值为0。
• step - 间隔帧数。默认值为1。
• include_pose - 是否包括骨架动画数据。默认值为False。
• include_scale - 是否包括缩放动画数据。默认值为False。
• include_visual_keying - 是否包括可见性关键点动画数据（如果存在）。默认值为False。
• include_all_actions - 是否在存储模式为'ADD'时包括所有动作。默认值为False。
• include_property - 是否包括对象的自定义属性。默认值为False。

返回值

返回值为 {'FINISHED'} 或者 {'CANCELLED'}，表示操作是否成功执行。

示例

# 存储选定对象的所有动作数据
bpy.ops.anim.stash(include_all_actions=True)

# 存储选定对象的位置数据
bpy.ops.anim.stash(include_pose=True)

# 存储选定对象的缩放和可见性关键点数据
bpy.ops.anim.stash(include_scale=True, include_visual_keying=True)

# 替换选定对象的动画数据（替换之前请确保堆栈中有需要替换的数据）
bpy.ops.anim.stash(stash_mode='REPLACE')

# 覆盖当前帧的动画数据
bpy.ops.anim.stash(stash_mode='OVERWRITE', frame_start=bpy.context.scene.frame_current, frame_end=bpy.context.scene.frame_current)

异常

无

注解

该操作可用于将动画数据存储在堆栈中，以便稍后恢复到以前的状态。存储的数据包括骨骼动画，缩放动画，可见性关键点和自定义属性。存储模式可以是 'ADD'，'REPLACE'或'OVERWRITE'。'ADD'模式将动画数据附加到堆栈的末尾，'REPLACE'模式将用新的动画数据替换堆栈中指定的索引处的数据，'OVERWRITE'模式将覆盖指定帧上的所有动画数据。