オペレーター InsertImage

Operator Library: Synchronization

オペレータ InsertImage は、n個の入力リンク I[0] .. I[n-1] を出力リンク O にマルチプレックスします。 したがって、オペレータはすべての入力の入力画像をシーケンシャルな順序で O から出力します。

オペレータは、入力画像を順番に出力へと転送します。 まず入力リンク I[0] が処理され、次にリンク I[1] が処理されます。リンク I[n-1] の後、オペレータは I[0] の次の画像から再度処理を開始します。 オペレータは、現在選択されている入力に画像が存在するまで待機します。 そのため、入力をスキップすることはできません。 「早い者勝ち」の処理戦略はありません。

説明したように、オペレータは特定の時点で特定の入力のみを転送します。 1つの入力が処理されている間、他のすべての入力はブロックされます。 ブロックされた入力に画像が存在する場合は、処理されるまでバッファリングできるようにしてください。 さらに、デッドロックの原因となるため、複数の入力が同じ画像ソースから供給されないようにユーザーが確認する必要があります。 正しい挿入方法の詳細については、「Basics and Examples」の 'Multiplex the Images of Two Cameras' を確認してください。

すべての入力 I[k] に対して、オペレータは制御入力 Ins[k] を提供します。 これらの入力は、画像データを使用してい出力に転送するか、破棄するかを制御するために使用されます。 Ins[k] 入力はバイナリデータを受け入れます。 それぞれの画像の最初のピクセルに 1 が指定された場合、画像は出力に転送されます。 一方、それぞれの画像の最初のピクセルに値 0 が指定された場合、画像は処理されますが破棄されます。

I[k] と Ins[k] のペアは同期しています。つまり、O-type オペレータの任意のネットワークを介して、同じ M-type ソースから供給される必要があります。 詳細については、'M-type Operators with Multiple Inputs' を参照してください。 したがって、これらのペアに SYNC オペレータは必要ありません。

オペレータの出力フレームレートは、入力フレームレートの n 倍高くなります。 ただし、出力 Parallelism は増加しません。 したがって、より多くのデータを転送する必要がある場合でも、出力帯域幅は入力帯域幅と等しくなります。 オペレータがデータを処理する前に、入力の Parallelism を増やす必要がある場合があります。

I[k] のすべての画像は、異なる高さと幅を持つことができます。 制御入力 Ins[k] は、空の入力画像の場合は無視されます。 これらの画像は出力に転送されず、つまり破棄されます。

I/O Property

Property 値
オペレータータイプ M
入力リンク I[0]、データ入力
I[k]、データ入力
Ins[k]、制御入力
Output Link O, data output

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

Link Parameter Input Link I[0] 入力リンク I[k] 入力リンク Ins[k] Output Link O
Bit Width [1, 64]1 as I[0] 1 as I[0]
Arithmetic {unsigned, signed} as I[0] unsigned as I[0]
Parallelism any as I[0] as I[0] as I[0]
Kernel Columns any as I[0] 1 as I[0]
Kernel Rows any as I[0] 1 as I[0]
Img Protocol VALT_IMAGE2D as I[0] as I[0] as I[0]
Color Format any as I[0] VAF_GRAY as I[0]
Color Flavor any as I[0] FL_NONE as I[0]
Max. Img Width any any I[k] として auto2
Max. Img Height any any I[k] として auto3

1

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

2

最大出力画像幅は、すべての I[k] 入力画像幅の最大値です。

3

最大出力画像高さは、すべての I[k] 入力画像高さの最大値です。

同期および非同期入力

  • 同期グループ: I[k] および Ins[k]
  • すべてのグループは相互に非同期です。

パラメーター

None

使用例

オペレータ InsertImage の使用法を以下の例に示します。