Handles

Настраиваемые 3D GUI элементы управления и чертежи в представлении Scene.

Ручки — это элементы управления 3D, которые Unity использует для манипулирования элементами в представлении Scene. Существует ряд встроенных Handle GUIs, таких как знакомые инструменты для позиционирования, масштабирования и вращения объекта через компонент Transform. Однако, также возможно определить свой собственный Handle GUIs для использования с пользовательскими редакторами компонентов. Такие GUIs могут быть очень полезным способом редактирования процедурно генерируемого Scene содержимого, "невидимых" элементов и групп связанных объектов, таких как точки маршрута и маркеры местоположения.

Вы также можете дополнить 3D Handle GUI в представлении Scene кнопками 2D и другими элементами управления, наложенными на представление Scene. Это делается путем включения стандартных Unity GUI в вызов Handles.BeginGUI и Handles.EndGUI в паре функций Editor.OnSceneGUI. Вы можете использовать HandleUtility.GUIPointToWorldRay и HandleUtility.WorldToGUIPoint для преобразования координат между мировыми координатами 2D GUI и 3D.

using UnityEngine;
using UnityEditor;
public class ExampleScript : MonoBehaviour
{
    public float value = 7.0f;
}

// A tiny custom editor for ExampleScript component
[CustomEditor(typeof(ExampleScript))]
public class ExampleEditor : Editor
{
    // Custom in-scene UI for when ExampleScript
    // component is selected.
    public void OnSceneGUI()
    {
        var t = target as ExampleScript;
        var tr = t.transform;
        var pos = tr.position;
        // display an orange disc where the object is
        var color = new Color(1, 0.8f, 0.4f, 1);
        Handles.color = color;
        Handles.DrawWireDisc(pos, tr.up, 1.0f);
        // display object "value" in scene
        GUI.color = color;
        Handles.Label(pos, t.value.ToString("F1"));
    }
}

.