bpy.ops.gpencil.segment_add

添加新的绘图笔记段。

参数

• airbrush: 是否启用喷笔功能（布尔类型，默认为 False）。

• align: 是否将新的笔记段与上一个笔记段对齐（布尔类型，默认为 False）。

• location: 新笔记段的位置（二维向量类型，默认为 (0.0, 0.0)）。

• pressure: 新笔记段的压力值（浮点类型，默认为 1.0）。

• strength: 新笔记段的强度值（浮点类型，默认为 1.0）。

• thickness: 新笔记段的笔画粗细（浮点类型，默认为 1.0）。

• velocity: 新笔记段的速度（浮点类型，默认为 0.0）。

返回值

• 如果成功添加了新的笔记段，则返回 { 'FINISHED' }。

• 如果无法添加新的笔记段，则返回 { 'CANCELLED' }。

示例

import bpy

# 选择当前对象的所有笔画
bpy.ops.object.select_all(action="SELECT")
bpy.ops.gpencil.convert(type="STROKE")

# 获取当前选择的绘画笔记
gpencil = bpy.context.active_object.data

# 添加新的笔记段
result = bpy.ops.gpencil.stroke_add(
    align=True,
    location=(1.0, 1.0),
    pressure=0.5,
    strength=0.8,
    thickness=2.0,
    velocity=0.0,
    airbrush=False
)

# 检查结果
if result == {'FINISHED'}:
    print("添加新的笔记段成功！")
else:
    print("添加新的笔记段失败！")