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