建立ROI
運算元功能
根據需求建立ROI陣列，可以建立1-100個ROI，操作方法如下：
- 選取需要建立的ROI型別
- 調整序號為0的ROI的位置和大小
- 鍵盤使用ctrl+c進行復制，ctrl+v進行貼上，delete進行刪除,esc退出複製貼上模式
注：最多建立100個ROI（序號0-99），最少建立1個ROI（序號為0）
引數介紹
輸入引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 輸入影像 | 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轴角度 |
計算引數
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 模式 | 配方/區域 | 區域 | 選擇建立ROI的模式，配方輸入或通過區域手動建立 | |
| 配方檔案 | 配方檔案路徑 | |||
| 區域型別 | 2D視窗陣列/2D圓形視窗陣列/2D多邊形視窗/盒子陣列/圓柱盒子陣列/旋轉盒子陣列 | 盒子陣列 | ||
| 型別 | 2D視窗陣列/2D圓形視窗陣列/2D多邊形視窗/盒子陣列/圓柱盒子陣列/旋轉盒子陣列 | 盒子陣列 | 選擇需要的ROI型別 | |
| 序號 | 已建立的所有ROI | 0 | 每次複製，則序號會按順序自動+1，刪除某個ROI，則後續ROI序號都會-1（所有ROI保持0-99的順序），最大值為99，最小值為0 |
結果顯示
| 引數 | 範圍 | 預設值 | 說明 | 圖示 |
|---|---|---|---|---|
| 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[]/polygon2d/ box[]/cylinderbox[]/orientedbox[] | 輸出ROI |
提示
更多引數型別詳細說明，請參看...添加個跳轉到引數型別介紹的連結...
異常排查
| 序號 | 異常資訊 | 對應引數 | 解決方法 |
|---|---|---|---|
| 1 | 輸入的ROI型別是{0}，無效ROI型別 | ROI型別 | 選擇區域型別為2D視窗陣列/2D圓形視窗陣列/2D多邊形視窗/盒子陣列/圓柱盒子陣列/旋轉盒子陣列之一 |
| 2 | 輸入的第{0}個2D視窗引數非法 | 序號 | 輸入的起點終點任意x或y的差不為0 |
| 3 | 輸入的第{0}個盒子引數非法 | 序號 | 輸入的起點終點任意x、y、z的差不為0 |
| 4 | 輸入的多邊形頂點個數小於3，無法形成多邊形 | 新增2d多邊形視窗頂點數，使得頂點數至少為三個 | |
| 5 | 檔案"{0}"不存在或無法訪問 | 檔名稱 | 輸入有效的配方路徑 |
| 6 | 檔案"{0}"載入失敗 | 檔名稱 | 輸入有效路徑且為json檔案 |
| 7 | 檔案不含有{0}鍵 | 鍵名稱 | 檢視配方檔案是否存在該鍵 |
| 8 | 第"{0}"個數組中沒有"{1}" | 組號、引數名稱 | 檢視該陣列中是否缺少該引數 |
示例介紹
工程設計
選擇
加载点云工具，載入需要處理的3d點雲圖到IM0；選擇
创建ROI工具。
工具使用
選擇需要進行操作的輸入影像，影像序號要與工程中影像所在IM序號一致
選擇區域型別為所需的ROI型別，將ROI移動到待測位置，進行復制、調整等操作
使用技巧
1. 通過影像視窗上的ROI控制器來拖動或縮放盒子；
2. 直接在計算引數中修改盒子的起點或終點座標來調整盒子位置和大小
在結果顯示欄中勾選想要顯示的內容
點選
测试，檢視影像視窗和引數是否符合預期沒有問題後點擊
保存，在執行列表中執行該運算元，即可在對應的IM檢視執行結果
2D視窗陣列
2D圓形視窗陣列
盒子陣列
圓柱盒子陣列
