Enhanced Applets (imaFlex CXP-12 Quad)#

このトピックでは、Enhanced Appletsについて説明します。Enhanced Appletsは、BaslerのCXP-12フレームグラバーおよびInterface Cards向けの、すぐに使用できる新しい一連のアプレットです。

Basler Webサイトから、ZIPファイルとして Enhanced Applets、Flat-Field Correction プラグイン、およびフラットフィールド補正値を計算するための Python スクリプトをダウンロードできます。

現在、Enhanced Appletsは以下で使用できます：

CXP-12インターフェースカード1C
CXP-12インターフェースカード2C
CXP-12インターフェースカード4C
imaWorx CXP-12 Quad
imaFlex CXP-12 Quad

Enhanced Applets は、 Acquisition Applets およびカスタムアプレット： Acquisition Applets 画像データおよび信号データの取得と前処理、ならびにシステム情報の処理のための機能を含む。

Enhanced Appletsには、Acquisition Appletsの機能範囲に加え、高度な画像処理機能が含まれています。

Custom AppletsはVisualAppletsを介して作成され、個別の機能を提供します。これらは、Acquisition AppletsまたはEnhanced Appletsのデザインに基づいてカスタマイズできます。

Acquisition AppletsとEnhanced Appletsは、サポートされているフレームグラバーおよびCXP-12 Interface Cardsに付属しています。

適応とカスタマイズ#

1セットのアプレットですべての顧客要件を満たすことは不可能です。Enhanced Appletsの目的は、特定の要件に素早く適応することです：

要件に適応した新しい、または変更されたEnhanced Appletsを生成するため
お客様の要件を正確に満たすものの、一般リリースには含まれないカスタムのEnhanced Appletsを生成するため。カスタム処理の複雑さに応じて、これはimaFlexフレームグラバーでのみ可能な場合があります。
非常に柔軟なカスタム処理のためにVisualAppletsで機能ブロックをコピーし、ご自身で実装を行うため。これはimaFlexフレームグラバーで可能です。

VisualApplets 機能の例#

VisualApplets には、ブロックベースのフラットフィールド補正を計算できるデザイン例が付属しています。これらの例とその保存場所に関する情報は、VisualApplets チュートリアルに記載されています。

VisualApplets でカスタム処理を行う以外に、適応とカスタマイズセクションに記載されているカスタマイズの可能性をご確認ください。

要件#

ホストソフトウェア: Framegrabber SDK バージョン 5.11.3 および pylon Viewer 8.0.1 または 8.0.2。
ハードウェア: 次のフレームグラバーまたはインターフェイスカードのいずれかがシステムに接続されていること:
- CXP-12インターフェースカード1C
- CXP-12インターフェースカード2C
- CXP-12インターフェースカード4C
- imaWorx CXP-12 Quad
- imaFlex CXP-12 Quad

制限事項

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

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

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

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

Documentation#

次のセクションでは、Enhanced Appletsのドキュメントへのリンクを提供しています：

Area Acquisition Applets#

GenTL	Fglib
Enh_SingleCXP12Area	Enh_SingleCXP12Area
Enh_DualCXP12Area	Enh_DualCXP12Area
Enh_QuadCXP12Area	Enh_QuadCXP12Area

エリアスキャン用 Acquisition Applets#

現在、エリアスキャンカメラ用のEnhanced Appletsが利用可能です。これらのアプレットは、boost vカメラの機能を完全に拡張し、画像前処理の要件を満たします。

以下のエリアスキャン用Enhanced Appletsが利用可能です：

Enh_SingleCXP12Area
Enh_DualCXP12Area
Enh_QuadCXP12Area

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

Enhanced Appletsで使用する適切なアプレットの選択は、リンク構成ではなく、フレームグラバーに接続されているカメラの台数のみによって決まります。したがって、適切なアプレットを選択するためのマトリックスは次のようになります。

カメラの数	アプレット	トポロジー
1	Enh_SingleCXP12Area
2	Enh_DualCXP12Area
4	Enh_QuadCXP12Area

アプレットの具体的な仕様については、アプレットドキュメントの「機能」の章をお読みください。

Acquisition Appletsとは対照的に、Enhanced Appletsにはすべて以下の追加機能があります。

最大 4x4 の Binning
モノクロカメラおよびカラーカメラ用のブロックベースフラットフィールド補正 (FFC)
PGI 高品質デベザリングおよび画質改善

Enhanced Applets の使用#

Framegrabber SDK での Enhanced Applets の使用#

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

Enhanced Applets のインストール#

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

Enhanced Applets の手動追加#

(インストーラー形式ではなく) DLLファイルとして受け取ったアプレットをホストファイルシステムに追加するには：

受け取ったアプレットのDLLファイルを取得します。
Copy this file into the following directory: <Framegrabber SDK installation directory>\Dll\<frame grabber model>
GenTL環境変数がFramegrabber SDKのインストールディレクトリを指していることを確認してください。

これで、microDisplay X、任意のGenTLコンシューマー、またはFramegrabber SDK APIを使用する独自のSDKプログラムで新しいアプレットを使用できるようになります。

画像取得のテスト#

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

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

Applet 設定の保存#

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

pylon Viewer での Enhanced Applets の使用#

Enhanced Applets は、pylon Viewer のプラグインとして提供されます。このプラグインについては、Basler 担当営業またはフィールドアプリケーションエンジニアにお問い合わせください。

pylon 用 Enhanced Applets プラグインのインストール#

pylon用のEnhanced AppletsプラグインはDLLファイルとして提供されます。pylon用のEnhanced Appletsプラグインをインストールするには：

Copy the DLL files into the pylon installation directory Runtime\x64\pylonCXP\dll\<frame grabber name>.
GenTL環境変数がpylonのインストールディレクトリを指していることを確認してください。

これで、microDisplay X、任意のGenTLコンシューマー、またはFramegrabber SDK APIを使用する独自のSDKプログラムで新しいアプレットを使用できるようになります。