Legacy Documentation: Version 5.6 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

PrimitiveBoundsHandle

class in UnityEditor.IMGUI.Controls

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Base class for a compound handle to edit a bounding volume in the Scene view.

This class allows you to display a shape with up to six control handles for simultaneously editing the size and center of a bounding volume. Dragging on any one control handle will expand the volume along the control handle's axis. All classes that inherit from this class also gain the following modifier keys while a control handle is being dragged:

Alt: Pin the center of the volume to its location at the time the control handle was clicked and grow the size in both directions along the control handle's axis of movement.
Shift: Uniformly scale the volume along all enabled axes in proportion to its size at the time the control handle was clicked.

The handle rendered by this class's DrawHandle method is affected by global state in the Handles class, such as Handles.matrix and Handles.color.

See Also: Editor.OnSceneGUI, Handles.SetCamera.

Variables

axesFlags specifying which axes should display control handles.
centerGets or sets the center of the bounding volume for the handle.
handleColorSpecifies the color of the control handles.
midpointHandleDrawFunctionAn optional CapFunction to use when displaying the control handles. Defaults to Handles.DotHandleCap if no value is specified.
midpointHandleSizeFunctionAn optional SizeFunction to specify how large the control handles should be in the space of Handles.matrix. Defaults to a fixed screen-space size.
wireframeColorSpecifies the color of the wireframe shape.

Constructors

PrimitiveBoundsHandleCreate a new instance of the PrimitiveBoundsHandle class.

Public Functions

DrawHandleA function to display this instance in the current handle camera using its current configuration.
SetColorSet handleColor and wireframeColor to the same value.

Protected Functions

DrawWireframeDraw a wireframe shape for this instance. Subclasses must implement this method.
GetSizeGets the current size of the bounding volume for this instance.
IsAxisEnabledGets a value indicating whether the specified axis is enabled for the current instance.
OnHandleChangedA callback for when a control handle was dragged in the scene.
SetSizeSets the current size of the bounding volume for this instance.