Operator Library: Base
Operator SelectROI 會從輸入連結的影格中擷取矩形感興趣區域 (ROI)。 ROI 是透過使用 4 個參數 X_Offset、X_Length、Y_Offset 和 Y_Length 來指定。 X 參數需以像素為單位指定。 Y 參數需以行為單位指定。
如果需要使用輸入連結而非參數來設定 ROI 座標,必須使用運算子 DynamicROI。
一旦 ROI 完成,運算子就會完成輸出影像。如果 ROI 小於輸入影像, 這可能會導致輸出影像完成的時間 早於輸入影像完成的時間。這與必須等待最後一行 / 像素的運算子 RemoveLine 或 RemovePixel 形成對比。
算子限制
X_Offset 和 X_Length 參數的總和不得超過最大連結影像寬度。 Y_Offset 和 Y_Length 參數的總和不得超過最大連結影像高度。
變更動態 ROI 參數僅允許在停止程序(即擷取)時進行。 在擷取執行期間進行變更將對 ROI 沒有影響。 這可避免在變更參數時產生無效的 ROI。
每個輸入影像的行必須具有相同的長度。因此不允許行長度不同的影像。
-
在 VisualApplets 中,要求行中的像素數量(即行寬)始終是 Parallelism 的倍數。 當 X_Length 無法被連結 Parallelism 整除時,運算子將插入虛擬像素以填滿最後一個 平行字元, 例如,如果連結 Parallelism 為 2,X_Offset 為 0 且 X_Length 為 5,運算子將輸出 6 個像素,其中最後一個像素 是虛擬像素。 該虛擬像素的值未定義。 在 VA 模擬中,虛擬像素將設為零以便於檢視。
-
當輸入影格小於指定的 ROI 時,運算子將僅輸出 ROI 中可用的部分。
-
當在 1D 模式下使用運算子時,Y 參數對運算子沒有影響。 運算子將僅在 X 方向裁剪 ROI。
| X_Offset | |
|---|---|
| Type | static/dynamic read/write parameter |
| Default | 0 |
| Range | [0, MaxImgWidth - X_Length] |
|
此參數值(連同 X_Offset)定義了 ROI 左側邊緣的位置(以像素為單位)。 |
|
| Y_Offset | |
|---|---|
| Type | static/dynamic read/write parameter |
| Default | 0 |
| Range | [0, MaxImgHeight - Y_Length] |
|
此參數值(連同 Y_Offset)定義了 ROI 上方邊緣的位置(以像素為單位)。 |
|
| X_Length | |
|---|---|
| Type | static/dynamic read/write parameter |
| Default | 1024 |
| Range | [1, MaxImgWidth - X_Offset] |
|
此參數定義 ROI 的寬度。 |
|
| Y_Length | |
|---|---|
| Type | static/dynamic read/write parameter |
| Default | 1024 |
| Range | [1, MaxImgHeight - Y_Offset] |
|
此參數定義 ROI 的高度。 |
|


上一頁

