GenICam_StartAcquisition

概要

デバイスでの画像取得を初期化しスタートします。

*本ページはFuture Processing社の許可の下、Adaptive Visionの当該Filter Referenceページを和訳化したものです。

名称 種別 範囲 説明
inAddress GenAddress   アドレスを定めるGenTLプロバイダモジュールとデバイス
inPixelFormat GenPixelFormat  

GenICamピクセル命名規則において要求されたピクセルのフォーマット

inInputQueueSize Integer 1 - 200 アプリケーションにより実行される前にバッファ可能なフレームの数

適用事例

通例、最初のトリガーイベント以前にカメラ接続を確立するために使われます。特に複数台カメラを使うシステムにとって重要です。

説明

このフィルタは画像ストリーミングを初期化するため、GenTL規格のインターフェースを通じた専用のドライバソフトウェアを使用する一般的なカメラデバイスとの接続を確立するためのものです。これはプログラムの初期段階で明確な画像取得の開始が要求されている場合にのみ必要となります。例えば、トリガーモードで稼働するカメラを用意したり、GenICam_GrabImageを最初に呼び出す前にトリガーシグナルを捉えたり、取得フェーズの前に同期して複数台のカメラを起動したりすることに利用できます。

このフィルタの使用は必須ではありません。GenICam_GrabImageあるいは GenICam_GrabImage_WithTimeoutフィルタが最初の呼び出しの段階で画像取得を初期化し開始します。このフィルタが使われるとき、その後のGenICam_GrabImageとGenICam_GrabImage_WithTimeoutフィルタにあるinPixelFormatパラメータは効果を持ちません。

このフィルタは、取得がGenICam_StopAcquisitionを用いることで明示的に停止されていない限り、2回目の呼び出し及び画像取得フィルタの後の呼び出しでは何も効果を持ちません。

デバイスアドレス(inAddressポート)は、システムにおける固有のデバイスとそのGenTLプロバイダモジュールを定める情報構造です。GenTL Device Manager(フィルタプロパティにある"..."ボタンをクリック)を使うことで、接続されているデバイスの適切なアドレスを選択できます。アドレスタイプの意味とデバイスアドレスの選択については、ユーザーマニュアルのDevice Managerセクションをご覧下さい。

デバイスのアドレスは以下の項目で構成されています:

VendorName - デバイスと通信するために使用されるGenTLプロバイダモジュールのベンダー名です。

TLType - インターフェースの転送技術タイプの識別コード(例:"GEV", "IIDC", "UVC", "USB3", "PCI", "Custom")。実際のコードはGenTLプロバイダモジュールに依存します。

DeviceID - 使用しているプロバイダモジュールで選択されたインターフェース技術におけるデバイスの固有IDです。この欄のフォーマットは正確にIDの文字列でなければならず、また、使用しているGenTLプロバイダモジュールに依存します。

ピクセルフォーマットは、画像のピクセル(カラー)フォーマットのテクスト上の名称を表します。フォーマット名はデバイスがサポートしているフォーマット名のいずれかと対応していなければなりません。そうでない場合、プログラム稼働時にエラーが発生します。GenTL Device Manager(フィルタプロパティにある"..."ボタンをクリック)を使うことで、デバイスがサポートしているフォーマットリストのフォーマット名が選択できます。ピクセルフォーマットの選択に関する情報は、ユーザーマニュアルのDevice Managerセクションをご覧下さい。

Gen TLデバイスで作業するにあたっての概略情報は、以降にある項目を参照して下さい。

ヒント

  • ・ご自身のアプリケーションのメインタスク(メインループ)の前にこのフィルタを使いましょう。
  • inAddressインプットを定めてネットワーク内で利用可能なカメラをインタラクティヴに選びましょう。
  • ・カメラがサポートしているものからinPixelFormatを選びましょう。

難易度

このフィルタはアドバンスドの難易度でご利用頂けます。

関連項目

    • Adaptive Visionのサイトが開きます
    • サンプル・デモ機のお申し込み
    • メールでのお問い合わせはこちら
    • お問い合わせフォーム