bpy.ops.brush.stencil_control

概述

bpy.ops.brush.stencil_control用于控制笔刷使用的图案遮罩。该操作的主要参数包括混合模式、透明度、平铺方式等。

语法

bpy.ops.brush.stencil_control(mode='TRANSLATION', direction='U', value=1, texture='', stencil='BRUSH', test_type='INVERT', invert=False, show_texture=True, mapping='FENEY', use_clamp_coords=False, show_uvedit=False, use_proportional_edit=False, proportional_size=1, use_proportional_connected=False, use_proportional_projected=False, release_confirm=False)

• mode (enum in ['TRANSLATION', 'SCALE', 'ROTATION'], (optional)) – 操作模式，默认值为'TRANSLATION'。
• direction (enum in ['U', 'V', 'UV'], (optional)) – 操作方向，默认值为'U'。
• value (float in [-inf, inf], (optional)) – 操作值，默认值为1。
• texture (string, (optional, never None)) – 图案遮罩的纹理，默认值为空。
• stencil (enum in ['BRUSH', 'TEXTURE'], (optional)) – 遮罩类型，默认值为'BRUSH'。
• test_type (enum in ['GREATER', 'LESS', 'EQUAL', 'NOTEQUAL', 'GEQUAL', 'LEQUAL', 'INVERT', 'ALPHA_EQUAL'], (optional)) – 测试方式，默认值为'INVERT'。
• invert (boolean, (optional)) – 是否反转图案遮罩的颜色，默认值为False。
• show_texture (boolean, (optional)) – 是否显示图案遮罩，默认值为True。
• mapping (enum in ['FENEY', 'CUBE', 'TUBE', 'SPHERE'], (optional)) – 纹理映射方式，默认值为'FENEY'。
• use_clamp_coords (boolean, (optional)) – 是否启用限制坐标，默认值为False。
• show_uvedit (boolean, (optional)) – 是否显示UV编辑模式，默认值为False。
• use_proportional_edit (enum in ['DISABLED', 'ENABLED', 'CONNECTED'], (optional)) – 是否使用比例编辑模式，默认值为'DISABLED'。
• proportional_size (float in [0.010000, 1000], (optional)) – 比例大小，默认值为1。
• use_proportional_connected (boolean, (optional)) – 是否使用连接编辑模式，默认值为False。
• use_proportional_projected (boolean, (optional)) – 是否使用投影编辑模式，默认值为False。
• release_confirm (boolean, (optional)) – 是否需要确认操作，默认值为False。

返回值

该函数没有返回值。

示例

import bpy

# 选择激活的笔刷
bpy.context.tool_settings.grease_pencil.draw_mode = 'DRAW' 
bpy.ops.gpencil.select_all(action='SELECT')
bpy.ops.gpencil.brush_select(index=0)

# 调整图案遮罩
bpy.ops.brush.stencil_control(mode='TRANSLATION', direction='U', value=1, texture='', stencil='BRUSH', test_type='INVERT', invert=False, show_texture=True, mapping='FENEY', use_clamp_coords=False, show_uvedit=False, use_proportional_edit=False, proportional_size=1, use_proportional_connected=False, use_proportional_projected=False, release_confirm=False)

参考资料

• bpy.ops.brush.stencil_control