bpy.ops.gpencil.stroke_editcurve_set_handle_type

设置笔画编辑曲线的控制点类型。

• 名称：bpy.ops.gpencil.stroke_editcurve_set_handle_type
• 所属模块：bpy.ops.gpencil
• 返回值：{'FINISHED'}，如果成功设置了控制点类型，否则会抛出异常。
• 操作系统：所有操作系统
• Blender版本：2.83+

描述

该操作用于设置笔画的编辑曲线的控制点类型，包括连续（AUTO）、自由（FREE）和连续自由（ALIGNED）三种类型。

用法

bpy.ops.gpencil.stroke_editcurve_set_handle_type(
    type='AUTO',
    symmetry=True,
    replace=False,
    only_keyframes=False
)

参数

• type (string, optional): 控制点类型。可以为以下值之一：
  • 'AUTO' - 连续，由系统自动决定。
  • 'FREE' - 自由，控制点互相独立，不限制其位置和方向。
  • 'ALIGNED' - 连续自由，控制点互相独立，位置和方向受到控制。
• symmetry (bool, optional): 是否启用对称模式。默认为True。
• replace (bool, optional): 是否替换当前选中的控制点。默认为False。
• only_keyframes (bool, optional): 是否仅影响关键帧。默认为False。

示例

设置笔画的编辑曲线的控制点类型为连续：

bpy.ops.gpencil.stroke_editcurve_set_handle_type(type='AUTO')

设置笔画的编辑曲线的控制点类型为自由：

bpy.ops.gpencil.stroke_editcurve_set_handle_type(type='FREE')

设置笔画的编辑曲线的控制点类型为连续自由：

bpy.ops.gpencil.stroke_editcurve_set_handle_type(type='ALIGNED')

异常

如果操作失败，将会抛出异常。常见的异常包括：

• RuntimeError - 如果操作未成功完成，则会引发此异常。
• ValueError - 如果传递的参数无效，则会引发此异常。

参考

• bpy.ops.gpencil.stroke_editcurve_reset_handles() - 重置笔划编辑曲线的控制点。
• bpy.ops.gpencil.stroke_editcurve_select_all() - 选择笔划的所有控制点。
• bpy.ops.gpencil.stroke_editcurve_select_last() - 选择笔划的最后一个控制点。