bpy.ops.gpencil.stroke_sample函数

创建新的样条路径点，并在当前笔划上添加它们。

参数

• mode (枚举): 确定新样条路径点的位置是在笔划的开始或结束。

  • 'START': 在笔划起始位置添加新的样条路径点。
  • 'END': 在笔划结束位置添加新的样条路径点。

• type (枚举): 配置新样条路径点的类型。

  • 'POINT': 普通点类型的新样条路径点。“Freehand”笔划使用此选项。
  • 'THINNING': 过渡型新样条路径点。 指定它时，使用笔压变化创建新样条路径点。
  • 'TEXTURE': 图形型新样条路径点。“Line”笔划使用此选项。 可以使用材质和纹理。
  • 'ERN': 熒光型新样条路径点。
  • 'EXTREMA': 关键型新样条路径点。表明笔划的极值。
  • 'MIDDLE': 拐角型新样条路径点。

• wait_for_input (布尔): 设置等待输入选项。

  • 如果wait_for_input = True，则等待用户输入样本。
  • 如果wait_for_input = False，则直接从鼠标光标位置获取新样条路径点。

• disable_view_update (布尔): 设置禁用试图更新选项。

  • 如果 disable_view_update = True，禁止3D视图更新，直到操作完成。
  • 如果 disable_view_update = False，允许3D视图在操作执行时更新。

返回值

• {'FINISHED'}: 表示函数已成功执行。
• {'CANCELLED'}: 表示函数已被用户取消或出现错误。

示例

# 在笔划起始位置添加一个普通点类型的新样条路径点
bpy.ops.gpencil.stroke_sample(mode='START', type='POINT', wait_for_input=False, disable_view_update=False)

# 在笔划结束位置添加一个过渡型新样条路径点，等待用户输入新样本
bpy.ops.gpencil.stroke_sample(mode='END', type='THINNING', wait_for_input=True, disable_view_update=False)

# 在笔划起始位置添加一个关键型新样条路径点，禁用试图更新
bpy.ops.gpencil.stroke_sample(mode='START', type='EXTREMA', wait_for_input=False, disable_view_update=True)

异常

异常情况下，会引发以下异常：

• 运行时错误: 如果操作无法执行，则会引发运行时错误。