bpy.context.gpencil

bpy.context.gpencil 是 Blender 中用于访问 Grease Pencil 的上下文对象。Grease Pencil 是 Blender 中用于 2D 动画绘制和注释的工具之一，可以在 3D 视口或单独的 Grease Pencil 视口中使用。

属性和方法

下面是 bpy.context.gpencil 的一些常用属性和方法：

.objects

类型：bpy_prop_collection

包含 Grease Pencil 对象的集合。可以使用下标 ([]) 或 get() 方法获取集合中的对象。

# 获取第一个 Grease Pencil 对象
grease_pencil = bpy.context.gpencil.objects[0]

# 或者使用 get() 方法
grease_pencil = bpy.context.gpencil.objects.get("ObjectName")

.layers

类型：bpy_prop_collection

包含 Grease Pencil 图层的集合。可以使用下标 ([]) 或 get() 方法获取集合中的图层。

# 获取第一个图层
layer = bpy.context.gpencil.layers[0]

# 或者使用 get() 方法
layer = bpy.context.gpencil.layers.get("LayerName")

.active_object

类型：bpy.types.GreasePencil

当前活动的 Grease Pencil 对象。

# 获取当前活动的 Grease Pencil 对象
grease_pencil = bpy.context.gpencil.active_object

.active_layer

类型：bpy.types.GPencilLayer

当前活动的 Grease Pencil 图层。

# 获取当前活动的图层
layer = bpy.context.gpencil.active_layer

.select_mode

类型：str

Grease Pencil 对象的选择模式。可以是 POINT, STROKE, VIEW 中的一种。

# 获取当前选择模式
select_mode = bpy.context.gpencil.select_mode

.edit_mode

类型：bool

当前是否处于编辑模式。

# 获取当前是否处于编辑模式
edit_mode = bpy.context.gpencil.edit_mode

.brush

类型：bpy.types.GPencilBrush

当前使用的 Grease Pencil 刷子。

# 获取当前使用的刷子
brush = bpy.context.gpencil.brush

示例

下面是一些 bpy.context.gpencil 的使用示例：

创建一个新的 Grease Pencil 对象并在其上创建一个新的图层

# 创建一个新的 Grease Pencil 对象
new_gpencil = bpy.data.grease_pencils.new("NewGreasePencilObject")
bpy.context.scene.grease_pencil_objects.link(new_gpencil)

# 在新对象上创建一个新的图层
new_layer = new_gpencil.layers.new("NewLayer")

遍历所有的 Grease Pencil 对象和图层

# 遍历所有的 Grease Pencil 对象和图层
for gpencil in bpy.context.gpencil.objects:
    print("Grease Pencil Object:", gpencil.name)
    for layer in gpencil.layers:
        print("    Layer:", layer.info, layer.name)

参考资料

• Blender Manual: Grease Pencil