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 failedFor 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 Your name Your email Suggestion* DescriptionA class for a compound handle to edit an angle and a radius in the Scene view.
ArcHandle in the Scene View.
This class allows you to display control handles for editing the angle and radius of an arc. The arc originates at Vector3.forward multiplied by the radius and rotates around Vector3.up. 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.
The following component defines an object with an angle and force property.
The following Custom Editor example allows you to edit the elevation angle and force properties for this component in the Scene view, where the force is represented by the radius of the handle.
using UnityEditor; using UnityEditor.IMGUI.Controls; using UnityEngine;[CustomEditor(typeof(ProjectileExample))] public class ProjectileExampleEditor : Editor { ArcHandle m_ArcHandle = new ArcHandle();
protected virtual void OnEnable() { // arc handle has no radius handle by default m_ArcHandle.SetColorWithRadiusHandle(Color.white, 0.1f); }
// the OnSceneGUI callback uses the Scene view camera for drawing handles by default protected virtual void OnSceneGUI() { ProjectileExample projectileExample = (ProjectileExample)target;
// copy the target object's data to the handle m_ArcHandle.angle = projectileExample.elevationAngle; m_ArcHandle.radius = projectileExample.impulse;
// set the handle matrix so that angle extends upward from target's facing direction along ground Vector3 handleDirection = projectileExample.facingDirection; Vector3 handleNormal = Vector3.Cross(handleDirection, Vector3.up); Matrix4x4 handleMatrix = Matrix4x4.TRS( projectileExample.transform.position, Quaternion.LookRotation(handleDirection, handleNormal), Vector3.one );
using (new Handles.DrawingScope(handleMatrix)) { // draw the handle EditorGUI.BeginChangeCheck(); m_ArcHandle.DrawHandle(); if (EditorGUI.EndChangeCheck()) { // record the target object before setting new values so changes can be undone/redone Undo.RecordObject(projectileExample, "Change Projectile Properties");
// copy the handle's updated data back to the target object projectileExample.elevationAngle = m_ArcHandle.angle; projectileExample.impulse = m_ArcHandle.radius; } } } }
Additional resources: Editor.OnSceneGUI, Handles.SetCamera.
Properties Property Description angle Returns or specifies the angle of the arc for the handle. angleHandleColor Returns or specifies the color of the angle control handle. angleHandleDrawFunction The CapFunction to use when displaying the angle control handle. angleHandleSizeFunction The SizeFunction to specify how large the angle control handle should be. fillColor Returns or specifies the color of the arc shape. radius Returns or specifies the radius of the arc for the handle. radiusHandleColor Returns or specifies the color of the radius control handle. radiusHandleDrawFunction The CapFunction to use when displaying the radius control handle. radiusHandleSizeFunction The SizeFunction to specify how large the angle control handle should be. wireframeColor Returns or specifies the color of the curved line along the outside of the arc. Constructors Constructor Description ArcHandle Creates a new instance of the ArcHandle class. Public Methods Method Description DrawHandle A function to display this instance in the current handle camera using its current configuration. SetColorWithoutRadiusHandle Sets angleHandleColor, wireframeColor, and fillColor to the same value, where fillColor will have the specified alpha value. radiusHandleColor will be set to Color.clear and the radius handle will be disabled. SetColorWithRadiusHandle Sets angleHandleColor, radiusHandleColor, wireframeColor, and fillColor to the same value, where fillColor will have the specified alpha value.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4