連続同時取込の実行(非同期)

Namespace: FVIL.Video
Assembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)

Syntax

C#
public virtual void SimGrabASync(
	CFviContinuousGrabFHC3312 target,
	uint capture_num
)
Visual Basic
Public Overridable Sub SimGrabASync ( 
	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) を実行して、メモリをロックしておいてください。
画像取込の状況を知るためには、 QueryCaptureNo()()()() を使用するか、 GrabStatus、GrabWait()()()()を使用して下さい。

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 メンバ内容
11FVIL.ErrorCode.INVALID_PARAMETER引数が不正です。
12FVIL.ErrorCode.INVALID_OBJECTtargetが呼び出し元オブジェクトと同一です。異なるオブジェクトでなければいけません。
25FVIL.ErrorCode.NOT_OPENEDデバイスがオープンされていません。
53FVIL.ErrorCode.TIMEOUTタイムアウトが発生しました。
31032FVIL.Video.ErrorCode.DEVICE_IDtargetが同一ボードではありません。
31037FVIL.Video.ErrorCode.NOW_CAPTURING現在、画像入力中のため画像取り込みを行えません。
31040FVIL.Video.ErrorCode.GRAB_FAILED画像入力に失敗しました。
31042FVIL.Video.ErrorCode.INVALID_IMAGE画像オブジェクトが不正です。メモリロックしてください。
31200FVIL.Video.ErrorCode.NOT_FOUND_CAMERAカメラが接続されていないが、電源が投入されていません。

Exceptions

ExceptionCondition
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also