Legacy Documentation: Version 4.6.2
Language: English
  • C#
  • JS
  • Boo

Script language

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

Handles

Namespace: UnityEditor

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

Sumbission failed

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

Close

Cancel

Description

Custom 3D GUI controls and drawing in the scene view.

Handles are the 3D controls that Unity uses to manipulate items in the scene view. There are a number of built-in Handle GUIs, such as the familiar tools to position, scale and rotate an object via the Transform component. However, it is also possible to define your own Handle GUIs to use with custom component editors. Such GUIs can be a very useful way to edit procedurally-generated scene content, "invisible" items and groups of related objects, such as waypoints and location markers.

You can also supplement the 3D Handle GUI in the scene with 2D buttons and other controls overlaid on the scene view. This is done by enclosing standard Unity GUI calls in a Handles.BeginGUI / EndGUI pair within the //OnSceneGUI// function. You can use HandleUtility.GUIPointToWorldRay and HandleUtility.WorldToGUIPoint to convert coordinates between 2D GUI and 3D world coordinates.

Static Variables

centerColor Color to use for handles that represent the center of something.
color Colors of the handles.
inverseMatrix The inverse of the matrix for all handle operations.
lighting Are handles lit?
matrix Matrix for all handle operations.
secondaryColor Soft color to use for for general things.
selectedColor Color to use for the currently active handle.
xAxisColor Color to use for handles that manipulates the X coordinate of something.
yAxisColor Color to use for handles that manipulates the Y coordinate of something.
zAxisColor Color to use for handles that manipulates the Z coordinate of something.

Variables

currentCamera Setup viewport and stuff for a current camera.

Static Functions

ArrowCap Draw an arrow like those used by the move tool.
BeginGUI Begin a 2D GUI block inside the 3D handle GUI.
Button Make a 3D Button.
CircleCap Draw a camera-facing Circle. Pass this into handle functions.
ClearCamera Clears the camera.
ConeCap Draw a Cone. Pass this into handle functions.
CubeCap Draw a cube. Pass this into handle functions.
CylinderCap Draw a Cylinder. Pass this into handle functions.
Disc Make a 3D disc that can be dragged with the mouse.
DotCap Draw a camera-facing dot. Pass this into handle functions.
DrawAAPolyLine Draw anti-aliased line specified with point array and width.
DrawBezier Draw textured bezier line through start and end points with the given tangents. To get an anti-aliased effect use a texture that is 1x2 pixels with one transparent white pixel and one opaque white pixel. The bezier curve will be swept using this texture.
DrawCamera Draws a camera inside a rectangle.
DrawDottedLine Draw a dotted line from p1 to p2.
DrawLine Draw a line from p1 to p2.
DrawPolyLine Draw a line going through the list of all points.
DrawSolidArc Draw a circular sector (pie piece) in 3D space.
DrawSolidDisc Draw a solid flat disc in 3D space.
DrawSolidRectangleWithOutline Draw a solid outlined rectangle in 3D space.
DrawWireArc Draw a circular arc in 3D space.
DrawWireDisc Draw the outline of a flat disc in 3D space.
EndGUI End a 2D GUI block and get back to the 3D handle GUI.
FreeMoveHandle Make an unconstrained movement handle.
FreeRotateHandle Make an unconstrained rotation handle.
GetMainGameViewSize Get the width and height of the main game view.
Label Make a text label positioned in 3D space.
PositionHandle Make a 3D Scene view position handle.
RadiusHandle Make a Scene view radius handle.
RotationHandle Make a Scene view rotation handle.
ScaleHandle Make a Scene view scale handle.
ScaleSlider Make a directional scale slider.
ScaleValueHandle Make a single-float draggable handle.
SelectionFrame Draw a camera facing selection frame.
SetCamera Set the current camera so all Handles and Gizmos are draw with its settings.
Slider Make a 3D slider.
Slider2D Slide a handle in a 2D plane.
SnapValue Rounds the value val to the closest multiple of snap (snap can only be posiive).
SphereCap Draw a Sphere. Pass this into handle functions.