bpy.ops.gpencil.layer_mask_remove

简介

移除指定图层的掩模层。

参数

• layer (GPencilLayer): 操作的图层对象。

• mask_layer (GPencilMaskLayer): 要移除的掩模层对象。

返回值

• {'CANCELLED'}，操作失败时返回。

示例

import bpy

# 选择要操作的笔画对象
obj = bpy.context.active_object
gpencil = obj.grease_pencil
layer = gpencil.layers.active

# 移除第一个掩模层
mask_layer = layer.mask_layers[0]
bpy.ops.gpencil.layer_mask_remove(layer=layer, mask_layer=mask_layer)

注意事项

• 操作前需要选择要操作的笔画对象，且该对象需要是使用了 GPencil 模式。

• 必须指定要操作的图层对象和要移除的掩模层对象。

• 如果成功移除掩模层，则返回 {'FINISHED'}。如果操作失败，则返回 {'CANCELLED'}。