非同期式画像入力
Namespace: FVIL.VideoAssembly: FVILdevice (in FVILdevice.dll) Version: 3.1.0.0 (3.1.0.5)
Syntax
C# |
---|
public override void GrabImageASync( CFviImage image ) |
Visual Basic |
---|
Public Overrides Sub GrabImageASync ( image As CFviImage ) |
Parameters
- image
- Type: FVIL.Data..::..CFviImage
取り込み先画像
Remarks
カメラから画像を取り込みます。 取り込みを開始すると即時に関数から制御が戻ります。 画像取り込みの状態を調べるには、GrabStatus を使用してください。 画像取り込み完了まで待機するには、GrabWait()()()() を使用してください。
デバイスがオープンされていない場合、画像取り込みを行うことができません。
デバイスから出力される画像サイズと、引数に指定された画像オブジェクトの 画像サイズが一致しない場合エラーになります。 画像取り込みを行う前に、 ChangeImageSize(CFviImage) を用いて画像メモリのサイズ変更を行うようにしてください。 ChangeImageSize(CFviImage) を用いると、 画像タイプ、画像サイズ、画像チャネル数、画像ビット深度がデバイスから出力される情報で正規化されます。
カメラ設定ファイルで Video-Timeout の項を 0 に指定した場合、タイムアウト設定は無効になります。 1 以上の値が設定された場合にのみ、タイムアウト機能が有効になり、 指定時間以内に画像入力が行われなかった場合はエラーとなります。
以下のパラメータに従って、画像取り込みを実行します。
- Trigger -
- ExposureTime -
- CC1 -
- CC2 -
- CC3 -
- CC4 -
- EXP -
- TriggerRetry -
- TriggerCycleTime -
- PackingMode -
処理に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。
エラーコード:
値 | ErrorCode メンバ | 内容 |
---|---|---|
25 | FVIL.ErrorCode.NOT_OPENED | デバイスがオープンされていません。 |
11 | FVIL.ErrorCode.INVALID_PARAMETER | 引数が不正です。 |
17 | FVIL.ErrorCode.INVALID_IMAGESIZE | 画像サイズが、デバイスの設定と一致しません。 |
16 | FVIL.ErrorCode.INVALID_IMAGETYPE | 画像タイプが、デバイスの設定と一致しません。 |
18 | FVIL.ErrorCode.INVALID_CHANNEL | 画像チャネル数が、デバイスの設定と一致しません。 |
31050 | FVIL.Video.ErrorCode.INVALID_IMAGE_DEPTH | 画像ビット深度が、デバイスの設定と一致しません。 |
31079 | FVIL.Video.ErrorCode.GET_PARAMETER | ボードから情報を取得できません。 |
31078 | FVIL.Video.ErrorCode.SET_PARAMETER | 画像情報を設定できません。 |
31046 | FVIL.Video.ErrorCode.MEMORY_LOCK | 画像メモリのロックに失敗しました。メモリ不足の可能性があります。 |
31047 | FVIL.Video.ErrorCode.MEMORY_UNLOCK | 画像メモリのアンロックに失敗しました。 |
31037 | FVIL.Video.ErrorCode.NOW_CAPTURING | 現在、画像入力中の為、画像取り込みを行えません。 |
31042 | FVIL.Video.ErrorCode.INVALID_IMAGE | 画像オブジェクトが不正です。 |
31040 | FVIL.Video.ErrorCode.GRAB_FAILED | 画像取り込みに失敗しました。 |
53 | FVIL.ErrorCode.TIMEOUT | タイムアウトが発生しました。 |
31410 | FVIL.Video.ErrorCode.PLL_RECONFIG_FAILED | PLLリコンフィグが失敗しました。 |
31411 | FVIL.Video.ErrorCode.PLL_RECONFIG_BUSY | PLLリコンフィグがビジーです。 |
Exceptions
Exception | Condition |
---|---|
FVIL..::..CFviException | この例外の原因については、上記のエラーコード表をご参照ください。 |