3D距離

運算元功能

選擇計算距離的型別，輸入待測點、線或面的引數。獲取兩者間最短距離、各座標軸方向距離和各座標平面方向的距離。

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	0-8	0	影像輸入的IM編號

計算引數

引數	範圍	預設值	說明	圖示
模式	到點的距離/異面直線的距離（向量公式法）/異面直線距離（向量公式法）/異面直線/平面距離（參考線/面外第三點）	到點的距離	參見模式
測量方向			參見測量方向

模式

• 到點的距離：選擇功能為測量點與點/線/面之間的距離

引數	範圍	預設值	說明	影像
幾何1	3D點	3D點	位置：輸入點的X、Y、Z座標
幾何2	3D點/3D直線/平面	3D點	型別：僅開啟手動啟用，設定手動輸入的型別：點/線/面 位置：僅開啟手動啟用，輸入點/線上一點/面上一點的X、Y、Z座標 方向：僅開啟手動，輸入型別為3D直线啟用，輸入直線的方向向量 法向量：僅開啟手動，輸入型別為平面啟用，輸入平面的法向量

• 異面直線距離（向量公式法）：選擇功能為測量異面直線的距離

引數	範圍	預設值	說明	影像
幾何1	3D直線	3D直線	位置：僅開啟手動啟用，輸入線上一點的X、Y、Z座標 方向：僅開啟手動啟用，輸入直線的方向向量
幾何2	3D直線	3D直線	位置：僅開啟手動啟用，輸入線上一點的X、Y、Z座標 方向：僅開啟手動啟用，輸入直線的方向向量

• 異面直線/平面距離（參考直線/平面外第三點）：選擇功能為利用第三點測量直線與直線、直線與平面、平面與平面之間的距離

引數	範圍	預設值	說明	影像
幾何1	3D直線/平面	3D直線	型別：僅開啟手動啟用，設定手動輸入的型別：線/面 位置：僅開啟手動啟用，輸入線/面上一點的X、Y、Z座標 方向：僅開啟手動，輸入型別為3D直线啟用，輸入直線的方向向量 法向量：僅開啟手動，輸入型別為平面啟用，輸入平面的法向量
幾何2	3D直線/平面	3D直線	型別：僅開啟手動啟用，設定手動輸入的型別：線/面 位置：僅開啟手動啟用，輸入線/面上一點的X、Y、Z座標 方向：僅開啟手動，輸入型別為3D直线啟用，輸入直線的方向向量 法向量：僅開啟手動，輸入型別為平面啟用，輸入平面的法向量
參考點	3D點	3D點	位置：輸入參考點的X、Y、Z座標

測量方向

• 方向：

引數	說明
最短距離	選擇模式為測量最短距離
平行於X軸	選擇模式為與X軸平行方向的距離
平行於Y軸	選擇模式為與Y軸平行方向的距離
平行於Z軸	選擇模式為與Z軸平行方向的距離
在XY平面上	選擇模式為投影到XY平面上的距離
在XZ平面上	選擇模式為投影到XZ平面上的距離
在YZ平面上	選擇模式為投影到YZ平面上的距離

根據不同的測量需求，可以選擇不同測量物件和測量方向：

到點的距離：

點到點的距離

引數	說明	影像
最短距離	該功能將測量兩點的最短距離（直線距離）
平行於座標軸	以與X軸平行為例，該功能僅測量與X軸平行方向上兩點間的最短距離
在座標平面上	以在XY平面上為例，該功能僅測量兩點在XY平面上的最短距離

點到直線的距離：

引數	說明	影像
最短距離	該功能將測量點到直線的最短距離
平行於座標軸	以與X軸平行為例，該功能僅測量與X軸平行方向上點到直線的最短距離
在座標平面上	以在XY平面上為例，該功能僅測量點到直線在XY平面上的最短距離

點到平面的距離：

引數	說明	影像
最短距離	該功能將測量點到平面的最短距離
平行於座標軸	以與X軸平行為例，該功能僅測量與X軸平行方向上點到平面的最短距離
在座標平面上	以在XY平面上為例，該功能僅測量點到平面在XY平面上的最短距離

異面直線的距離（向量公式法）

如下圖所示，選擇該方法時，無論選擇何種測量方向，均輸出測量的異面直線最短距離

異面直線/平面距離（參考線/面外第三點）

直線到直線的距離：

引數	說明	影像
最短距離	該功能將參考兩直線外一點，測量兩直線間的最短距離
平行於座標軸	以與X軸平行為例，該功能將參考兩直線外一點，測量與X軸平行方向上兩直線的最短距離
在座標平面上	以在XY平面上為例，該功能將參考兩直線外一點，測量在XY平面上兩直線的最短距離

直線到平面的距離：

引數	說明	影像
最短距離	該功能將參考直線和平面外一點，測量直線和平面間的最短距離
平行於座標軸	以與X軸平行為例，該功能將參考直線和平面外一點，測量與X軸平行方向上直線和平面的最短距離
在座標平面上	以在XY平面上為例，該功能將參考直線和平面外一點，測量在XY平面上直線和平面的最短距離

平面到平面的距離：

引數	說明	影像
最短距離	該功能將參考兩平面外一點，測量兩平面間的最短距離
平行於座標軸	以與X軸平行為例，該功能將參考兩平面外一點，測量與X軸平行方向上兩平面的最短距離
在座標平面上	以在XY平面上為例，該功能將參考兩平面外一點，測量在XY平面上兩平面的最短距離

結果顯示

引數	範圍	預設值	說明	圖示
幾何1	true/false	false	若啟用，則在影像中顯示幾何1
幾何2	true/false	false	若啟用，則在影像中顯示幾何2
參考點	true/false	false	參考點，若啟用，則在影像中顯示
距離線段	true/false	false	距離線段，若啟用，則在影像中顯示
距離值	true/false	false	距離值，若啟用，則在影像中顯示

輸出引數

名稱	型別	範圍	說明
Result	bool	true/false	true為成功 false為失敗
Warning	bool	true/false	true表示有警告 false表示沒有
Message	string		輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空
Time	float		運算元執行時間，單位: ms
distance	float		輸出距離

提示

更多引數型別詳細說明，請參看型別定義

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入的測量方向為{0}，無效的測量方向	測量方向	輸入的測量方式為直接距離/平行於X軸/平行於Y軸/平行於Z軸/在XY平面上/在YZ平面上/在XZ平面上
2	輸入的幾何1型別是{0}，無效幾何型別	幾何型別	第第一個物件型別選擇為3D點/3D直線/平面
3	輸入的幾何2直線引數非法		輸入的直線方向向量引數不全為0
4	輸入的幾何2平面引數非法		輸入的平面的法向量引數不全為0
5	輸入的幾何2型別是{0}，無效幾何型別	幾何型別	第二個物件型別選擇為3D點/3D直線/平面
6	輸入的幾何1直線引數非法		輸入的直線方向向量引數不全為0
7	輸入的參考點型別是{0}，無效的參考點型別	幾何型別	參考點型別設定為3D點
8	輸入的幾何1平面引數非法		輸入的平面的法向量引數不全為0
9	輸入的模式為{0}，無效輸入模式	模式	輸入的模式為到點的距離/異面直線的距離（向量公式法）/異面直線距離（向量公式法）/異面直線/平面距離（參考線/面外第三點）其中之一
10	輸入平面與測量面平行，無法計算距離		若測量方向為XY平面，則輸入平面法向量的X、Y方向分量不能全為0；若測量方向為YZ平面，則輸入平面法向量的Y、Z方向分量不能全為0；若測量方向為XZ平面，則輸入平面法向量的X、Z方向分量不能全為0

示例介紹

工程設計

1. 選擇加载点云工具，載入需要處理的3D點雲圖到IM0。

2. 選擇3D裁切工具，分別複製IM0到IM1、IM2用於不同的操作

3. 選擇兩個方形探针工具獲取一個點和一條線，用於測量點線距離，選擇兩個方形探针工具獲取兩條線，用於測量線線距離，選擇兩個3D平面工具獲取兩條線，用於測量面面距離，

4. 選擇3D距离工具。

工具使用

1. 選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致

2. 設定輸入模式與輸入幾何

選擇多個3D距离工具，分別設定不同輸入模式（點線距離、線線距離、面面距離）。繫結上一步方形探针工具和3D平面獲取的線或面作為輸入幾何1、幾何2。

3. 設定引數

4. 在結果顯示欄中勾選想要顯示的內容

5. 點選测试，檢視影像視窗和引數是否符合預期

6. 沒有問題後點擊保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果