Operator SelectROI

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。

I/O Properties

Property Value
Operator Type P
Input Link I, data input
Output Link O, data output

支援的 Link 格式

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns any as I
Kernel Rows any as I
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any as I

1

輸入 Bit Width 的範圍是 [1, 64]。 對於帶號輸入,範圍是 [2, 64]。 對於不帶號彩色輸入,範圍是 [3, 63],對於帶號彩色,範圍是 [6, 63]。

參數

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 的高度。

使用範例

以下範例顯示了 operator SelectROI 的使用方式: