Operator Library: Base
DynamicROIオペレーターは、入力リンクIから長方形のROI（関心領域）を抽出します。 出力画像の高さとライン幅は、ROI画像パラメータのYlengthおよびXlengthによって定義されます。 このROIのサイズは、4つの入力リンクであるXoffset、Yoffset、Xlength、およびYlengthによって動的に定義されます。 このオペレーターの目的は、画像処理ステップの結果に合わせてROIの寸法と位置を適応させることです。 ROIのすべてのパラメータは、画像ごとに異なる場合があります。
IからOへの画像ストリームは、4つのリンク（Xoffset、Yoffset、Xlength、Ylength）によって制御されます。 これら4つのリンクは、完全に非同期（異なるMタイプオペレーターをソースとする）としても、完全に同期（Oタイプオペレーターの任意のネットワークを介して同じMタイプオペレーターをソースとする）としても機能させることができます。 出力OでROIを出力するには、5つのすべての入力に画像を提供する必要があります。 すでに画像が提供されている入力は、すべての入力に画像が提供されるまでブロックされます。個々の入力、特に入力リンクIでのバッファリング要素の使用を強くお勧めします。 DynamicROIの動作は、すべての入力に画像が提供された場合にのみ開くバルブに例えることができます。
4つの制御入力のそれぞれに画像が到着するたびに、各制御リンクの最後のピクセルがDynamicROIによってキャプチャされます。 DynamicROIが制御入力ですべての画像を受信するとすぐにバルブが開き、画像がIからOへ通過できるようになります。 次に、キャプチャされたROI座標を使用してROIが抽出されます。 ROI画像がOに転送された後、バルブは再び閉じ、制御リンクに次の画像ROI座標セットが表示されるのを待ちます。
このオペレーターの重要な用途の1つは、CreateBlankImageおよびCoefficientBufferと組み合わせる場合や、Object Detection実装の結果と組み合わせて使用する場合です。 パラメータを使用してROI座標を制御するオペレーターはSelectROIです。
Operator Restrictions
- XlengthがリンクIおよびOのParallelismの整数倍でない場合、オペレーターはParallelismに合わせてROI幅を拡張します。 ダミーピクセルが各ラインの末尾に追加されます。 そのダミーピクセルの値は未定義です。 VAシミュレーションでは、視認性を高めるためにダミーピクセルはゼロに設定されます。
- ROI座標が無効な場合、つまりXlengthやYlengthがゼロであるか、オフセットが画像境界を超えている場合、 オペレーターは空の画像を切り出して出力するか、画像を削除します。この動作はパラメータSuppressEmptyRoIを使用して制御できます。
- オフセット座標は有効であるが、XlengthやYlengthの座標が画像境界を超えている場合、 オペレーターは画像境界に合わせてROIを縮小します。
- ROI入力に空の座標セット（高さと幅が0のROIフレームなど）が提供された場合、 DynamicROIオペレーターはそのような空のROIを無効な座標を持つROIとして扱います。 オペレーターは空の画像を切り出して出力するか、画像を削除します。この動作はパラメータSuppressEmptyRoIを使用して制御できます。
- ポートIにおける空の画像はサポートされていません。
- ポートIにおける各入力画像のラインは同じ長さでなければなりません。したがって、ラインの長さが異なる画像は許可されません。
| Property | 値 |
|---|---|
| オペレータータイプ | M |
| 入力リンク | I、画像入力 Xoffset、xオフセット入力 Yoffset、yオフセット入力 Xlength、x長入力 Ylength、y長入力 |
| Output Link | O, data output |
同期および非同期入力
- すべての入力は非同期です。つまり、異なるMタイプオペレーターをソースとする場合があります。
|
|
入力 Bit Width の範囲は [1, 64] です。 符号付き入力の場合の範囲は [2, 64] です。 符号なしカラー入力の場合の範囲は [3, 63] であり、符号付きカラーの場合の範囲は [6, 63] です。 |
|
|
制御入力で許可されるBit Widthは、入力リンクIの最大画像寸法から自動的に決定されます 
|
| SuppressEmptyRoI | |
|---|---|
| タイプ | static パラメータ |
| Default | ON |
| 範囲 | {ON, OFF} |
|
このパラメータは、ROI座標が無効な場合にオペレーターの出力から空の画像を削除するかどうかを制御します。 詳細については、Operator Restrictionsを参照してください。 |
|
DynamicROIオペレーターの使用方法を以下の例に示します。
-
例 - ブロブ解析オペレーターが入力カメラ画像に適用されます。 このアプレットは、アプレット内でのブロブデータの使用方法を示しています。 このケースでは、最大面積を持つオブジェクトが特定され、その座標を使用して元の画像からオブジェクトが切り出されます。
前へ
