bpy.ops.gpencil.layer_active

描述

激活给定的动画图层。

语法

bpy.ops.gpencil.layer_active(layer="", frame=None)

参数

• layer（字符串）：图层的名称。
• frame（整数）：要激活的帧数。

返回值

• {'FINISHED'}：操作完成。

示例

下面的示例演示了如何使用 bpy.ops.gpencil.layer_active 操作来激活给定的动画图层。

import bpy

# 获取数据
dg = bpy.context.evaluated_depsgraph_get()
obj = bpy.context.object
gp = obj.evaluated_get(dg).grease_pencil

# 激活图层
bpy.ops.gpencil.layer_active(layer=gp.layers[0].info, frame=1)

print("Active layer:", gp.layers.active.info)
print("Active frame:", gp.layers.active.active_frame.frame_number)

异常

• RuntimeError：如果没有可用图层或帧，则引发该异常。

参考

• bpy.ops.gpencil.layer_add()：添加新的动画图层。
• bpy.ops.gpencil.layer_remove()：从Active Grease Pencil Object中删除动画图层。