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_keymap

Ignore the key-map for this gizmo

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

Show 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

use_tooltip

Use tooltips when hovering over this gizmo

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
Return type: enum set in Operator Return Items

setup()

invoke(context, event)

Returns: result
Return type: enum set in Operator Return Items

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)) – ID to use when gizmo is selectable. Use -1 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 Object Axis Items, (optional)) – Arrow Orientation
select_id (int in [-1, inf], (optional)) – ID to use when gizmo is selectable. Use -1 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 Object Axis Items, (optional)) – Arrow Orientation
select_id (int in [-1, inf], (optional)) – ID to use when gizmo is selectable. Use -1 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)) – ID to use when gizmo is selectable. Use -1 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

shape (Undefined.) – The cached shape to draw.
matrix (mathutils.Matrix) – 4x4 matrix, when not given bpy.types.Gizmo.matrix_world is used.
select_id – The selection id. Only use when drawing within bpy.types.Gizmo.draw_select.

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

target (string) – Target property name.
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

bpy_struct.id_data

Inherited Functions

References