bpy.ops.gpencil.layer_add

添加新的 Grease Pencil 图层。

描述

通过 bpy.ops.gpencil.layer_add 可以在当前 Grease Pencil 对象中添加新的图层。

参数

该操作没有参数。

返回值

返回一个包含新图层名称的 {'FINISHED'} 字典。

示例代码

在脚本中使用

import bpy

# 获取当前场景的 Grease Pencil 数据
gpb = bpy.context.scene.grease_pencil

# 添加一个新图层
bpy.ops.gpencil.layer_add()

# 获取新图层
new_layer = gpb.layers[-1]

# 重命名新图层
new_layer.name = "My New Layer"

在控制台中使用

>>> bpy.ops.gpencil.layer_add()
{'FINISHED'}