Brush Operators

bpy.ops.brush.active_index_set(mode="", index=0)

Set active sculpt/paint brush from it’s number

Parameters:
  • mode (string, (optional)) – mode, Paint mode to set brush for
  • index (int in [-inf, inf], (optional)) – number, Brush number
File :

startup/bl_operators/wm.py:164

bpy.ops.brush.add()

Add brush by mode type

bpy.ops.brush.curve_preset(shape='SMOOTH')

Set brush shape

Parameters:shape (enum in [‘SHARP’, ‘SMOOTH’, ‘MAX’, ‘LINE’, ‘ROUND’, ‘ROOT’], (optional)) – Mode
bpy.ops.brush.image_tool_set(tool='DRAW')

Set the image tool

Parameters:tool (enum in [‘DRAW’, ‘SOFTEN’, ‘SMEAR’, ‘CLONE’], (optional)) – Tool
bpy.ops.brush.reset()

Return brush to defaults based on current tool

bpy.ops.brush.scale_size(scalar=1.0)

Change brush size by a scalar

Parameters:scalar (float in [0, 2], (optional)) – Scalar, Factor to scale brush size by
bpy.ops.brush.sculpt_tool_set(tool='BLOB')

Set the sculpt tool

Parameters:tool (enum in [‘BLOB’, ‘CLAY’, ‘CREASE’, ‘DRAW’, ‘FILL’, ‘FLATTEN’, ‘GRAB’, ‘INFLATE’, ‘LAYER’, ‘NUDGE’, ‘PINCH’, ‘ROTATE’, ‘SCRAPE’, ‘SMOOTH’, ‘SNAKE_HOOK’, ‘THUMB’], (optional)) – Tool
bpy.ops.brush.uv_sculpt_tool_set(tool='PINCH')

Set the UV sculpt tool

Parameters:tool (enum in [‘PINCH’, ‘RELAX’, ‘GRAB’], (optional)) –

Tool

  • PINCH Pinch, Pinch UVs.
  • RELAX Relax, Relax UVs.
  • GRAB Grab, Grab UVs.
bpy.ops.brush.vertex_tool_set(tool='MIX')

Set the vertex paint tool

Parameters:tool (enum in [‘MIX’, ‘ADD’, ‘SUB’, ‘MUL’, ‘BLUR’, ‘LIGHTEN’, ‘DARKEN’], (optional)) –

Tool

  • MIX Mix, Use mix blending mode while painting.
  • ADD Add, Use add blending mode while painting.
  • SUB Subtract, Use subtract blending mode while painting.
  • MUL Multiply, Use multiply blending mode while painting.
  • BLUR Blur, Blur the color with surrounding values.
  • LIGHTEN Lighten, Use lighten blending mode while painting.
  • DARKEN Darken, Use darken blending mode while painting.
bpy.ops.brush.weight_tool_set(tool='MIX')

Set the weight paint tool

Parameters:tool (enum in [‘MIX’, ‘ADD’, ‘SUB’, ‘MUL’, ‘BLUR’, ‘LIGHTEN’, ‘DARKEN’], (optional)) –

Tool

  • MIX Mix, Use mix blending mode while painting.
  • ADD Add, Use add blending mode while painting.
  • SUB Subtract, Use subtract blending mode while painting.
  • MUL Multiply, Use multiply blending mode while painting.
  • BLUR Blur, Blur the color with surrounding values.
  • LIGHTEN Lighten, Use lighten blending mode while painting.
  • DARKEN Darken, Use darken blending mode while painting.

Previous topic

Boid Operators

Next topic

Buttons Operators