bpy.ops.gpencil.stroke_enter_editcurve_mode

将选择的手绘笔画对象转换为编辑曲线模式。

参数

• mode ('DRAW', 'EDIT', 'SCULPT', 'WEIGHT_PAINT', 'VERTEX_PAINT', 'TEXTURE_PAINT', 'PARTICLE_EDIT', 'POSE'): 要切换到的模式，默认为'EDIT'。

• align ('VIEW', 'CURSOR', 'WORLD', 'NORMAL', 'GIMBAL', 'GRID'): 对齐控制点的方式， 默认为'VIEW'。

• location (float array of 3 items in [-inf, inf]): 控制点位置。默认为(0.0, 0.0, 0.0)。

• rotation (float array of 3 items in [-inf, inf]): 控制点旋转值。默认为(0.0, 0.0, 0.0)。

• scale (float in [-inf, inf]): 缩放因子。默认为1.0。

返回值

• {'FINISHED'}：成功进入编辑曲线模式。

示例

import bpy

# 获取当前场景对象中所有的手绘笔画
gpencil_objects = [obj for obj in bpy.context.scene.objects if obj.type == 'GPENCIL']

# 选择第一个手绘笔画对象，并将其转换为编辑曲线模式
if gpencil_objects:
    gpencil_obj = gpencil_objects[0]
    bpy.ops.object.select_all(action='DESELECT')
    gpencil_obj.select_set(state=True)
    bpy.context.view_layer.objects.active = gpencil_obj
    bpy.ops.gpencil.stroke_enter_editcurve_mode()

异常

• {'CANCELLED'}：如果操作被取消。

• {'INVALID_INPUT'}：如果参数无效。

注意事项

• 如果选择的手绘笔画对象没有笔画，则此操作提供所有参数的默认值，并保留当前模式。

• 进入编辑曲线模式后，可以使用bpy.ops.gpencil.curve_simplify()来简化曲线，并使用bpy.ops.gpencil.stroke_leave_editcurve_mode()退出编辑曲线模式。