3D位置調整

運算元功能

根據輸入的位置資訊，對點雲進行平移或者旋轉的操作來調整點雲的位置。

引數介紹

輸入引數

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

計算引數

僅調整位置引數

引數	範圍	預設值	說明	圖示
模式			僅調整位置：根據輸入的新原点資訊，對輸入點雲進行座標變換 方位調整：根據輸入的新方向資訊，對點雲的方向和位置進行調整
變換型別			永久：輸出變換後的點雲 臨時：輸出變換矩陣 注意：臨時模式現在並不會輸出變換矩陣到暫存器當中且並不會對原始點雲進行變換。因此，在進行設定時，變換型別需要選擇為永久，後續版本會逐漸引入臨時模式。
型別			線：將線的位置資訊(線的中心點)作為原點 3D平面：將平面的位置資訊(面的中心點)作為原點 盒子：由盒子的起始點和終點計算出中心點，將其作為原點
變換成分			調整X位置：僅將新原點的X座標調整為0 調整Y位置：僅將新原點的Y座標調整為0 調整Z位置：僅將新原點的Z座標調整為0
輸出影像			影像輸出的IM編號

方位調整引數

引數	範圍	預設值	說明	圖示
模式	僅調整位置/方位調整	方位調整	僅調整位置：根據輸入的新原点資訊，對輸入點雲進行座標變換 方位調整：根據輸入的新方向資訊，對點雲的方向和位置進行調整
變換型別			永久：輸出變換後的點雲 臨時：輸出變換矩陣
型別	3D直線/3D平面	3D直線	3D直線：將直線的方向向量作為新的方向 3D平面：將平面的法向量作為新的方向
旋轉向量至軸	+X/-X/+Y/-Y	+X	+X：目標方向向量為座標軸+X方向 +Y：目標方向向量為座標軸+Y方向 -X：目標方向向量為座標軸-X方向 -Y：目標方向向量為座標軸-Y方向
角度範圍	360度/180度	360度	360度：計算新方向和目標方向時，採用[0度, 360度]的角度範圍 180度：計算新方向和目標方向時，採用[0度, 180度]的角度範圍
旋轉中心	目標中心/原點(0,0,0)/	目標中心	目標中心：圍繞新方向型別的位置中心進行旋轉 原點(0,0,0)：圍繞Z軸旋轉 特殊位置：設定自定義的旋轉中心
同時調整位置			調整X位置：僅將新原點的X座標調整為0 調整Y位置：僅將新原點的Y座標調整為0 調整Z位置：僅將新原點的Z座標調整為0
輸出影像	0-31	0	影像輸出的IM編號

提示

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

輸出引數

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

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入的值是{0}，無效的變換型別	變換型別	只支援permanent
2	輸入的值是{0}，無效的新原點型別	新原點型別	只支援point3d、line3d、plane、Box
3	輸入的值是{0}，無效的新方向型別	新方向型別	只支援line3d、plane
4	輸入的值是{0}，無效的目標軸	旋轉向量至軸	只支援+X、+Y、-X、-Y
5	輸入的值是{0}，無效的角度範圍	角度範圍	只支援360度、180度
6	輸入的值是{0}，無效的特殊位置型別		只支援point3d、line3d、plane
7	方位調整失敗		1. 檢查輸入點雲是否為空 2. 檢查新方向來源是否支援，只支援line3d、plane
8	輸入的值是{0}，無效的位置調整模式	模式	只支援position only、orientation
9	輸入的值是{0}，無效的旋轉點型別	旋轉點型別來源	只支援object center、origin、specific position

示例介紹

工程設計

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

2. 選擇兩個3D方形探针工具，分別提取輪廓到IM1、IM2、IM獲取點和線。

3. 選擇兩個3D位置调整工具，分別設定模式為僅位置調整與方位調整。

工具使用

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

2. 設定引數

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

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