Assembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)
Syntax
C# |
---|
public virtual void SimGrabSync( CFviContinuousGrabFHC3312 target, uint capture_num ) |
Visual Basic |
---|
Public Overridable Sub SimGrabSync ( target As CFviContinuousGrabFHC3312, capture_num As UInteger ) |
Parameters
- target
- Type: FVIL.Video..::..CFviContinuousGrabFHC3312
他CHのクラス
- capture_num
- Type: System..::..UInt32
取込枚数。 0を指定した場合、無限取込。
Remarks
連続同時取り込みを行います。
本関数を使用するためには、同一ボードのCH0とCH1をそれぞれオープンした、CFviContinuousGrabFHC3312クラスのインスタンスが必要です。
同時取り込みは、同一ボードでのCH0とCH1の間においてのみ可能です。異なるボード間の同時取り込みはできません。
本関数は、画像取込命令を、画像入力ボードに行い、指定枚数の画像入力が終わった後、制御が戻ります。 予め、 MemoryLock(UInt32) または、 MemoryLock(CFviImage) を実行して、メモリをロックしておいてください。
CH0, CH1の両方のインスタンスに対し、 GrabStatus、GrabWait()()()() で 指定枚数分画像取り込みが終わったことを確認するか、 StopCapture()()()() で取り込みを停止させなければ、次の取り込みを行えません。
各取り込みモードによる、動作は次のようになります。
・エリアカメラ、ノーマルモードの場合
ノーマルモードの場合、CH0とCH1のカメラ同期が取れないため、完全な同時取り込みとなりません。
同時に取込開始が行われますが、カメラの撮影タイミングによって、ずれが生じます。
・エリアカメラ、内部トリガモードの場合
CH0とCH1のトリガ信号が同時に出力去ることによって、同時取り込みが可能です。
・エリアカメラ、外部トリガモードの場合
CH0とCH1の両方の外部トリガ入力端子に、トリガ信号を入れなければいけません。片方のチャネルにのみトリガ信号を入れた場合、
そのチャネルしか取り込みが行われません。
・ラインセンサで、エンコーダを使用しない場合
ラインセンサモードの場合、ライントリガ信号が出力され続けられます。このとき、CH0とCH1のタイミングが一致するとは限りません。
同時に取込開始が行われますが、ライントリガ信号のずれにより、取込開始位置にずれが生じます。
・ラインセンサで、エンコーダを使用する場合
同時に取込開始が行われれ、エンコーダの一致信号合わせて、トリガ出力が行われます。
取り込みを実行します。capture_num引数に1を指定した場合、1枚取込を行います。 画像が入力される先は、 MemoryLock() で指定した画像メモリです。 CH0, CH1のそれぞれのインスタンスに対し、 MemoryLock() を行わなければいけません。 画像取込枚数(capture_num引数)に、0を指定した場合、無限長取込となります。それ以外の値を指定した場合、 その枚数が取込終わった時点で、取り込み終了となります。
カメラ設定ファイルで USER-USER_TIMEOUT1の項を0に指定した場合、タイムアウト設定はOFFになります。 1以上の値が設定された場合にのみ、タイムアウト機能がONになり、指定時間以内に画像入力が行われなかった場合、 エラーとなります。
本関数は、WIL Ver.2.0で追加しました。
エラーコード:
値 | ErrorCode メンバ | 内容 |
---|---|---|
11 | FVIL.ErrorCode.INVALID_PARAMETER | 引数が不正です。 |
12 | FVIL.ErrorCode.INVALID_OBJECT | targetが呼び出し元オブジェクトと同一です。異なるオブジェクトでなければいけません。 |
25 | FVIL.ErrorCode.NOT_OPENED | デバイスがオープンされていません。 |
53 | FVIL.ErrorCode.TIMEOUT | タイムアウトが発生しました。 |
31032 | FVIL.Video.ErrorCode.DEVICE_ID | targetが同一ボードではありません。 |
31037 | FVIL.Video.ErrorCode.NOW_CAPTURING | 現在、画像入力中のため画像取り込みを行えません。 |
31040 | FVIL.Video.ErrorCode.GRAB_FAILED | 画像入力に失敗しました。 |
31042 | FVIL.Video.ErrorCode.INVALID_IMAGE | 画像オブジェクトが不正です。メモリロックしてください。 |
31200 | FVIL.Video.ErrorCode.NOT_FOUND_CAMERA | カメラが接続されていないが、電源が投入されていません。 |
Exceptions
Exception | Condition |
---|---|
FVIL..::..CFviException | この例外の原因については、上記のエラーコード表をご参照ください。 |