Operator ImageSequence

Operator Library: Memory

ハードウェアプラットフォームの可用性
このオペレータは、microEnable 4シリーズ(Pixelplantを含む)のターゲットプラットフォームでのみ利用可能ですのでご注意ください。

この演算子の主な特徴は、 SequenceLength個の連続した入力画像をバッファリングすることです。このシーケンスは同時に出力されます。さらに、関心領域(ROI)機能も含まれています。

このオペレータは、イメージストリームを Frame Grabber RAM (DRAM) にバッファリングします。 タイプ RAM の VisualApplets リソースが1つ必要です('Allocation of Device Resources'を参照)。

オペレーターのレイテンシについては、「表 46:Library Memory 内のオペレーターの個別のレイテンシ」を参照してください。

画像シーケンスの同時出力は、 SequenceLength列のカーネルを使用して実行されます。各カーネルコンポーネントはシーケンスの1つの画像を表し、つまり画像シーケンス番号に対応します。たとえば、シーケンス長が3の場合、入力画像0はカーネルインデックス0に、画像1はカーネルインデックス1に、画像2はカーネルインデックス2に出力されます。次に、演算子は次のシーケンスに連続して接続され、入力画像3はカーネルインデックス0に出力されます。

オペレータは帯域幅を変更しません。読み書き時の帯域幅は一定に保たれます。ただし、出力画像のフレームレートは、入力時のフレームレートの 1/ SequenceLengthになります。また、出力画像は(カーネルのため)単一の入力画像よりも N 倍大きくなります。

このオペレータはFIFOバッファのように動作します。シーケンスを生成するのに十分な画像がバッファリングされると、オペレータはそのシーケンスを出力します。この間、次の画像はバッファに格納されます。

XOffset 、 XLength 、 YOffset 、 YLengthというパラメータを使用することで、ROIのサイズを定義できます。

[Warning] 液面レベルと流量制御なし

このオペレータには、充填レベルをチェックするパラメータも、オーバーフローをチェックするパラメータも含まれていません。さらに、InfiniteSource パラメータも含まれていません。オペレータは常に、入力に無限ソースが存在することを前提としています。オペレータがオーバーフロー状態にあるかどうかを確認することはできません。フロー制御の詳細については、 「無限ソース / カメラの接続」を参照してください。

Operator Restrictions

  • 空のフレームはサポートされていません。

  • ライン長が変動する画像はサポートされていません。

  • シーケンス内のすべての入力画像は、同じ幅と高さでなければなりません。そうでない場合、演算子の動作は未定義となります。

  • 入力画像の最小許容幅はXOffset + XLength、最小許容高さはYOffset + YLengthです。

  • 使用可能なRAM容量には制限があります。また、内部実装の都合上、利用可能なバッファは物理的な容量よりも小さくなる場合があります。必要なメモリ容量は、画像の最大幅、最大高さ、およびシーケンス長によって決まります。画像の最大幅が2のべき乗であれば、メモリは効率的に使用されます。詳細については、 「デバイスリソース」を参照してください。

帯域幅の最適化

Frame Grabber RAM (DRAM) を使用するオペレーターを通過する理論上の帯域幅 [ビット/秒] は、次の式に従って計算されます。

しかし、実際の帯域幅はDRAMの効率により、常に理論上の帯域幅よりも小さくなります。

オペレーターを通過する最大帯域幅は、Bit WidthとParallelismの積が内部のRAM Port Widthと等しい場合に達します。

[注] プラットフォーム固有の値

RAM Port WidthとSystem Clockはプラットフォーム固有のものです。 個々のプラットフォームの詳細については、Device Resourcesを参照してください。

I/O Property

Property 値
オペレータータイプ M
Input Link I、画像データ入力
Output Link O、データ入力

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

Link Parameter Input Link I Output Link O
Bit Width [1, 64]12 as I
Arithmetic {unsigned, signed} as I
Parallelism any3 as I
Kernel Columns 1 シーケンス長 as I
Kernel Rows 1 as I
Img Protocol VALT_IMAGE2D as I
Color Format any as I
Color Flavor any as I
Max. Img Width 65535 as I
Max. Img Height any as I

1

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

2 3

ビット幅とParallelismの積が、ネイティブのRAMデータ幅を超えてはなりません。 詳細については、Device Resourcesを確認してください。

パラメーター

SequenceLength
タイプ static パラメータ
Default 2
範囲 [2、RAMサイズによっては可能]

このパラメータは、シーケンスに連結する画像の数を定義します。パラメータSequenceLengthの値は、カーネルの列数を定義します。

XOffset
タイプ dynamic/static read/write parameter
Default 0
範囲 [0, Max.Img Width - XLength]

このパラメータは、ROIの左上隅のX座標を定義します。

ステップサイズはParallelismです。

XLength
タイプ dynamic/static read/write parameter
Default 1024
範囲 [2* Parallelism 、最大画像幅 - Xオフセット]

このパラメータはROIの幅を定義します。

The step size is the parallelism.

YOffset
タイプ dynamic/static read/write parameter
Default 0
範囲 [0, Max.Img Height - YLength]

このパラメータは、ROIの左上隅のY座標を定義します。

YLength
タイプ dynamic/static read/write parameter
Default 1024
範囲 [2, 最大画像高さ - Yオフセット]

This parameter defines the height of the ROI.