同期式 2ch 同時画像入力 (グレイ/2値画像入力)

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

Syntax

C#
public virtual void GrabImageSync(
	CFviImage img_gray0,
	CFviImage img_gray1,
	CFviImage img_bin0,
	CFviImage img_bin1
)
Visual Basic
Public Overridable Sub GrabImageSync ( 
	img_gray0 As CFviImage,
	img_gray1 As CFviImage,
	img_bin0 As CFviImage,
	img_bin1 As CFviImage
)

Parameters

img_gray0
Type: FVIL.Data..::..CFviImage
取り込み先画像(ch0-グレイ)
img_gray1
Type: FVIL.Data..::..CFviImage
取り込み先画像(ch1-グレイ)
img_bin0
Type: FVIL.Data..::..CFviImage
取り込み先画像(ch0-２値)
img_bin1
Type: FVIL.Data..::..CFviImage
取り込み先画像(ch1-２値)

Remarks

2ch同時入力で、グレイ画像と２値画像の両方の画像を入力します。 画像取り込みが完了するか、エラーが発生するまで待機します。 引数に null を指定する事で特定のチャネルの取り込みを省略する事が出来ます。

デバイスがオープンされていない場合、画像取り込みを行うことができません。

カメラのピクセルレートが早い場合、全チャネルに画像入力をした際に、ボード内部の処理が追いつかず、 取り込み時間がカメラのフレームレートよりも大きくなってしまう場合があります。

デバイスから出力される画像サイズと、引数に指定された画像オブジェクトの 画像サイズが一致しない場合エラーになります。 画像取り込みを行う前に、 ImageSize で画像入力サイズを取得し、画像メモリに設定しておくか、 ChangeImageSize(CFviImage) を用いて画像メモリのサイズ変更を行うようにしてください。 画像タイプは、グレイ画像を入力する場合、 FVIL.ImageType.UC8 で画像メモリを生成し、 ２値画像を入力する場合、 FVIL.ImageType.BIN で画像メモリを生成してください。

カメラ設定ファイルで Video-Timeout の項を 0 に指定した場合、タイムアウト設定は無効になります。 1 以上の値が設定された場合にのみ、タイムアウト機能が有効になり、 指定時間以内に画像入力が行われなかった場合はエラーとなります。 タイムアウト機能は、FVC05ドライバ Ver1.0.1.54 から対応しています。

カメラの出力画像サイズよりも狭い範囲（垂直方向のみ）で取り込みサイズを設定し、 トリガモード(内部トリガ・外部トリガ)を設定し取り込みを行った場合、 1 枚の画像取り込み時間は短くなりますが、次の取り込みが行えるのはカメラの垂直期間が完了した後となります。

以下のパラメータに従って、画像取り込みを実行します。

処理に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値ErrorCode メンバ内容
25FVIL.ErrorCode.NOT_OPENEDデバイスがオープンされていません。
11FVIL.ErrorCode.INVALID_PARAMETER引数が不正です。
17FVIL.ErrorCode.INVALID_IMAGESIZE画像サイズが、デバイスの設定と一致しません。
16FVIL.ErrorCode.INVALID_IMAGETYPE画像タイプが、デバイスの設定と一致しません。
31037FVIL.Video.ErrorCode.NOW_CAPTURING現在、画像入力中の為、画像取り込みを行えません。
31040FVIL.Video.ErrorCode.GRAB_FAILED画像取り込みに失敗しました。
31046FVIL.Video.ErrorCode.MEMORY_LOCK画像メモリのロックに失敗しました。メモリ不足の可能性があります。
31047FVIL.Video.ErrorCode.MEMORY_UNLOCK画像メモリのアンロックに失敗しました。
53FVIL.ErrorCode.TIMEOUTタイムアウトが発生しました。

Exceptions

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

See Also