bpy.ops.gpencil.annotate

描述

在当前的画布上创建绘图注释。

用法

bpy.ops.gpencil.annotate(
    stroke=None,
    wait_for_input=True,
    disable_straight=True,
    use_event_paint=False
)

参数

• stroke: bpy.types.GreasePencilStroke，创建的笔画。如果未设置，则将在当前图层上创建新笔画。
• wait_for_input: bool，如果为True，则等待用户输入完成后再结束注释绘制。否则，通过按下ESC键或选择其他工具来停止注释绘制。
• disable_straight：bool，如果为True，则禁用笔划拉直功能（默认情况下启用Alt键）。
• use_event_paint: bool，如果为 True，鼠标事件将触发绘画动作（当在3D视图中绘制注释时）。

返回值

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

示例

# 获取当前的Grease Pencil对象和当前激活的笔画
gpencil = bpy.context.scene.grease_pencil
layer = gpencil.layers.active
stroke = layer.active_frame.strokes.active

# 在当前笔画上创建一个注释
bpy.ops.gpencil.annotate(stroke=stroke)

# 在当前图层上创建一个注释
bpy.ops.gpencil.annotate()