Operator Library: Base
SelectROI演算子は、入力リンクのフレームから矩形の関心領域（ROI）を抽出します。ROIは、X_Offset、X_Length、Y_Offset、Y_Lengthの4つのパラメータを使用して指定します。Xパラメータはピクセル単位で、Yパラメータは行単位で指定します。
パラメータの代わりにインプットリンクを使用してROI座標を設定する必要がある場合は、オペレーター DynamicROI を使用する必要があります。
ROIが完了するとすぐに、オペレーターは出力画像をファイナライズします。ROIが入力画像よりも小さい場合、入力画像のファイナライズよりも前に出力画像がファイナライズされる動作になる可能性があります。これは、最後のライン/ピクセルを待機する必要がある RemoveLine や RemovePixel などのオペレーターとは対照的です。
オペレーターの制限
X_OffsetとX_Lengthのパラメータの合計は、最大リンク画像幅を超えてはなりません。Y_OffsetとY_Lengthのパラメータの合計は、最大リンク画像高さを超えてはなりません。
ダイナミックROIパラメータの変更は、プロセス（つまり、アクルジション）が停止している場合にのみ許可されます。アクルジションの実行中に行った変更は、ROIには反映されません。これにより、パラメータ変更時の無効なROIを回避できます。
各入力画像のライン長は同じでなければなりません。したがって、ライン長が異なる画像は許可されません。
-
VisualAppletsでは、1ラインあたりのピクセル数、つまりライン幅が常にParallelismの倍数である必要があります。X_LengthがリンクのParallelismで割り切れない場合、オペレーターはダミーピクセルを挿入して最後のパラレルワードをFillします。例えば、リンクのParallelismが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 | |
|---|---|
| タイプ | スタティック/ダイナミック読み取り/書き込みパラメータ |
| Default | 0 |
| 範囲 | [0, MaxImgWidth - X_Length] |
|
このパラメータ値は（X_Offsetと共に）ピクセル単位でROIの左端の位置を定義します。 |
|
| Y_Offset | |
|---|---|
| タイプ | スタティック/ダイナミック読み取り/書き込みパラメータ |
| Default | 0 |
| 範囲 | [0, MaxImgHeight - Y_Length] |
|
このパラメータ値は（Y_Offsetと共に）ピクセル単位でROIの上端の位置を定義します。 |
|
| X_Length | |
|---|---|
| タイプ | スタティック/ダイナミック読み取り/書き込みパラメータ |
| Default | 1024 |
| 範囲 | [1, MaxImgWidth - X_Offset] |
|
このパラメーターは、ROIの幅を定義します。 |
|
| Y_Length | |
|---|---|
| タイプ | スタティック/ダイナミック読み取り/書き込みパラメータ |
| Default | 1024 |
| 範囲 | [1, MaxImgHeight - Y_Offset] |
|
このパラメーターは、ROIの高さを定義します。 |
|
前へ
