bpy.ops.gpencil.select_box

简介

此操作命令将根据提供的矩形框选择绘制中的所有画笔数据。只有在笔刷模式下此操作才会影响笔刷样式。

参数

• mode：选择模式，类型为字符串，可选参数为：'SET'、'ADD'、'SUBTRACT'、'INTERSECT'，分别表示设置模式、添加模式、减去模式、交集模式。默认值为'SET'。
• wait_for_input：等待用户输入，类型为布尔值。如果为True，则等待用户输入矩形框。默认为False。
• location：矩形框的左下角顶点，类型为二元组（x，y），如果不提供，则需要用户输入矩形框。
• modebox：将选择矩形框的左上角缩放到屏幕空间中的最大位置，类型为布尔值。默认为False。
• pinned：设置绘画放置的位置是否被固定（钉住），类型为布尔值。默认为False。

返回值

此命令没有返回值。

报错

• AttributeError: 'bpy_prop_collection' object has no attribute 'active'

此报错可能是由于没有正确设置或加载骨架或形态键，或没有选择正确的笔刷而导致的。

示例代码

import bpy

bpy.ops.gpencil.select_box(wait_for_input=True, mode='ADD', modebox=False, pinned=True)

以上代码将等待用户输入，然后选择在屏幕上绘制的所有画笔数据，在笔刷模式下将它们添加到已选择的画笔中，并将选择矩形框的左上角缩放到屏幕空间中的最大位置，最后将绘画放置的位置固定（钉住）。