Operator DmaToPC

Operator Library: Hardware Platform

DmaToPC オペレーターは、VisualAppletsのアプレットとホストPC間の画像インターフェースです。DMAToPC オペレーターは、アプレットからホストPCへと画像を転送します。画像転送にはダイレクトメモリーアクセス(DMA)が使用され、画像データはホストPCのメモリに直接書き込まれます。

複数の Color Format、Bit Width、Parallelism がサポートされています。許可される組み合わせは、使用するハードウェアプラットフォームによって異なります:

  • imaFlex 2 Dual 100:

    • Bit Width と Parallelism の積は、8の整数倍であり、かつ512以下である必要があります。

    • 最大画像幅と最大画像高さの積は、4バイトで割り切れる必要があります。

  • imaFlex CXP-12 Quad および imaFlex CXP-12 Penta:

    • Bit Width と Parallelism の積は、8の整数倍であり、かつ256以下である必要があります。

    • 最大画像幅と最大画像高さの積は、4バイトで割り切れる必要があります。

  • microEnable 5 marathon VCLx、microEnable 5 marathon VCL、microEnable 5 marathon VCX-QP、microEnable 5 marathon VF2、および LightBridge VCL:

    オペレーター入力のリンクプロパティは、アプレットがサポートする PCIe モードによって異なります。サポートされている PCIe モードは、オペレーター AppletProperties のパラメーター PcieInterfaceType で選択できます。

    複数の Color Format、Bit Width、Parallelism がサポートされています。Parallelism x Bit Width の積の最大値は8の倍数であり、オペレーター AppletProperties で選択した PCIe モードによって異なります:

    • Generation_1: Parallelism x Bit Width <= 64 Bit.
    • Generation_2: Parallelism x Bit Width <= 128 bit

    最大画像幅と最大画像高さの積は、4バイトで割り切れる必要があります。

  • microEnable 5 ironman VD8-PoCL、microEnable 5 ironman VQ8-CXP6D(DINコネクタ)、および microEnable 5 ironman VQ8-CXP6B(BNCコネクタ):

    • オペレーター AppletProperties のパラメーター PcieInterfaceType が Generation_1 に設定されている場合、Bit Width と Parallelism の積は8の倍数であり、128以下である必要があります。

    • オペレーター AppletProperties のパラメーター PcieInterfaceType が Generation_2 に設定されている場合、Bit Width と Parallelism の積は8の倍数であり、256以下である必要があります。

[注] RGBからBGRへの変換

オペレーターはRGBデータをBGRデータに変換します(つまり、DMA転送の前にRコンポーネントとBコンポーネントが入れ替えられます)。DMA転送後、元のRGB画像はPCのRAM内でBGR画像として利用可能になります。この変換は、ほとんどのソフトウェアツールがBGRフォーマットを直接サポートしているため、ソフトウェアツールによる以降の処理を容易にするために実行されます。

ハードウェアプラットフォームで使用可能
imaFlex 2 Dual 100
imaFlex CXP-12 Penta
imaFlex CXP-12 Quad
microEnable 5 marathon VCLx
microEnable 5 marathon VCL
microEnable 5 marathon VCX-QP
microEnable 5 marathon VF2
LightBridge VCL
microEnable 5 ironman VQ8-CXP6D/-CXP6B
microEnable 5 ironman VD8-PoCL

リソース

このオペレーターは1つの VisualApplets リソースを使用します。

imaFlex 2 Dual 100:

imaFlex 2 Dual 100プラットフォームでは、オペレーターはDmaToHostPortタイプのVisualAppletsリソースを1つ使用します。プラットフォーム上で最大5つのDmaToPCオペレーターを使用できます。リソースインデックスは、0 → 1 → 2 → 3 → 4のように厳密な単調増加にする必要があります。最初のオペレーターには常にインデックス0を割り当て、後続の各オペレーターには次のインデックス(+1)を割り当てる必要があります。リソースインデックスに欠損があってはならず、インデックスは常に0から始まります。オペレーターのリソースダイアログでリソースインデックスを設定します。詳細については、「デバイスリソースの割り当て」を参照してください。

imaFlex CXP-12 Quad および imaFlex CXP-12 Penta:

imaFlex CXP-12 QuadおよびimaFlex CXP-12 Pentaプラットフォームでは、オペレーターはDMAタイプのVisualAppletsリソースを1つ使用します。オペレーターのリソースダイアログでリソースインデックスを設定します。詳細については、「デバイスリソースの割り当て」を参照してください。

I/O Property

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

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

Link Parameter Input Link I
Bit Width 説明を参照
Arithmetic unsigned
Parallelism 説明を参照
Kernel Columns 1
Kernel Rows 1
Img Protocol VALT_IMAGE2D
Color Format {VAF_COLOR, VAF_GRAY}
Color Flavor {FL_NONE, FL_RGB} If VAF_GRAY selected: FL_NONE; If VAF_COLOR selected: FL_RGB
Max. Img Width any
Max. Img Height any

パラメーター

CurrentTransferLength
タイプ 動的リードパラメータ
Default
範囲 [0; 2^34-1]

このパラメーターは、処理中のフレームのうち、すでに転送されたバイト数を反映します。この情報により、フレーム全体が送信される前に、ソフトウェアアプリケーションでDMAバッファーデータを解析できるようになります。

[注] 可用性

mE5 marathon VCLx、mE5 marathon VCL、mE5 marathon VCX-QP、mE5 marathon VF2、LightBridge VCL、mE5 ironman VQ8-CXP6D、およびmE5 ironman VQ8-CXP6B

使用例

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