建立ROI陣列

運算元功能

根據需求建立m×n個ROI

引數介紹

輸入引數

引數	範圍	預設值	說明	圖示
輸入影像	0-8	0	影像輸入的IM編號
3D基準			可以通過繫結選擇基准
X			3D基準引數X座標值，可以通過繫結設定X
Y			3D基準引數Y座標值，可以通過繫結設定Y
Z			3D基準引數Z座標值，可以通過繫結設定Z
X軸角度	-10000000000.000-10000000000.000		3D基準引數X軸角度值，可以通過繫結設定X轴角度
Y軸角度	-10000000000.000-10000000000.000		3D基準引數Y軸角度值，可以通過繫結設定Y轴角度
Z軸角度	-10000000000.000-10000000000.000		3D基準引數Z軸角度值，可以通過繫結設定Z轴角度

計算引數

引數	範圍	預設值	說明	圖示
區域	2D視窗/2D圓形視窗/盒子/圓柱盒子	盒子	手動框選合適的ROI區域 可以通过绑定选择已存在的ROI区域
模式	手動/自動	手動	手動模式生成多個輸入ROI樣式的ROI陣列，自動模式將輸入的ROI自動切割成ROI陣列
手動			手動方式生成ROI陣列
自動			自動方式生成ROI陣列
邊界	2D視窗/盒子	盒子	設定自動模式下邊界的型別，當邊界為2D視窗時，區域僅支援2D視窗/2D圓形視窗，當邊界為盒子時，支援所有區域型別
ROI型別	2D視窗/2D圓形視窗/盒子/圓柱盒子	盒子	設定輸出的ROI型別
ROI外接矩形長		5.0	生成ROI陣列的外接矩形長度
ROI外接矩形寬		5.0	生成ROI陣列的外接矩形寬度
行間隔		2.0	生成ROI陣列的行間隔值
列間隔		2.0	生成ROI陣列的列間隔值
行數		2	生成ROI陣列的行數
列數		2	生成ROI陣列的列數

結果顯示

引數	範圍	預設值	說明	圖示
ROI	true/false	false	若啟用，則在影像中顯示建立的ROI

輸出引數

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

提示

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

異常排查

序號	異常資訊	對應引數	解決方法
1	輸入的模式是{0}，無效模式	模式	模式選擇手動/自動其中之一
2	自動模式下輸入的邊界型別為{0}，無效的邊界型別	邊界型別	選擇邊界型別為2D視窗/盒子
3	輸入的2D視窗引數非法		輸入的起點終點任意x或y的差不為0
4	輸入的盒子引數非法		輸入的起點終點任意x、y、z的差不為0
5	自動模式邊界型別為2D視窗時，輸入的區域型別非法	區域型別	選擇區域型別為2D視窗/2D圓形視窗
6	自動模式邊界型別為盒子時，輸入的區域型別非法	區域型別	輸選擇區域型別為2D視窗/2D圓形視窗/盒子/圓柱
7	手動模式下輸入的區域型別為{0}，無效的區域型別	區域型別	選擇區域型別為2D視窗/2D圓形視窗/盒子/圓柱
8	間隔計算為負，不能建立ROI陣列		增大邊界的尺寸或減小行列
9	ROI數量超過10000上限，不能建立ROI陣列		修改相關引數，減少ROI的建立數量
10	輸入的自動模式是{0}，無效自動模式	模式	模式自動選擇基於行列/基於間隔其中之一
11	ROI超出設定的邊界，不能建立ROI陣列		增大邊界的尺寸或減小間隔

示例介紹

工程設計

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

2. 選擇创建ROI阵列工具。

工具使用

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

2. 不啟用使用區域引數或啟用區域並選擇區域型別為盒子，將盒子移動到待測位置

使用技巧

1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小

3. 設定引數

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

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

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

手動建立

自動建立