Operator AppendImage

Operator Library: Synchronization

AppendImageオペレータは、入力画像を結合して1つの大きな出力画像を生成します。 出力リンク O で結合される画像の数は、パラメータ AppendNumber によって定義されます。 例えば、AppendNumber が 2 に設定されている場合、 オペレータは2つの連続した画像を組み合わせて、より大きな新しい画像を生成します。

このオペレータは、元の帯域幅を維持しながら出力のフレームレートを低下させることに注意してください。 フレームレートは AppendNumber の係数分だけ低下します。

また、オペレータの出力リンクの画像プロトコルを VALT_LINE1D に設定することもできます。 この場合、オペレータはすべての入力画像を高さが無制限の1つの画像に結合します。 これにより、このオペレータを使用して 2D 画像ストリームを 1D ラインストリームに変換できます。 VisualApplets のシミュレーションで 2D から 1D への変換を使用する場合、画像は結合されません。 シミュレーションでは、入力画像ごとに 1 つの出力画像が生成されます。

取り込みの実行中に動的に AppendNumber の値を変更した場合でも、 オペレータは画像の整合性を保証します。 オペレータは、出力フレームが完了するまで古い AppendNumber の値を保持します。 現在の出力フレームが完了した後に、オペレータは以降の結合処理に対して新しい AppendNumber の値を使用し始めます。

[注意] 最大画像高さを超えています

このオペレータを使用すると、出力リンクで定義されている最大画像高さを超える可能性があることに注意してください。 結合された入力画像が、出力リンクのパラメータ化された最大画像高さを超えないように常に確認してください。 画像高さを超えた場合、後続のオペレータが正しく動作しない可能性があります。

例えば、高さ 1024 の入力画像が 3 つ結合される場合、 出力画像の高さは 3072 になります。 したがって、VisualApplets オペレータの正しい機能を確保するために、出力リンクの最大画像高さは 3072 以上に設定する必要があります。

[ヒント] 1D から 2D への変換

1D から 2D への変換を実行するには、SplitImage オペレータを使用できます。SplitImage オペレータに関するドキュメントを参照してください。

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_IMAGE2D, VALT_LINE1D
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any any2

1

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

2

最大出力画像高さは、パラメータ AppendNumber と入力画像高さを掛けた値以上である必要があります。 ただし、出力リンクの画像プロトコルが VALT_LINE1D に設定されている場合、パラメータ AppendNumber は無効になります。

パラメーター

AppendNumber
タイプ 動的読み取り/書き込みパラメータ
Default 1
範囲 [1, Max. Image Height(output link)]

単一の出力画像に結合される入力画像の数。

このパラメータは、出力リンクの画像プロトコルが VALT_IMAGE2D に設定されている場合にのみ変更できます。

LinesToSimulate
タイプ 静的読み取り/書き込みパラメーター
Default 1
範囲 [1, 2^32 - 1]

シミュレートされた1D出力ストリーム内の行数。

このパラメータは、出力プロトコルが VALT_IMAGE1D に設定されている場合にのみ、シミュレーションで使用できます。

Background information: In VisualApplets simulation, there are always 2-dimensional images created. To be able to simulate lines, this parameter has been created (for simulation only). The parameter allows to specify the number of lines that are to be simulated. During simulation, these lines are put together to one 2-dimensional "image". This way, the individual lines can be simulated. All lines that come in after the number specified in LinesToSimulate has been reached are discarded. Exactly one 2-dimensional output image is generated for simulation.

使用例

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