bpy.ops.gpencil.segment_remove

删除笔画中的指定段落

描述

bpy.ops.gpencil.segment_remove 函数可以在 Blender 中删除指定笔画中的指定段落。

语法

bpy.ops.gpencil.segment_remove(gpencil_data=None, 
                                layer=None, 
                                frame=None, 
                                stroke=None, 
                                stroke_id=None, 
                                seg_idx=None)

参数

• gpencil_data (bpy.types.GreasePencil): 笔画数据对象。
• layer (bpy.types.GPencilLayer): 笔画图层。
• frame (int): 笔画所在帧数。
• stroke (bpy.types.GPencilStroke): 笔画对象。
• stroke_id (int): 笔画 ID。
• seg_idx (int): 要删除的笔画段落的索引编号。

返回值

• 如果删除成功，则返回 {'FINISHED'}；如果删除失败，则返回{'CANCELLED'}。

示例

import bpy

# 获取活动笔画数据对象
gpencil_data = bpy.context.scene.grease_pencil

# 获取指定笔画图层
layer = gpencil_data.layers[0]

# 获取指定笔画所在帧数
frame = bpy.context.scene.frame_current

# 获取指定笔画对象
stroke = layer.active_frame.strokes[0]

# 要删除的笔画段落的索引编号
seg_idx = 1

# 删除指定的笔画段落
bpy.ops.gpencil.segment_remove(gpencil_data=gpencil_data, 
                                layer=layer, 
                                frame=frame, 
                                stroke=stroke, 
                                stroke_id=0, 
                                seg_idx=seg_idx)

异常

• 如果 gpencil_data、layer 或 stroke 参数为 None，则会触发 RuntimeError 异常。