4-光学指纹采集仪技术开发手册.doc

光学指纹采集仪技术开发手册光学指纹采集仪技术开发手册1.产品简介32.SDK说明3光盘中目录说明33.二次开发接口说明33.1打开设备43.2释放设备43.3探测手指是否按在采集仪上43.4 获取的数据是否是手指43.5获取图像43.6保存图像53.7从文件中载入图像53.8保存特征53.9从文件加载特征53.10提取特征53.11指纹比对63.12获取版本号63.13获取指纹特征匹配度63.14快速搜索63.15两次合并模板73.16三次合并模板73.17 灯控制73.18多设备支持函数73.19读取唯一序列号函数84.主要程序流程84.1获取指纹图像94.2 比对104.3 录入1144搜索124.5 快速搜索135.示例程序说明146.控件开发接口15151. 产品简介光学指纹采集仪由成都乙木科技有限公司(Biovo)于1997年推出的产品。采集图像速度快，图像精度高，稳定性好，同时提供指纹算法，和二次开发所需的SDK。产品性能指标如下：图像采集速度：8帧/s。图像精度：680DPI图像大小：256*304像素免驱动，在98以上系统不需要安装驱动。算法性能：拒真率：1%认假率：0.001%比对速度：在P1G，256M内存的PC上,比对速度为800枚/秒，利用快速搜索可达到每秒4000枚。2. SDK说明光学采集仪提供供二次开发所需要的SDK开发包。以光盘的形式提供。光盘中目录说明 Bin：是Demo程序的可执行文件。 Example：是Demo程序的源代码,提供VC和Delphi的示例代码。Driver for Windows98: Windows 98下的驱动程序.98以上系统免驱动。Update: 固件更新程序,当有新的固件版本发布时,可以用这个程序更新.DLL:是提供的采集仪支持库和接口说明.ActiveX:可供二次开发的ocx控件. 3. 二次开发接口说明在SDK中提供了一个动态库，MXOTDLL.dll，其中实现了使用光学指纹仪进行二次开发所需用到的一些函数。此文件调用到的动态库为OSL_DLL_DLINK.dll，OSL_DLL_DLINK.dll的函数接口不对外公开，只供MXOTDLL使用。 可供调用的函数如下： 3.1打开设备函数原型：int WINAPI MXInitDev(HWND hwndPreview);函数功能: 初始化设备函数参数：hwndPreview 预览窗口句柄，对此设备必须传入NULL返回值： 成功返回1，失败返回0。 3.2释放设备函数原型：int WINAPI MXReleaseDev(void);函数功能: 释放设备函数参数：void返回值： 成功返回1，失败返回0。3.3探测手指是否按在采集仪上函数原型：int WINAPI MXIsFingerOn();函数功能: 探测手指是否按在采集仪上。函数参数： 返回值： 有手指返回1，无手指返回0。3.4 获取的数据是否是手指函数原型：int WINAPI MXDetectFinger(unsigned char *FingerBuf);函数功能: 检测获取的数据是否是手指函数参数：FingerBuf-读取的指纹数据,通过此指纹数据判断是否是手指.缓冲区大小304*256Byte。返回值： 成功返回1，失败返回0。3.5获取图像函数原型：int WINAPI MXReadFingerFromSensor(unsigned char*FingerBuf);函数功能: 从传感器上读入指纹图像并存放到FingerBuf中。函数参数：FingerBuf-存放指纹图像数据。缓冲区大小304*256Byte。返回值： 成功返回1，失败返回0。3.6保存图像函数原型：int WINAPI MXSaveFingerToFile(unsigned char*FingerBuf,char* strFingerName);函数功能: 把内存中的图像保存到bmp文件中。函数参数：FingerBuf-存放指纹图像数据的缓冲区，缓冲区大小304*256Byte。 strFingerName-指纹文件名称，如C:finger.bmp。返回值： 成功返回1，失败返回0。 3.7从文件中载入图像函数原型：int WINAPI MXLoadFingerFromFile(char* strFingerName,unsigned char*FingerBuf);函数功能: 载入指纹图像Bmp文件到内存中。函数参数：FingerBuf-存放指纹图像数据的缓冲区，缓冲区大小304*256Byte。 strFingerName-指纹文件名称,如C:Finger.bmp。返回值： 成功返回1，失败返回0。3.8保存特征函数原型：int WINAPI MXSaveFeatureToFile(unsigned char*FeatureBuf,char* strFeatureName);函数功能: 把内存中的特征点保存到特征文件中。函数参数：FeatureBuf-存放指纹特征数据的缓冲区，大小256Byte strFeatureName-指纹特征文件名称，如C:Finger.dat返回值： 成功返回1，失败返回0。3.9从文件加载特征函数原型：int WINAPI MXLoadFeatureFromFile(char* strFeatureName,unsigned char*FeatureBuf);函数功能: 载入指纹特征文件到内存中。函数参数：FeatureBuf-存放指纹特征数据的缓冲区，大小256Byte strFeatureName-指纹特征文件名称,如C:Finger.dat返回值： 成功返回1，失败返回0。3.10提取特征函数原型：int WINAPI MXExtract(unsigned char*FingerBuf,unsigned char* FeatureBuf);函数功能: 对内存中的指纹进行处理，提取出特征值并放到缓冲区。函数参数：FingerBuf-存放指纹图像数据的缓冲区，缓冲区大小304*256Byte。 FeatureBuf-指纹特征数据缓冲区,缓冲区大小256Byte。返回值： 成功返回0，失败返回非0（非0代码代表具体的错误代码）。3.11指纹比对函数原型：int WINAPI MXIdentify(unsigned char*SrcFeatureBuf,unsigned char* DesFeatureBuf);函数功能: 对两个指纹特征进行比对。函数参数：SrcFeatureBuf,DesFeatureBuf-要比对的两个指纹特征数据.缓冲区大小256Byte.返回值： 返回的是比对的分数，0-100，分数越高说明相似度越高。用户可以定义验证通过的分数如大于50分表示验证通过.一般大于30分通常都可以认为比对通过。分数越高安全等级越高.3.12获取版本号函数原型：int WINAPI MXVersion(char* Version);函数功能: 获取动态库的版本号；函数参数：Version-获取的版本信息。返回值： 始终为1。3.13获取指纹特征匹配度 函数原型：int WINAPI MXSimDegree(unsigned char *UserInfo,unsigned char *TempletInfo)函数功能：快速搜索时，可以先调用此函数找到最匹配的结果，再进行比对。函数参数：UserInfo待匹配的用户模板 TempletInfo读取的临时用户模板返回值：匹配度值越大匹配度越高 3.14快速搜索函数原型：int WINAPI MXQuickSearch(unsigned char *UserInfo,unsigned char *BufferP,int StartID,int TotalSortNum,int * MatchScore);函数功能：在缓冲区中，快速搜索指纹模版,之前需要把所有指纹模版读到连续内存中参数说明：UserInfo 待比对的用户特征信息(母板) BufferP 模板信息缓冲区指针(子板缓冲区指针) StartID 搜索范围(起始ID) TotalSortNum 搜索范围(搜索个数) MatchScore 用户指定的指针，用来存放匹配模板的得分，没有匹配模板则得0分返回值： 匹配模板的ID(09999) 返回SORTFAIL(20000)表示没有比配模板或搜索失败。说明: unsigned char * BufferP指定的模板缓冲区大小为256bytes*10000(最大10000枚指纹)，要求模板连续存放，无模板空间以0xff填充3.15两次合并模板函数原型：int WINAPI MXMerge2(unsigned char *Feature1,unsigned char *Feature2,unsigned char *Templet);函数功能: 将两个指纹特征合并为指纹模板。函数参数：Feature1 - 指纹特征1，256字节 Feature2 - 指纹特征2，256字节 Templet - 指纹模板，256字节返回值： 0 - 合并失败,Templet缓冲清0；1 - 合并成功,Templet缓冲保存指纹模板3.16三次合并模板函数原型：int WINAPI MXMerge3(unsigned char *Feature1,unsigned char *Feature2,unsigned char *Feature3,unsigned char *Templet);函数功能: 将三个指纹特征合并为指纹模板。函数参数：Feature1 - 指纹特征1，256字节 Feature2 - 指纹特征2，256字节 Feature3 - 指纹特征3，256字节 Templet - 指纹模板，256字节返回值： 0 - 合并失败,Templet缓冲清01 - 合并成功,Templet缓冲保存指纹模板3.17 灯控制 函数原型：int WINAPI MXLampOnOff(int nLamp,bool bOn);函数功能：灯控制，控制灯的打开关闭。函数参数：nLamp 表示打开的是红灯还是绿灯， nLamp=1,表示红灯，=2表示绿灯。bOn表示开还是关，true表示开，false表示关。返回值：1成功，0失败。3.18多设备支持函数为了支持在一台电脑上插入多个设备的情况，提供下面几个函数，对应前面函数的扩展。l 打开设备HANDLE WINAPI MXInitDevEx(int nDeviceNum)nDeviceNum是要打开的设备号，从0开始。返回打开的设备句柄。INVALID_HANDLE_VALUE表示打开失败。l 关闭设备int WINAPI MXReleaseDevEx(HANDLE hDev)hDev是打开的设备句柄。成功返回1，失败0l 探测是否手指按在采集仪上int WINAPI MXIsFingerOnEx(HANDLE hDev)hDev是打开的设备句柄。有手指返回1，否则返回0。l 从采集仪上采集指纹int WINAPI MXReadFingerFromSensorEx(HANDLE hDev,unsigned char*FingerBuf)hDev是打开的句柄，FingerBuf是图像缓冲。成功返回1，失败返回0。参考MXReadFingerFromSensor函数.l 灯控制int WINAPI MXLampOnOffEx(HANDLE hDev,int nLamp,bool bOn)hDev是打开的句柄，nLamp是灯，bOn表示打开还是关闭,参考MXLampOnOff函数。3.19读取唯一序列号函数l 函数原型：int WINAPI MXReadID(unsigned char* pData);pData为24字节的序列号，仅仅Biovo V3.51以上设备有此功能。4. 主要程序流程以下是几个主要操作的程序流程图，注意： 在操作设备前需要调用MXIn