mode (DRAW、DRAW_POLY、DRAW_FT、ERASE、SLICE)
- 缺省值：DRAW
- 描述：指定绘制模式，可以是线性( DRAW )、多边形( DRAW_POLY )、自由型( DRAW_FT )、擦除( ERASE )或剪切( SLICE )。
snap (ON、OFF)
- 缺省值：OFF
- 描述：指定是否启用吸附工具。
snap_target (VERTEX、EDGE、FACE、VOLUMNE)
- 缺省值：VERTEX
- 描述：指定吸附工具的目标对象。
snap_align (ALIGN、NEAREST)
- 缺省值：ALIGN
- 描述：指定吸附工具对齐到目标对象的方式。
sort_method (DISTANCE、PROP_ITER)
- 缺省值：DISTANCE
- 描述：指定排序方法，可以是距离( DISTANCE )或属性( PROP_ITER )。
radius (float)
- 缺省值：0.25
- 描述：指定笔划的半径。
use_pressure (ON、OFF)
- 缺省值：OFF
- 描述：指定是否使用笔划压力。
use_strength (ON、OFF)
- 缺省值：OFF
- 描述：指定是否使用笔划强度。
pen_flip (ON、OFF)
- 缺省值：OFF
- 描述：指定是否翻转笔划方向。
pen_only (ON、OFF)
- 缺省值：OFF
- 描述：指定是否只绘制笔划而不是曲线。
curve (CURVE)
- 缺省值：None
- 描述：指定要添加笔划的曲线对象。
source (SOURCE)
- 缺省值：None
- 描述：指定要添加笔划的数据源（例如，可以是网格）。

示例

创建新曲线对象

import bpy

bpy.ops.curve.pen()

使用默认参数，该操作会在3D视图编辑器中启用画笔工具，以便您可以开始绘制曲线。绘制完成后，将根据您的笔划创建一个新的曲线对象。

向现有曲线对象添加笔划

import bpy
from bpy.props import StringProperty

# 获取当前选定的对象
obj = bpy.context.object

# 确认选定对象是曲线对象
if obj.type != 'CURVE':
    raise ValueError("The selected object is not a curve object.")

# 定义笔划参数
stroke_props = {
    'mode': 'DRAW',
    'snap': 'ON',
    'snap_target': 'VERTEX',
    'snap_align': 'ALIGN',
}

# 指定曲线对象作为要添加笔划的目标
stroke_props['curve'] = obj.data.name

# 使用笔工具添加笔划
bpy.ops.curve.pen(**stroke_props)

此示例演示了如何使用此操作向现有曲线对象添加笔划。首先，我们获取当前选定的对象，如果它不是曲线对象，则会引发错误。接下来，定义笔划参数，并将曲线对象名称指定为要添加笔划的目标。最后，使用这些参数调用笔划操作即可在当前3D视图编辑器中启用笔工具。

使用数据源添加笔划

import bpy
from bpy.props import StringProperty

# 获取当前选定的对象
obj = bpy.context.object

# 确认选定对象是网格对象
if obj.type != 'MESH':
    raise ValueError("The selected object is not a mesh object.")

# 定义笔划参数
stroke_props = {
    'mode': 'DRAW_FT',
    'snap': 'ON',
    'snap_target': 'VERTEX',
    'snap_align': 'NEAREST',
}

# 指定网格数据源作为要添加笔划的目标
stroke_props['source'] = obj.name

# 使用笔工具添加笔划
bpy.ops.curve.pen(**stroke_props)

此示例演示了如何使用此操作在使用数据源时向现有网格对象添加笔划。首先，我们获取当前选定的对象，如果它不是网格对象，则会引发错误。接下来，定义笔划参数，并将网格对象名称指定为要添加笔划的目标。最后，使用这些参数调用笔划操作即可在当前3D视图编辑器中启用笔工具。