bpy.ops.gpencil.sculpt_paint

功能

利用笔刷对Grease Pencil中的笔画进行雕刻和绘制。

用法

bpy.ops.gpencil.sculpt_paint(mode='DRAW', stroke=None, uv_layer_index=0)

参数

• mode (str): 绘画模式。默认值为 DRAW，可选值包括：
  • DRAW: 绘画模式，将绘制新的笔画或修改笔画形状。
  • SCULPT: 雕刻模式，将会改变笔画的形状和厚度，与笔画距离较远的点不会被影响。
• stroke (GPencilStroke, optional): 要编辑的笔画。如果未指定，则将编辑当前激活的笔画。
• uv_layer_index (int): 笔画使用的uv层的索引。默认为0。

返回值

• {'FINISHED'}：成功执行。

异常

• RuntimeError: 没有选择笔画时抛出。

示例

通过以下示例可对笔画进行绘制和雕刻：

import bpy

# 选择要编辑的笔画
gp_layer = bpy.context.scene.grease_pencil.layers['GP_Layer']
gp_frame = gp_layer.frames[0]
stroke = gp_frame.strokes[0]

# 绘制新笔画
bpy.ops.gpencil.sculpt_paint('INVOKE_DEFAULT',
                             stroke=None,
                             uv_layer_index=0,
                             mode='DRAW')
# 雕刻已有笔画
bpy.ops.gpencil.sculpt_paint('INVOKE_DEFAULT',
                             stroke=stroke,
                             uv_layer_index=0,
                             mode='SCULPT')