FAST Vision Library 1000万画素カメラKU

FAST Vision Library シリーズ
FAST Vision Library
1000万画素カメラKU-MP1000
ソフトウェア
for WindowsNT
☆第２版☆
（株）ファースト
御注意
◎本書の内容の一部または全部を無断で転載することは固くお断りします。
◎本書の内容について、将来改良を目的に予告なしに変更することがあります。
◎Visual C++TMは、Microsoft Corporationの商標です。
はしがき
この説明書は、
FAST Vision Library 1000万画素カメラKU-MP1000ソフトウェア開発キット for WindowsNT Ver.2.90
について記載したものです。
なお、この他に FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 として、下
記のようなものがあります。
◎ FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 基本編
◎ FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 濃淡画像編
◎ FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 ２値画像編
◎ FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 キャリパー編
◎ FAST Vision Library 基本ソフトウェア開発キット for WindowsNT/2000 ビジョン・ツール編
本ライブラリの適用コンパイラは Microsoft® VisualC++™ Ver6.0 以降です。
目
1 ．概
次
要･･････････････････････････････････････････････1
2 ．ビデオ入力制御ライブラリ･･････････････････････････････5
カメラ通信用 RS232C のチャネル設定（Lib_SetKumpRs232c） ------------------------------- 8
画像取込（同期式）（Lib_GrabImageSync）---------------------------------------------- 9
画像取込（非同期式）（Lib_GrabImageASync）------------------------------------------ 10
入力画像取込完了待ち（非同期式）（Lib_GrabStatus） ---------------------------------- 11
カメラ入力モード参照（Lib_GetVideoMode）-------------------------------------------- 12
カメラ入力モード設定（Lib_SetVideoMode）-------------------------------------------- 13
露光時間参照（Lib_GetExposureTime）------------------------------------------------- 14
露光時間設定（Lib_SetExposureTime）------------------------------------------------- 15
画像取り込みサイズの参照（Lib_GetGrabSize）----------------------------------------- 16
画像取り込みサイズの設定（Lib_SetGrabSize）----------------------------------------- 17
画像取り込みオフセットサイズの参照（Lib_GetGrabOffsetSize） ------------------------- 18
画像取り込みオフセットサイズの設定（Lib_SetGrabOffsetSize） ------------------------- 19
カメラパラメータの参照（Lib_GetKumpParam）------------------------------------------ 20
カメラパラメータの設定（Lib_SetKumpParam）------------------------------------------ 21
[1]
1．概
-1-
要
-2-
本書は、『FAST Vision Library 1000万画素カメラKU-MP1000ソフトウェア開発キット for WindowsNT』、
のビデオ入力制御、入力モード設定等のライブラリについて記載されています。
『FAST Vision Library 1000万画素カメラKU-MP1000ソフトウェア開発キット for WindowsNT』とは、Int
elPCにインストールされたWindowsNT上で画像処理を利用するアプリケーションを構築する際の支援ライブ
ラリです。
本ソフトウェアは、『FAST Vision Library 基本ソフトウェア開発キット for WindowsNT』と協調して動
作します。
必ず、『FAST Vision Library 基本ソフトウェア開発キット for WindowsNT』と合わせてご使用ください。
本ライブラリを使用して画像処理システムを構築するには、Microsoft WindowsNT に関する知識、Window
sプログラミングに関する知識、Ｃ／Ｃ＋＋言語、画像処理に関する知識を必要とします。本リリースでは、
特にアプリケーションプログラムは用意しておりません。お客様がプログラムを作ることにより初めて、こ
のライブラリの真価を発揮します。
アプリケーション開発環境としては、Microsoft® VisualC++™ Ver6.0 以降と
Microsoft® Visual Basic® Ver6.0以降に対応しています。
-3-
-4-
2．ビデオ入力制御ライブラリ
-5-
-6-
本ライブラリはビデオキャプチャボードからの画像を画像メモリ上に取り込んだり、入力モードを設定す
るものです。
-7-
Lib_SetKumpRs232c
機
能
形
式
カメラ通信用RS232Cのチャネル設定
#include "w_video.h"
int WINAPI Lib_SetKumpRs232c( int ch );
※インポートライブラリは［FVL_cap.lib］です。
解
説
PC とカメラ間で使用する RS232C のチャネル(PC 側)を指定し、通信を確立します。
以降のライブラリを使用する場合、必ずこの関数を最初に実行してください。
① ch はPC側のRS232Cポートのチャネル番号です。(1∼2)
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○以降の関数を使用する場合、この関数を必ず最初に実行してください。
この関数を実行しない場合、あるいは実行しても正常終了しない場合、
以降の設定関数は使用できません。異常終了となります。
・Lib_SetVideoMode
・Lib_SetExposureTime
・Lib_SetGrabSize
・Lib_SetGrabOffsetSize
・Lib_SetKumpParam
ただし、画像の取り込みは可能です。その際、画像サイズは最大サイズ
4000×2624ドットとなります。
-8-
Lib_GrabImageSync
機
能
形
式
画像取込（同期式）
#include "w_video.h"
int WINAPI Lib_GrabImageSync( int memory_no );
※インポートライブラリは［FVL_cap.lib］です。
解
説
キャプチャボードより送られた画像を濃淡画像メモリに取り込みます。
（同期）
この関数は、画像が濃淡画像メモリに転送が完了するまで終了しません。
① memory_no は濃淡画像メモリ領域の管理番号です。
濃淡画像メモリ領域とは、Lib_alloc_gray_memory()で確保された領域を示し、その管
理番号とはLib_alloc_gray_memory()での戻り値です。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-9-
Lib_GrabImageASync
機
能
形
式
画像取込（非同期式）
#include "w_video.h"
int WINAPI Lib_GrabImageASync( int memory_no );
※インポートライブラリは［FVL_cap.lib］です。
解
説
キャプチャボードより送られた画像を濃淡画像メモリに取り込みます。（非同期）
同期式では、画像が濃淡画像メモリに転送が完了するまで終了しませんが、この関数では
画像取込命令をキャプチャボードへ送った後、即座にこの関数は終了します。
画像転送の終了はLib_GrabStatus()にて確認してください。
① memory_no は濃淡画像メモリ領域の管理番号です。
濃淡画像メモリ領域とは、Lib_alloc_gray_memory()で確保された領域を示し、その管
理番号とはLib_alloc_gray_memory()での戻り値です。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○同期式では画像が濃淡画像メモリに転送が完了するまでこの関数が終了しませんが、こ
の関数では画像取込命令をキャプチャボードへ送った後、即座にこの関数は終了します。
画像転送の終了はLib_GrabStatus()にて確認してください。
-10-
Lib_GrabStatus
機
能
形
式
入力画像取込完了待ち（非同期式）
#include "w_video.h"
int WINAPI Lib_GrabStatus( void );
※インポートライブラリは［FVL_cap.lib］です。
解
説
戻り値
Lib_GrabImageASync関数によって画像取込を開始した場合の取込完了を待ちます。
この関数を呼び出した場合は画像の取込が完了するまで待ち受け状態になります。
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○Lib_GrabImageASync関数にて画像取込を開始した場合は必ずこの関数にて画像取込の完
了を確認してください。
-11-
Lib_GetVideoMode
機
能
形
式
カメラ入力モード参照
#include "w_video.h"
int WINAPI Lib_GetVideoMode( int* dummy1, int* Trigger, int* dummy2,
int* dummy3, int* dummy4 );
※インポートライブラリは［FVL_cap.lib］です。
解
説
カメラ入力モードを参照します。
① dummy1 は将来拡張用のパラメタです。
② Trigger はトリガモードです。
値
定
数
０
１
AV_NON_TRIGGER
AV_TRIGGER
意
味
通常入力モード
トリガ入力モード
③ dummy2 は将来拡張用のパラメタです。
④ dummy3 は将来拡張用のパラメタです。
⑤ dummy4 は将来拡張用のパラメタです。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-12-
Lib_SetVideoMode
機
能
形
式
カメラ入力モード設定
#include "w_video.h"
int WINAPI Lib_SetVideoMode( int dummy1, int Trigger, int dummy2,
int dummy3, int dummy4 );
※インポートライブラリは［FVL_cap.lib］です。
解
説
カメラ入力モードを設定します。
① dummy1 は将来拡張用のパラメタです。
② Trigger はトリガモードです。
値
定
数
０
１
AV_NON_TRIGGER
AV_TRIGGER
意
味
通常入力モードに設定します。
トリガ入力モードに設定します。
③ dummy2 は将来拡張用のパラメタです。
④ dummy3 は将来拡張用のパラメタです。
⑤ dummy4 は将来拡張用のパラメタです。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○Lib_SetKumpRs232cが実行されていなければなりません。
-13-
Lib_GetExposureTime
機
能
形
式
露光時間参照
#include "w_video.h"
int WINAPI Lib_GetExposureTime( DWORD *dwTime );
※インポートライブラリは［FVL_cap.lib］です。
解
説
カメラの露光時間を参照します。
① dwTime は露光時間を返します。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-14-
Lib_SetExposureTime
機
能
形
式
露光時間設定
#include "w_video.h"
int WINAPI Lib_SetExposureTime( DWORD dwTime );
※インポートライブラリは［FVL_cap.lib］です。
解
説
カメラの露光時間を設定します。
① dwTime は露光時間です。
デフォルト値は１００です。
設定範囲は１∼１０２４で、単位は２２１．４μｓです。
(２２１．４μｓ∼２２６．７ｍｓｅｃ)
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○ランダムトリガモードではない場合でも設定可能です。
○露光は奇数フィールド,偶数フィールドそれぞれの先頭で行われます
○Lib_SetKumpRs232cが実行されていなければなりません。
-15-
Lib_GetGrabSize
機
能
形
式
画像取り込みサイズの参照
#include "w_video.h"
int WINAPI Lib_GetGrabSize( int* iXsize, int* iYsize );
※インポートライブラリは［FVL_cap.lib］です。
解
説
画像取り込みサイズを参照します。
① iXsize は画像取り込みＸ方向サイズを返します。
② iYsize は画像取り込みＹ方向サイズを返します。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-16-
Lib_SetGrabSize
機
能
形
式
画像取り込みサイズの設定
#include "w_video.h"
int WINAPI Lib_SetGrabSize( int iXsize, int iYsize );
※インポートライブラリは［FVL_cap.lib］です。
解
説
画像取り込みサイズを設定します。
① iXsize は画像取り込みＸ方向サイズです。
デフォルト値は４０００です。
② iYsize は画像取り込みＹ方向サイズです。
デフォルト値は２６２４です。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○画像取り込みＸ方向サイズは32の倍数でなければなりません。
範囲は32∼4000です。
また、画像取り込みＸ方向オフセットサイズと以下の関係が成り立たなければなりませ
ん。
4000 ≧(Ｘ方向サイズ＋Ｘ方向オフセットサイズ)
○画像取り込みＹ方向サイズは2の倍数でなければなりません。
範囲は2∼2624です。
また、画像取り込みＹ方向オフセットサイズと以下の関係が成り立たなければなりませ
ん。
2624 ≧(Ｙ方向サイズ＋Ｙ方向オフセットサイズ)
※画像取り込みＸ,Ｙ方向オフセットサイズはLib_SetGrabOffsetSizeで設定されます。
○既に確保されていた画像メモリは破棄されます。(0番の画像メモリは自動的に新しいサ
イズで確保されます。)
○フレームウィンドウを表示していた場合、破棄されます。
○グレイサーチでパターンを登録していた場合、画像サイズが変わるとサーチ出来なくな
ります。新たに登録し直してください。
○Lib_SetKumpRs232cが実行されていなければなりません。
-17-
Lib_GetGrabOffsetSize
機
能
形
式
画像取り込みオフセットサイズの参照
#include "w_video.h"
int WINAPI Lib_GetGrabOffsetSize( int* iOffsetXsize, int* iOffsetYsize );
※インポートライブラリは［FVL_cap.lib］です。
解
説
画像取り込みオフセットサイズを参照します。
① iOffsetXsize は画像取り込みＸ方向オフセットサイズを返します。
② iOffsetYsize は画像取り込みＹ方向オフセットサイズを返します。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-18-
Lib_SetGrabOffsetSize
機
能
形
式
画像取り込みオフセットサイズの設定
#include "w_video.h"
int WINAPI Lib_SetGrabOffsetSize( int iOffsetXsize, int iOffsetYsize );
※インポートライブラリは［FVL_cap.lib］です。
解
説
画像取り込みオフセットサイズを設定します。
① iOffsetXsize は画像取り込みＸ方向オフセットサイズです。
デフォルト値は０です。
② iOffsetYsize は画像取り込みＹ方向オフセットサイズです。
デフォルト値は０です。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○画像取り込みＸ方向オフセットサイズは32の倍数でなければなりません。
範囲は0∼4000です。
また、画像取り込みＸ方向サイズと以下の関係が成り立たなければなりません。
4000 ≧(Ｘ方向サイズ＋Ｘ方向オフセットサイズ)
○画像取り込みＹ方向オフセットサイズは2の倍数でなければなりません。
範囲は2∼2624です。
また、画像取り込みＹ方向サイズと以下の関係が成り立たなければなりません。
2624 ≧(Ｙ方向サイズ＋Ｙ方向オフセットサイズ)
※画像取り込みＸ,Ｙ方向サイズはLib_SetGrabSizeで設定されます。
○Lib_SetKumpRs232cが実行されていなければなりません。
-19-
Lib_GetKumpParam
機
能
形
式
カメラパラメータの参照
#include "w_video.h"
int WINAPI Lib_GetKumpParam( int* iOffset, int* iGain , int* datamode,
int* dum1 );
※インポートライブラリは［FVL_cap.lib］です。
解
説
ビデオオフセット,ゲイン, データの変換モードを参照します。
① iOffset は画像増幅回路のオフセット値を返します。
② iGain は画像増幅回路のゲイン値を返します。
③ datamode はデータの変換モードを返します。
④ dum1 は将来拡張用のパラメタです。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
ありません。
-20-
Lib_SetKumpParam
機
能
形
式
カメラパラメータの設定
#include "w_video.h"
int WINAPI Lib_SetKumpParam( int iOffset, int iGain , int datamode, int dum1 );
※インポートライブラリは［FVL_cap.lib］です。
解
説
ビデオオフセット、ゲイン、データの変換モードを設定します。
① iOffset は画像増幅回路のオフセット値です。(０∼２５５)
値を大きくすると画像の黒レベルの値が上昇します。
デフォルト値は１２８です。
② iGain は画像増幅回路のゲイン値です。(０∼２５５)
値を大きくすると画像の輝度が上昇します。
デフォルト値は１２８です。
③ datamode は画像データの変換モードです。(０∼１)
カメラから出力される１画素あたりの画像データは１２bitですが、本ライブラリでは
８bitに変換して使用します。
０：ＭＳＢ側の８bitを使用します。(ＬＳＢ側の４bitを捨てる)
１：ＬＳＢ側の８bitを使用します。(ＭＳＢ側の４bitを捨てる)
デフォルト値は０です。
④ dum1 は将来拡張用のパラメタです。
戻り値
処理結果
値
０
−１
留意事項
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
○Lib_SetKumpRs232cが実行されていなければなりません。
-21-
索
Ｇ
Lib_GetExposureTime ....................................14
Lib_GetGrabOffsetSize ...................................18
Lib_GetGrabSize .............................................16
Lib_GetKumpParam.......................................20
Lib_GetVideoMode..........................................12
Lib_GrabImageASync .....................................10
Lib_GrabImageSync..........................................9
Lib_GrabStatus ...............................................11
Ｓ
Lib_SetExposureTime.....................................15
Lib_SetGrabOffsetSize....................................19
Lib_SetGrabSize..............................................17
Lib_SetKumpParam .......................................21
Lib_SetKumpRs232c.........................................8
Lib_SetVideoMode ..........................................13
引
FAST Vision Library
1000万画素カメラKU-MP1000 ソフトウェア for WindowsNT
２００５年１月第２版第１刷発行
発行所
本
株式会社ファースト
社〒242-0001 神奈川県大和市下鶴間２７９１−５
ユーザー・サポート
FAX 046-272-8692
TEL 046-272-8691
E-mail : [email protected]
B-001061

Download Report