3D角度
運算元功能
測量兩待測幾何之間的夾角。如果設定了測量方向，則限制了測量角度的平面，或角度的旋轉軸
引數介紹
輸入引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 輸入影像 | 0-8 | 0 | 影像輸入的IM編號 | |
計算引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 幾何1 | 該部分接受第一個幾何輸入：參見幾何1 | |||
| 幾何2 | 該部分接受第二個幾何輸入：參見幾何1 | |||
| 角度範圍 | -90° - 90°/0° - 180°/0° - 90° | -90° - 90° | 參見角度範圍 | |
| 測量方向 | 直接角度/投影到XY平面/投影到XZ平面/投影到YZ平面 | 直接角度 | 參見測量方向 |
幾何1
引數 | 說明 | 影像 |
|---|---|---|
| 型別 | 設定手動輸入的型別：線/面/向量 | |
| 位置 | 輸入型別為3D直线/平面啟用，輸入線/面上一點的X、Y、Z座標 | |
| 方向 | 輸入型別為3D直线啟用，輸入直線的方向向量 | |
| 向量 | 輸入型別為向量啟用，輸入向量引數 | |
| 法向量 | 輸入型別為平面啟用，輸入平面的法向量 |
幾何2
引數 | 說明 | 影像 |
|---|---|---|
| 型別 | 設定手動輸入的型別：線/面/向量 | |
| 位置 | 輸入型別為3D直线/平面啟用，輸入線/面上一點的X、Y、Z座標 | |
| 方向 | 輸入型別為3D直线啟用，輸入直線的方向向量 | |
| 向量 | 輸入型別為向量啟用，輸入向量引數 | |
| 法向量 | 輸入型別為平面啟用，輸入平面的法向量 |
角度範圍
引數 | 說明 | 影像 |
|---|---|---|
| -90° - 90° | 設定輸出角度為-90°和90°之間的值(這將是兩條線的方向差) |  |
| 0° - 180° | 設定輸出角度為0°和180°之間的值(這將是兩條線之間的開口角)，以向量與向量的角度為例，如下圖所示： | |
| 0° - 90° | 設定輸出角度為0°-90°之間的值，它忽略旋轉軸的方向，並且總是給出兩條線之間可能出現的兩個 |
測量方向
引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 不限制測量方向 |  |
| 投影到XY平面 | 將直線或向量投影到XY平面內進行測量 | |
| 投影到XZ平面 | 將直線或向量投影到XZ平面內進行測量 | |
| 投影到YZ平面 | 將直線或向量投影到YZ平面內進行測量 |
根據不同的測量需求，可以選擇不同測量物件和測量方向：
向量與向量的角度：實現測量兩向量間角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量兩向量間的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下僅測量兩向量投影到XY平面內的角度 |  |
向量與直線的角度：實現測量向量與直線間角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量向量與直線間的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下僅測量向量與直線投影到XY平面內的角度 |  |
向量與平面的角度：實現測量向量與平面間角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量向量與平面法向量間的角度，取其餘角即為向量與平面的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下僅測量向量與平面法向量投影到XY平面內的角度，取其餘角即為向量與平面在XY平面內的角度 |  |
直線與直線的角度：實現測量兩直線間角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量兩直線間的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下僅測量兩直線投影到XY平面內的角度 |  |
直線與平面的角度：實現測量直線與平面角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量直線與平面法向量間的角度，取其餘角即為直線與平面的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下測量直線與平面法向量投影到XY平面內的角度，取其餘角即為直線與平面在XY平面內的角度 |  |
平面與平面的角度：實現測量兩平面間角度的功能，可根據需求選擇不同的測量方向
| 引數 | 說明 | 影像 |
|---|---|---|
| 直接角度 | 該模式下將直接測量兩平面法向量間的角度 |  |
| 投影到座標平面 | 以在XY平面內為例，該模式下僅測量兩平面法向量投影到XY平面內的角度 |  |
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 幾何1 | true/false | false | 若啟用，則在影像中顯示幾何1 | |
| 幾何2 | true/false | false | 若啟用，則在影像中顯示幾何2 |
輸出引數
| 名稱 | 型別 | 範圍 | 說明 |
|---|---|---|---|
| Result | bool | true/false | true為成功 false為失敗 |
| Warning | bool | true/false | true表示有警告 false表示沒有 |
| Message | string | 輸出成功或錯誤或警告資訊,如果沒有錯誤或警告為空 | |
| Time | float | 運算元執行時間，單位: ms | |
| angle | float | 輸出角度 |
提示
更多引數型別詳細說明，請參看型別定義
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的幾何1直線引數非法 | 輸入的直線方向向量引數不全為0 | |
| 2 | 輸入的幾何1平面引數非法 | 輸入的平面的法向量引數不全為0 | |
| 3 | 輸入的幾何1型別是{0}，無效幾何型別 | 幾何型別 | 輸入目標一型別為3D直線/平面/向量其中之一 |
| 4 | 輸入的幾何2直線引數非法 | 輸入的直線方向向量引數不全為0 | |
| 5 | 輸入的幾何2平面引數非法 | 輸入的平面的法向量引數不全為0 | |
| 6 | 輸入的幾何2型別是{0}，無效幾何型別 | 幾何型別 | 目標二型別為3D直線/平面/向量其中之一 |
| 7 | 輸入的幾何1向量引數非法 | 輸入向量引數不全為0 | |
| 8 | 輸入的幾何2向量引數非法 | 輸入向量引數不全為0 |
示例介紹
工程設計
選擇
加载点云工具，載入需要處理的3d點雲圖到IM0。選擇
3D裁切工具，分別複製IM0到IM1、IM2用於不同的操作選擇兩個
方形探针工具獲取兩條線，用於測量線線角度，選擇一個方形探针工具用於獲取一條線，一個3D平面工具用於獲取一個平面，用於測量線面角度。選擇
3D角度工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
設定輸入幾何
繫結上一步多個方形探針工具獲取的線或面作為輸入幾何1、幾何2。
設定引數
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
