GenAPI
GenApiは、カメラを設定する際に生じる問題を解決します。一般的な解決手法が用いられているため、同じ方法をフレームグラバーを含むさまざまな種類のデバイスに適用できます。この章では、カメラについて言及する内容はフレームグラバーにも適用されます。
GenApiが機能するには、レジスタ記述とGenApi実装の2つが必要です。
レジスタ記述
レジスタ記述は、カメラのデータシートをコンピューターが解読できる方法で記述したXMLファイルです。カメラの設定(PixelFormatやTriggerSourceなど)やその設定方法に関する指示(ExposureModeをTimedに設定するには値0x12をレジスタ0xE0140に書き込む、など)が定義されます。またカメラのドキュメントが含まれることもあります。
GenApi実装
GenApi実装は、レジスタ記述ファイルを読み取って解釈するソフトウェアモジュールです。
EMVAはリファレンス実装を提供していますが、使用するのはかなり難しく、ログ機能の性能が非常に劣っています。eGrabberソフトウェアパッケージに同梱されているEuresysの実装を使用することをお勧めします。この実装では、強力な設定スクリプトを書くことも可能です。
機能
GenApiからは、カテゴリ別に編成された名前付きの機能が得られます。
set/get機能は単純な設定(MultiCamではパラメーターと呼ばれる)であり、さまざまな型を使用できます。
□ | 整数型(Width など) |
□ | 浮動小数点数型(AcquisitionFrameRate など) |
□ | 列挙型(PixelFormat など) |
□ | ブール型(LUTEnable など) |
□ | 文字列型(DeviceVendorName など) |
機能の値は、get/set関数を使用して取得/変更できます。一部には読み取り専用の機能や書き込み専用の機能もありますが、ほとんどの機能には読み取り/書き込み権限が許可されています。