bpy.ops.clip.add_marker

概述

bpy.ops.clip.add_marker()函数用于在视频剪辑中添加标记。

参数

• frame (int) - 标记所在的帧数。
• name (string, 可选) - 标记的名称，如果没有指定则会自动生成一个名称。
• color (float array of 4 items, 可选) - 标记的颜色，默认为 [1.0, 1.0, 1.0, 1.0]。

返回值

{'FINISHED'} 表示函数执行成功。

示例

import bpy

# 在当前视频剪辑中添加一个标记
bpy.ops.clip.add_marker(frame=50, name="my_marker", color=[1.0, 0.0, 0.0, 1.0])

异常

可能会抛出 RuntimeError 异常，例如：

• 当前没有视频剪辑打开时。
• 无法在当前标记所在的帧上添加新的标记。

注意事项

• 如果没有指定标记名称，则函数会自动生成一个名称，如 Marker.001，Marker.002等。
• frame 参数只能是整数类型，表示标记所在的帧数。
• color 参数必须是一个长度为 4 的数组，分别表示 RGBA 颜色值，数值范围为 0.0 到 1.0。默认颜色为白色。