杭州中正光学指纹采集仪开发手册.doc

光学指纹采集仪开发手册 一、产品介绍 光学指纹采集仪是杭州中正生物认证技术有限公司(MIAXIS研制的一款桌面应用型指纹产品,其特点是采集速度快,图像质量高,主要技术指标如下: <1>图像采集速度:8 帧/s。 <2>图像精度:500DPI <3>图像大小:256*304 像素 <4>免驱动,在Win98以上Windows操作系统不需要安装USB驱动。 该指纹仪适用于各种基于PC的安全控制系统,如本机用户身份确认、局域网用户身份确认、各种应用系统用户身份确认等。通过指纹来取代传统的密码,可增加系统的安全性和方便性。 与指纹仪配套的软件库如下: <1> MXOTDLL.dll 包含Win32指纹仪驱动接口、指纹算法接口,实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能。适用于CS架构客户端程序。 <2> MXOTOCX.ocx 包含指纹仪驱动接口、指纹算法接口,实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能。适用于BS架构浏览器端程序。 <3>MXOTFingerMatch.so Unix或Linux指纹比对算法动态库,实现比对功能。适用于服务器端程序。 二、MXOTDLL.dll接口说明 1、 函 数:int IsMxUsbDevice( 功 能:是否正确连接 参 数: 返回值: 0 - 成功; -1 - 失败。 2、 函 数: int mxUsbGetImage(unsigned char* imageBuf,long nTimeOut 功 能: 从指纹仪中,获取指纹图像。 参 数: imageBuf - 输出,指纹图像缓存,大小:256*304字节(二进制码。 nTimeOut - 输入,超时时间,单位:毫秒。 如果nTimeOut=0,则表示无限时等待 返回值: 0 - 成功; 其他 - 失败。 失败说明: -1 - 打开指纹仪失败; -2 - 用户取消操作; -3 - 等待手指超时; -4 - 采集图像失败; -5 - 上传图像失败。 3、 函 数: void mxCancelGetImage( 功 能: 取消正在进行获取指纹图像操作 4、 函 数: int IsMxGetImage( 功 能: 是否正在进行获取指纹图像操作 参 数: 返回值: 0 - 是 -1 - 否 5、 函 数: void mxGetDeviceVersion(char szVersion[256] 功 能: 获取版本信息 参 数: szVersion -获取版本信息(256字节 返回值: 6、 函 数: int mxWriteDevSN(char* pData,int nLength 功 能: 写设备序列号 参 数: pData - 序列号,长度小于256字节 nLength - 序列号长度 返回值: 0 - 成功 其他 - 失败 7、 函 数: int mxReadDevSN(char* pData,int *nLength 功 能: 读设备序列号 参 数: pData - 序列号,长度小于256字节 nLength - 序列号长度 返回值: 0 - 成功 其他 - 失败 8、 函 数:int mxRaw2Bmp(unsigned char* pBmp,unsigned char* pRaw,int X,int Y 功 能:原始图像数据,转换成bmp格式数据(包含文件头 参 数:pBmp - bmp格式数据(大小:图像数据大小+1078 pRaw - 原始图像数据 X - 图像宽度 Y - 图像高度 返 回: 0 - 成功; 非 0 - 失败。 9、 函 数:int mxBmp2Raw(unsigned char* pBmp, unsigned char* pRaw,int *pW,int *pH 功 能:bmp格式数据,转换成原始图像数据(不包含文件头 参 数:pBmp - bmp格式数据(大小:图像数据大小+1078 pRaw - 原始图像数据 X - 图像宽度 Y - 图像高度 返 回: 0 - 成功; 非 0 - 失败。 10、函 数:unsigned int mxBase64Encode(unsigned char *pInput, unsigned int inputLen, unsigned char *pOutput, unsigned int outputbufsize 功 能:对数据块进行base64编码 参 数:pInput - 输入,编码前数据块 inputLen - 输入,输入数据块(pInput长度 pOutput - 输出,base64编码后数据块,大小为输入数据的4/3倍, 输出数据块pInput 和输入数据块pOutput 起始地址可以相同 o