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