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