コンテンツにスキップ

imaWorx CXP-12 Quad用 Acquisition Applets#

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

フレームグラバーの機能は、ハードウェアに関連する特定のプログラムによって定義されます。このハードウェア実装は applet と呼ばれます。フレームグラバーごとに複数の applet が用意されています。

フレームグラバーにアプレットをロードすることで、フレームグラバーの機能が定義され、特定アプリケーションの要件に適応させることができます。

imaWorx CXP-12 Quad用のAcquisition Appletsは、Framegrabber SDKおよびpylon Software Suiteに同梱されています。

imaWorx CXP-12 Quad では、提供されているすべての applet がすでに imaWorx CXP-12 Quad フレームグラバー上に存在しますが、有効になっているのは 1 つだけです。imaWorx CXP-12 Quad で別の applet を有効にするには、Framegrabber SDK を使用した Applet の有効化またはpylon を使用したフレームグラバーの構成の手順に従ってください。

Acquisition Applets のほかに、Enhanced Applets を使用することもできます。Enhanced Applets はプロトタイプであり、お近くの Basler の担当営業またはフィールドアプリケーションエンジニアへの問い合わせによってのみ入手可能です。すべての Enhanced Applets には、次の追加機能があります。

要件#

  • ホストソフトウェア: ハードウェア依存の acquisition applet を備えた Framegrabber SDK（バージョン 5.9 以降）または pylon Software Suite（バージョン 6.3 以降）
  • ハードウェア: システムに接続された imaWorx CXP-12 Quad フレームグラバー

制限事項

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

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

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

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

Documentation#

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

エリア Acquisition Applets#

GenTL Fglib
Acq_SingleCXP12Area PDF Acq_SingleCXP12Area PDF
Acq_DualCXP12Area PDF Acq_DualCXP12Area PDF
Acq_TripleCXP12Area PDF Acq_TripleCXP12Area PDF
Acq_QuadCXP12Area PDF Acq_QuadCXP12Area PDF

ライン Acquisition Applets#

GenTL Fglib
Acq_SingleCXP12Line PDF Acq_SingleCXP12Line PDF
Acq_DualCXP12Line PDF Acq_DualCXP12Line PDF
Acq_TripleCXP12Line PDF Acq_TripleCXP12Line PDF
Acq_QuadCXP12line PDF Acq_QuadCXP12line 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_TripleCXP12Area
  • Acq_QuadCXP12Area

applet 名の分母である「single」、「dual」、「triple」、「quad」は、接続できるカメラの最大数を表しています。詳細については、エリアスカン用 Acquisition Applet の適切な選択を参照してください。

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

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

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

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

カメラの最大台数 1チャンネルカメラの台数 2チャンネルカメラの台数 4チャンネルカメラの台数 アプレット ROIステップサイズ[px]
4 1 Acq_QuadCXP12Area x：8
y：1
4 2 Acq_QuadCXP12Area x：8
y：1
4 3 Acq_QuadCXP12Area x：8
y：1
4 4 Acq_QuadCXP12Area x：8
y：1
3 1 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Areaa x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Areab x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Area x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Area x: 16/8/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_DualCXP12Areac x：16
y：1
2 2 Acq_DualCXP12Area x：16
y：1
1 1 Acq_SingleCXP12Areaa x：32
y：1
1 1 Acq_SingleCXP12Aread x：32
y：1
1 1 Acq_SingleCXP12Area x：32
y：1

すべてのエリアスキャン用 Acquisition Applets に共通する仕様#
最大画像サイズ [px] 32k x 64ke
カメラポート 4
カメラタイプ 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 から mono へ、
Bayer または mono から RGB へ
帯域幅合計 DMA [MB/s] f 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_TripleCXP12Area x：8
y：1		 最初の 2 台のカメラの場合は 1200
3 台目のカメラの場合は 2400		 1X-1Y のみ
Acq_QuadCXP12Area x：8
y：1		 1200 1X-1Y のみ

ラインスキャン用 Acquisition Applets#

以下のラインスキャン用 Acquisition Applets が利用可能です。

  • Acq_SingleCXP12Line
  • Acq_DualCXP12Line
  • Acq_TripleCXP12Line
  • Acq_QuadCXP12Line

applet 名の分母である「single」、「dual」、「triple」、「quad」は、接続できるカメラの最大数を表しています。詳細については、ラインスカン用 Acquisition Applet の適切な選択を参照してください。

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

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

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

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

カメラの最大台数 1チャンネルカメラの台数 2チャンネルカメラの台数 4チャンネルカメラの台数 アプレット ROIステップサイズ[px]
4 1 Acq_QuadCXP12Line x：8
y：1
4 2 Acq_QuadCXP12Line x：8
y：1
4 3 Acq_QuadCXP12Line x：8
y：1
4 4 Acq_QuadCXP12Line x：8
y：1
3 1 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 2 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 3 Acq_TripleCXP12Lineg x: 16/8/8
y: 1
3 1 Acq_TripleCXP12Lineh x: 16/8/8
y: 1
3 1 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
3 2 1 Acq_TripleCXP12Line x: 16/8/8
y: 1
2 1 Acq_DualCXP12Lineg x：16
y：1
2 2 Acq_DualCXP12Lineg x：16
y：1
2 1 Acq_DualCXP12Line x：16
y：1
2 1 1 Acq_DualCXP12Linei x：16
y：1
2 2 Acq_DualCXP12Line x：16
y：1
1 1 Acq_SingleCXP12Line x：32
y：1
1 1 Acq_SingleCXP12Line x：32
y：1
1 1 Acq_SingleCXP12Line x：32
y：1

すべてのラインスキャン用 Acquisition Applets に共通する仕様#
最大画像サイズ [px] 32k x 8Me
カメラポート 4
カメラタイプ 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] f 7200

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

ROIステップサイズ[px] 帯域幅: カメラあたりの平均 [MP/s]
Acq_SingleCXP12Line x：32
y：1		 4850
Acq_DualCXP12Line x：16
y：1		 2400
Acq_TripleCXP12Line x：16
y：1		 最初の 2 台のカメラの場合は 1200
3 台目のカメラの場合は 2400
Acq_QuadCXP12Line x：4
y：1		 1200

Frame Grabber Test Applet#

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

このアプレットには以下の機能が用意されています。

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

Acquisition Applets の使用#

Framegrabber SDKでのAcquisition Appletsの使用#

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

Appletのインストール#

フレームグラバーで特定の applet を使用するには、事前にフレームグラバーにインストールする必要があります。applet のインストールの詳細については、Managing Applets (microDiagnostics)を参照してください。

Appletを手動で追加する#

インストーラー形式ではなく *.dll ファイルとして受け取った applet をホストファイルシステムに追加するには、次のようにします。

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

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

画像取り込みのテスト#

独自のソフトウェアで（APIを介して）アプレットの使用を開始する前に、システムセットアップまたは個別のアプレット（とそのパラメータ設定オプション）をテストするとよいでしょう。

この目的のために、Framegrabber SDK 環境の一部としてコンピュータにインストールされている microDisplay X ツールが提供されています。applet のロードおよびテスト方法については、Configuring the Applet (microDisplay X)を参照してください。

アプレット設定の保存#

applet の設定（microDisplay X または Framegrabber API を使用）後、設定を保存できます。詳細については、Other Tasks (microDisplay X)を参照してください。

pylon での Acquisition Applets の使用#

pylonでアプレットを使用する方法については、pylonを使用したフレームグラバーの設定を参照してください。

  1. 8Kピクセルを超える画像を反転させる必要がある場合にのみ推奨されます。それ以外の場合は、QuadCXP12Areaを使用してください。 ↩↩↩↩↩↩

  2. 推奨されません。代わりにDualCXP12Areaを使用してください。 ↩

  3. 8Kピクセルを超える画像を反転させる必要がある場合にのみ推奨されます。それ以外の場合は、TripleCXP12Area（シングルチャンネルカメラのみ）を使用してください。 ↩

  4. 21840ピクセルを超える画像を反転させる必要がある場合にのみ推奨されます。それ以外の場合は、DualCXP12Areaを使用してください。 ↩

  5. この場合、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 ↩↩

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

  7. 8Kピクセルを超える画像を反転させる必要がある場合にのみ推奨されます。それ以外の場合は、QuadCXP12Lineを使用してください。 ↩↩↩↩↩

  8. 推奨されません。代わりにDualCXP12Lineを使用してください。 ↩

  9. 8Kピクセルを超える画像を反転させる必要がある場合にのみ推奨されます。それ以外の場合は、TripleCXP12Line（シングルチャンネルカメラのみ）を使用してください。 ↩