FAST Vision Library シリーズ FAST Vision Library 1000万画素カメラKU-MP1000 ソフトウェア for WindowsNT ☆第2版☆ (株)ファースト 御注意 ◎本書の内容の一部または全部を無断で転載することは固くお断りします。 ◎本書の内容について、将来改良を目的に予告なしに変更することがあります。 ◎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 2値画像編 ◎ 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プログラミングに関する知識、C/C++言語、画像処理に関する知識を必要とします。本リリースでは、 特にアプリケーションプログラムは用意しておりません。お客様がプログラムを作ることにより初めて、こ のライブラリの真価を発揮します。 アプリケーション開発環境としては、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) 戻り値 処理結果 値 0 −1 留意事項 定 数 意 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()での戻り値です。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 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()での戻り値です。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ○同期式では画像が濃淡画像メモリに転送が完了するまでこの関数が終了しませんが、こ の関数では画像取込命令をキャプチャボードへ送った後、即座にこの関数は終了します。 画像転送の終了はLib_GrabStatus()にて確認してください。 -10- Lib_GrabStatus 機 能 形 式 入力画像取込完了待ち(非同期式) #include "w_video.h" int WINAPI Lib_GrabStatus( void ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 戻り値 Lib_GrabImageASync関数によって画像取込を開始した場合の取込完了を待ちます。 この関数を呼び出した場合は画像の取込が完了するまで待ち受け状態になります。 処理結果 値 0 −1 留意事項 定 数 意 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 はトリガモードです。 値 定 数 0 1 AV_NON_TRIGGER AV_TRIGGER 意 味 通常入力モード トリガ入力モード ③ dummy2 は将来拡張用のパラメタです。 ④ dummy3 は将来拡張用のパラメタです。 ⑤ dummy4 は将来拡張用のパラメタです。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 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 はトリガモードです。 値 定 数 0 1 AV_NON_TRIGGER AV_TRIGGER 意 味 通常入力モードに設定します。 トリガ入力モードに設定します。 ③ dummy2 は将来拡張用のパラメタです。 ④ dummy3 は将来拡張用のパラメタです。 ⑤ dummy4 は将来拡張用のパラメタです。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ○Lib_SetKumpRs232cが実行されていなければなりません。 -13- Lib_GetExposureTime 機 能 形 式 露光時間参照 #include "w_video.h" int WINAPI Lib_GetExposureTime( DWORD *dwTime ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 カメラの露光時間を参照します。 ① dwTime は露光時間を返します。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ありません。 -14- Lib_SetExposureTime 機 能 形 式 露光時間設定 #include "w_video.h" int WINAPI Lib_SetExposureTime( DWORD dwTime ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 カメラの露光時間を設定します。 ① dwTime は露光時間です。 デフォルト値は100です。 設定範囲は1∼1024で、単位は221.4μsです。 (221.4μs∼226.7msec) 戻り値 処理結果 値 0 −1 留意事項 定 数 意 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 は画像取り込みX方向サイズを返します。 ② iYsize は画像取り込みY方向サイズを返します。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ありません。 -16- Lib_SetGrabSize 機 能 形 式 画像取り込みサイズの設定 #include "w_video.h" int WINAPI Lib_SetGrabSize( int iXsize, int iYsize ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 画像取り込みサイズを設定します。 ① iXsize は画像取り込みX方向サイズです。 デフォルト値は4000です。 ② iYsize は画像取り込みY方向サイズです。 デフォルト値は2624です。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ○画像取り込みX方向サイズは32の倍数でなければなりません。 範囲は32∼4000です。 また、画像取り込みX方向オフセットサイズと以下の関係が成り立たなければなりませ ん。 4000 ≧(X方向サイズ+X方向オフセットサイズ) ○画像取り込みY方向サイズは2の倍数でなければなりません。 範囲は2∼2624です。 また、画像取り込みY方向オフセットサイズと以下の関係が成り立たなければなりませ ん。 2624 ≧(Y方向サイズ+Y方向オフセットサイズ) ※画像取り込みX,Y方向オフセットサイズはLib_SetGrabOffsetSizeで設定されます。 ○既に確保されていた画像メモリは破棄されます。(0番の画像メモリは自動的に新しいサ イズで確保されます。) ○フレームウィンドウを表示していた場合、破棄されます。 ○グレイサーチでパターンを登録していた場合、画像サイズが変わるとサーチ出来なくな ります。新たに登録し直してください。 ○Lib_SetKumpRs232cが実行されていなければなりません。 -17- Lib_GetGrabOffsetSize 機 能 形 式 画像取り込みオフセットサイズの参照 #include "w_video.h" int WINAPI Lib_GetGrabOffsetSize( int* iOffsetXsize, int* iOffsetYsize ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 画像取り込みオフセットサイズを参照します。 ① iOffsetXsize は画像取り込みX方向オフセットサイズを返します。 ② iOffsetYsize は画像取り込みY方向オフセットサイズを返します。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ありません。 -18- Lib_SetGrabOffsetSize 機 能 形 式 画像取り込みオフセットサイズの設定 #include "w_video.h" int WINAPI Lib_SetGrabOffsetSize( int iOffsetXsize, int iOffsetYsize ); ※インポートライブラリは[FVL_cap.lib]です。 解 説 画像取り込みオフセットサイズを設定します。 ① iOffsetXsize は画像取り込みX方向オフセットサイズです。 デフォルト値は0です。 ② iOffsetYsize は画像取り込みY方向オフセットサイズです。 デフォルト値は0です。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ○画像取り込みX方向オフセットサイズは32の倍数でなければなりません。 範囲は0∼4000です。 また、画像取り込みX方向サイズと以下の関係が成り立たなければなりません。 4000 ≧(X方向サイズ+X方向オフセットサイズ) ○画像取り込みY方向オフセットサイズは2の倍数でなければなりません。 範囲は2∼2624です。 また、画像取り込みY方向サイズと以下の関係が成り立たなければなりません。 2624 ≧(Y方向サイズ+Y方向オフセットサイズ) ※画像取り込みX,Y方向サイズは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 は将来拡張用のパラメタです。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 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 は画像増幅回路のオフセット値です。(0∼255) 値を大きくすると画像の黒レベルの値が上昇します。 デフォルト値は128です。 ② iGain は画像増幅回路のゲイン値です。(0∼255) 値を大きくすると画像の輝度が上昇します。 デフォルト値は128です。 ③ datamode は画像データの変換モードです。(0∼1) カメラから出力される1画素あたりの画像データは12bitですが、本ライブラリでは 8bitに変換して使用します。 0:MSB側の8bitを使用します。(LSB側の4bitを捨てる) 1:LSB側の8bitを使用します。(MSB側の4bitを捨てる) デフォルト値は0です。 ④ dum1 は将来拡張用のパラメタです。 戻り値 処理結果 値 0 −1 留意事項 定 数 意 NORMAL_RETURN ERROR_RETURN 味 正常終了しました。 異常終了しました。 ○Lib_SetKumpRs232cが実行されていなければなりません。 -21- 索 G Lib_GetExposureTime ....................................14 Lib_GetGrabOffsetSize ...................................18 Lib_GetGrabSize .............................................16 Lib_GetKumpParam.......................................20 Lib_GetVideoMode..........................................12 Lib_GrabImageASync .....................................10 Lib_GrabImageSync..........................................9 Lib_GrabStatus ...............................................11 S 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 2005年1月第2版第1刷発行 発行所 本 株式会社ファースト 社 〒242-0001 神奈川県大和市下鶴間2791−5 ユーザー・サポート FAX 046-272-8692 TEL 046-272-8691 E-mail : support@fast-corp.co.jp B-001061
© Copyright 2024 Paperzz