リリースノート

FAST Vision Library シリーズ
FVL-LCS -KEY/W
FAST Vision Library ライセンス・キー
for Windows
リリースノート
☆第7版☆
FVL-LCS-KEY for Windows
Ver2.10
FAST
(株)ファースト
1
FAST Vision Library for Windows
本書で説明しているソフトウェア・ハードウェアは、ライセンスのもとで作成されており、本ページに
記されている著作権を明記したライセンスに基づいた許可なしに、使用したり複写したりすることは
できません。ライセンスの保持者以外にソフトウェア・ハードウェア、本書、あるいはそれらのコピー
を提供することはできません。本ソフトウェア・ハードウェアの権利と所有者は(株)ファーストあるい
はそのライセンス保持者にあります。
(株)ファーストは、同社が提供していない装置における同社製ソフトウェア・ハードウェアの使用ま
たは信頼性についてはいかなる責任も負いません。(株)ファーストは本書で記載されているソフト
ウェア・ハードウェアの内容、商品価値、又は特定の使用目的に対する責任に対して明示又は黙示
に関わらずいかなる保証も行いません。
本書の内容は、予告なしに変更することがあります。内容の変更について、(株)ファーストはいか
なる責任も負いません。本書あるいは関連ソフトウェアにおける誤りについて、(株)ファーストはい
かなる責任も負いません。
Copyright 2001
(株)ファースト
All Rights Reserved
Printed in Japan
2
FAST Vision Library for Windows
目次
はじめに ---------------------------------------------------------------------------- 4
FVL ライセンス・キー for Windows の紹介------------------------------------------------------ 5
FAST Vision Library ライセンス・キー for Windows について ------------------------- 5
FAST Vision Library ライセンス認証条件 ------------------------------------------- 5
FAST Vision Library ライセンス・キーの透過性 ------------------------------------- 5
改版履歴 ---------------------------------------------------------------------------- 6
ライセンス・キー ハードウェア情報 --------------------------------------------------- 7
ライセンス・キーの取り付け方-------------------------------------------------------- 7
ライセンス・キー ソフトウェア情報 --------------------------------------------------- 8
ライセンス・キー認証用システムドライバ インストールの概要 ------------------------------ 8
ライセンス・キー認証用システムドライバ アンインストールの概要 -------------------------- 8
FVL ライブラリ関数一覧--------------------------------------------------------------- 9
FVLライセンス・キー用初期化ライブラリ編 --------------------------------------------- 9
FAST提供ボードを使用しない場合に機能しないライブラリ関数 ---------------------------- 9
プログラマーズガイド --------------------------------------------------------------- 10
FVLライセンス・キーを用いたプログラミングシーケンス ---------------------------------- 10
FVLの画像メモリ取得関数--------------------------------------------------------- 10
FVL ライセンス・キー 使用時のライブラリ説明 ------------------------------------------------ 11
FAST Vision Library 基本編 ------------------------------------------------------- 11
Lib_XInitVisionLibrary ------------------------------------------------------------- 12
システム構成例 --------------------------------------------------------------------- 13
FAST Vision Library ライセンス・キー を使用したシステム構成例 ------------------------ 13
FAST Vision Library ユーザ・サポート ----------------------------------------------- 14
FAST Vision Library ユーザ・サポートについて --------------------------------------- 14
3
はじめに
本書には、『FAST Vision Library ライセンス・キー for Windows』 Ver 2.00のソフトウェア・ハードウ
ェアリリースに関する情報が含まれています。本リリースノートでは、『FAST Vision Library ライセン
ス・キー for Windows』の商品名を『FVL-LCS-KEY/W』と略することがあります。
このリリースノートは、次の節から構成されています。
・『FAST Vision Library ライセンス・キー for Windows』の紹介では、『FAST Vision Library ライセン
ス・キー for Windows』の製品概要を説明します。
・「ハードウェア情報」には、『FAST Vision Library ライセンス・キー for Windows』のハードウェアに
関する情報が含まれています。
・「ソフトウェア情報」には、『FAST Vision Library ライセンス・キー for Windows』のソフトウェアに関
する情報が含まれています。
・「プログラマーズガイド」には、『FAST Vision Library ライセンス・キー for Windows』のソフトウェア
開発に関する情報が含まれています。
4
FAST Vision Library for Windows
FVL ライセンス・キー for Windows の紹介
FAST Vision Library ライセンス・キー for Windows について
『FAST Vision Library ライセンス・キー for Windows』とは、『FAST Vision Library』を弊社提供以外
のビデオキャプチャーボードと組み合わせて使用する場合やビデオキャプチャボードを搭載せずに
使用する場合に、『FAST Vision Library』の使用を許可し、プロテクトを解除するハード・キーです。
弊社の提供するビデオキャプチャボードがターゲットPC上に搭載されていて、そのシステムドライ
バが動作している場合は、上記ライセンス・キーを必要としません。
FAST Vision Library ライセンス認証条件
FVLを利用したアプリケーション(DLL等、FVLコードが実行される形式のファイル
が存在している場合も含む)がターゲットPC上で動作する場合、下記該当用件のいずれか
を満たさない場合は、
『FAST Vision Library ライセンス』は認証されません。
1.RICE−001 PCIバス仕様 ビデオキャプチャボードを搭載し、そのドライバが
ビデオキャプチャボード
起動している。
起動
起動し
2.FVC01 PCIバス仕様 ビデオキャプチャボードを搭載し、そのドライバが起動
起動
ビデオキャプチャボード
ている。
起動し
3.FVC02 PCIバス仕様 ビデオキャプチャボードを搭載し、そのドライバが起動
起動
ビデオキャプチャボード
ている。
4.FVC04 PCIバス仕様
起動し
PCIバス仕様 ビデオキャプチャボードを搭載し、そのドライバが起動
ビデオキャプチャボード
起動
ている。
5.FHC331/FHC331LV PCIバス仕様 デジタルカメラキャプチャボードを
デジタルカメラキャプチャボード
搭載し、そのドライバが起動
起動している。
起動
6.FHC330A PCIバス仕様 ラインセンサカメラキャプチャボードを搭載し、その
ラインセンサカメラキャプチャボード
ドライバが起動
起動している。
起動
7.FHC3310 PCIバス仕様 高速・高分解能画像入力ボード
そのドライバ
高速・高分解能画像入力ボードを搭載し、
ボード
が起動
起動している。
起動
8.FHC3321 PCIバス仕様 高分解能デジタル画像入力ボード
高分解能デジタル画像入力ボードを搭載し、そのドラ
ボード
イバが起動
起動している。
起動
9.PCIバス仕様1
PCIバス仕様1000万画素カメラ用インタフェースボードKU-MP1000
000万画素カメラ用インタフェースボードKU-MP1000/
万画素カメラ用インタフェースボードKU-MP1000/IFを搭載し、そのド
IF
NTのみ)
ライバが起動
起動している。(Windows
起動
10. FHC3322AFA PCIバス仕様 画質改善画像入力ボードを搭載し、そのド
画質改善画像入力ボード
ライバが起動
起動している。
起動
そのドラ
11. FHC3328 PCIバス仕様 アナログカラー画像入力ボード
アナログカラー画像入力ボードを搭載し、
ボード
イバが起動
起動している。
起動
起動している。
12. FVLライセンス・キーを装着し、そのドライバが起動
起動
FVLライセンス・キー
FAST Vision Library ライセンス・キーの透過性
FAST Vision Library ライセンス・キーは、コンピュータのパラレルポー
ト・インターフェースに取り付けるハードウェア・キーです。
本ハードウェアは、レインボーテクノロジー社で開発されたSentinelSuperP
roTM という製品を採用しています。本ハードウェアを搭載した上で、プリンタをご使用さ
れる場合、極めて高い確率で正常動作しますが、まれに相性問題が発生します。これらにつ
いては改善の努力はいたしますが、保証は致しかねます。また、プリンタ以外のデバイスで
の接続使用はできません。
5
FAST Vision Library for Windows
改版履歴
バージョン
1.40
1.50
1.60
1.70
1.80
2.00
2.10
日付
1999/09/17
2000/01/20
2000/04/14
2000/06/15
2001/01/29
2001/06/18
2002/10/18
備考
製品出荷版 FVL Ver1.40 より適用
Windows2000対応
対応するキャプチャボードを追加
Windows2000で動作を行う場合、バージョン2.00以降をお使いください。
6
FAST Vision Library for Windows
ライセンス・キー ハードウェア情報
ライセンス・キーの取り付け方
1.ターゲットPC(FVLを使用したアプリケーションを実行するPC)のLPT(プリンタポート)にライセ
ンス・キーを差込み、ネジでしっかり固定して下さい。
2.ターゲットPCのBIOS設定で、ライセンス・キーを装着したLPT(プリンタポート)が有効になって
いる事を確かめて下さい。
7
FAST Vision Library for Windows
ライセンス・キー ソフトウェア情報
ライセンス・キー認証用システムドライバ インストールの概要
1.『FAST Vision Library ライセンス・キー for Windows』ソフトウェア(ライセンス・キー認証用シス
テムドライバ)をPCにイン ストールする場合は、『FAST Vision Library ライセン ス・キー for
Windows』DiskをFDドライブに挿入し、setup.exe を起動して下さい。
2.起動後は、何もメッセージを出さず(インストール元のディスクに一瞬だけアクセスします)に
WindowsNT/2000、Windows95/98などの動作環境を自動判定してソフトウェアが導入されます。
上記ソフトウェアの導入を行った後は一部のコンピュータを除いて再起動する必要はありません。
注!
富士通製コンピュータFM/Vシリーズに関してだけは、上記ソフトウェアを導入した後で
必ず電源を完全に切ってから再起動を行って下さい。
ライセンス・キー認証用システムドライバ アンインストールの概要
『FAST Vision Library ライセンス・キー for Windows』ソフトウェア(ライセンス・キー認証用システム
ドライバ)をアンインストールするには2つの方法があります。どちらの方法でも削除を行った後には
必ずコンピュータを再起動して下さい。
1.SETUP.EXEを使用する方法
SETUP.EXEに”/U”オプションをつけて実行することでファイルと設定を削除することができま
す。
2.Windowsの“アプリケーションの追加と削除”を使用する方法
Windows95/98、Windows2000ではコントロールパネル“アプリケーションの追加と削除”の項目
から、WindowsNT4.0ではコントロールパネル“アプリケーションの追加と削除”または、マルチメ
ディア内の“ドライバ項目”で、それぞれリストから“Sentinel System Driver”を選んで削除を
行えます。
8
FAST Vision Library for Windows
FVL ライブラリ関数一覧
FVLライセンス・キー用初期化ライブラリ編
■FVLライセンス・キー用初期化ライブラリ
FVL拡張初期化
Lib_XInitVisionLibrary
FAST提供ボードを使用しない場合に機能しないライブラリ関数
■ビデオ入力制御ライブラリ
ビデオ入力画像取込(同期式)
ビデオ入力画像取込(非同期式)
ビデオ入力画像同時取込(同期式)
ビデオ入力画像同時取込(非同期式)
ビデオ入力画像取込完了待ち(非同期式)
ビデオ入力チャネル参照
ビデオ入力チャネル設定
ビデオ入力モード参照
ビデオ入力モード設定
ビデオ入力PLLクロック参照
ビデオ入力PLLクロック設定
露光時間参照
露光時間設定
キャプチャボード枚数取得
カレントキャプチャボード番号取得
カレントキャプチャボード番号設定
Lib_GrabImageSync
Lib_GrabImageASync
Lib_GrabImageSyncDual
Lib_GrabImageASyncDual
Lib_GrabStatus
Lib_GetVideoChannel
Lib_SetVideoChannel
Lib_GetVideoMode
Lib_SetVideoMode
Lib_GetPLLClock
Lib_SetPLLClock
Lib_GetExposureTime
Lib_SetExposureTime
Lib_GetCaptureNumber
Lib_GetVideoCapture
Lib_SetVideoCapture
ビデオ入力制御系のライブラリは、すべて使用できなくなっております。
ビデオ入力に関する制御は、お客様が使用するビデオキャプチャボードの仕様にあわせてプ
ログラムして下さい。
9
FAST Vision Library for Windows
プログラマーズガイド
FVLライセンス・キーを用いたプログラミングシーケンス
本ライブラリは『FAST Vision Library 基本ソフトウェア開発キット for WindowsNT』および『FAST
Vision Library 基本ソフトウェア開発キット for Windows2000』と協調して動作します。通常、弊社の
提供するビデオキャプチャボードをご使用の場合は、Lib_InitVisionLibraryの引数にビデオキャプチ
ャボードタイプを指定して、FVLの初期化とビデオデバイスの初期化を行います。その場合、ノーマ
ルカメラ画像のフォーマットは横512x縦480画素となり、画像メモリも初期化されますが、FVL拡張
初期化ライブラリ関数Lib_XInitVisionLibraryをお使いの場合は、指定のサイズで画像メモリが構成
されます。
つまり、Lib_alloc_gray_memoryライブラリ関数を呼び出した場合においてFVL拡張初期化ライブラリ
関数Lib_XinitVisionLibrary(640,480)とするとLib_alloc_gray_memoryで生成される画像メモリ領域は、
640x480(1画素8bit)の領域が確保されます。画像取り込みの際には、Lib_adrs_gray_memoryライブ
ラリ関数にて、先頭アドレスポインタを受け取り、そのアドレスに画像を書き込んで下さい。
Lib_InitVisionLibraryの初期化シーケンスとLib_XinitVisionLibraryの初期化シーケンスの流れを以下
に記します。
Lib_XInitVisionLibrary 使用
Lib_InitVisionLibrary 使用
Lib_InitVisionLibrary( RICE_PCI, …)
Lib_XInitVisionLibrary( 640,480 )
画像メモリサイズ、ウィンドウサイズ
を 512x480 に初期化します。
画像メモリサイズ、ウィンドウサイズを
640x480 に初期化します。
RICE-001 ビデオキャプチャボードの
初期化
を行います。
FVLの画像メモリ取得関数
本ライブラリでは、画像メモリ領域の取得に、Win32API
Win32API の GlobalAlloc を使用しており、そのメモリブ
ロックのアドレス取得には、GlobalLock
GlobalLock を使用しています。弊社提供以外のビデオキャプチャデバイ
スを御使用の際には、そのビデオキャプチャボードの仕様と照らし合わせて画像取り込みを行って
下さい。
10
FAST Vision Library for Windows
FVL ライセンス・キー 使用時のライブラリ説明
FAST Vision Library 基本編
FVL拡張初期化
Lib_XInitVisionLibrary
11
FAST Vision Library for Windows
Lib_XInitVisionLibrary
機
能
ビジョンライブラリ拡張初期化
形
式
#include "w_frame.h"
int WINAPI Lib_XInitVisionLibrary( int
解
説
fx_size, int
fy_size );
FVLを指定された画像メモリX:Yサイズで初期化します。このライブラ
リ呼び出し以降に、FVLライブラリ関数が使用できるようになります。必
ず、他のFVLライブラリ関数が呼ばれるより先に実行されるように記述し
て下さい。
① fx_size は、濃淡画像メモリ領域または2値画像メモリ領域のX(横)サ
イズを指定して下さい。
fx_sizeは必ず、32の倍数値を指定して下さい。
例:512,640,1024…8160
② fy_size は、濃淡画像メモリ領域または2値画像メモリ領域のY(縦)サイ
ズを指定して下さい。
fy_sizeは必ず、2の倍数(偶数)値を指定して下さい。
例:480,640,1024…32768
戻り値
処理結果
値
0
−1
例
定
数
意
NORMAL_RETURN
ERROR_RETURN
味
正常終了しました。
異常終了しました。
基本編説明書のLib_GrabImageSync関数の例を参照してください。
留意事項
本ライブラリ関数を使用する場合は、基本ライブラリの
Lib_InitVisionLibraryと併用しないでください。また、本ライブラリは同一
プロセス中で、複数回呼び出さないでください。
画像メモリのサイズ制限は以下のとうりです。
X方向:512−8160
Y方向:480−32768
インポートライブラリ
FVLframe.lib
12
FAST Vision Library for Windows
システム構成例
FAST Vision Library ライセンス・キー を使用したシステム構成例
『FAST Vision Library ライセンス・キー for Windows』を使用した、システム構成例です。基本的に
は、WindowsNT/2000,95/98がインストールされたPC/ATに、市販のビデオキャプチャボードを搭載
していただき、画像処理アプリケーションを構築していきます。
市販 ビデオキャプチャボード
NTSC B/W カメラ
その他
FVL プロテクト・キー を LPT に装着します
PC/AT
プリンタ
13
FAST Vision Library for Windows
FAST Vision Library ユーザ・サポート
FAST Vision Library ユーザ・サポートについて
弊社は、お客様に信頼される画像処理製品・サポートを会社創立以来提供して参りました。
正確なサポートのために、できる限り E-mail 又は FAX にてのお問い合わせにご協力ください。
ユーザ・サポート窓口
FAX 046-272-8692 TEL 046-272-8691
E-mail : [email protected]
14
FVLシリーズ
FAST Vision Library ライセンス・キー リリースノート
2002年10月第7版第1刷発行
本
社
ユーザ・サポート
発行所
株式会社ファースト
〒242-0001
神奈川県大和市下鶴間2791−5
FAX 046-272-8692
TEL 046-272-8691
E-mail : [email protected]
FAST Vision Library for Windows
B-000883