オペレーター SelectROI

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 では、1ラインあたりのピクセル数、つまりライン幅が常に Parallelism の倍数である必要があります。 X_Length がリンク Parallelism で割り切れない場合、オペレーターは最後のパラレルワードを埋めるためにダミーピクセルを挿入します。 たとえば、リンク Parallelism が 2、X_Offset が 0、X_Length が 5 の場合、オペレーターは 6 ピクセルを出力し、最後のピクセルはダミーピクセルになります。 そのダミーピクセルの値は不定です。 VAシミュレーションでは、視認性を高めるためにダミーピクセルはゼロに設定されます。

  • 入力フレームが指定されたROIよりも小さい場合、オペレーターはROI利用可能な部分のみを出力します。

  • 1Dモードでオペレーターを使用する場合、Yパラメータはオペレーターに影響しません。 オペレーターはX方向のROIのみを切り取ります。

I/O Property

Property 値
オペレータータイプ P
Input Link I, data input
Output Link O, data output

サポートされているリンクフォーマット

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
タイプ static/dynamic read/write parameter
Default 0
範囲 [0, MaxImgWidth - X_Length]

このパラメータ値は（X_Offset とともに）ROIの左端の位置をピクセル単位で定義します。

Y_Offset
タイプ static/dynamic read/write parameter
Default 0
範囲 [0, MaxImgHeight - Y_Length]

This parameter value (together with Y_Offset) defines the position of the upper edge of the ROI in pixels.

X_Length
タイプ static/dynamic read/write parameter
Default 1024
範囲 [1, MaxImgWidth - X_Offset]

このパラメータはROIの幅を定義します。

Y_Length
タイプ static/dynamic read/write parameter
Default 1024
範囲 [1, MaxImgHeight - Y_Offset]

This parameter defines the height of the ROI.

使用例

オペレーター SelectROI の使用方法は、以下の例に示されています：

  前へ     レベルアップ     Next  
目次 上面 ホーム