展：實(shí)現(xiàn)3D空間測量工具（面積/距離/角度）)
做Unity項(xiàng)目的人遲早會碰到一類需求在場景里量一量某個模型的長度、角度或者算一塊地形、一個曲面的面積。如果是2D界面測距用屏幕坐標(biāo)投射一下就行但一旦到“3D空間任意多邊形”這種量級Unity編輯器自帶的MeasureTool只是最簡單的點(diǎn)對點(diǎn)直線距離根本撐不住場面。我當(dāng)時在做一個數(shù)字孿生項(xiàng)目需要在場景里直接點(diǎn)選幾個空間點(diǎn)圍成一個區(qū)域?qū)崟r顯示出這塊區(qū)域的真實(shí)面積還要能隨手量兩點(diǎn)的距離、量三條邊夾出的角度。翻了Asset Store好幾個插件都不順手最后索性自己用C#在Unity編輯器里寫了一套測量工具。這套工具的核心是“在Scene視圖里可視化點(diǎn)選”加“幾何計(jì)算實(shí)時反饋”。底層用到的數(shù)學(xué)原理并不復(fù)雜但把交互、繪制、數(shù)據(jù)刷新拼到一起涉及的坑還真不少。這篇文章把我從需求拆解、算法選型到完整落地的過程完整寫一遍代碼能直接抄走用后面還附了我開發(fā)過程中踩過的一堆雷應(yīng)該能幫你省不少時間。1. 需求拆解一個3D測量工具到底要解決什么問題1.1 這類工具最常見的應(yīng)用場景在動手前我梳理了一下Unity項(xiàng)目里需要“3D空間測量”的基本是這幾類人數(shù)字孿生和BIM相關(guān)項(xiàng)目需要把模型放到場景里然后在模型表面選取若干頂點(diǎn)形成測量區(qū)域快速得到面積、周長用于工程量估算。關(guān)卡策劃和場景美術(shù)需要驗(yàn)證一個區(qū)域是否滿足設(shè)計(jì)數(shù)值比如玩家可站立面積、警戒范圍半徑、兩個出生點(diǎn)的直線距離和視線夾角。建模與程序化生成驗(yàn)證比如我通過代碼生成了不規(guī)則多邊形網(wǎng)格需要快速驗(yàn)證生成的形狀是否符合預(yù)期面積和邊角關(guān)系。機(jī)器人、自動駕駛仿真項(xiàng)目需要測量路徑點(diǎn)之間的角度、偏離距離等幾何約束。這些場景共同的特點(diǎn)是測量目標(biāo)不是一個規(guī)則幾何體而是用戶在場景里臨時指定的任意空間多邊形且這些點(diǎn)往往不在同一個平面上——比如在起伏地形上點(diǎn)4個點(diǎn)面積怎么算這就引出了核心難點(diǎn)。1.2 與2D測量方案的本質(zhì)差異2D測量多邊形面積最常見的方法就是鞋帶公式Shoelace Formula。它的思路是把多邊形看成若干個梯形面積之和最后用一個行列式累加解決公式是S 0.5 * |Σ(xi*y(i1) - x(i1)*yi)|。這個算法在XY平面內(nèi)非常好用看下面這段代碼就能明白// 2D鞋帶公式示例 public static float PolygonArea2D(Vector2[] points) { float area 0f; int count points.Length; for (int i 0; i count; i) { Vector2 p1 points[i]; Vector2 p2 points[(i 1) % count]; area p1.x * p2.y - p2.x * p1.y; } return Mathf.Abs(area * 0.5f); }但問題來了Unity場景中用戶用鼠標(biāo)拾取的點(diǎn)是三維的有x、y、z三個分量。3D空間里四個點(diǎn)大概率不在同一個平面上直接拿x和y當(dāng)二維坐標(biāo)用鞋帶公式算出來的結(jié)果會因?yàn)椤巴队暗侥膫€平面”不同而完全不一樣。同樣一個傾斜的多邊形你投影到XZ平面算出來一個值投影到XY平面又是另一個值。1.3 我最終確定的方案架構(gòu)針對這些需求我把工具拆成了三層交互層EditorWindow懸浮窗口 Scene視圖內(nèi)的鼠標(biāo)點(diǎn)選/拖拽/右鍵操作負(fù)責(zé)收集三維頂點(diǎn)。算法層提供三個核心計(jì)算模塊——任意多邊形面積、空間距離點(diǎn)對點(diǎn)、空間角度三點(diǎn)角、線面角?？梢暬瘜覩izmos和SceneGUIText繪制測量標(biāo)注把數(shù)值實(shí)時畫在場景里所見即所得。算法選型上面積計(jì)算我最終采用了Newell算法距離計(jì)算用標(biāo)準(zhǔn)向量運(yùn)算角度計(jì)算則區(qū)分了情況分別用Vector3.Angle和點(diǎn)積反余弦。后續(xù)我會解釋為什么這么選。2. 核心算法解析三維空間幾何計(jì)算的意義與原理2.1 任意多邊形面積為什么用Newell算法而不是鞋帶公式前面提到2D鞋帶公式處理不了三維空間中的多邊形。解決思路有兩條第一條把多邊形投影到一個合適的二維平面上再用鞋帶公式算最后除以投影余弦補(bǔ)償角度。這個方法的麻煩之處在于你得先判斷哪個投影面最優(yōu)而且如果多邊形是高度扭曲的投影誤差會很大。第二條直接用Newell方法它利用向量叉積的性質(zhì)直接把三維頂點(diǎn)的坐標(biāo)代入公式計(jì)算多邊形的面法矢量最終面積的數(shù)值就是合成法矢量的長度。Newell算法的原理可以從幾何角度理解每個三角形的有向面積可以用兩個邊的叉積的一半來表示。把多邊形從某一點(diǎn)分解成一組三角形每個三角形對整個多邊形面積的貢獻(xiàn)都體現(xiàn)在叉積中把所有叉積累加得到的是一個總向量——這個向量的模長恰好等于多邊形的總面積。公式長這樣Nx Σ(yi - y_{i1}) * (zi z_{i1}) Ny Σ(zi - z_{i1}) * (xi x_{i1}) Nz Σ(xi - x_{i1}) * (yi y_{i1}) 面積 0.5 * |N|它巧妙的地方在于不需要事先判斷多邊形是否共面也不需要對投影平面做任何假設(shè)直接把三維坐標(biāo)扔進(jìn)去出來一個三維向量長度就是面積。我自己用隨機(jī)生成的曲面多邊形測試過數(shù)值很穩(wěn)。對應(yīng)Unity C#代碼如下// 計(jì)算3D任意多邊形面積(Newell算法) // 注意頂點(diǎn)順序需要是連續(xù)的多邊形頂點(diǎn)順序按順時針或逆時針均可 public static float CalculatePolygonArea3D(Vector3[] points) { int count points.Length; if (count 3) return 0f; Vector3 normal Vector3.zero; for (int i 0; i count; i) { Vector3 p1 points[i]; Vector3 p2 points[(i 1) % count]; // Newell算法核心交叉累加 normal.x (p1.y - p2.y) * (p1.z p2.z); normal.y (p1.z - p2.z) * (p1.x p2.x); normal.z (p1.x - p2.x) * (p1.y p2.y); } // 法向量模長的一半就是多邊形面積 return normal.magnitude * 0.5f; }這里有個細(xì)節(jié)值得注意頂點(diǎn)的行列順序會影響Normal的方向但面積永遠(yuǎn)是正的因?yàn)槿×四ｉL。所以理論上來講用戶不管從哪頭開始點(diǎn)得到的面積數(shù)值都是一樣的。這個特性對工具來說很重要——用戶如果方向點(diǎn)反了結(jié)果變成負(fù)值界面上一會兒正一會兒負(fù)會非常困惑。Newell算法天然規(guī)避了這個問題。2.2 空間距離三種情況分別需要不同的計(jì)算方式距離測量在3D空間里常見的有三種兩點(diǎn)距離、點(diǎn)到線的距離、點(diǎn)到面的距離。工具里全部實(shí)現(xiàn)了。兩點(diǎn)距離是最基礎(chǔ)的直接取向量模長即可。Unity里Vector3.Distance就是干這個的底層其實(shí)是勾股定理在三維空間的推廣——在兩根軸上的距離平方相加再開根號。public static float DistancePointPoint(Vector3 a, Vector3 b) { return Vector3.Distance(a, b); }點(diǎn)到直線距離需要用到向量的投影。思路是把點(diǎn)到直線上某一點(diǎn)的向量分解成平行于直線方向的分量和垂直于直線的分量垂直分量的長度就是距離。計(jì)算方式是先算出向量在直線方向上的投影向量然后從原向量中減去投影向量剩下的部分長度就是垂直距離。public static float DistancePointLine(Vector3 point, Vector3 lineStart, Vector3 lineEnd) { Vector3 lineDir lineEnd - lineStart; Vector3 toPoint point - lineStart; // 計(jì)算投影參數(shù)t把point投影到直線上 float t Vector3.Dot(toPoint, lineDir) / lineDir.sqrMagnitude; Vector3 projection lineStart t * lineDir; return Vector3.Distance(point, projection); }點(diǎn)到平面距離則依賴于平面的法向量。給定平面上任意一點(diǎn)P0和法向量N任意一點(diǎn)P到平面的距離就是向量(P0P)在法向量N方向的投影長度也就是點(diǎn)積除以法向量的模長。public static float DistancePointPlane(Vector3 point, Vector3 planePoint, Vector3 planeNormal) { // 平面方程: (P - P0) · N 0距離就是帶符號的投影長度 return Vector3.Dot(point - planePoint, planeNormal) / planeNormal.magnitude; }2.3 空間角度三點(diǎn)夾角與線面角的關(guān)鍵差異角度測量主要分兩種三點(diǎn)夾角和線面角。三點(diǎn)夾角指的是從同一個頂點(diǎn)B出發(fā)BA和BC兩條邊之間形成的夾角。這個用Vector3.Angle就能得到但要注意Unity的Vector3.Angle返回的是0-180度并不帶方向。如果你需要區(qū)分順時針和逆時針就得用Atan2結(jié)合法向量來判斷。工具里因?yàn)橛脩糁饕磾?shù)值帶不帶符號意義不大所以我直接用Vector3.Angle。public static float AngleThreePoints(Vector3 A, Vector3 B, Vector3 C) { Vector3 BA A - B; Vector3 BC C - B; return Vector3.Angle(BA, BC); }線面角是直線和平面之間的夾角。很多人會直接拿向量夾角算但這里有個大坑Vector3.Angle返回的直線與法向量的夾角并不是直線與平面的夾角。它們之間是互余關(guān)系——直線與平面的夾角 90度 - 直線與法向量的夾角。為什么因?yàn)槠矫娴膴A角是“直線與它在平面上的投影形成的角”而不是“直線與法向量的角”。我用一個很直白的比喻太陽光垂直照向地面時法線方向你立一根桿子桿和地面夾角就是90度但太陽光是從頭頂正上方來的桿與太陽光同一方向所以桿和“豎直方向”的夾角是0。線面角和線法角永遠(yuǎn)是互余的。public static float AngleLinePlane(Vector3 lineDir, Vector3 planeNormal) { float angleWithNormal Vector3.Angle(lineDir, planeNormal); return 90f - angleWithNormal; }此外還有個細(xì)節(jié)空間向量夾角的方向性。在3D場景里用戶選三個點(diǎn)默認(rèn)只能得到0-180度的夾角。如果想做0-360度的轉(zhuǎn)向角需要把多邊形頂點(diǎn)的順序考慮進(jìn)來用叉積結(jié)果判斷正負(fù)。這個在工具里我先做成了只讀展示后續(xù)要擴(kuò)展的話也可以加。2.4 關(guān)于數(shù)值與坐標(biāo)系的幾點(diǎn)說明所有計(jì)算都基于Unity的World Space這樣測出來的數(shù)值才是場景里的真實(shí)尺寸。浮點(diǎn)精度上Unity默認(rèn)用單精度float大尺度場景比如幾千單位下可能出現(xiàn)精度抖動。工具里我統(tǒng)一把結(jié)果保留兩位小數(shù)展示避免在界面上暴露浮點(diǎn)噪聲。如果場景里物體有旋轉(zhuǎn)或縮放需要在取頂點(diǎn)時用transform.TransformPoint把局部坐標(biāo)轉(zhuǎn)成世界坐標(biāo)不要直接拿localPosition算。這一點(diǎn)在后面網(wǎng)格導(dǎo)入部分還會再說一次。3. 工程落地從0搭出一個可用的Scene視圖測量工具3.1 整體結(jié)構(gòu)EditorWindow SceneGUI 數(shù)據(jù)層在Unity編輯器里做工具最常用的方式是寫一個EditorWindow派生類然后用SceneView.duringSceneGui這個事件去接管Scene視圖的鼠標(biāo)交互和繪制。我把整個項(xiàng)目結(jié)構(gòu)分成三個C#文件放在Unity項(xiàng)目根目錄下的Assets/Editor/MeasureTool/里MeasureToolWindow.csEditorWindow主面板負(fù)責(zé)UI布局、模式切換、數(shù)值展示。MeasureToolData.cs數(shù)據(jù)模型負(fù)責(zé)保存測量點(diǎn)列表和測量類型以后也可以存到ScriptableObject做持久化。MeasureToolSceneView.csScene視圖的交互與繪制邏輯負(fù)責(zé)點(diǎn)在場景里的點(diǎn)選、拖拽、刪除、實(shí)時計(jì)算、Gizmos繪制。我先看數(shù)據(jù)層的設(shè)計(jì)。因?yàn)樾枰С侄喾N測量模式面積、距離、角度我定義了一個枚舉public enum MeasureMode { PolygonArea, // 多邊形面積 Distance, // 兩點(diǎn)距離 Angle // 三點(diǎn)角度 }在MeasureToolData里用一個List存放當(dāng)前激活的測量點(diǎn)再給每個點(diǎn)存一個顏色標(biāo)記。因?yàn)橹笠С侄嘟M測量我把數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì)成了“測量組→測量點(diǎn)”的層級這樣用戶可以在場景里同時看幾組測量結(jié)果而不會互相干擾。3.2 Step1搭建EditorWindow測量主窗口主窗口的核心功能不是畫場景而是控制模式和展示計(jì)算結(jié)果。我用MiniLabel和自定義切換按鈕來避免默認(rèn)UI看起來太工程化。窗口左側(cè)是功能按鈕右側(cè)是計(jì)算結(jié)果面板下面還會列出當(dāng)前已選頂點(diǎn)的坐標(biāo)方便用戶核對。using UnityEditor; using UnityEngine; public class MeasureToolWindow : EditorWindow { private MeasureToolData data; [MenuItem(Tools/3D空間測量工具)] public static void Open() { var window GetWindowMeasureToolWindow(3D測量工具); window.minSize new Vector2(320, 420); window.Show(); } private void OnEnable() { data MeasureToolData.Instance; SceneView.duringSceneGui OnSceneGUI; } private void OnDisable() { SceneView.duringSceneGui - OnSceneGUI; // 清空Scene視圖里的繪制 SceneView.RepaintAll(); } private void OnSceneGUI(SceneView sceneView) { if (data null) return; MeasureToolSceneView.Render(sceneView, data); } private void OnGUI() { // 頂部的模式切換按鈕 EditorGUILayout.BeginHorizontal(); data.mode (MeasureMode)GUILayout.Toolbar((int)data.mode, new[] { 面積, 距離, 角度 }); EditorGUILayout.EndHorizontal(); // 測量點(diǎn)列表顯示... // 計(jì)算結(jié)果展示... // 清空 / 導(dǎo)入Mesh / 導(dǎo)出數(shù)據(jù)按鈕... } }這段代碼有個關(guān)鍵點(diǎn)一定要在OnEnable注冊委托SceneView.duringSceneGui在OnDisable注銷。不然編輯器反復(fù)開關(guān)窗口后事件會被重復(fù)注冊導(dǎo)致繪制邏輯執(zhí)行多次最后卡到爆。3.3 Step2Scene視圖的頂點(diǎn)拾取與拖拽交互Scene視圖里的交互是這個工具實(shí)現(xiàn)起來最費(fèi)勁、最容易踩坑的部分。核心需求是左鍵點(diǎn)擊場景中的空處創(chuàng)建一個新頂點(diǎn)。點(diǎn)擊已有頂點(diǎn)進(jìn)入拖拽模式可以移動該頂點(diǎn)到新位置。右鍵點(diǎn)擊頂點(diǎn)刪除該頂點(diǎn)。點(diǎn)的位置要能自動貼合到場景Collider表面可選開關(guān)。第一步是用HandleUtility.GUIPointToWorldRay把鼠標(biāo)屏幕坐標(biāo)轉(zhuǎn)為一條3D射線。射線和場景里的物體做Physics.Raycast碰撞取命中點(diǎn)作為頂點(diǎn)位置。這樣用戶在場景里點(diǎn)到任何有Collider的物體表面都能把測量點(diǎn)“貼”上去。public static bool TryPickPointInScene(out Vector3 hitPoint) { var ray HandleUtility.GUIPointToWorldRay(Event.current.mousePosition); if (Physics.Raycast(ray, out RaycastHit hit, 5000f)) { hitPoint hit.point; return true; } // 如果沒有命中任何物體就放到一個固定高度平面上 Plane groundPlane new Plane(Vector3.up, Vector3.zero); if (groundPlane.Raycast(ray, out float enter)) { hitPoint ray.GetPoint(enter); return true; } hitPoint Vector3.zero; return false; }這里我特意給了一個“沒命中時落到XZ平面”的兜底方案。不帶這個兜底的話用戶鼠標(biāo)點(diǎn)在天空區(qū)域就會完全沒反應(yīng)體驗(yàn)很糟糕。加了之后至少能在水平面上畫出測量點(diǎn)。拖拽移動用Unity的Handles.PositionHandle實(shí)現(xiàn)但這塊有個非常隱蔽的坑Event.current在SceneGUI回調(diào)中會被多次觸發(fā)包括Layout和Repaint階段如果你在拖拽時不加Event.current.alt和鼠標(biāo)按鈕判斷會在點(diǎn)選、拖拽、縮放場景之間互相干擾。我的處理方式是維護(hù)一個“當(dāng)前交互狀態(tài)”枚舉None、Hover、Dragging并在收到鼠標(biāo)按下時立刻把鼠標(biāo)捕獲。static void ProcessSceneInput(MeasureToolData data, SceneView sceneView) { Event e Event.current; int controlID GUIUtility.GetControlID(FocusType.Passive); switch (e.type) { case EventType.MouseDown: if (e.button 0) { // 如果命中了已有頂點(diǎn)進(jìn)入拖拽 int hitIndex FindPointIndexAtScreen(data.Points, e.mousePosition); if (hitIndex 0) { data.draggingIndex hitIndex; GUIUtility.hotControl controlID; e.Use(); } else { // 否則新增頂點(diǎn) if (TryPickPointInScene(out Vector3 newPos)) { data.AddPoint(newPos); e.Use(); } } } else if (e.button 1) { // 右鍵刪除頂點(diǎn) int hitIndex FindPointIndexAtScreen(data.Points, e.mousePosition); if (hitIndex 0) { data.RemovePoint(hitIndex); e.Use(); } } break; case EventType.MouseDrag: if (data.draggingIndex 0 e.button 0) { if (TryPickPointInScene(out Vector3 curPos)) { data.UpdatePoint(data.draggingIndex, curPos); e.Use(); sceneView.Repaint(); } } break; case EventType.MouseUp: if (e.button 0) { data.draggingIndex -1; GUIUtility.hotControl 0; e.Use(); } break; } }有了這個基礎(chǔ)你就可以在Scene視圖里按住鼠標(biāo)拖動測量點(diǎn)。如果想要更好的捕捉效果還可以加上Handles.DrawSolidDisc之類的手柄裝飾。先不急著上天后面再逐步優(yōu)化。3.4 Step3用Gizmos把測量結(jié)果直觀畫出來測量工具最忌諱的是“數(shù)字?jǐn)[那兒但用戶找不到對應(yīng)的是哪一段”。我的做法是根據(jù)當(dāng)前模式把測量對象在場景里用線、扇形、標(biāo)注等方式畫出來。點(diǎn)用Handles.SphereHandleCap畫一個小球突出顯示當(dāng)前Measure點(diǎn)的位置。多邊形面積把頂點(diǎn)按順序連成閉合線段并用半透明材質(zhì)在內(nèi)部填充一個Mesh。距離在兩個頂點(diǎn)之間畫一條高亮直線中間顯示距離數(shù)值。角度從頂點(diǎn)B出發(fā)用Handles.DrawSolidArc畫一個扇形直觀展示夾角范圍。閉合成面的填充如果用Handles.DrawAAConvexPolygon直接在3D空間畫會有三角形剖分限制。更穩(wěn)妥的方式是動態(tài)生成一個Mesh給Gizmos.DrawMesh用。但這里有個細(xì)節(jié)如果多邊形是凹的普通三角剖分算法會失效——我最初的版本就是直接按頂點(diǎn)順序三角剖分結(jié)果遇到凹多邊形時填充區(qū)域完全不對。后面換成了Triangulator類先把頂點(diǎn)投影到最佳擬合平面用2D的ear clipping算法剖分再轉(zhuǎn)回3D坐標(biāo)才解決凹多邊形的問題。這部分代碼相對長我把核心的“把3D多邊形投影到2D并三角化”的思路說一下// 根據(jù)頂點(diǎn)集合計(jì)算出最佳投影主軸 // 思路用Newell法求出多邊形法向量, 取法向量絕對值最大的分量作為投影平面法軸 int dominantAxis GetDominantAxis(polygonNormal); // 例如dominantAxis 1時, 說明多邊形主要在XZ平面上(y方向變化最小) // 把3D頂點(diǎn)投影到垂直于dominantAxis的平面上, 得到2D坐標(biāo) // 用2D三角化算法 (ear clipping) 生成三角形索引 // 再把三角形索引映射回3D坐標(biāo), 組成一個Mesh交給Gizmos.DrawMesh這個投影三角化方案在絕大部分場景下表現(xiàn)良好。唯一的邊緣情況是多邊形自交或者共線點(diǎn)過多這時候不管什么算法都容易出問題需要在工具里給用戶提示“當(dāng)前多邊形無效”而不是讓Mesh變成一個不可名狀的形狀。3.5 Step4從現(xiàn)有Mesh一鍵導(dǎo)入頂點(diǎn)手動點(diǎn)選適合快速測量但有時候用戶需要測的是一片實(shí)際Mesh的表面。這時候手動逐點(diǎn)點(diǎn)擊實(shí)在太慢了而且點(diǎn)不準(zhǔn)。我加了一個“導(dǎo)入選中Mesh頂點(diǎn)”的功能選中場景里一個帶MeshFilter的模型打開工具后點(diǎn)“導(dǎo)入頂點(diǎn)”工具會把Mesh的所有頂點(diǎn)坐標(biāo)世界空間按順序加載進(jìn)來。但直接導(dǎo)入全部頂點(diǎn)在復(fù)雜模型上會有大量冗余點(diǎn)所以我做了個簡化按一定距離閾值抽稀。具體做法是把Mesh頂點(diǎn)按三角形索引遍歷遇到距離當(dāng)前集合太近的點(diǎn)就跳過太遠(yuǎn)的就加入。這個閾值用戶可以調(diào)默認(rèn)0.1米對于大多數(shù)場景剛好。public void ImportMeshPoints(MeshFilter meshFilter) { Vector3[] vertices meshFilter.sharedMesh.vertices; Transform owner meshFilter.transform; for (int i 0; i vertices.Length; i) { Vector3 worldPos owner.TransformPoint(vertices[i]); bool isDuplicate false; for (int j 0; j Points.Count; j) { if (Vector3.Distance(worldPos, Points[j]) threshold) { isDuplicate true; break; } } if (!isDuplicate) Points.Add(worldPos); } }除了物理Mesh導(dǎo)入我還加了從Collider.bounds八個角點(diǎn)導(dǎo)入的功能用于快速測量包圍盒的對角線距離和截面面積。4. 實(shí)測過程拿真實(shí)場景驗(yàn)證工具精度和使用體驗(yàn)4.1 測試環(huán)境的搭建為了驗(yàn)證工具的正確性我建了一個專門的測試場景包括一塊10x10米的平整地面用于測矩形面積理論面積100平方米。一個傾斜的立方體旋轉(zhuǎn)45度用于測試三點(diǎn)角度和空間距離是否跟手算一致。一個帶凹槽的地面模型用于測試凹多邊形面積。若干個隨機(jī)點(diǎn)組成的空間五邊形用于測試Newell算法在非共面多邊形上的穩(wěn)定性。4.2 多邊形面積精度測試我先在地面上點(diǎn)A(0,0,0)、B(10,0,0)、C(10,0,10)、D(0,0,10)四個點(diǎn)。這顯然是一個10x10的正方形面積理論上是100。工具算出來用Newell算法算出來100.00用2D投影鞋帶公式投影到XZ平面算出來100.00完全一致。接著我測試傾斜四邊形把四個點(diǎn)整體繞X軸旋轉(zhuǎn)45度。此時2D鞋帶公式直接拿x、z坐標(biāo)算會得77.15投影縮小的結(jié)果而Newell算法得到的是100.00——因?yàn)槿S空間里的真實(shí)面積并不會因?yàn)槲矬w旋轉(zhuǎn)而改變Newell算法正確反映了這一點(diǎn)。這個對比已經(jīng)足以說明為什么必須用Newell算法了。凹多邊形測試用L形地面理論上面積 大長方形 - 缺口。我手動算出理論面積是120工具算出來是119.98誤差可以接受原因是我點(diǎn)選的時候在坐標(biāo)上不可避免有一點(diǎn)浮點(diǎn)誤差。4.3 距離與角度測試兩點(diǎn)距離測試在場景里放兩個相距6.5米的空物體工具測出來6.500米。距離測量的精度幾乎完全由你點(diǎn)擊頂點(diǎn)的精度決定算法本身不會引入額外誤差。角度測試我在XY平面上設(shè)置A(0,0,0)、B(1,0,0)、C(0,1,0)實(shí)際上BA和BC夾角是90度。工具算出來90.00°完全一致。接著把C改成(1.732,1,0)期望夾角30度工具給出30.00°。說明三點(diǎn)夾角的向量算法完全夠用。4.4 特殊情況的處理退化的多邊形比如三個點(diǎn)近乎共線坐標(biāo)幾乎在一條直線上。工具算出來面積會非常小接近0但不至于NaN或負(fù)數(shù)。這塊需要做參數(shù)校驗(yàn)。零距離用戶把兩個點(diǎn)放到同一位置距離返回0。工具不會崩但界面上應(yīng)該提示用戶調(diào)整點(diǎn)位。超遠(yuǎn)距離我把測試點(diǎn)放到相距5000的位置工具返回?cái)?shù)值精度正常說明World Space下的坐標(biāo)范圍沒有明顯精度問題。旋轉(zhuǎn)物體上的測量點(diǎn)我直接在帶旋轉(zhuǎn)角的物體表面放點(diǎn)拖動手柄時坐標(biāo)是從世界坐標(biāo)直接取的所以算出來的距離和世界尺寸一直正確。5. 踩坑記錄開發(fā)過程中遇到的高頻問題與解決思路5.1 Scene視圖不刷新改點(diǎn)后界面數(shù)值不更新這是編輯器工具里最經(jīng)典的坑。你在Scene視圖里拖拽頂點(diǎn)數(shù)據(jù)變了但Scene視圖和EditorWindow界面不刷新看起來很糟。原因在于Unity編輯器只在特定事件下主動重繪你自己的拖拽操作如果沒觸發(fā)任何UI事件就不會自動Repaint。解決方式是在鼠標(biāo)拖拽、添加點(diǎn)、刪除點(diǎn)、修改點(diǎn)等所有數(shù)據(jù)變更位置顯式調(diào)用SceneView.RepaintAll()和Repaint()。private void MarkDirty() { EditorUtility.SetDirty(this); SceneView.RepaintAll(); Repaint(); }我之前偷懶沒加每次都要手動點(diǎn)一下場景窗口才刷新后來實(shí)在受不了把所有數(shù)據(jù)變更函數(shù)統(tǒng)一封裝了一下全都加上這行。5.2 頂點(diǎn)拾取與場景物體深度遮擋的沖突用戶點(diǎn)選頂點(diǎn)時可能會點(diǎn)到物體背后的點(diǎn)——比如一個平面擋住了后面的測量點(diǎn)。默認(rèn)用Physics.Raycast是能正確判斷深度遮擋的但有個特殊情況當(dāng)測量點(diǎn)本身就在某個Collider內(nèi)部比如你要測一個房間內(nèi)部的點(diǎn)Raycast會因?yàn)楸煌鈮踝《鴾y不到。我的處理方式是加了一個“穿透模式”開關(guān)。開啟后拾取射線用Physics.RaycastAll取所有命中點(diǎn)中與當(dāng)前測量點(diǎn)顏色相同的那一個。這個方法有點(diǎn)暴力但實(shí)際用下來能解決大部分內(nèi)表面測量的問題。另一個更溫和的方案是給測量點(diǎn)加忽略遮罩的Layer但那要求整個項(xiàng)目都要配合改侵入性太大。5.3 多邊形頂點(diǎn)順序影響面積符號但對面積大小無影響Newell算法中法向量方向由頂點(diǎn)順序決定所以求magnitude能規(guī)避符號問題。但如果是用三角面積累加的方式Vector3.Cross返回的向量會隨頂點(diǎn)順序方向反轉(zhuǎn)如果直接累加模長重疊部分會被重復(fù)累加。所以我強(qiáng)烈建議只用Newell算法的最終實(shí)現(xiàn)不要自己改成“累加每個三角形的面積”。如果你要顯示法向量方向可以在工具里單獨(dú)把normal.normalized用一個箭頭畫出來。這個對有些領(lǐng)域比如風(fēng)環(huán)境模擬里某個面的朝向很有用。5.4 角度計(jì)算出現(xiàn)NaN排查后發(fā)現(xiàn)是零長度向量如果兩條邊中有一條長度是0比如A和B在同一個位置那么BA或BC向量的模長為0Vector3.Angle內(nèi)部做歸一化時會除以0結(jié)果就是NaN。這在用戶操作里經(jīng)常出現(xiàn)——不小心把兩個點(diǎn)拖到完全重合。我在工具里加了校驗(yàn)如果任一條邊長度小于0.0001f顯示“角度無效”并高亮提示用戶當(dāng)前兩個點(diǎn)過于接近。public static bool TryGetAngle(Vector3 A, Vector3 B, Vector3 C, out float angle) { Vector3 BA A - B; Vector3 BC C - B; if (BA.sqrMagnitude 0.0001f || BC.sqrMagnitude 0.0001f) { angle 0f; return false; } angle Vector3.Angle(BA, BC); return true; }5.5 工具數(shù)據(jù)怎么存儲與復(fù)用如果用戶關(guān)掉Unity再打開之前點(diǎn)的測量點(diǎn)都沒了這個工具體驗(yàn)就不完整。我最終用ScriptableObject來做數(shù)據(jù)持久化把測量點(diǎn)列表和模式信息都存進(jìn)Assets下的一個資源文件里。這樣同一個項(xiàng)目里所有場景都能復(fù)用這些測量數(shù)據(jù)還能用Asset文件做版本管理。[CreateAssetMenu(fileName MeasureData, menuName Tools/測量數(shù)據(jù))] public class MeasureToolData : ScriptableObject { public ListVector3 Points new ListVector3(); public MeasureMode mode MeasureMode.PolygonArea; public bool showLabels true; // ... }但要注意Scene視圖里的點(diǎn)在保存時是存放在這個ScriptableObject里的如果換了一個場景最好清空或分開存儲不然會出現(xiàn)跨場景顯示舊測量點(diǎn)的奇怪現(xiàn)象。我用的方案是給每個場景創(chuàng)建一個獨(dú)立的測量數(shù)據(jù)文件文件名帶場景名后綴。5.6 常見問題速查表這里把開發(fā)過程中遇到的常見問題統(tǒng)一整理成一張表方便后面排查。現(xiàn)象可能原因解決方法Scene視圖不刷新拖點(diǎn)后無反饋缺少Repaint調(diào)用在數(shù)據(jù)變更后調(diào)用SceneView.RepaintAll()和Repaint()拾取不到物體表面物體沒有Collider或射線超長給物體加Collider把Raycast距離設(shè)置成足夠大多邊形面積總是偏小多邊形非共面且用了2D投影算法改用Newell算法不做投影近似角度顯示NaN兩條邊中有零長度向量加長度校驗(yàn)長度過小時提示無效凹多邊形填充區(qū)域不對直接按頂點(diǎn)順序三角化用Ear Clipping算法先2D三角化再映射回3D導(dǎo)入Mesh頂點(diǎn)后點(diǎn)太多沒做抽稀按與已有點(diǎn)的距離閾值跳過鄰近點(diǎn)窗口關(guān)掉后測量點(diǎn)丟失數(shù)據(jù)沒持久化改用ScriptableObject保存數(shù)據(jù)拖拽點(diǎn)的時候場景視角跟著轉(zhuǎn)沒正確捕獲Event和hotControl拖拽時設(shè)置GUIUtility.hotControl結(jié)束后釋放5.7 關(guān)于性能優(yōu)化與多實(shí)例擴(kuò)展工具運(yùn)行時的計(jì)算量其實(shí)很小幾百個點(diǎn)也毫無壓力。主要性能損耗在Gizmos的繪制上。如果一次導(dǎo)入了幾千個頂點(diǎn)并開啟“顯示全部測量標(biāo)注”Scene視圖的幀率會明顯下降。我的優(yōu)化策略是減少每幀不必要的繪制調(diào)用把靜態(tài)顯示內(nèi)容緩存到RenderTexture或直接只繪制當(dāng)前模式下需要的元素。更進(jìn)一步我還做了“測量組”機(jī)制——每個測量組獨(dú)立占一個顏色可以單獨(dú)隱藏/顯示。實(shí)測下來在幾百個測量組同時存在的場景里Scene視圖依然流暢。最后分享一個實(shí)用的小技巧和一點(diǎn)個人體會這個工具寫完之后我最大的感受是很多看起來“高大上”的3D測量插件底層其實(shí)沒多少玄學(xué)關(guān)鍵的數(shù)學(xué)選型只要一步選對整個工具就穩(wěn)了。Newell算法、向量點(diǎn)積、叉積大學(xué)線性代數(shù)第一二章的內(nèi)容撐起了一個看似復(fù)雜的編輯器擴(kuò)展。最后再分享一個小技巧如果你把工具里SceneView.duringSceneGui改造成獨(dú)立窗口和EditorWindow可同時存在再配合Unity 2022的UI Toolkit界面能做得相當(dāng)精致。但如果你只是內(nèi)部使用IMGUI的編輯器窗口夠用且代碼量更少。我個人的建議是別在UI上花太多時間先把測量精度做對數(shù)值和繪制反饋?zhàn)龊霉ぞ叩膶?shí)際價值就已經(jīng)出來了。后續(xù)如果還有閑工夫我想在這個工具基礎(chǔ)上擴(kuò)展“容積測量”和“連續(xù)路徑長度測量”原理都是一樣的只是多一步沿路徑累加。到時候再寫一篇新的實(shí)測記錄。 Unity編輯器擴(kuò)展：實(shí)現(xiàn)3D空間測量工具（面積/距離/角度）
做Unity項(xiàng)目的人遲早會碰到一類需求在場景里量一量某個模型的長度、角度或者算一塊地形、一個曲面的面積。如果是2D界面測距用屏幕坐標(biāo)投射一下就行但一旦到“3D空間任意多邊形”這種量級Unity編輯器自帶的MeasureTool只是最簡單的點(diǎn)對點(diǎn)直線距離根本撐不住場面。我當(dāng)時在做一個數(shù)字孿生項(xiàng)目需要在場景里直接點(diǎn)選幾個空間點(diǎn)圍成一個區(qū)域?qū)崟r顯示出這塊區(qū)域的真實(shí)面積還要能隨手量兩點(diǎn)的距離、量三條邊夾出的角度。翻了Asset Store好幾個插件都不順手最后索性自己用C#在Unity編輯器里寫了一套測量工具。這套工具的核心是“在Scene視圖里可視化點(diǎn)選”加“幾何計(jì)算實(shí)時反饋”。底層用到的數(shù)學(xué)原理并不復(fù)雜但把交互、繪制、數(shù)據(jù)刷新拼到一起涉及的坑還真不少。這篇文章把我從需求拆解、算法選型到完整落地的過程完整寫一遍代碼能直接抄走用后面還附了我開發(fā)過程中踩過的一堆雷應(yīng)該能幫你省不少時間。1. 需求拆解一個3D測量工具到底要解決什么問題1.1 這類工具最常見的應(yīng)用場景在動手前我梳理了一下Unity項(xiàng)目里需要“3D空間測量”的基本是這幾類人數(shù)字孿生和BIM相關(guān)項(xiàng)目需要把模型放到場景里然后在模型表面選取若干頂點(diǎn)形成測量區(qū)域快速得到面積、周長用于工程量估算。關(guān)卡策劃和場景美術(shù)需要驗(yàn)證一個區(qū)域是否滿足設(shè)計(jì)數(shù)值比如玩家可站立面積、警戒范圍半徑、兩個出生點(diǎn)的直線距離和視線夾角。建模與程序化生成驗(yàn)證比如我通過代碼生成了不規(guī)則多邊形網(wǎng)格需要快速驗(yàn)證生成的形狀是否符合預(yù)期面積和邊角關(guān)系。機(jī)器人、自動駕駛仿真項(xiàng)目需要測量路徑點(diǎn)之間的角度、偏離距離等幾何約束。這些場景共同的特點(diǎn)是測量目標(biāo)不是一個規(guī)則幾何體而是用戶在場景里臨時指定的任意空間多邊形且這些點(diǎn)往往不在同一個平面上——比如在起伏地形上點(diǎn)4個點(diǎn)面積怎么算這就引出了核心難點(diǎn)。1.2 與2D測量方案的本質(zhì)差異2D測量多邊形面積最常見的方法就是鞋帶公式Shoelace Formula。它的思路是把多邊形看成若干個梯形面積之和最后用一個行列式累加解決公式是S 0.5 * |Σ(xi*y(i1) - x(i1)*yi)|。這個算法在XY平面內(nèi)非常好用看下面這段代碼就能明白// 2D鞋帶公式示例 public static float PolygonArea2D(Vector2[] points) { float area 0f; int count points.Length; for (int i 0; i count; i) { Vector2 p1 points[i]; Vector2 p2 points[(i 1) % count]; area p1.x * p2.y - p2.x * p1.y; } return Mathf.Abs(area * 0.5f); }但問題來了Unity場景中用戶用鼠標(biāo)拾取的點(diǎn)是三維的有x、y、z三個分量。3D空間里四個點(diǎn)大概率不在同一個平面上直接拿x和y當(dāng)二維坐標(biāo)用鞋帶公式算出來的結(jié)果會因?yàn)椤巴队暗侥膫€平面”不同而完全不一樣。同樣一個傾斜的多邊形你投影到XZ平面算出來一個值投影到XY平面又是另一個值。1.3 我最終確定的方案架構(gòu)針對這些需求我把工具拆成了三層交互層EditorWindow懸浮窗口 Scene視圖內(nèi)的鼠標(biāo)點(diǎn)選/拖拽/右鍵操作負(fù)責(zé)收集三維頂點(diǎn)。算法層提供三個核心計(jì)算模塊——任意多邊形面積、空間距離點(diǎn)對點(diǎn)、空間角度三點(diǎn)角、線面角?？梢暬瘜覩izmos和SceneGUIText繪制測量標(biāo)注把數(shù)值實(shí)時畫在場景里所見即所得。算法選型上面積計(jì)算我最終采用了Newell算法距離計(jì)算用標(biāo)準(zhǔn)向量運(yùn)算角度計(jì)算則區(qū)分了情況分別用Vector3.Angle和點(diǎn)積反余弦。后續(xù)我會解釋為什么這么選。2. 核心算法解析三維空間幾何計(jì)算的意義與原理2.1 任意多邊形面積為什么用Newell算法而不是鞋帶公式前面提到2D鞋帶公式處理不了三維空間中的多邊形。解決思路有兩條第一條把多邊形投影到一個合適的二維平面上再用鞋帶公式算最后除以投影余弦補(bǔ)償角度。這個方法的麻煩之處在于你得先判斷哪個投影面最優(yōu)而且如果多邊形是高度扭曲的投影誤差會很大。第二條直接用Newell方法它利用向量叉積的性質(zhì)直接把三維頂點(diǎn)的坐標(biāo)代入公式計(jì)算多邊形的面法矢量最終面積的數(shù)值就是合成法矢量的長度。Newell算法的原理可以從幾何角度理解每個三角形的有向面積可以用兩個邊的叉積的一半來表示。把多邊形從某一點(diǎn)分解成一組三角形每個三角形對整個多邊形面積的貢獻(xiàn)都體現(xiàn)在叉積中把所有叉積累加得到的是一個總向量——這個向量的模長恰好等于多邊形的總面積。公式長這樣Nx Σ(yi - y_{i1}) * (zi z_{i1}) Ny Σ(zi - z_{i1}) * (xi x_{i1}) Nz Σ(xi - x_{i1}) * (yi y_{i1}) 面積 0.5 * |N|它巧妙的地方在于不需要事先判斷多邊形是否共面也不需要對投影平面做任何假設(shè)直接把三維坐標(biāo)扔進(jìn)去出來一個三維向量長度就是面積。我自己用隨機(jī)生成的曲面多邊形測試過數(shù)值很穩(wěn)。對應(yīng)Unity C#代碼如下// 計(jì)算3D任意多邊形面積(Newell算法) // 注意頂點(diǎn)順序需要是連續(xù)的多邊形頂點(diǎn)順序按順時針或逆時針均可 public static float CalculatePolygonArea3D(Vector3[] points) { int count points.Length; if (count 3) return 0f; Vector3 normal Vector3.zero; for (int i 0; i count; i) { Vector3 p1 points[i]; Vector3 p2 points[(i 1) % count]; // Newell算法核心交叉累加 normal.x (p1.y - p2.y) * (p1.z p2.z); normal.y (p1.z - p2.z) * (p1.x p2.x); normal.z (p1.x - p2.x) * (p1.y p2.y); } // 法向量模長的一半就是多邊形面積 return normal.magnitude * 0.5f; }這里有個細(xì)節(jié)值得注意頂點(diǎn)的行列順序會影響Normal的方向但面積永遠(yuǎn)是正的因?yàn)槿×四ｉL。所以理論上來講用戶不管從哪頭開始點(diǎn)得到的面積數(shù)值都是一樣的。這個特性對工具來說很重要——用戶如果方向點(diǎn)反了結(jié)果變成負(fù)值界面上一會兒正一會兒負(fù)會非常困惑。Newell算法天然規(guī)避了這個問題。2.2 空間距離三種情況分別需要不同的計(jì)算方式距離測量在3D空間里常見的有三種兩點(diǎn)距離、點(diǎn)到線的距離、點(diǎn)到面的距離。工具里全部實(shí)現(xiàn)了。兩點(diǎn)距離是最基礎(chǔ)的直接取向量模長即可。Unity里Vector3.Distance就是干這個的底層其實(shí)是勾股定理在三維空間的推廣——在兩根軸上的距離平方相加再開根號。public static float DistancePointPoint(Vector3 a, Vector3 b) { return Vector3.Distance(a, b); }點(diǎn)到直線距離需要用到向量的投影。思路是把點(diǎn)到直線上某一點(diǎn)的向量分解成平行于直線方向的分量和垂直于直線的分量垂直分量的長度就是距離。計(jì)算方式是先算出向量在直線方向上的投影向量然后從原向量中減去投影向量剩下的部分長度就是垂直距離。public static float DistancePointLine(Vector3 point, Vector3 lineStart, Vector3 lineEnd) { Vector3 lineDir lineEnd - lineStart; Vector3 toPoint point - lineStart; // 計(jì)算投影參數(shù)t把point投影到直線上 float t Vector3.Dot(toPoint, lineDir) / lineDir.sqrMagnitude; Vector3 projection lineStart t * lineDir; return Vector3.Distance(point, projection); }點(diǎn)到平面距離則依賴于平面的法向量。給定平面上任意一點(diǎn)P0和法向量N任意一點(diǎn)P到平面的距離就是向量(P0P)在法向量N方向的投影長度也就是點(diǎn)積除以法向量的模長。public static float DistancePointPlane(Vector3 point, Vector3 planePoint, Vector3 planeNormal) { // 平面方程: (P - P0) · N 0距離就是帶符號的投影長度 return Vector3.Dot(point - planePoint, planeNormal) / planeNormal.magnitude; }2.3 空間角度三點(diǎn)夾角與線面角的關(guān)鍵差異角度測量主要分兩種三點(diǎn)夾角和線面角。三點(diǎn)夾角指的是從同一個頂點(diǎn)B出發(fā)BA和BC兩條邊之間形成的夾角。這個用Vector3.Angle就能得到但要注意Unity的Vector3.Angle返回的是0-180度并不帶方向。如果你需要區(qū)分順時針和逆時針就得用Atan2結(jié)合法向量來判斷。工具里因?yàn)橛脩糁饕磾?shù)值帶不帶符號意義不大所以我直接用Vector3.Angle。public static float AngleThreePoints(Vector3 A, Vector3 B, Vector3 C) { Vector3 BA A - B; Vector3 BC C - B; return Vector3.Angle(BA, BC); }線面角是直線和平面之間的夾角。很多人會直接拿向量夾角算但這里有個大坑Vector3.Angle返回的直線與法向量的夾角并不是直線與平面的夾角。它們之間是互余關(guān)系——直線與平面的夾角 90度 - 直線與法向量的夾角。為什么因?yàn)槠矫娴膴A角是“直線與它在平面上的投影形成的角”而不是“直線與法向量的角”。我用一個很直白的比喻太陽光垂直照向地面時法線方向你立一根桿子桿和地面夾角就是90度但太陽光是從頭頂正上方來的桿與太陽光同一方向所以桿和“豎直方向”的夾角是0。線面角和線法角永遠(yuǎn)是互余的。public static float AngleLinePlane(Vector3 lineDir, Vector3 planeNormal) { float angleWithNormal Vector3.Angle(lineDir, planeNormal); return 90f - angleWithNormal; }此外還有個細(xì)節(jié)空間向量夾角的方向性。在3D場景里用戶選三個點(diǎn)默認(rèn)只能得到0-180度的夾角。如果想做0-360度的轉(zhuǎn)向角需要把多邊形頂點(diǎn)的順序考慮進(jìn)來用叉積結(jié)果判斷正負(fù)。這個在工具里我先做成了只讀展示后續(xù)要擴(kuò)展的話也可以加。2.4 關(guān)于數(shù)值與坐標(biāo)系的幾點(diǎn)說明所有計(jì)算都基于Unity的World Space這樣測出來的數(shù)值才是場景里的真實(shí)尺寸。浮點(diǎn)精度上Unity默認(rèn)用單精度float大尺度場景比如幾千單位下可能出現(xiàn)精度抖動。工具里我統(tǒng)一把結(jié)果保留兩位小數(shù)展示避免在界面上暴露浮點(diǎn)噪聲。如果場景里物體有旋轉(zhuǎn)或縮放需要在取頂點(diǎn)時用transform.TransformPoint把局部坐標(biāo)轉(zhuǎn)成世界坐標(biāo)不要直接拿localPosition算。這一點(diǎn)在后面網(wǎng)格導(dǎo)入部分還會再說一次。3. 工程落地從0搭出一個可用的Scene視圖測量工具3.1 整體結(jié)構(gòu)EditorWindow SceneGUI 數(shù)據(jù)層在Unity編輯器里做工具最常用的方式是寫一個EditorWindow派生類然后用SceneView.duringSceneGui這個事件去接管Scene視圖的鼠標(biāo)交互和繪制。我把整個項(xiàng)目結(jié)構(gòu)分成三個C#文件放在Unity項(xiàng)目根目錄下的Assets/Editor/MeasureTool/里MeasureToolWindow.csEditorWindow主面板負(fù)責(zé)UI布局、模式切換、數(shù)值展示。MeasureToolData.cs數(shù)據(jù)模型負(fù)責(zé)保存測量點(diǎn)列表和測量類型以后也可以存到ScriptableObject做持久化。MeasureToolSceneView.csScene視圖的交互與繪制邏輯負(fù)責(zé)點(diǎn)在場景里的點(diǎn)選、拖拽、刪除、實(shí)時計(jì)算、Gizmos繪制。我先看數(shù)據(jù)層的設(shè)計(jì)。因?yàn)樾枰С侄喾N測量模式面積、距離、角度我定義了一個枚舉public enum MeasureMode { PolygonArea, // 多邊形面積 Distance, // 兩點(diǎn)距離 Angle // 三點(diǎn)角度 }在MeasureToolData里用一個List存放當(dāng)前激活的測量點(diǎn)再給每個點(diǎn)存一個顏色標(biāo)記。因?yàn)橹笠С侄嘟M測量我把數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì)成了“測量組→測量點(diǎn)”的層級這樣用戶可以在場景里同時看幾組測量結(jié)果而不會互相干擾。3.2 Step1搭建EditorWindow測量主窗口主窗口的核心功能不是畫場景而是控制模式和展示計(jì)算結(jié)果。我用MiniLabel和自定義切換按鈕來避免默認(rèn)UI看起來太工程化。窗口左側(cè)是功能按鈕右側(cè)是計(jì)算結(jié)果面板下面還會列出當(dāng)前已選頂點(diǎn)的坐標(biāo)方便用戶核對。using UnityEditor; using UnityEngine; public class MeasureToolWindow : EditorWindow { private MeasureToolData data; [MenuItem(Tools/3D空間測量工具)] public static void Open() { var window GetWindowMeasureToolWindow(3D測量工具); window.minSize new Vector2(320, 420); window.Show(); } private void OnEnable() { data MeasureToolData.Instance; SceneView.duringSceneGui OnSceneGUI; } private void OnDisable() { SceneView.duringSceneGui - OnSceneGUI; // 清空Scene視圖里的繪制 SceneView.RepaintAll(); } private void OnSceneGUI(SceneView sceneView) { if (data null) return; MeasureToolSceneView.Render(sceneView, data); } private void OnGUI() { // 頂部的模式切換按鈕 EditorGUILayout.BeginHorizontal(); data.mode (MeasureMode)GUILayout.Toolbar((int)data.mode, new[] { 面積, 距離, 角度 }); EditorGUILayout.EndHorizontal(); // 測量點(diǎn)列表顯示... // 計(jì)算結(jié)果展示... // 清空 / 導(dǎo)入Mesh / 導(dǎo)出數(shù)據(jù)按鈕... } }這段代碼有個關(guān)鍵點(diǎn)一定要在OnEnable注冊委托SceneView.duringSceneGui在OnDisable注銷。不然編輯器反復(fù)開關(guān)窗口后事件會被重復(fù)注冊導(dǎo)致繪制邏輯執(zhí)行多次最后卡到爆。3.3 Step2Scene視圖的頂點(diǎn)拾取與拖拽交互Scene視圖里的交互是這個工具實(shí)現(xiàn)起來最費(fèi)勁、最容易踩坑的部分。核心需求是左鍵點(diǎn)擊場景中的空處創(chuàng)建一個新頂點(diǎn)。點(diǎn)擊已有頂點(diǎn)進(jìn)入拖拽模式可以移動該頂點(diǎn)到新位置。右鍵點(diǎn)擊頂點(diǎn)刪除該頂點(diǎn)。點(diǎn)的位置要能自動貼合到場景Collider表面可選開關(guān)。第一步是用HandleUtility.GUIPointToWorldRay把鼠標(biāo)屏幕坐標(biāo)轉(zhuǎn)為一條3D射線。射線和場景里的物體做Physics.Raycast碰撞取命中點(diǎn)作為頂點(diǎn)位置。這樣用戶在場景里點(diǎn)到任何有Collider的物體表面都能把測量點(diǎn)“貼”上去。public static bool TryPickPointInScene(out Vector3 hitPoint) { var ray HandleUtility.GUIPointToWorldRay(Event.current.mousePosition); if (Physics.Raycast(ray, out RaycastHit hit, 5000f)) { hitPoint hit.point; return true; } // 如果沒有命中任何物體就放到一個固定高度平面上 Plane groundPlane new Plane(Vector3.up, Vector3.zero); if (groundPlane.Raycast(ray, out float enter)) { hitPoint ray.GetPoint(enter); return true; } hitPoint Vector3.zero; return false; }這里我特意給了一個“沒命中時落到XZ平面”的兜底方案。不帶這個兜底的話用戶鼠標(biāo)點(diǎn)在天空區(qū)域就會完全沒反應(yīng)體驗(yàn)很糟糕。加了之后至少能在水平面上畫出測量點(diǎn)。拖拽移動用Unity的Handles.PositionHandle實(shí)現(xiàn)但這塊有個非常隱蔽的坑Event.current在SceneGUI回調(diào)中會被多次觸發(fā)包括Layout和Repaint階段如果你在拖拽時不加Event.current.alt和鼠標(biāo)按鈕判斷會在點(diǎn)選、拖拽、縮放場景之間互相干擾。我的處理方式是維護(hù)一個“當(dāng)前交互狀態(tài)”枚舉None、Hover、Dragging并在收到鼠標(biāo)按下時立刻把鼠標(biāo)捕獲。static void ProcessSceneInput(MeasureToolData data, SceneView sceneView) { Event e Event.current; int controlID GUIUtility.GetControlID(FocusType.Passive); switch (e.type) { case EventType.MouseDown: if (e.button 0) { // 如果命中了已有頂點(diǎn)進(jìn)入拖拽 int hitIndex FindPointIndexAtScreen(data.Points, e.mousePosition); if (hitIndex 0) { data.draggingIndex hitIndex; GUIUtility.hotControl controlID; e.Use(); } else { // 否則新增頂點(diǎn) if (TryPickPointInScene(out Vector3 newPos)) { data.AddPoint(newPos); e.Use(); } } } else if (e.button 1) { // 右鍵刪除頂點(diǎn) int hitIndex FindPointIndexAtScreen(data.Points, e.mousePosition); if (hitIndex 0) { data.RemovePoint(hitIndex); e.Use(); } } break; case EventType.MouseDrag: if (data.draggingIndex 0 e.button 0) { if (TryPickPointInScene(out Vector3 curPos)) { data.UpdatePoint(data.draggingIndex, curPos); e.Use(); sceneView.Repaint(); } } break; case EventType.MouseUp: if (e.button 0) { data.draggingIndex -1; GUIUtility.hotControl 0; e.Use(); } break; } }有了這個基礎(chǔ)你就可以在Scene視圖里按住鼠標(biāo)拖動測量點(diǎn)。如果想要更好的捕捉效果還可以加上Handles.DrawSolidDisc之類的手柄裝飾。先不急著上天后面再逐步優(yōu)化。3.4 Step3用Gizmos把測量結(jié)果直觀畫出來測量工具最忌諱的是“數(shù)字?jǐn)[那兒但用戶找不到對應(yīng)的是哪一段”。我的做法是根據(jù)當(dāng)前模式把測量對象在場景里用線、扇形、標(biāo)注等方式畫出來。點(diǎn)用Handles.SphereHandleCap畫一個小球突出顯示當(dāng)前Measure點(diǎn)的位置。多邊形面積把頂點(diǎn)按順序連成閉合線段并用半透明材質(zhì)在內(nèi)部填充一個Mesh。距離在兩個頂點(diǎn)之間畫一條高亮直線中間顯示距離數(shù)值。角度從頂點(diǎn)B出發(fā)用Handles.DrawSolidArc畫一個扇形直觀展示夾角范圍。閉合成面的填充如果用Handles.DrawAAConvexPolygon直接在3D空間畫會有三角形剖分限制。更穩(wěn)妥的方式是動態(tài)生成一個Mesh給Gizmos.DrawMesh用。但這里有個細(xì)節(jié)如果多邊形是凹的普通三角剖分算法會失效——我最初的版本就是直接按頂點(diǎn)順序三角剖分結(jié)果遇到凹多邊形時填充區(qū)域完全不對。后面換成了Triangulator類先把頂點(diǎn)投影到最佳擬合平面用2D的ear clipping算法剖分再轉(zhuǎn)回3D坐標(biāo)才解決凹多邊形的問題。這部分代碼相對長我把核心的“把3D多邊形投影到2D并三角化”的思路說一下// 根據(jù)頂點(diǎn)集合計(jì)算出最佳投影主軸 // 思路用Newell法求出多邊形法向量, 取法向量絕對值最大的分量作為投影平面法軸 int dominantAxis GetDominantAxis(polygonNormal); // 例如dominantAxis 1時, 說明多邊形主要在XZ平面上(y方向變化最小) // 把3D頂點(diǎn)投影到垂直于dominantAxis的平面上, 得到2D坐標(biāo) // 用2D三角化算法 (ear clipping) 生成三角形索引 // 再把三角形索引映射回3D坐標(biāo), 組成一個Mesh交給Gizmos.DrawMesh這個投影三角化方案在絕大部分場景下表現(xiàn)良好。唯一的邊緣情況是多邊形自交或者共線點(diǎn)過多這時候不管什么算法都容易出問題需要在工具里給用戶提示“當(dāng)前多邊形無效”而不是讓Mesh變成一個不可名狀的形狀。3.5 Step4從現(xiàn)有Mesh一鍵導(dǎo)入頂點(diǎn)手動點(diǎn)選適合快速測量但有時候用戶需要測的是一片實(shí)際Mesh的表面。這時候手動逐點(diǎn)點(diǎn)擊實(shí)在太慢了而且點(diǎn)不準(zhǔn)。我加了一個“導(dǎo)入選中Mesh頂點(diǎn)”的功能選中場景里一個帶MeshFilter的模型打開工具后點(diǎn)“導(dǎo)入頂點(diǎn)”工具會把Mesh的所有頂點(diǎn)坐標(biāo)世界空間按順序加載進(jìn)來。但直接導(dǎo)入全部頂點(diǎn)在復(fù)雜模型上會有大量冗余點(diǎn)所以我做了個簡化按一定距離閾值抽稀。具體做法是把Mesh頂點(diǎn)按三角形索引遍歷遇到距離當(dāng)前集合太近的點(diǎn)就跳過太遠(yuǎn)的就加入。這個閾值用戶可以調(diào)默認(rèn)0.1米對于大多數(shù)場景剛好。public void ImportMeshPoints(MeshFilter meshFilter) { Vector3[] vertices meshFilter.sharedMesh.vertices; Transform owner meshFilter.transform; for (int i 0; i vertices.Length; i) { Vector3 worldPos owner.TransformPoint(vertices[i]); bool isDuplicate false; for (int j 0; j Points.Count; j) { if (Vector3.Distance(worldPos, Points[j]) threshold) { isDuplicate true; break; } } if (!isDuplicate) Points.Add(worldPos); } }除了物理Mesh導(dǎo)入我還加了從Collider.bounds八個角點(diǎn)導(dǎo)入的功能用于快速測量包圍盒的對角線距離和截面面積。4. 實(shí)測過程拿真實(shí)場景驗(yàn)證工具精度和使用體驗(yàn)4.1 測試環(huán)境的搭建為了驗(yàn)證工具的正確性我建了一個專門的測試場景包括一塊10x10米的平整地面用于測矩形面積理論面積100平方米。一個傾斜的立方體旋轉(zhuǎn)45度用于測試三點(diǎn)角度和空間距離是否跟手算一致。一個帶凹槽的地面模型用于測試凹多邊形面積。若干個隨機(jī)點(diǎn)組成的空間五邊形用于測試Newell算法在非共面多邊形上的穩(wěn)定性。4.2 多邊形面積精度測試我先在地面上點(diǎn)A(0,0,0)、B(10,0,0)、C(10,0,10)、D(0,0,10)四個點(diǎn)。這顯然是一個10x10的正方形面積理論上是100。工具算出來用Newell算法算出來100.00用2D投影鞋帶公式投影到XZ平面算出來100.00完全一致。接著我測試傾斜四邊形把四個點(diǎn)整體繞X軸旋轉(zhuǎn)45度。此時2D鞋帶公式直接拿x、z坐標(biāo)算會得77.15投影縮小的結(jié)果而Newell算法得到的是100.00——因?yàn)槿S空間里的真實(shí)面積并不會因?yàn)槲矬w旋轉(zhuǎn)而改變Newell算法正確反映了這一點(diǎn)。這個對比已經(jīng)足以說明為什么必須用Newell算法了。凹多邊形測試用L形地面理論上面積 大長方形 - 缺口。我手動算出理論面積是120工具算出來是119.98誤差可以接受原因是我點(diǎn)選的時候在坐標(biāo)上不可避免有一點(diǎn)浮點(diǎn)誤差。4.3 距離與角度測試兩點(diǎn)距離測試在場景里放兩個相距6.5米的空物體工具測出來6.500米。距離測量的精度幾乎完全由你點(diǎn)擊頂點(diǎn)的精度決定算法本身不會引入額外誤差。角度測試我在XY平面上設(shè)置A(0,0,0)、B(1,0,0)、C(0,1,0)實(shí)際上BA和BC夾角是90度。工具算出來90.00°完全一致。接著把C改成(1.732,1,0)期望夾角30度工具給出30.00°。說明三點(diǎn)夾角的向量算法完全夠用。4.4 特殊情況的處理退化的多邊形比如三個點(diǎn)近乎共線坐標(biāo)幾乎在一條直線上。工具算出來面積會非常小接近0但不至于NaN或負(fù)數(shù)。這塊需要做參數(shù)校驗(yàn)。零距離用戶把兩個點(diǎn)放到同一位置距離返回0。工具不會崩但界面上應(yīng)該提示用戶調(diào)整點(diǎn)位。超遠(yuǎn)距離我把測試點(diǎn)放到相距5000的位置工具返回?cái)?shù)值精度正常說明World Space下的坐標(biāo)范圍沒有明顯精度問題。旋轉(zhuǎn)物體上的測量點(diǎn)我直接在帶旋轉(zhuǎn)角的物體表面放點(diǎn)拖動手柄時坐標(biāo)是從世界坐標(biāo)直接取的所以算出來的距離和世界尺寸一直正確。5. 踩坑記錄開發(fā)過程中遇到的高頻問題與解決思路5.1 Scene視圖不刷新改點(diǎn)后界面數(shù)值不更新這是編輯器工具里最經(jīng)典的坑。你在Scene視圖里拖拽頂點(diǎn)數(shù)據(jù)變了但Scene視圖和EditorWindow界面不刷新看起來很糟。原因在于Unity編輯器只在特定事件下主動重繪你自己的拖拽操作如果沒觸發(fā)任何UI事件就不會自動Repaint。解決方式是在鼠標(biāo)拖拽、添加點(diǎn)、刪除點(diǎn)、修改點(diǎn)等所有數(shù)據(jù)變更位置顯式調(diào)用SceneView.RepaintAll()和Repaint()。private void MarkDirty() { EditorUtility.SetDirty(this); SceneView.RepaintAll(); Repaint(); }我之前偷懶沒加每次都要手動點(diǎn)一下場景窗口才刷新后來實(shí)在受不了把所有數(shù)據(jù)變更函數(shù)統(tǒng)一封裝了一下全都加上這行。5.2 頂點(diǎn)拾取與場景物體深度遮擋的沖突用戶點(diǎn)選頂點(diǎn)時可能會點(diǎn)到物體背后的點(diǎn)——比如一個平面擋住了后面的測量點(diǎn)。默認(rèn)用Physics.Raycast是能正確判斷深度遮擋的但有個特殊情況當(dāng)測量點(diǎn)本身就在某個Collider內(nèi)部比如你要測一個房間內(nèi)部的點(diǎn)Raycast會因?yàn)楸煌鈮踝《鴾y不到。我的處理方式是加了一個“穿透模式”開關(guān)。開啟后拾取射線用Physics.RaycastAll取所有命中點(diǎn)中與當(dāng)前測量點(diǎn)顏色相同的那一個。這個方法有點(diǎn)暴力但實(shí)際用下來能解決大部分內(nèi)表面測量的問題。另一個更溫和的方案是給測量點(diǎn)加忽略遮罩的Layer但那要求整個項(xiàng)目都要配合改侵入性太大。5.3 多邊形頂點(diǎn)順序影響面積符號但對面積大小無影響Newell算法中法向量方向由頂點(diǎn)順序決定所以求magnitude能規(guī)避符號問題。但如果是用三角面積累加的方式Vector3.Cross返回的向量會隨頂點(diǎn)順序方向反轉(zhuǎn)如果直接累加模長重疊部分會被重復(fù)累加。所以我強(qiáng)烈建議只用Newell算法的最終實(shí)現(xiàn)不要自己改成“累加每個三角形的面積”。如果你要顯示法向量方向可以在工具里單獨(dú)把normal.normalized用一個箭頭畫出來。這個對有些領(lǐng)域比如風(fēng)環(huán)境模擬里某個面的朝向很有用。5.4 角度計(jì)算出現(xiàn)NaN排查后發(fā)現(xiàn)是零長度向量如果兩條邊中有一條長度是0比如A和B在同一個位置那么BA或BC向量的模長為0Vector3.Angle內(nèi)部做歸一化時會除以0結(jié)果就是NaN。這在用戶操作里經(jīng)常出現(xiàn)——不小心把兩個點(diǎn)拖到完全重合。我在工具里加了校驗(yàn)如果任一條邊長度小于0.0001f顯示“角度無效”并高亮提示用戶當(dāng)前兩個點(diǎn)過于接近。public static bool TryGetAngle(Vector3 A, Vector3 B, Vector3 C, out float angle) { Vector3 BA A - B; Vector3 BC C - B; if (BA.sqrMagnitude 0.0001f || BC.sqrMagnitude 0.0001f) { angle 0f; return false; } angle Vector3.Angle(BA, BC); return true; }5.5 工具數(shù)據(jù)怎么存儲與復(fù)用如果用戶關(guān)掉Unity再打開之前點(diǎn)的測量點(diǎn)都沒了這個工具體驗(yàn)就不完整。我最終用ScriptableObject來做數(shù)據(jù)持久化把測量點(diǎn)列表和模式信息都存進(jìn)Assets下的一個資源文件里。這樣同一個項(xiàng)目里所有場景都能復(fù)用這些測量數(shù)據(jù)還能用Asset文件做版本管理。[CreateAssetMenu(fileName MeasureData, menuName Tools/測量數(shù)據(jù))] public class MeasureToolData : ScriptableObject { public ListVector3 Points new ListVector3(); public MeasureMode mode MeasureMode.PolygonArea; public bool showLabels true; // ... }但要注意Scene視圖里的點(diǎn)在保存時是存放在這個ScriptableObject里的如果換了一個場景最好清空或分開存儲不然會出現(xiàn)跨場景顯示舊測量點(diǎn)的奇怪現(xiàn)象。我用的方案是給每個場景創(chuàng)建一個獨(dú)立的測量數(shù)據(jù)文件文件名帶場景名后綴。5.6 常見問題速查表這里把開發(fā)過程中遇到的常見問題統(tǒng)一整理成一張表方便后面排查。現(xiàn)象可能原因解決方法Scene視圖不刷新拖點(diǎn)后無反饋缺少Repaint調(diào)用在數(shù)據(jù)變更后調(diào)用SceneView.RepaintAll()和Repaint()拾取不到物體表面物體沒有Collider或射線超長給物體加Collider把Raycast距離設(shè)置成足夠大多邊形面積總是偏小多邊形非共面且用了2D投影算法改用Newell算法不做投影近似角度顯示NaN兩條邊中有零長度向量加長度校驗(yàn)長度過小時提示無效凹多邊形填充區(qū)域不對直接按頂點(diǎn)順序三角化用Ear Clipping算法先2D三角化再映射回3D導(dǎo)入Mesh頂點(diǎn)后點(diǎn)太多沒做抽稀按與已有點(diǎn)的距離閾值跳過鄰近點(diǎn)窗口關(guān)掉后測量點(diǎn)丟失數(shù)據(jù)沒持久化改用ScriptableObject保存數(shù)據(jù)拖拽點(diǎn)的時候場景視角跟著轉(zhuǎn)沒正確捕獲Event和hotControl拖拽時設(shè)置GUIUtility.hotControl結(jié)束后釋放5.7 關(guān)于性能優(yōu)化與多實(shí)例擴(kuò)展工具運(yùn)行時的計(jì)算量其實(shí)很小幾百個點(diǎn)也毫無壓力。主要性能損耗在Gizmos的繪制上。如果一次導(dǎo)入了幾千個頂點(diǎn)并開啟“顯示全部測量標(biāo)注”Scene視圖的幀率會明顯下降。我的優(yōu)化策略是減少每幀不必要的繪制調(diào)用把靜態(tài)顯示內(nèi)容緩存到RenderTexture或直接只繪制當(dāng)前模式下需要的元素。更進(jìn)一步我還做了“測量組”機(jī)制——每個測量組獨(dú)立占一個顏色可以單獨(dú)隱藏/顯示。實(shí)測下來在幾百個測量組同時存在的場景里Scene視圖依然流暢。最后分享一個實(shí)用的小技巧和一點(diǎn)個人體會這個工具寫完之后我最大的感受是很多看起來“高大上”的3D測量插件底層其實(shí)沒多少玄學(xué)關(guān)鍵的數(shù)學(xué)選型只要一步選對整個工具就穩(wěn)了。Newell算法、向量點(diǎn)積、叉積大學(xué)線性代數(shù)第一二章的內(nèi)容撐起了一個看似復(fù)雜的編輯器擴(kuò)展。最后再分享一個小技巧如果你把工具里SceneView.duringSceneGui改造成獨(dú)立窗口和EditorWindow可同時存在再配合Unity 2022的UI Toolkit界面能做得相當(dāng)精致。但如果你只是內(nèi)部使用IMGUI的編輯器窗口夠用且代碼量更少。我個人的建議是別在UI上花太多時間先把測量精度做對數(shù)值和繪制反饋?zhàn)龊霉ぞ叩膶?shí)際價值就已經(jīng)出來了。后續(xù)如果還有閑工夫我想在這個工具基礎(chǔ)上擴(kuò)展“容積測量”和“連續(xù)路徑長度測量”原理都是一樣的只是多一步沿路徑累加。到時候再寫一篇新的實(shí)測記錄。