bpy.ops.gpencil.vertex_group_assign

描述

将纤维笔画中的笔画点分配给指定的顶点组。

用法

bpy.ops.gpencil.vertex_group_assign(group="", subtract=False)

参数

• group (string, optional) - 要分配笔画点的顶点组。
• subtract (boolean, optional) - 是否减去笔画点，而不是添加到顶点组。

返回

• {'FINISHED'} - 已成功分配纤维笔画点。

抛出

• RuntimeError - 如果当前对象不是纤维笔画或未选择纤维笔画，则引发此异常。

示例

以下示例演示如何将笔画点分配给新的顶点组：

import bpy

# 选择当前物体的纤维笔画
obj = bpy.context.object
gpencil_obj = obj.select_get(active=True)
active_gpencil_layer = gpencil_obj.active_gpencil_layer

# 在纤维笔画中创建新的顶点组
vertex_group_name = "MyVertexGroup"
bind_group = active_gpencil_layer.vertex_groups.new(name=vertex_group_name)

# 分配笔画点到组
bpy.ops.gpencil.vertex_group_assign(group=vertex_group_name)

错误标志

• BLENDERGPENCIL_OT_vertex_group_assign.ERROR_USE_CONFIRM_REGION - 当取消操作时，设置了错误标志。