GenApi
GenApi はカメラ設定の問題を解決します。 これは一般的な方法であり、フレームグラバーを含むさまざまな種類のデバイスに適用されます。 この章では、カメラについての言及はすべてフレームグラバーにも当てはまります。
GenApiが機能するためには: 登録説明と GenApi実装の2つが必要です。
登録説明
登録説明 はカメラのコンピュータ可読データシートと考えることができるXMLファイルです。 それは、カメラ設定( PixelFormat
および TriggerSource
など)、およびそれらをどのように構成するかについての指示(例えば、 ExposureMode
を Timed
に設定し、値 0x12
を レジスタ 0xE0140
に書き込む)を定義します。 それはまたカメラのドキュメンテーションを含むことができます。
GenApi実装
GenApi実装 は登録説明ファイルを読み取って解釈することができるソフトウェアモジュールです。
EMVA は リファレンス実装を提供しますが、使用するのはかなり難しく、ロギングは非常に貧弱です。 代わりに、CoaxlinkソフトウェアパッケージにバンドルされているEuresys実装を使用することをお勧めします。 この実装は強力な 設定スクリプトを書くことも可能です。
特徴
ユーザーがGenApiから取得するのは、 カテゴリ別に整理された 機能のグループです。
Set/get機能は単純な設定( MultiCamでは パラメータ と呼ばれます)であり、さまざまな種類があります:
● | 整数 (例、 Width ) |
● | フロート (例、 AcquisitionFrameRate ) |
● | 列挙 (例、 PixelFormat ) |
● | ブーリアン (例、 LUTEnable ) |
● | 文字列 (例、 DeviceVendorName ) |
機能の値は、 get/set 関数を使用して取得/変更できます。 一部の機能は読み取り専用であり、一部は書き込み専用ですが、ほとんどの機能は読み取り/書き込みアクセスを許可します。