marathon ACX-SP 用 Acquisition Applets#
フレームグラバーの機能は、特定のハードウェア関連プログラムによって定義されます。このハードウェア実装はアプレットと呼ばれます。各フレームグラバーには、複数のアプレットが用意されています。
フレームグラバーにアプレットをロードすることで、フレームグラバーの機能が定義され、特定アプリケーションの要件に適応させることができます。
marathon ACX-SP 用の acquisition applets は、Framegrabber SDK に含まれています。
marathon フレームグラバーでは、アプレットをフレームグラバーにフラッシュするとすぐに使用できるようになります。
要件#
- ホストソフトウェア：ハードウェア依存の acquisition applets を含む Framegrabber SDK（5.7、5.10a以降）
- ハードウェア：marathon ACX-SP フレームグラバーがシステムに接続されていること
制限事項
すべてのアプレットにおいて、4 GBを超えるバッファを割り当てることはできません。アプレットでより大きなバッファサイズが許可されている場合でも、ドライバーとファームウェアの制限により、4 GBを超えるバッファの割り当てはできません。
バッファサイズは次のように計算できます。
バッファサイズ = 画像の高さ * 画像の幅 * (ピクセル幅 / 8)
RGB画像の場合：バッファサイズ = (画像の高さ * 画像の幅 * (ピクセル幅 / 8)) * 3
Documentation#
以下のセクションでは、acquisition applets のドキュメントへのリンクを提供しています。
| Area Acquisition Applets | Line Acquisition Applets | Test Applet |
|---|---|---|
| Acq_SingleCXP6x1AreaBayer PDF | ||
| Acq_SingleCXP6x1AreaGray PDF | Acq_SingleCXP6x1LineGray PDF | |
| Acq_SingleCXP6x1AreaRGB PDF | Acq_SingleCXP6x1LineRGB PDF | |
| FrameGrabberTest PDF |
エリアスキャン用 Acquisition Applets#
以下のエリアスキャン用 Acquisition Appletsを利用できます：
- Acq_SingleCXP6x1AreaBayer
- Acq_SingleCXP6x1AreaGray
- Acq_SingleCXP6x1AreaRGB
アプレット名に含まれる「single」という分母は、接続できるカメラの最大数を示しています。詳細については、適切なエリアスキャン用 Acquisition Appletの選択を参照してください。
エリアスキャン用 Acquisition Applets の選び方#
カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラから受信した画像を正しく処理・表示できなくなったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。
どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。
ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。
| カメラの数 | カメラポート数 | フレームグラバーポート数 | モード | アプレット | ROIステップサイズ[px] | トポロジー |
|---|---|---|---|---|---|---|
| 1 | 1 | 1 | Bayerパターン | Acq_SingleCXP6x1AreaBayer | x：8 y：1 |  |
| 1 | 1 | 1 | グレースケール | Acq_SingleCXP6x1AreaGray | x：4 y：1 |  |
| 1 | 1 | 1 | RGB | Acq_SingleCXP6x1AreaRGB | x：4 y：1 |  |
すべてのエリアスキャン用 Acquisition Applets に共通の仕様#
| カメラポート | 1 |
| カメラタイプ | CXP-6 |
| ミラーリング | はい（水平および垂直） |
| Image Selector | はい |
| LUT | フル解像度 |
| 総帯域幅 DMA [MB/s] b | 1800 |
エリアスキャン用 Acquisition Applets 間で異なる仕様#
| 最大画像サイズ [px] c | ROIステップサイズ[px] | 処理ビット深度 [bit] | 出力ビット深度 [bit] | モード | ホワイトバランス | 帯域幅：カメラあたりの平均 [MP/s] | |
|---|---|---|---|---|---|---|---|
| Acq_SingleCXP6x1AreaBayer | 16k x 64k | x：8 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | Bayerパターン | はい | 600 |
| Acq_SingleCXP6x1AreaGray | 64k x 64k | x：4 y：1 | 16 | グレースケール 8、10 packed、12 packed、14 packed、または16 | グレースケール | いいえ | 600 |
| Acq_SingleCXP6x1AreaRGB | 64k x 64k | x：4 y：1 | カラーコンポーネントあたり16 | BGR 24、30 packed、36 packed、42 packed、または48 | RGB | はい | 200 |
ラインスキャン用 Acquisition Applets#
次の Line Scan Acquisition Applets が利用可能です：
- Acq_SingleCXP6x1LineGray
- Acq_SingleCXP6x1LineRGB
アプレット名に含まれる「single」という分母は、接続できるカメラの最大数を指しています。詳細については、Choosing the Right Line Scan Acquisition Appletを参照してください。
ラインスキャン用 Acquisition Applets の選び方#
カメラのセットアップに適したアプレットを選択する必要があります。そうしないと、カメラが動作しなかったり、カメラのパフォーマンスが大幅に低下したりする可能性があります。
どのアプレットが適切かは、カメラの台数、カメラあたりのチャンネル数、および必要なROIのステップサイズによって異なります。
ROIステップサイズは画像前処理の並列性によって異なるため、カメラやフレームグラバーによって異なります。
| カメラの数 | カメラポート数 | フレームグラバーポート数 | モード | アプレット | ROIステップサイズ[px] | トポロジー |
|---|---|---|---|---|---|---|
| 1 | 1 | 1 | グレースケール | Acq_SingleCXP6x1LineGray | x：4 y：1 | |
| 1 | 1 | 1 | RGB | Acq_SingleCXP6x1LineRGB | x：4 y：1 | |
すべてのラインスキャン用 Acquisition Applets に共通の仕様#
| カメラポート | 1 |
| カメラタイプ | CXP-6 |
| ROIステップサイズ[px] | x：4 y：1 |
| ミラーリング | はい（水平および垂直） |
| Image Selector | はい |
| Bayer Color Reconstruction (HQe) | いいえ |
| LUT | フル解像度 |
| 総帯域幅 DMA [MB/s] b | 1800 |
ラインスキャン用 Acquisition Applets 間で異なる仕様#
| 最大画像サイズ [px] c | カメラポート | 処理ビット深度 [bit] | 出力ビット深度 [bit] | モード | ホワイトバランス | 帯域幅：カメラあたりの平均 [MP/s] | |
|---|---|---|---|---|---|---|---|
| Acq_SingleCXP6x1LineGray | 64k x 8M | 1 | グレースケール 8、10 packed、12 packed、14 packed、または16 | 16 | グレースケール | いいえ | 600 |
| Acq_SingleCXP6x1LineRGB | 48k x 8M | 1 | BGR 24、30 packed、36 packed、42 packed、または48 | カラーコンポーネントあたり16 | RGB | はい | 200 |
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)を参照してください。