Operator ImageNumber

Operator Library: Base

ImageNumber オペレーターは、出力リンクで入力リンクの現在画像のインデックスを提供します。 これにより、入力の各ピクセルは画像のインデックス、つまり画像番号に置き換えられます。 実際の入力ピクセル値は使用されません。 このオペレーターは、入力に新しい画像が入るたびにインクリメントされるCounterとして機能します。 Counterは、プロセスの開始時('Multiple Processes')または最大値に達した後にリセットされます。 最初の画像の画像インデックスは0になります。

出力リンクOの Bit Width を変更することで、Counterの幅を定義できます。 Counterが最大値に達すると、再びゼロから開始されます(ラップアラウンド条件)。 例えば、出力の Bit Width が8 bitの場合、Counterの値は0から255の間になります。

パラメータ SingleShot を使用すると、ラップアラウンド条件でオペレーターはリセットされません。 Counterの出力値は最大値のまま維持されます。 したがって、8 bitのイメージ Counterの場合、Counterの値は最大値の255のままになります。

多くの場合、このオペレーターは RemoveImage オペレーターと組み合わせて使用され、 シーケンスの最初のN個の画像を削除します。

Operator Restrictions

  • このオペレーターは空画像をサポートしています。 オペレーターはそれらの空画像をカウントします。 ただし、空画像の場合、空フレームの出力にはピクセルが含まれないため、 出力で Counter の値を提供することはできません。 次の非空画像の後に、出力リンクは正しい Counter の値を提供します。

I/O Property

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

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

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

1

入力 Bit Width の範囲は [1, 64] です。 符号付き入力の場合の範囲は [2, 64] です。 符号なしカラー入力の場合の範囲は [3, 63] であり、符号付きカラーの場合の範囲は [6, 63] です。

パラメーター

SingleShot
タイプ static パラメータ
Default OFF
範囲 {OFF, ON}

このパラメータはラップアラウンド条件を制御します。 OFFに設定すると、Counterは処理された画像ごとに無限にカウントします。 つまり、出力リンクの Bit Width によって定義される最大可能な Counter 値でラップアラウンドが発生します。

ONに設定すると、最大可能な値に達するまでCounterはカウントを続けます。 Counterは最大値でカウントを停止します。

使用例

ImageNumber オペレーターの使用法を次の例に示します。