WorkSpaceTool(bpy_struct)

base class — bpy_struct

class bpy.types.WorkSpaceTool(bpy_struct)
brush_type

If the tool uses brushes and is limited to a specific brush type, the identifier of the brush type

Type

enum in ['DEFAULT'], default "'DEFAULT'", (readonly)

has_datablock
Type

boolean, default False, (readonly)

idname
Type

string, default “”, (never None)

idname_fallback
Type

string, default “”, (never None)

index
Type

int in [-inf, inf], default 0, (readonly)

mode
Type

enum in ['DEFAULT'], default "'DEFAULT'", (readonly)

space_type
Type

enum in Space Type Items, default "'EMPTY'", (readonly)

use_brushes
Type

boolean, default False, (readonly)

use_paint_canvas

Does this tool use a painting canvas

Type

boolean, default False, (readonly)

widget
Type

string, default “”, (readonly, never None)

setup(idname, *, cursor='DEFAULT', keymap='', gizmo_group='', brush_type='', data_block='', operator='', index=0, options={}, idname_fallback='', keymap_fallback='')

Set the tool settings

Parameters
  • idname (string, (never None)) – Identifier

  • cursor (enum in Window Cursor Items, (optional)) – cursor

  • keymap (string, (optional, never None)) – Key Map

  • gizmo_group (string, (optional, never None)) – Gizmo Group

  • brush_type (enum in [], (optional)) – Brush Type, Limit this tool to a specific type of brush

  • data_block (string, (optional, never None)) – Data Block

  • operator (string, (optional, never None)) – Operator

  • index (int in [-inf, inf], (optional)) – Index

  • options (enum set in {'KEYMAP_FALLBACK', 'USE_BRUSHES'}, (optional)) –

    Tool Options

    • KEYMAP_FALLBACK Fallback.

    • USE_BRUSHES Uses Brushes – Allow this tool to use brushes via the asset system.

  • idname_fallback (string, (optional, never None)) – Fallback Identifier

  • keymap_fallback (string, (optional, never None)) – Fallback Key Map

operator_properties(operator)

operator_properties

Return type

OperatorProperties, (never None)

gizmo_group_properties(group)

gizmo_group_properties

Return type

GizmoGroupProperties, (never None)

refresh_from_context()

refresh_from_context

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters

id (str) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters

id (str) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References