marathon VCX-QP用 Acquisition Applets#
フレームグラバーの機能は、特定のハードウェア関連プログラムによって定義されます。このハードウェア実装はアプレットと呼ばれます。各フレームグラバーには、複数のアプレットが用意されています。
フレームグラバーにアプレットをロードすることで、フレームグラバーの機能が定義され、特定アプリケーションの要件に適応させることができます。
marathon VCX-QP用のAcquisition Appletsは、Framegrabber SDKに含まれています。
marathon フレームグラバーでは、アプレットをフレームグラバーにフラッシュするとすぐに使用できるようになります。
要件#
- ホストソフトウェア：ハードウェア依存の acquisition applets を含む Framegrabber SDK（5.7、5.10a以降）
- ハードウェア：marathon VCX-QPフレームグラバーがシステムに接続されていること
制限事項
すべてのアプレットにおいて、4 GBを超えるバッファを割り当てることはできません。アプレットでより大きなバッファサイズが許可されている場合でも、ドライバーとファームウェアの制限により、4 GBを超えるバッファの割り当てはできません。
バッファサイズは次のように計算できます。
バッファサイズ = 画像の高さ * 画像の幅 * (ピクセル幅 / 8)
RGB画像の場合：バッファサイズ = (画像の高さ * 画像の幅 * (ピクセル幅 / 8)) * 3
Documentation#
以下のセクションでは、acquisition applets のドキュメントへのリンクを提供しています。
エリアスキャン用 Acquisition Applets#
以下のエリアスキャン用 Acquisition Appletsを利用できます：
- Acq_DualCXP6x2AreaBayer
- Acq_DualCXP6x2AreaGray
- Acq_DualCXP6x2AreaRGB
- Acq_QuadCXP6x1AreaBayer
- Acq_QuadCXP6x1AreaGray
- Acq_QuadCXP6x1AreaRGB
- Acq_SingleCXP6x4AreaBayer
- Acq_SingleCXP6x4AreaGray
- Acq_SingleCXP6x4AreaRGB
アプレット名に含まれる「single」「dual」「quad」という表現は、接続可能なカメラの最大数を示しています。詳細については、Choosing the Right Area Scan Acquisition Appletを参照してください。
エリアスキャン用 Acquisition Applets の選び方#
カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラから受信した画像を正しく処理・表示できなくなったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。
どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。
ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。
| カメラの数 | カメラポート数 | フレームグラバーポート数 | モード | アプレット | ROIステップサイズ[px] | トポロジー |
|---|---|---|---|---|---|---|
| 1 | 4 | 4 | Bayerパターン | Acq_SingleCXP6x4AreaBayer | x：8 y：1 |  |
| 1 | 4 | 4 | グレースケール | Acq_SingleCXP6x4AreaGray | x：16 y：1 |  |
| 1 | 4 | 4 | RGB | Acq_SingleCXP6x4AreaRGB | x：8 y：1 |  |
| 2 | 2 | 4 | Bayerパターン | Acq_DualCXP6x2AreaBayer | x：8 y：1 |  |
| 2 | 2 | 4 | グレースケール | Acq_DualCXP6x2AreaGray | x：16 y：1 |  |
| 2 | 2 | 4 | RGB | Acq_DualCXP6x2AreaRGB | x：4 y：1 |  |
| 4 | 1 | 4 | Bayerパターン | Acq_QuadCXP6x1AreaBayer | x：4 y：1 |  |
| 4 | 1 | 4 | グレースケール | Acq_QuadCXP6x1AreaGray | x：8 y：1 |  |
| 4 | 1 | 4 | RGB | Acq_QuadCXP6x1AreaRGB | x：4 y：1 |  |
すべてのエリアスキャン用 Acquisition Applets に共通の仕様#
| カメラタイプ | CXP-6 |
| ミラーリング | はい（水平および垂直） |
| イベント生成 | はい |
| Image Selector | はい |
| LUT | フル解像度 |
| 総帯域幅 DMA [MB/s] b | 1800 |
エリアスキャン用 Acquisition Applets 間で異なる仕様#
| カメラポート | 最大画像サイズ [px] c | ROIステップサイズ[px] | 処理ビット深度 [bit] | 出力ビット深度 [bit] | モード | Bayer Color Reconstruction (HQe) | ホワイトバランス | 帯域幅：カメラあたりの平均 [MP/s] | |
|---|---|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x2AreaBayer | 2 | 16k x 64k | x：8 y：1 | 色成分あたり14 | BGR 24、30 packed、36 packed、42 packed、または48 | Bayerパターン | はい、High Quality Extended (HQe) | はい | 1200 |
| Acq_DualCXP6x2AreaGray | 2 | 64k x 64k | x：16 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | いいえ | 1200 |
| Acq_DualCXP6x2AreaRGB | 2 | 64k x 64k | x：4 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | いいえ | はい | 400 |
| Acq_QuadCXP6x1AreaBayer | 4 | 8k x 64k | x：4 y：1 | 色成分あたり14 | BGR 24、30 packed、36 packed、42 packed、または48 | Bayerパターン | はい、High Quality Extended (HQe) | はい | 600 |
| Acq_QuadCXP6x1AreaGray | 4 | 64k x 64k | x：8 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | いいえ | 600 |
| Acq_QuadCXP6x1AreaRGB | 4 | 64k x 64k | x：4 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | いいえ | はい | 200 |
| Acq_SingleCXP6x4AreaBayer | 1 | 48k x 48k | x：8 y：1 | 色成分あたり14 | BGR 24、30 packed、36 packed、42 packed、または48 | Bayerパターン | はい、High Quality Extended (HQe) | はい | 2400 |
| Acq_SingleCXP6x4AreaGray | 1 | 64k x 64k | x：16 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | いいえ | 2400 |
| Acq_SingleCXP6x4AreaRGB | 1 | 64k x 64k | x：8 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | いいえ | はい | 800 |
ラインスキャン用 Acquisition Applets#
次の Line Scan Acquisition Applets が利用可能です：
- Acq_DualCXP6x2LineGray
- Acq_DualCXP6x2LineRGB
- Acq_QuadCXP6x1LineGray
- Acq_QuadCXP6x1LineRGB
- Acq_SingleCXP6x4LineGray
- Acq_SingleCXP6x4LineRGB
アプレット名に含まれる「single」、「dual」、「quad」という名称は、接続できるカメラの最大数を表しています。詳細については、適切なラインスキャン用Acquisition Appletの選択を参照してください。
ラインスキャン用 Acquisition Applets の選び方#
カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラが動作しなかったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。
どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。
ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。
| カメラの数 | カメラポート数 | フレームグラバーポート数 | モード | アプレット | ROIステップサイズ[px] | トポロジー |
|---|---|---|---|---|---|---|
| 1 | 4 | 4 | グレースケール | Acq_SingleCXP6x4LineGray | x：16 y：1 | |
| 1 | 4 | 4 | RGB | Acq_SingleCXP6x4LineRGB | x：8 y：1 | |
| 2 | 2 | 4 | グレースケール | Acq_DualCXP6x2LineGray | x：16 y：1 | |
| 2 | 2 | 4 | RGB | Acq_DualCXP6x2LineRGB | x：4 y：1 | |
| 4 | 1 | 4 | グレースケール | Acq_QuadCXP6x1LineGray | x：8 y：1 | |
| 4 | 1 | 4 | RGB | Acq_QuadCXP6x1LineRGB | x：4 y：1 | |
すべてのラインスキャン用 Acquisition Applets に共通の仕様#
| 最大画像サイズ [px] | 64k x 8Mc |
| カメラタイプ | CXP-6 |
| ミラーリング | はい（水平および垂直） |
| イベント生成 | はい |
| Image Selector | はい |
| Bayer Color Reconstruction (HQe) | いいえ |
| LUT | フル解像度 |
| 総帯域幅 DMA [MB/s] b | 1800 |
ラインスキャン用 Acquisition Applets 間で異なる仕様#
| カメラポート | ROIステップサイズ[px] | 処理ビット深度 [bit] | 出力ビット深度 [bit] | モード | ホワイトバランス | 帯域幅：カメラあたりの平均 [MP/s] | |
|---|---|---|---|---|---|---|---|
| Acq_DualCXP6x2LineGray | 2 | x：16 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | 1200 |
| Acq_DualCXP6x2LineRGB | 2 | x：4 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | はい | 400 |
| Acq_QuadCXP6x1LineGray | 4 | x：8 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | 600 |
| Acq_QuadCXP6x1LineRGB | 4 | x：4 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | はい | 200 |
| Acq_SingleCXP6x4LineGray | 1 | x：16 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | 2400 |
| Acq_SingleCXP6x4LineRGB | 1 | x：8 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | はい | 800 |
Frame Grabber Test Applet#
このアプレットは Frame Grabber Test Applet です。その目的はハードウェアをテストすることです。
アプレットには次の機能が備わっています：
| 機能 | 説明 |
|---|---|
| DMAパフォーマンスのテスト | さまざまなメモリサイズと割り込みレートに対して異なる画像サイズをテストします |
| RAMテスト | エラーと処理を確認します |
| カメラポートの画像取り込みの確認 | カメラポートからの画像取り込みを確認します |
| カメラへのトリガー信号の送信 | カメラにトリガー信号を送信します |
| GPIOモニタリング | GPIを監視し、GPOを設定します |
| イベントテスト | ソフトウェアコールバックイベントを生成します |
| 総合モニタリング | FPGA温度、電源管理、PoCXPなどを監視します |
Acquisition Applets の使用#
Framegrabber SDKでのアプレットの使用に関する一般的な情報については、Acquisition Appletsを参照してください。
Applets のインストール#
フレームグラバーで特定のアプレットを使用する前に、それをフレームグラバーにインストールする必要があります。アプレットのインストールの詳細については、Managing Applets (microDiagnostics)をご覧ください。
Applet の手動追加#
インストーラーの形式ではなく、*.dllファイルとして受け取ったアプレットをホストファイルシステムに追加するには、次の手順を実行します。
- 受け取ったアプレットファイル (*.dll) を用意します。
- Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<Frame grabber model>
これで、新しいアプレットを使用できるようになります。
画像取得のテスト#
独自ソフトウェア内で（APIを介して）アプレットを使用し始める前に、システム構成や個別のアプレット（およびそのパラメータ設定オプション）をテストすることをお勧めします。
この目的のために、Framegrabber SDK環境の一部としてコンピューターにインストールされているmicroDisplay Xツールが提供されています。アプレットをロードしてテストする方法については、Configuring the Applet (microDisplay X)を参照してください。
Applet 設定の保存#
アプレットを設定した後（microDisplay XまたはFramegrabber API経由）、設定を保存できます。詳細については、Other Tasks (microDisplay X)を参照してください。