Handles

描述

场景视图中的自定义 3D GUI 控件和绘制。

Handles 是 Unity 用于在场景视图中操作项目的 3D 控件。有许多内置的 Handle GUI，例如熟悉的用于通过 Transform 组件定位、缩放和旋转对象的工具。但是，也可以定义自己的 Handle GUI 以与自定义组件编辑器一起使用。此类 GUI 可以成为编辑程序生成场景内容、“不可见”项目和相关对象组（例如路点和位置标记）的非常有用的方法。

您还可以使用叠加在场景视图上的 2D 按钮和其他控件来补充场景中的 3D Handle GUI。这是通过在 Handles.BeginGUI 和 Handles.EndGUI 对内包含标准 Unity GUI 调用来完成的，这些调用位于 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"));
    }
}

.

静态属性

属性

静态方法

委托