bpy.ops.gpencil.select

简介

该操作用于选择该Grease Pencil对象下的所有笔画（strokes）或指定笔画。

参数

• select_all: bool — 是否选择所有笔画。默认为True。
• toggle: bool — 是否切换选择状态。默认为False。
• extend: bool — 是否扩展选择状态。默认为False。
• deselect: bool — 是否取消选择。默认为False。
• location: tuple of 2 floats — 选择矩形的左上角坐标。仅在mode参数设置为RECTANGLE时使用。
• tweak: bool — 是否在已选择笔画上进行操作。默认为False。
• vertex_select_mode: enum in {'OFF', 'HIDE', 'BLUR', 'VERT', 'TIP', 'PARENT', 'POINT', 'THRESHHOLD', 'STROKE'}[-3:] — 选取模式。
• mode: enum in {'POINT', 'STROKE', 'ERASER', 'WEIGHT', 'BOX', 'RECTANGLE'}[-4:] — 工具模式。

返回值

• {'FINISHED'} — 操作完成。
• {'CANCELLED'} — 操作取消。

异常

• RuntimeError — 如果使用错误的选择模式。

示例

import bpy

# 选取Grease Pencil对象下的所有笔画
bpy.ops.gpencil.select()

# 取消选择已选择的笔画
bpy.ops.gpencil.select(deselect=True)

# 选择Grease Pencil对象下的某个笔画
bpy.ops.gpencil.select(stroke="Stroke")

# 使用矩形选择笔画
bpy.ops.gpencil.select(location=(0,0), mode="RECTANGLE")

备注

详见官方文档：https://docs.blender.org/api/current/bpy.ops.gpencil.html#bpy.ops.gpencil.select