bpy.ops.gpencil.interpolate_sequence

描述

通过插值把选定的手绘动画序列转换为指定长度的新序列。新序列将整齐地分割为给定的帧数、帧范围和步长。

语法

bpy.ops.gpencil.interpolate_sequence(frame_step=1, use_cyclic=False, total_frames=0, time_range=(0, 0))

参数

• frame_step (int) -- 帧步长，即相邻两帧的帧数差。默认值为1。
• use_cyclic (bool) -- 是否使用循环重复播放（即以第一帧作为最后一帧的前导帧）。默认为false。
• total_frames (int) -- 生成的序列的总帧数。默认为0，表示使用原始序列的总帧数。
• time_range (tuple) -- 生成的序列的时间范围。由长度为2的元组表示，包含起始帧编号和结束帧编号。默认为(0, 0)，表示使用原始序列的时间范围。

返回值

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

示例

import bpy

# 选中第一个笔划物体
g_pencil = bpy.context.selected_objects[0].data

# 插值它的手绘动画序列，生成长度为100的新序列，间隔1帧
bpy.ops.gpencil.interpolate_sequence(
    frame_step=1, 
    total_frames=100, 
    time_range=(0, g_pencil.frames[-1].frame_number)
)

异常

• RuntimeError -- 手绘动画序列为空时抛出异常。