Operator Library: Base
「SelectROI」運算子會從輸入鏈路中的幀中擷取一個矩形感興趣區域（ROI）。 該 ROI 透過 4 個參數 X_Offset、X_Length、Y_Offset 及 Y_Length 來指定。 X 參數應以像素為單位指定。 Y 參數應以行數為單位指定。
若需使用輸入連結而非參數來設定 ROI 座標，操作員 DynamicROI 。
一旦 ROI 處理完成，該運算子便會立即完成輸出影像。若 ROI 比輸入影像更小， 這可能會導致 輸出影像在輸入影像完成之前便已完成的現象。這與下列運算子不同： RemoveLine 或 RemovePixel ，後者必須等待最後一行／像素的處理完成。
Operator Restrictions
X_Offset 與 X_Length 參數的總和不得超過連結影像的最大寬度。 Y_Offset 與 Y_Length 參數的總和不得超過連結影像的最大高度。
僅在流程（即資料擷取）停止時，才允許變更動態 ROI 參數。 若在資料擷取執行期間進行變更，將不會對 ROI 產生任何影響。 此舉可避免在變更參數時產生無效的 ROI。
每張輸入影像的行數必須相同。因此，不允許行數不一致的影像。
-
在VisualApplets 中，要求一行中的像素數（即行寬）必須始終是並行度的整數倍。 當 X_Length 無法被鏈路並行度整除時，運算子會插入虛擬像素來填滿最後一個 並行字元組， 例如，若鏈路並行度為 2、X_Offset 為 0 且 X_Length 為 5，則運算子將輸出 6 個像素，其中最後一個像素 為虛擬像素。 該虛擬像素的數值未定義。 在 VA 模擬中，為提高可視性，虛擬像素將被設為零。
-
當輸入影像框小於指定的 ROI 時，操作員將僅輸出 ROI 中可用的部分。
-
在 1D 模式下使用此運算子時，Y 參數對該運算子沒有影響。 該運算子僅會沿 X 方向裁切感興趣區域 (ROI)。
|
|
輸入 Bit Width 的範圍為 [1, 64]。 對於有號輸入，範圍為 [2, 64]。 對於無號彩色輸入，範圍為 [3, 63]，而對於有號彩色，範圍則為 [6, 63]。 |
| X_Offset | |
|---|---|
| Type | static/dynamic 讀寫參數 |
| Default | 0 |
| Range | [0, MaxImgWidth - X_Length] |
|
此參數值（連同 X_Offset）定義了 ROI 左邊緣的位置（以像素為單位）。 |
|
| Y_Offset | |
|---|---|
| Type | static/dynamic 讀寫參數 |
| Default | 0 |
| Range | [0, MaxImgHeight - Y_Length] |
|
此參數值（連同 Y_Offset）定義了 ROI 上緣的位置（以像素為單位）。 |
|
| X_Length | |
|---|---|
| Type | static/dynamic 讀寫參數 |
| Default | 1024 |
| Range | [1, MaxImgWidth - X_Offset] |
|
此參數定義 ROI 的寬度。 |
|
| Y_Length | |
|---|---|
| Type | static/dynamic 讀寫參數 |
| Default | 1024 |
| Range | [1, MaxImgHeight - Y_Offset] |
|
此參數定義 ROI 的高度。 |
|
上一頁
