オペレーター AppendLine

Operator Library: Synchronization

オペレーター AppendLine は、リンクIに入力された入力画像の画像行を結合し、リンクOの出力画像においてより大きな行を構成します。 新しい1行にマージされる行数は、パラメーター AppendNumber によって定義されます。 たとえば、AppendNumber が2に設定されている場合、オペレーターは入力画像の連続する2行を結合して、出力画像内の新しいより大きな1行を構成します。 入力画像の高さが AppendNumber パラメーター値で割り切れない場合、出力画像の最後の行は短くなり、 残りの入力画像の最後の行が結合されたものが含まれます。

このオペレーターはフレームレートや帯域幅を変更しないことに注意してください。

オペレーターの出力リンク画像プロトコルは、VALT_PIXEL0D（つまり、オペレーターがすべての受信行を無制限の幅の行に結合する）に設定することもできます。 したがって、このオペレーターを使用して、2D画像ストリームまたは1Dラインストリームを0Dピクセルストリームに変換できます。

取り込みの実行中に AppendNumber の値を動的に変更する場合でも、オペレーターは行の整合性を保証します。 オペレーターは、出力行が完了するまで古い AppendNumber の値を保持します。 現在の出力行が完了した後、オペレーターはさらにマージを行うために新しい AppendNumber の値の使用を開始します。

[Warning] 最大画像寸法を超えることの防止

このオペレーターを使用すると、出力リンクで定義された最大画像幅および高さを超える可能性があります。したがって、 結合された入力行が出力リンクのパラメータ化された最大画像幅を超えないように常に確認してください。 また、出力リンクのパラメータ化された最大画像高が十分に大きいことを確認してください。 画像幅または高さがリンクのプロパティで指定された制限を超えている場合、後続のオペレーターが正常に動作しない可能性があります。

たとえば、幅1024の3つの入力行が結合されます。 出力画像の幅は3072になります。 VisualAppletsオペレーターの正しい機能を確保するために、この幅を出力リンクで指定する必要があります。

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_LINE1D} {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format any as I
Color Flavor any as I
Max. Img Width any any2
Max. Img Height any any

1

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

2

最大画像幅は、パラメーター AppendNumber と入力画像幅を乗算した値以上である必要があります。

パラメーター

AppendNumber
タイプ 動的読み取り/書き込みパラメータ
Default 1
範囲 Input IMAGE2D: [1, Input Maximum Image Height]; Input LINE1D: [1, Output Maximum Image Width / Parallelism]

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

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

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

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

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

正確に1つの出力画像が生成されます。残りの入力行は破棄されます。

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

シミュレートされた0D出力ストリーム内の入力ピクセル数。

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

正確に1つの出力画像が生成されます。残りの入力ピクセルは破棄されます。

使用例

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

  前へ     レベルアップ     Next  
目次 上面 ホーム