コンテンツにスキップ

imaFlex CXP-12 Penta用アプレット#

このトピックでは、imaFlex CXP-12 Pentaフレームグラバーで使用できるAcquisition Appletsについて説明します。

システムリソースの最適な使用を確保するため、imaFlex CXP-12 Penta用に設計されたすべての画像取り込みおよび処理機能が同時にimaFlex CXP-12 Pentaにロードされるわけではありません。その代わりに、特定のアプリケーション分野の要件を満たすように組み合せた、画像取り込みおよび処理機能のさまざまなコンパイルがBaslerから提供されます。

通常、appletは特定のカメラインターフェース規格とトポロジ、特定の画像取り込み機能、および場合によっては特定の画像（前）処理機能をサポートしています。フレームグラバーにappletをロードすることで、フレームグラバーの機能を定義し、特定のアプリケーションの要件に適応させます。

アプレットには、Baslerが常に提供するアクリジションアプレット（*.dll）と、ユーザー自身またはBaslerがVisualAppletsで開発したカスタムアプレット（*.hap）の2種類があります。納品物に同梱されているアクリジションアプレットに加え、imaFlex CXP-12 Pentaは、特定のアプリケーションで必要とされる高度な画像処理タスクを実行するようにプログラミングできます。プログラミングは、Basler、認定パートナー、または使いやすいグラフィカルなFPGAプログラミング環境であるVisualAppletsを使用してご自身で行うことができます。

imaFlex CXP-12 Penta用のAcquisition Appletsは、Framegrabber SDKおよびpylon Software Suiteに含まれています。

要件#

  • ホストソフトウェア： Framegrabber SDK バージョン 5.11.3以降
  • ハードウェア： imaFlex CXP-12 Pentaフレームグラバーがシステムに接続されていること

制限事項

すべてのアプレットにおいて、4 GBを超えるバッファを割り当てることはできません。アプレットでより大きなバッファサイズが許可されている場合でも、ドライバーとファームウェアの制限により、4 GBを超えるバッファの割り当てはできません。

バッファサイズは次のように計算できます。

バッファサイズ = 画像の高さ * 画像の幅 * (ピクセル幅 / 8)

RGB画像の場合：バッファサイズ = (画像の高さ * 画像の幅 * (ピクセル幅 / 8)) * 3

Documentation#

以下のセクションでは、acquisition applets のドキュメントへのリンクを提供しています。

Area Acquisition Applets#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_PentaCXP12Area PDF Acq_PentaCXP12Area PDF

Line Acquisition Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_PentaCXP12line PDF Acq_PentaCXP12line PDF

Frame Grabber Test Applet#

GenTL Fglib
Frame Grabber Test Applet PDF Frame Grabber Test Applet PDF

エリアスキャン用 Acquisition Applets#

以下のエリアスキャン用 Acquisition Appletsを利用できます：

  • Acq_SingleCXP12Area
  • Acq_DualCXP12Area
  • Acq_PentaCXP12Area

アプレット名に含まれる「single」「dual」「penta」という用語は、接続できるカメラの最大数を表しています。詳細については、最適なエリアスキャンアクリジションアプレットの選択を参照してください。

エリアスキャン用 Acquisition Applets の選び方#

カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラから受信した画像を正しく処理・表示できなくなったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。

どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。

ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。

最大カメラ台数 1チャンネルカメラの数 2チャンネルカメラの数 4チャンネルカメラの数 アプレット ROIステップサイズ[px]
5 1 Acq_PentaCXP12Area x：8
y：1
5 2 Acq_PentaCXP12Area x：8
y：1
5 3 Acq_PentaCXP12Area x：8
y：1
5 4 Acq_PentaCXP12Area x：8
y：1
5 5 Acq_PentaCXP12Area x：8
y：1
2 1 Acq_DualCXP12Areaa x：16
y：1
2 2 Acq_DualCXP12Areaa x：16
y：1
2 1 1 Acq_DualCXP12Area x：16
y：1
2 1 Acq_DualCXP12Area x：16
y：1
2 2 Acq_DualCXP12Area x：16
y：1
1 1 Acq_SingleCXP12Areaa x：32
y：1
1 1 Acq_SingleCXP12Areab x：32
y：1
1 1 Acq_SingleCXP12Area x：32
y：1

すべてのエリアスキャン用 Acquisition Applets に共通の仕様#
最大画像サイズ [px] 32k x 64kc
CXPポート 5
最大CXP速度 CXP-12
処理ビット深度 [bit] 16（Bayerデモザイキングの場合は14）
Pixel Formats Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
Bayer8-14
YUV422_8
ミラーリング はい（水平および垂直）
Image Selector はい
Bayer Color Reconstruction (HQe) はい、High Quality Extended (HQe)
ホワイトバランス はい
LUT フル解像度
Pixel Format変換 RGBまたはBayerからモノクロへの変換、
BayerまたはモノクロからRGBへの変換
帯域幅合計 DMA [MB/s]d 7200

エリアスキャン用 Acquisition Applets 間で異なる仕様#

ROIステップサイズ[px] 帯域幅：カメラあたりの平均 [MP/s] タップジオメトリのソート
Acq_SingleCXP12Area x：32
y：1		 4850 1X-1Y、1X-2YE
Acq_DualCXP12Area x：16
y：1		 2400 1X-1Y、1X-2YE
Acq_PentaCXP12Area x：8
y：1		 1200 1X-1Yのみ

ラインスキャン用 Acquisition Applets#

次の Line Scan Acquisition Applets が利用可能です：

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_PentaCXP12Line

アプレット名に含まれる「single」、「dual」、「penta」は、接続できるカメラの最大数を指しています。詳細については、最適なラインスキャンアクリジションアプレットの選択を参照してください。

ラインスキャン用 Acquisition Applets の選び方#

カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラが動作しなかったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。

どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。

ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。

最大カメラ台数 1チャンネルカメラの数 2チャンネルカメラの数 4チャンネルカメラの数 アプレット ROIステップサイズ[px]
5 1 Acq_PentaCXP12Line x：8
y：1
5 2 Acq_PentaCXP12Line x：8
y：1
5 3 Acq_PentaCXP12Line x：8
y：1
5 4 Acq_PentaCXP12Line x：8
y：1
5 5 Acq_PentaCXP12Line x：8
y：1
2 1 Acq_DualCXP12Linee x：16
y：1
2 2 Acq_DualCXP12Linee x：16
y：1
2 1 1 Acq_DualCXP12Line x：16
y：1
2 1 Acq_DualCXP12Line x：16
y：1
2 2 Acq_DualCXP12Line x：16
y：1
1 1 Acq_SingleCXP12Linee x：32
y：1
1 1 Acq_SingleCXP12Linef x：32
y：1
1 1 Acq_SingleCXP12Line x：32
y：1

すべてのラインスキャン用 Acquisition Applets に共通の仕様#
最大画像サイズ [px] 32k x 8Mc
カメラポート 5
カメラタイプ CXP-12
処理ビット深度 [bit] 16（BiColorからBGR/RGBへの変換の場合は12ビット）
Pixel Formats Mono8-16
RGB8-16
RGBa8
BGR8-16
BGRa8
BiColor8-12
YUV422_8
ミラーリング はい（水平および垂直）
タップジオメトリのソート 1X-1Yのみ
Image Selector はい
カラーアレイフィルター はい、2ライン BiColor です
ホワイトバランス はい
LUT フル解像度
Pixel Format変換 RGB または BiColor からモノクロへ、
モノクロまたは BiColor から RGB へ
帯域幅：合計 DMA [MB/s]d 7200

ラインスキャン用 Acquisition Applets 間で異なる仕様#

ROIステップサイズ[px] 帯域幅：カメラあたりの平均 [MP/s]
Acq_SingleCXP12Line x：32
y：1		 4850
Acq_DualCXP12Line x：16
y：1		 2400
Acq_PentaCXP12Line x：8
y：1		 1200

Frame Grabber Test Applet#

このアプレットは Frame Grabber Test Applet です。その目的はハードウェアをテストすることです。

アプレットには次の機能が備わっています：

機能 説明
DMAパフォーマンスのテスト さまざまなメモリサイズと割り込みレートに対して異なる画像サイズをテストします
RAMテスト エラーと処理を確認します
カメラポートの画像取り込みの確認 カメラポートからの画像取り込みを確認します
カメラへのトリガー信号の送信 カメラにトリガー信号を送信します
GPIOモニタリング GPIを監視し、GPOを設定します
イベントテスト ソフトウェアコールバックイベントを生成します
総合モニタリング FPGA温度、電源管理、PoCXPなどを監視します
DMAfromPC DMAを介してフレームグラバーに画像を送信します。

Acquisition Applets の使用#

Framegrabber SDKでのAcquisition Appletsの使用#

Framegrabber SDKでのアプレットの使用に関する一般的な情報については、Acquisition Appletsを参照してください。

Applets のインストール#

フレームグラバーで特定のアプレットを使用する前に、フレームグラバーにアプレットをインストールする必要があります。アプレットのインストールの手順については、アプレットの管理 (microDiagnostics) を参照してください。

Applet の手動追加#

インストーラーの形式ではなく、*.dllファイルとして受け取ったアプレットをホストファイルシステムに追加するには、次の手順を実行します。

  1. 受け取ったアプレットファイル (*.dll) を用意します。
  2. Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<frame grabber model>

これで、新しいアプレットを使用できるようになります。

画像取得のテスト#

独自ソフトウェア内で（APIを介して）アプレットを使用し始める前に、システム構成や個別のアプレット（およびそのパラメータ設定オプション）をテストすることをお勧めします。

この目的のために、Framegrabber SDK 環境の一部としてホストコンピューターにインストールされている microDisplay X ツールが提供されています。アプレットをロードしてテストする方法については、アプレットの設定 (microDisplay X) を参照してください。

Applet 設定の保存#

アプレットを設定した後（microDisplay XまたはFramegrabber API経由）、設定を保存できます。詳細については、Other Tasks (microDisplay X)を参照してください。

  1. 5456ピクセルを超える画像をミラーリングする必要がある場合にのみ推奨されます。それ以外の場合はPentaCXP12Areaを使用してください。 ↩↩↩

  2. 21840ピクセルを超える画像をミラーリングする必要がある場合にのみ推奨されます。それ以外の場合はDualCXP12Areaを使用してください。 ↩

  3. この場合のk PxおよびM Pxはバイナリ形式を指します。バイナリ計算の例は次のとおりです。

    16M px = 16384k px = 16777216 px

    8M px = 8192k px = 8388608 px

    64k px = 65536 px

    48k px = 49152 px

    32k px = 32768 px

    16k px = 16384 px ↩↩

  4. 実際のDMA帯域幅は、ホストコンピュータの特定のマザーボードおよびチップセットによって異なります。 ↩↩

  5. 8kピクセルを超える画像をミラーリングする必要がある場合にのみ推奨されます。それ以外の場合はPentaCXP12Lineを使用してください。 ↩↩↩

  6. 21840ピクセルを超える画像をミラーリングする必要がある場合にのみ推奨されます。それ以外の場合はDualCXP12Lineを使用してください。 ↩