VisualApplets
オペレーターリファレンス

Operator Library: Memory

このオペレーターを使用すると、ホストPCからフレームグラバーへ画像ファイルをアップロードし、連続して出力して画像ソースとして使用することができます。ここでは画像ファイルが汎用データコンテナとして使用されます。そのため、アップロードされた画像には、係数などの任意のデータを含めることができます。すべての係数画像は同じピクセル幅と高さを持つ必要がありますが、フォーマットは完全に異なっていてもかまいません。たとえば、リンク0の係数画像はGRAY 8 bitフォーマットにすることができます。リンク1ではRGB16フォーマットの画像を提供できます。また、リンク2はバイナリ画像にすることができます。すべての係数画像は Frame Grabber RAM (DRAM)に格納されます。タイプ RAMのVisualAppletsリソースが1つ必要です。詳細については、'Allocation of Device Resources'を確認してください。オペレーターのレイテンシについては、Table 46, 'Individual Latencies of the Operators in Library Memory'を参照してください。

CoefficientBufferは、imaFlex CXP-12 QuadおよびimaFlex CXP-12 Pentaプラットフォームでは利用できません。

CoefficientBufferは、imaFlex CXP-12 QuadおよびimaFlex CXP-12 Pentaプラットフォームではサポートされていません。'Functional Example for Loading Test Images Using ImageInjector'の例では、ImageInjectorオペレーターを使用して、imaFlex CXP-12 QuadまたはimaFlex CXP-12 Penta上でCoefficientBufferオペレーターの機能をテスト画像ソースとして代替する方法を示しています。 '2D Shading Correction / Flat Field Correction Using Operator RamLUT'の例は、2Dシェーディング補正のためにCoefficientBufferの代わりにRamLUTを使用する方法を示しています。

リンクの数は、CoefficientBufferに格納されている係数画像の数に対応します。係数画像は、画像acquisitionが実行されていないときに、ソフトウェアを介してのみFPGAバッファにアップロードできます。これを行うには、パラメーター LoadCoefficientsに書き込みを行います。

オペレーターの出力ポートは同期して動作します。最初の画像ピクセルの転送は、すべての出力ポートで全く同時に開始されます。すべての画像が受信側オペレーターに転送されると、CoefficientBufferは再び同期して画像の出力を開始します。

	シミュレーション中の動作
	オペレーターのリンク上の画像は同時に出力されます。1つのシミュレーションステップにおいて、オペレーターは各リンクに出力される画像を最大1つとします。シミュレーションステップ中に格納されたすべての画像（各リンクに1つ）が受信側オペレーターに転送された場合、つまりブロッキングが発生しなかった場合、次のシミュレーションステップでも同じ出力（各リンクに1つの画像）が転送されます。

CoefficientBufferは、関心領域（RoI）の管理もサポートしています。RoIは、4つのパラメーター（XOffset、XLength、YOffset、YLength）によって定義されます。XOffsetとYOffsetはRoIの左上隅、つまりピクセル単位の開始座標を定義します。RoIの寸法は、パラメーター BufferWidthおよび BufferHeightによって定義される格納された係数画像の寸法を超えてはなりません。RoIは、acquisition中、またはacquisitionが実行されていないときに、4つのRoI座標パラメータすべてに新しい値を設定し、UpdateROIパラメータに書き込むことで、動的に更新できます。なお、XLengthはリンクのBit Widthの粒度も満たしている必要があることに注意してください。つまり、XLength modulo LinkParallelism = 0となります。

各出力リンクに対して、係数画像ファイルがバッファに格納されます。つまり、リンク0には係数画像0が提供されます。係数画像は、acquisitionが開始される前にCoefficientBufferにロードされる必要があります。係数画像は、パラメータ CoefficientFile Nで指定されたファイルに格納される必要があります。Nは、それぞれリンク番号または係数画像番号を表します。係数ファイルはTIF形式でエンコードされている必要があります。

BufferWidthは、CoefficientBufferに格納されているすべての係数画像の幅をピクセル単位で指定します。

BufferHeightは、CoefficientBufferによって管理されるすべての係数画像の高さをピクセル単位で指定します。BufferWidthと BufferHeightは、すべての出力リンクの最大出力画像寸法を決定します。

グレースケールリンクには、グレースケール画像ファイルを使用する必要があります。カラーリンクには、RGB画像ファイルを使用する必要があります。

リンクのBit Widthが画像ファイルのBit Widthよりも高い場合、オペレーターは複数の画像ファイルピクセルを使用して出力ピクセルを生成します。たとえば、22 bitのリンクでは、8 bitの画像ファイルで3つのピクセルが必要になります。したがって、画像ファイルの画像幅は、パラメータ BufferWidthの3倍である必要があります。

リンクのBit Widthが画像ファイルのBit Widthよりも小さい場合、オペレーターは入力画像ファイルの下位ビットのみを使用します。たとえば、8 bitの画像ファイルと3 bitのリンクでは、ファイルのビット0、1、2が使用されます。

16 bit TIFファイルの使用には十分注意する必要があります。

Parameter LoadCoefficientsは、画像acquisitionが開始される前に、係数画像のバッファへのロードを開始するために使用されます。ロードは、書き込みサイクルまたはこのパラメータへの値1の書き込みによってトリガーされます。値0を書き込んでも効果はありません。

Parameter UpdateROIは、画像acquisitionの実行中または画像が取得されていないときに、現在のRoIを動的に更新するために使用されます。このパラメータに書き込む前に、新しいRoIを4つのRoI座標パラメータで指定する必要があります。書き込まれた値は更新プロセスには影響せず、書き込みサイクルのみがそれをトリガーします。つまり、書き込まれた値は0または1のいずれでもかまいません。

Parameter XOffsetは、左側の画像境界からRoIの最初の列までの水平方向のオフセットを指定します。指定された値はピクセル単位で測定され、BufferWidth-1の値を超えてはなりません。

Parameter XLength specifies the length of the RoI in horizontal direction in pixels. The specified value must not exceed BufferWidth and must be divisible by the output link parallelism. Also the following constraint must be met: XOffset + XLength <= BufferWidth.

Parameter YOffsetは、上部の画像境界からRoIの最初の行までの垂直方向のオフセットを指定します。YOffsetはピクセル単位で指定する必要があり、BufferHeight-1を超えてはなりません。

Parameter YLength specifies the length of the RoI in vertical direction in pixels. The length must not exceed BufferHeight. Furthermore, the following constraint must be met: YOffset + YLength <= BufferHeight.

Parameter CoefficientFile Nは、TIF形式で保存されたリンクNの係数画像のファイル名を指定します。

注意

リンク0のParallelismによって、他のすべてのリンクのParallelismが決定されます。 リンク0のParallelismを設定すると、新しいParallelismで割り切れるようにXLengthの値が修正されます。これは将来のVAバージョンでは異なる方法で処理される可能性があります。つまり、リンクのParallelism属性のスピンボックスで上下ボタンを使用すると、XLengthが変更される可能性があるということです。したがって、すべてのリンクが接続され指定された後に、XLengthの設定を確認することをお勧めします。 パラメータBufferWidthとBufferHeightを設定すると、いずれかの座標が新しい画像寸法を超える場合に備えて、RoI座標が修正されます。座標は、可能な限り最も近い有効な値に修正されます。 CoefficientBufferは、2D、1D、および0Dの画像をサポートしています。1D画像および0D画像の場合、オペレーターは、フレーム終了マーカーやライン終了マーカーを生成することなく、2D画像として保存されている係数画像を連続的に提供します。 このオペレーターは1つのDDRRAMバンクを使用します。そのため、係数画像のストレージ容量は、1オペレーターあたり1つのRAMバンクの容量（mE5ボードでは256MByteなど）に制限されます。さらに、DDRRAMの内部フォーマットに起因して、実際のストレージ容量が物理的なストレージ容量よりもわずかに少なくなる場合があります。使用されるストレージ容量は、リンクフォーマットおよび各リンクのピクセル幅に関連しています。最適なケースでは、すべてのリンクのピクセル幅の合計が1つのRAMバンクの容量（mE5の場合は256）で割り切れます。この場合、すべての係数画像を1つのMemoryバンクにまとめて保存できます。それ以外の場合、ストレージの使用効率は最適でなくなります。ハードウェアプラットフォームの詳細については、Device Resourcesを確認してください。

帯域幅の最適化

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

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

オペレータを通過する maximum bandwidth は、Bit Width と Parallelism の積が内部 RAM ポート幅 x 2（読み取り専用パラメータの場合に該当）と等しいときに達します。

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

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

Link Parameter	出力リンク O[n]
Bit Width	[1, 64]
Arithmetic	{unsigned, signed}
Parallelism	any
Kernel Columns	1
Kernel Rows	1
Img Protocol	{VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format	any
Color Flavor	any
Max. Img Width	BufferWidth
Max. Img Height	BufferHeight

	出力 Bit Width の範囲は、符号なし入力の場合は [1, 64] です。符号付き入力の場合は [2, 64] です。符号なしカラー入力の場合は [3, 63] で、符号付きカラー入力の場合は [6, 63] です。
	Bit Width と Parallelism の積は、ネイティブの RAM データ幅を超えてはなりません。詳細については、Device Resources を確認してください。