Unity编辑器开发（七）——Scene界面拓展之Handles

个人学习笔记，如有错误、疑问，欢迎留言。
声明：本文不得以任何形式进行转载。

---

 前言：在Unity编辑器拓展时，一个很重要的部分便是在Scene界面进行拓展，通过可视化的显示UI控件，并能响应用户的操作，可以让各种抽象的position、rotatino、scale等信息可视化，策划可以可视化的操作，大幅度的降低了工作量和难度，提高了工作效率。
 今天先介绍Unity中的Handles接口，这个接口常用于地图编辑器等工具。

---

---

一、Handles简介

 首先，什么Handles？Handles的中文翻译是手柄，其实就是Unity中的这个东西：

 上面这个Handle便是控制位置的位置控制器，除此之外，还有旋转控制器和大小控制器。

---

二、如何在Scene界面自定义绘制？

 在SceneView接口中，有一个事件，名为duringSceneGui，订阅这个事件可以实现在Scene界面每次调用OnGUI方法时接收的回调，以实现自定义绘制Scene界面。
 如下所示：

void OnEnable() //在OnEnable中订阅这个回调
{
    SceneView.duringSceneGui += OnSceneFunc; //onSceneFunc为你自己的绘制方法
}

//我们自己的绘制方法
static void OnSceneFunc(SceneView view)
{
    //在这里面实现你想要的绘制效果
}

void OnDisable()
{
    SceneView.duringSceneGui -= OnSceneFunc; //记得取消订阅
}

---

三、Handles常用接口

3.1 手柄类

//位置手柄
public static Vector3 DoPositionHandle(Vector3 position, Quaternion rotation);
public static Vector3 PositionHandle(Vector3 position, Quaternion rotation);

//旋转手柄
public static Quaternion DoRotationHandle(Quaternion rotation, Vector3 position);
public static Quaternion RotationHandle(Quaternion rotation, Vector3 position);

//大小手柄
public static Vector3 DoScaleHandle(Vector3 scale, Vector3 position, Quaternion rotation, float size);
public static Vector3 ScaleHandle(Vector3 scale, Vector3 position, Quaternion rotation, float size);

//变换手柄（可以同时改变位置、旋转、大小的手柄）
public static void TransformHandle(ref Vector3 position, ref Quaternion rotation, ref Vector3 scale);
public static void TransformHandle(ref Vector3 position, ref Quaternion rotation, ref float uniformScale);
public static void TransformHandle(ref Vector3 position, ref Quaternion rotation);

 注：在Unity官方API中已经没有DoPositionHandle、DoRotationHandle、DoScaleHandle这三个接口，但是仍然可以使用，通过查看Unity的C#源码，可以发现PositionHandle也是调用的DoPostionHandle，也就是说二者没有任何区别。

---

3.2 绘制类

//实线
public static void DrawLine(Vector3 p1, Vector3 p2); //实线
public static void DrawLines(Vector3[] lineSegments); //一系列线段

//多边线
public static void DrawPolyLine(params Vector3[] points); //多边线（穿过points列表的线）

//虚线
public static void DrawDottedLine(Vector3 p1, Vector3 p2, float screenSpaceSize); //虚线
public static void DrawDottedLines(Vector3[] lineSegments, float screenSpaceSize); //一系列虚线

//贝塞尔曲线
public static void DrawBezier(Vector3 startPosition, Vector3 endPosition, Vector3 startTangent, Vector3 endTangent, Color color, Texture2D texture, float width);

//扇形
public static void DrawSolidArc(Vector3 center, Vector3 normal, Vector3 from, float angle, float radius);

//圆形
public static void DrawSolidDisc(Vector3 center, Vector3 normal, float radius);

//矩形
public static void DrawSolidRectangleWithOutline(Vector3[] verts, Color faceColor, Color outlineColor);

//标签
public static void Label(Vector3 position, string text);
public static void Label(Vector3 position, Texture image);

//摄像机
public static void DrawCamera(Rect position, Camera camera);

//缩放滑动条
public static float ScaleSlider(float scale, Vector3 position, Vector3 direction, Quaternion rotation, float size, float snap);

---

3.3 绘制2D的UI

public static void BeginGUI(); //在3D的GUI块中开启2D的GUI块
public static void EndGUI(); //结束2D的GUI块

 使用方法：
 只需使用上面的这两个方法开启一个2D的GUI块，在里面使用GUILayout或者EditorGUILayout的组件即可。

---

这里只列表了部分常用的示例，完整的接口可以参考官方API。
官方API：UnityEditor.Handles - Unity 脚本 API (unity3d.com)