Gizmo(bpy_struct)

base class — bpy_struct

class bpy.types.Gizmo(bpy_struct)

Collection of gizmos

alpha
Type

float in [0, 1], default 0.0

alpha_highlight
Type

float in [0, 1], default 0.0

bl_idname
Type

string, default “”, (never None)

color
Type

float array of 3 items in [0, inf], default (0.0, 0.0, 0.0)

color_highlight
Type

float array of 3 items in [0, inf], default (0.0, 0.0, 0.0)

group

Gizmo group this gizmo is a member of

Type

GizmoGroup, (readonly)

hide
Type

boolean, default False

hide_select
Type

boolean, default False

is_highlight
Type

boolean, default False, (readonly)

is_modal
Type

boolean, default False, (readonly)

line_width
Type

float in [0, inf], default 0.0

matrix_basis
Type

float multi-dimensional array of 4 * 4 items in [-inf, inf], default ((0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0))

matrix_offset
Type

float multi-dimensional array of 4 * 4 items in [-inf, inf], default ((0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0))

matrix_space
Type

float multi-dimensional array of 4 * 4 items in [-inf, inf], default ((0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0))

matrix_world
Type

float multi-dimensional array of 4 * 4 items in [-inf, inf], default ((0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0)), (readonly)

properties
Type

GizmoProperties, (readonly, never None)

scale_basis
Type

float in [0, inf], default 0.0

select
Type

boolean, default False

select_bias

Depth bias used for selection

Type

float in [-inf, inf], default 0.0

use_draw_hover
Type

boolean, default False

use_draw_modal

Draw while dragging

Type

boolean, default False

use_draw_offset_scale

Scale the offset matrix (use to apply screen-space offset)

Type

boolean, default False

use_draw_scale

Use scale when calculating the matrix

Type

boolean, default False

use_draw_value

Show an indicator for the current value while dragging

Type

boolean, default False

use_event_handle_all

When highlighted, do not pass events through to be handled by other keymaps

Type

boolean, default False

use_grab_cursor
Type

boolean, default False

use_operator_tool_properties

Merge active tool properties on activation (does not overwrite existing)

Type

boolean, default False

use_select_background

Don’t write into the depth buffer

Type

boolean, default False

draw(context)
draw_select(context, select_id=0)
test_select(context, location)
Parameters

location (int array of 2 items in [-inf, inf], (never None)) – Location, Region coordinates

Returns

Use -1 to skip this gizmo

Return type

int in [-1, inf]

modal(context, event, tweak)
Parameters

tweak (enum set in {'PRECISE', 'SNAP'}) – Tweak

Returns

result

  • RUNNING_MODAL Running Modal, Keep the operator running with blender.

  • CANCELLED Cancelled, The operator exited without doing anything, so no undo entry should be pushed.

  • FINISHED Finished, The operator exited after completing its action.

  • PASS_THROUGH Pass Through, Do nothing and pass the event on.

  • INTERFACE Interface, Handled but not executed (popup menus).

Return type

enum set in {‘RUNNING_MODAL’, ‘CANCELLED’, ‘FINISHED’, ‘PASS_THROUGH’, ‘INTERFACE’}

setup()
invoke(context, event)
Returns

result

  • RUNNING_MODAL Running Modal, Keep the operator running with blender.

  • CANCELLED Cancelled, The operator exited without doing anything, so no undo entry should be pushed.

  • FINISHED Finished, The operator exited after completing its action.

  • PASS_THROUGH Pass Through, Do nothing and pass the event on.

  • INTERFACE Interface, Handled but not executed (popup menus).

Return type

enum set in {‘RUNNING_MODAL’, ‘CANCELLED’, ‘FINISHED’, ‘PASS_THROUGH’, ‘INTERFACE’}

exit(context, cancel)
Parameters

cancel (boolean) – Cancel, otherwise confirm

select_refresh()
draw_preset_box(matrix, select_id=-1)

Draw a box

Parameters
  • matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – The matrix to transform

  • select_id (int in [-1, inf], (optional)) – Zero when not selecting

draw_preset_arrow(matrix, axis='POS_Z', select_id=-1)

Draw a box

Parameters
  • matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – The matrix to transform

  • axis (enum in ['POS_X', 'POS_Y', 'POS_Z', 'NEG_X', 'NEG_Y', 'NEG_Z'], (optional)) – Arrow Orientation

  • select_id (int in [-1, inf], (optional)) – Zero when not selecting

draw_preset_circle(matrix, axis='POS_Z', select_id=-1)

Draw a box

Parameters
  • matrix (float multi-dimensional array of 4 * 4 items in [-inf, inf]) – The matrix to transform

  • axis (enum in ['POS_X', 'POS_Y', 'POS_Z', 'NEG_X', 'NEG_Y', 'NEG_Z'], (optional)) – Arrow Orientation

  • select_id (int in [-1, inf], (optional)) – Zero when not selecting

draw_preset_facemap(object, face_map, select_id=-1)

Draw the face-map of a mesh object

Parameters
  • object (Object, (never None)) – Object

  • face_map (int in [0, inf]) – Face map index

  • select_id (int in [-1, inf], (optional)) – Zero when not selecting

target_set_prop(target, data, property, index=-1)
Parameters
  • target (string, (never None)) – Target property

  • data (AnyType, (never None)) – Data from which to take property

  • property (string, (never None)) – Identifier of property in data

target_set_operator(operator, index=0)

Operator to run when activating the gizmo (overrides property targets)

Parameters
  • operator (string, (never None)) – Target operator

  • index (int in [0, 255], (optional)) – Part index

Returns

Operator properties to fill in

Return type

OperatorProperties

target_is_valid(property)
Parameters

property (string, (never None)) – Property identifier

Return type

boolean

draw_custom_shape(shape, *, matrix=None, select_id=None)

Draw a shape created form bpy.types.Gizmo.draw_custom_shape.

Parameters
static new_custom_shape(type, verts)

Create a new shape that can be passed to bpy.types.Gizmo.draw_custom_shape.

Parameters
  • type (string) – The type of shape to create in (POINTS, LINES, TRIS, LINE_STRIP).

  • verts (sequence of of 2D or 3D coordinates.) – Coordinates.

  • display_name (Callable that takes a string and returns a string.) – Optional callback that takes the full path, returns the name to display.

Returns

The newly created shape.

Return type

Undefined (it may change)

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – 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 (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

target_get_range(target):

Get the range for this target property.

Parameters

target – Target property name.

Returns

The range of this property (min, max).

Return type

tuple pair.

target_get_value(target):

Get the value of this target property.

Parameters

target (string) – Target property name.

Returns

The value of the target property.

Return type

Single value or array based on the target type

target_set_handler(target, get, set, range=None):

Assigns callbacks to a gizmos property.

Parameters
  • get (callable) – Function that returns the value for this property (single value or sequence).

  • set (callable) – Function that takes a single value argument and applies it.

  • range (callable) – Function that returns a (min, max) tuple for gizmos that use a range.

target_set_value(target):

Set the value of this target property.

Parameters

target (string) – Target property name.

Inherited Properties

Inherited Functions

References