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:: mathutils.Color of 3 items in [0, inf], default (0.0, 0.0, 0.0)

color_highlight#

Type:: mathutils.Color 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:: mathutils.Matrix 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:: mathutils.Matrix 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:: mathutils.Matrix 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:: mathutils.Matrix 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 (mathutils.Matrix 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 (mathutils.Matrix 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 (mathutils.Matrix 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

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 Gizmo.draw_custom_shape.

Parameters:

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

static new_custom_shape(type, verts)#

Create a new shape that can be passed to 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