Handles
Описание
Пользовательские элементы управления трехмерным графическим интерфейсом и рисование в представлении «Сцена».
Ручки — это 3D-элементы управления, которые Unity использует для управления элементами в представлении «Сцена». Существует ряд встроенных графических интерфейсов Handle, таких как знакомые инструменты для позиционирования, масштабирования и поворота объекта с помощью компонента Transform. Однако также можно определить свои собственные графические интерфейсы Handle для использования с редакторами пользовательских компонентов. Такие графические интерфейсы могут быть очень полезным способом редактирования процедурно сгенерированного содержимого сцены, «невидимых» элементов и групп связанных объектов, таких как путевые точки и маркеры местоположения.
Вы также можете дополнить графический интерфейс 3D-манипулятора в сцене 2D-кнопками и другими элементами управления, наложенными на вид сцены. Это делается путем включения стандартных вызовов 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"));
}
}
Статические Свойства
| centerColor | Цвет, используемый для маркеров, представляющих центр чего-либо. |
| color | Цвета ручек. |
| inverseMatrix | Инверсия матрицы для всех операций дескриптора. |
| lighting | Подсвечиваются ли ручки? |
| lineThickness | Получает параметр предпочтения пользователя, управляющий толщиной линий рукоятки инструмента. (Только чтение) |
| matrix | Матрица для всех операций с дескрипторами. |
| preselectionColor | Цвет, используемый для выделения невыбранного дескриптора, находящегося в данный момент под указателем мыши. |
| secondaryColor | Мягкий цвет для обычных вещей. |
| selectedColor | Цвет для текущего активного дескриптора. |
| xAxisColor | Цвет, используемый для маркеров, которые манипулируют координатой X чего-либо. |
| yAxisColor | Цвет, используемый для маркеров, которые манипулируют координатой Y чего-либо. |
| zAxisColor | Цвет, используемый для маркеров, которые манипулируют координатой Z чего-либо. |
| zTest | Проверка дескрипторов. |
Свойства
| currentCamera | Настройка видового экрана и прочее для текущей камеры. |
Статические Методы
| ArrowHandleCap | Рисует стрелку, аналогичную той, что используется в инструменте перемещения. |
| BeginGUI | Начните блок 2D-графического интерфейса внутри графического интерфейса 3D-дескриптора. |
| Button | Создаёт 3D-кнопку. |
| CircleHandleCap | Рисует круглую ручку. Передайте это в функции обработки. |
| ClearCamera | Очищает камеру. |
| ConeHandleCap | Рисует ручку-конус. Передайте это в функции обработки. |
| CubeHandleCap | Рисует ручку куба. Передайте это в функции обработки. |
| CylinderHandleCap | Рисует ручку цилиндра. Передайте это в функции обработки. |
| Disc | Создаёт 3D-диск, который можно перетаскивать мышью. |
| DotHandleCap | Рисует маркер в виде точки. Передайте это в функции обработки. |
| DrawAAConvexPolygon | Рисует сглаженный выпуклый многоугольник, заданный массивом точек. |
| DrawAAPolyLine | Рисует сглаженную линию, указанную с помощью массива точек и ширины. |
| DrawBezier | Рисует текстурированную линию Безье через начальную и конечную точки с заданными касательными. |
| DrawCamera | Рисует камеру внутри прямоугольника. |
| DrawDottedLine | Рисует пунктирную линию от p1 до p2. |
| DrawDottedLines | Рисует список сегментов пунктирной линии. |
| DrawGizmos | Рисует подмножество Gizmos (до или после постобработки) для данной камеры. |
| DrawLine | Рисует линию от p1 до p2. |
| DrawLines | Рисует список сегментов линии. |
| DrawPolyLine | Рисует линию, проходящую через список точек. |
| DrawSelectionFrame | Рисует рамку выбора, обращенную к камере. |
| DrawSolidArc | Рисует круговой сектор (кусок пирога) в трехмерном пространстве. |
| DrawSolidDisc | Рисует твердый плоский диск в трехмерном пространстве. |
| DrawSolidRectangleWithOutline | Рисует сплошной прямоугольник в трехмерном пространстве. |
| DrawTexture3DSDF | Рисует 3D-текстуру, используя режим рендеринга Signed Distance Field в 3D-пространстве. |
| DrawTexture3DSlice | Рисует 3D-текстуру, используя режим рендеринга Slice в 3D-пространстве. |
| DrawTexture3DVolume | Рисует 3D-текстуру, используя режим объемного рендеринга в 3D-пространстве. |
| DrawWireArc | Рисует дугу окружности в трехмерном пространстве. |
| DrawWireCube | Рисует каркасную рамку с центром и размером. |
| DrawWireDisc | Рисует контур плоского диска в трехмерном пространстве. |
| EndGUI | Завершить блок 2D-графического интерфейса и вернуться к графическому интерфейсу 3D-дескриптора. |
| FreeMoveHandle | Создаёт неограниченный маркер перемещения. |
| FreeRotateHandle | Создаёт дескриптор неограниченного поворота. |
| GetMainGameViewSize | Получить ширину и высоту основного вида игры. |
| Label | Создаёт текстовую метку, расположенную в трехмерном пространстве. |
| MakeBezierPoints | Перенастраивает массив точек для представления кривой Безье. |
| PositionHandle | Создаёт дескриптор позиции. |
| RadiusHandle | Создаёт маркер радиуса просмотра сцены. |
| RectangleHandleCap | Рисует прямоугольную ручку. Передайте это в функции обработки. |
| RotationHandle | Создаёт дескриптор поворота представления "Сцена". |
| ScaleHandle | Создаёт дескриптор масштаба представления сцены. |
| ScaleSlider | Создаёт ползунок шкалы направления. |
| ScaleValueHandle | Создаёт 3D-манипулятор, который масштабирует одно плавающее число. |
| SetCamera | Настраивает текущую камеру так, чтобы все ручки и приспособления отображались с ее настройками. |
| ShouldRenderGizmos | Определяет, следует ли рисовать вещицы. |
| Slider | Создаёт 3D-ползунок, который перемещается вдоль одной оси. |
| Slider2D | Создаёт 3D-ползунок, который перемещается по плоскости, определяемой двумя осями. |
| SnapToGrid | Округляет каждую позицию Transform.position до ближайшего кратного EditorSnap.move. |
| SnapValue | Округляет значение до ближайшего кратного привязки, если привязка активна. Обратите внимание, что привязка может быть только положительной. |
| SphereHandleCap | Рисует ручку сферы. Передайте это в функции обработки. |
| TransformHandle | Создает дескриптор преобразования. |
Делегаты
| CapFunction | Функция, используемая для рисования ручки, например. Ручки.RectangleCap. |
| SizeFunction | Тип делегата для получения размера дескриптора на основе его текущей позиции. |
Обновлено 17 ноября 2026 г.