bpy.ops.gpencil.stroke_trim

简介

这个操作会裁剪指定的手绘笔划，使其从指定的起点开始并以指定的终点结束。

参数

• mode: 裁剪模式。支持以下值：
  • 'CURRENT': 当前笔划。
  • 'ALL': 所有笔划。
  • 'SELECTION': 已选中的笔划。
• type: 裁剪类型。支持以下值：
  • 'CLIP': 裁剪（保留）给定的起点和终点之间的部分。
  • 'CLEAR': 移除给定的起点和终点之间的部分。
• trim_start: 裁剪起点，介于0和1之间的百分比值。
• trim_end: 裁剪终点，介于0和1之间的百分比值。
• clear: 只在type设为'CLEAR'时使用。如果设置为True，会在裁剪范围内清除笔划之间的部分（即裁剪范围的“空隙”）。如果设置为False，则仅删除笔划内裁剪范围内的线段。

返回值

这个操作没有返回值。

示例

import bpy

# 选择当前画笔模式
bpy.context.scene.tool_settings.gpencil_mode = 'DRAW'

# 裁剪当前笔划的第一半
bpy.ops.gpencil.stroke_trim(mode='CURRENT', type='CLIP', trim_start=0.0, trim_end=0.5)

# 裁剪选中笔划的后一半
bpy.ops.gpencil.stroke_trim(mode='SELECTION', type='CLIP', trim_start=0.5, trim_end=1.0)