该操作用于在特定时间范围内对动作进行采样。
bpy.ops.actions.sample(
start_frame=0,
end_frame=0,
step=1,
filter_blending='NONE',
filter_glob="*"
)
start_frame
:开始采样的帧数,默认是0。end_frame
:结束采样的帧数,默认是0。step
:采样间隔,默认是1。filter_blending
:指定用于混合关键帧的方法,默认是'NONE',表示不混合。filter_glob
:指定一个glob模式用于匹配要采样的动作。默认是"*",表示匹配所有动作。该操作没有返回值。
# 采样整个动作
bpy.ops.actions.sample(start_frame=0, end_frame=250, step=1)
# 每隔10帧采样一次动作
bpy.ops.actions.sample(start_frame=0, end_frame=250, step=10)
# 指定匹配一个名字含有"move"的动作进行采样
bpy.ops.actions.sample(filter_glob="*move*")
如果start_frame
大于end_frame
,则会抛出异常。
如果未指定要采样的动作,则会抛出异常。
该操作必须在“动作编辑器”(Action Editor)中使用。
采样的结果将被保存到“动作编辑器”的当前动作,因此,请确保当前动作被保存以保存采样的结果。
在采样之前,建议在动作编辑器中对关键帧进行调整,以免在采样过程中出现意外错误。