bpy.ops.gpencil.segment_move

移动笔画线段的操作。

描述

bpy.ops.gpencil.segment_move 允许用户移动指定的笔画线段。可以通过传递鼠标事件和笔画的唯一标识符来选择需要移动的线段。该操作还支持相对于当前视图平移和旋转笔画。如果需要更复杂的变换，则可以使用 bpy.ops.gpencil.transform 。

语法

bpy.ops.gpencil.segment_move(
    x=0,
    y=0,
    z=0,
    orient_type=None,
    orient_matrix=((1, 0, 0), (0, 1, 0), (0, 0, 1)),
    orient_matrix_type='GLOBAL',
    gpencil_layer="", 
    gpencil_data="", 
    spline="", 
    stroke="", 
    point_index=0, 
    point_index_hovered=0, 
    events=None
)

参数

• x (float)：笔画线段在 X 轴上的偏移量。
• y (float)：笔画线段在 Y 轴上的偏移量。
• z (float)：笔画线段在 Z 轴上的偏移量。
• orient_type (str)：笔画的旋转方式。可用值包括 VIEW、CURSOR、UP 和 NORMAL。
• orient_matrix (matrix)：笔画的旋转矩阵。
• orient_matrix_type (str)：笔画的旋转矩阵类型。可用值包括 GLOBAL、LOCAL 和 VIEW。
• gpencil_layer (str)：笔迹所在的 grease pencil 层。
• gpencil_data (str)：笔迹所在的 grease pencil 数据对象。
• spline (str)：需要移动的笔画线段所在的曲线。
• stroke (str)：需要移动的笔画线段所在的笔画。
• point_index (int)：需要移动的笔画线段的起始点索引。
• point_index_hovered (int)：鼠标悬停在的笔画线段的起始点索引。
• events (list)：鼠标事件列表。

返回值

• {'FINISHED'}：如果成功执行操作，则返回该值。

抛出异常

• RuntimeError：如果无法执行操作，则会引发此异常。

示例

以下脚本演示如何使用 bpy.ops.gpencil.segment_move 移动笔画线段。

import bpy

# 选择要移动的笔画线段
gp_layer = bpy.context.scene.grease_pencil.layers.active
gp_data = gp_layer.active_data
spline = gp_layer.active_frame.strokes[1].splines[0] # 这里的 1 和 0 表示第二个笔画的第一条曲线段
stroke = spline.strokes[0]
point_index = 0
point_index_hovered = 0

# 移动笔画线段
bpy.ops.gpencil.segment_move(
    x=0.1,
    y=0.2,
    z=0,
    orient_type='NORMAL',
    gpencil_layer=gp_layer.name, 
    gpencil_data=gp_data.name, 
    spline=spline.name, 
    stroke=stroke.name, 
    point_index=point_index, 
    point_index_hovered=point_index_hovered, 
    events=None
)

参考

• bpy.ops.gpencil.transform：将笔画进行更复杂的变换。
• bpy.ops.gpencil.stroke_split：将笔画分割为两个笔画。
• bpy.ops.gpencil.stroke_vertex_add：在笔画中添加新的顶点。
• bpy.ops.gpencil.stroke_vertex_move：移动笔画中的顶点。