《杭州中正光学指纹采集仪开发手册》由会员分享，可在线阅读，更多相关《杭州中正光学指纹采集仪开发手册（7页珍藏版）》请在金锄头文库上搜索。
1、 第 1 页 共 7 页 光学指纹采集仪开发手册 一一一一、 产品介绍产品介绍产品介绍产品介绍 光学指纹采集仪是杭州中正生物认证技术有限公司(MIAXIS)研制的一款桌面应用型指纹产品，其特点是采集速度快，图像质量高，主要技术指标如下： 图像采集速度：8 帧/s。 图像精度：500DPI 图像大小：256*304 像素 免驱动，在Win98以上Windows操作系统不需要安装USB驱动。 该指纹仪适用于各种基于PC的安全控制系统， 如本机用户身份确认、 局域网用户身份确认、各种应用系统用户身份确认等。通过指纹来取代传统的密码，可增加系统的安全性和方便性。 与指纹仪配套的软件库如下： MXOTD
2、LL.dll 包含Win32指纹仪驱动接口、指纹算法接口，实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能。适用于CS架构客户端程序。 MXOTOCX.ocx 包含指纹仪驱动接口、指纹算法接口，实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能。适用于BS架构浏览器端程序。 MXOTFingerMatch.so Unix或Linux指纹比对算法动态库，实现比对功能。适用于服务器端程序。 第 2 页 共 7 页 二二二二、 MXOTDLL.dll接口说明接口说明接口说明接口说明 1、 函 数：int IsMxUsbDevice() 功 能：是否正
3、确连接 参 数： 返回值： 0 成功； -1 失败。 2、 函 数: int mxUsbGetImage(unsigned char* imageBuf,long nTimeOut) 功 能: 从指纹仪中，获取指纹图像。 参 数: imageBuf 输出，指纹图像缓存，大小：256*304 字节（二进制码） 。 nTimeOut 输入，超时时间，单位：毫秒。 如果 nTimeOut=0，则表示无限时等待 返回值: 0 成功； 其他 失败。 失败说明: -1 打开指纹仪失败； -2 用户取消操作； -3 等待手指超时； -4 采集图像失败； -5 上传图像失败。 3、 函 数: void mxC
4、ancelGetImage() 功 能: 取消正在进行获取指纹图像操作 4、 函 数: int IsMxGetImage() 功 能: 是否正在进行获取指纹图像操作 参 数: 返回值: 0 - 是 -1 - 否 5、 函 数: void mxGetDeviceVersion(char szVersion256) 功 能: 获取版本信息 参 数: szVersion -获取版本信息(256 字节) 返回值: 6、 函 数: int mxWriteDevSN(char* pData,int nLength) 功 能: 写设备序列号 参 数: pData - 序列号，长度小于 256 字节 nLen
5、gth - 序列号长度 返回值: 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） pRa
6、w 原始图像数据 X 图像宽度 Y 图像高度 返 回： 0 成功； 非 0 失败。 9、 函 数：int mxBmp2Raw(unsigned char* pBmp, 第 3 页 共 7 页 unsigned char* pRaw,int *pW,int *pH) 功 能：bmp 格式数据,转换成原始图像数据(不包含文件头) 参 数：pBmp bmp 格式数据（大小：图像数据大小1078） pRaw 原始图像数据 X 图像宽度 Y 图像高度 返 回： 0 成功； 非 0 失败。 10、函 数：unsigned int mxBase64Encode(unsigned char *pInput,
7、unsigned int inputLen, unsigned char *pOutput, unsigned int outputbufsize) 功 能：对数据块进行 base64 编码 参 数：pInput - 输入，编码前数据块 inputLen - 输入，输入数据块（pInput）长度 pOutput - 输出， base64 编码后数据块， 大小为输入数据的 4/3 倍， 输出数据块 pInput 和输入数据块 pOutput 起始地址可以相同 outputbufsize - 输入,存放编码后数据（pOutput）的缓冲区大小 返 回： 0 - 用于存放编码后数据的缓冲区不够，编码
8、失败。 大于 0 - 编码后数据长度，值为(inputLen+2)/3*4 11、函 数：unsigned int mxBase64Decode(unsigned char *pInput, unsigned int inputLen, unsigned char *pOutput) 功 能：对输入的 base64 编码数据块进行 base64 解码 参 数：pInput - 输入，base64 编码数据块 inputLen - 输入，base64 编码数据块长度 pOutput - 输出，base64 解码后的数据块 输出数据块pInput和输入数据块pOutput起始地址可以相同 返 回：
9、 0 - 用于存放编码后数据的缓冲区不够，编码失败。 大于 0 - 编码后数据长度，值为(inputLen+2)/3*4 12、 函 数：int mxGetTzBase64 (unsigned char *input, unsigned char *tzBuf) 功 能：从指纹图象中获取特征。 参 数：input 输入，指纹图象缓冲，大小为 256*304 字节（二进制码） ； tzBuf 输出，指针指向现场录入的指纹特征，344 字节（Base64 码） 。 返 回： 0 获取特征成功； -1 获取特征失败。 13、 函 数：int mxGetMBBase64 (unsigned char
10、*tzBuf1, unsigned char *tzBuf2, unsigned char *tzBuf3, unsigned char *mbBuf) 功 能：从三个指纹特征中合并指纹模板。 参 数：tzBuf1 输入，指向指纹特征 1 的指针，344 字节（Base64 码） ； tzBuf2 输入，指向指纹特征 2 的指针，344 字节（Base64 码） ； tzBuf3 输入，指向指纹特征 3 的指针，344 字节（Base64 码） ； mbBuf 输出，指向指纹模板的指针 ，344 字节（Base64 码） 。 返 回： 0 合并模板成功； -1 合并模板失败。 14、 函 数：
11、 int mxFingerMatchBase64 (unsigned char *mb, unsigned char *tz, int level) 第 4 页 共 7 页 功 能：比对指纹特征和指纹模板。 参 数：mb 输入，指向指纹模板的指针，344 字节（Base64 码） ； tz 输入，指向指纹特征的指针，344 字节（Base64 码） ； level 输入，安全等级，1-5 级，级别越高，越安全，一般取 3。 返 回： 0 比对成功； -1 比对失败。 第 5 页 共 7 页 三三三三、 MXOTOCX.ocx接口说明接口说明接口说明接口说明 控件名控件名控件名控件名： MXOT
12、OCX.ocx 类类类类 IDIDIDID： 4E16E1BD-B562-48E3-813E-DC5CA566D94C 两点说明两点说明两点说明两点说明： 1、采集指纹过程，可看到指纹图像，用于辅助判断所采集指纹图像的质量。 2、返回值为 String 的函数失败返回时，失败返回值为字符串，不是整型。 控件控件控件控件方法方法方法方法说明说明说明说明： 1、 函数：String IsMxUsbDevice() 功能：是否正确连接设备 参数： 返回：成功： 0 失败： -1 2、 函数：String mxUsbGetImage (DWORD dwWaitTime) 功能：获取指纹图像。 参数：d
13、wWaitTime-输入，超时时间(单位：毫秒)。 返回：成功：指纹图像信息（指纹图像数据进行 Base64 编码后的字符串） ； 失败： -1 打开指纹仪失败； -2 用户取消操作； -3 等待手指超时； -4 采集图像失败； -5 上传图像失败。 3、 函数：String mxUsbGetTz (DWORD dwWaitTime) 功能：获取指纹特征。 参数：dwWaitTime-输入，超时时间(单位：毫秒)。 返回：成功：指纹特征； 失败： -1 打开指纹仪失败； -2 用户取消操作； -3 等待手指超时； -4 采集图像失败； -5 上传图像失败； -6 提取指纹特征失败。 4、 函数
14、：String mxUsbGetMb (DWORD dwWaitTime) 功能：获取指纹模板 参数：dwWaitTime-输入，超时时间(单位：毫秒)。 返回：成功：指纹模板； 失败： -1 打开指纹仪失败； -2 用户取消操作； -3 等待手指超时； -4 采集图像失败； -5 上传图像失败； -6 提取指纹特征失败； -7 合并指纹模板失败。 5、 函数：int mxFingerMatch(char *mb, char *tz,int level) 功能：指纹比对。 参数：mb - 输入，指向指纹模板的指针，256 字节（Base64 码） ； tz - 输入，指向指纹特征的指针，344
15、 字节（Base64 码） ； level - 输入，安全等级，1-5 级，级别越高，越安全，一般取 3。 返回： 0 - 比对成功； 第 6 页 共 7 页 非 0 - 比对失败。 6、 函 数: String mxGetDeviceVersion() 功 能: 获取版本信息 参 数: 返回值: 版本信息 7、 函 数: String mxGetDeviceSN() 功 能: 获取设备序列号 参 数: 返回值: 成功：设备序列号 失败：-1 打开设备失败 -2 写入操作失败 8、 函 数: short mxSetDeviceSN(char* szDevSN, short nLength) 功
16、 能: 获取版本信息 参 数: szDevSN - 输入，设备序列号，长度小于 256 字节 nLength - 输入，设备序列号长度 返回值: 0 成功 其他 失败 第 7 页 共 7 页 四四四四、 MXOTFingerMatch.so接口说明接口说明接口说明接口说明 函 数：unsigned int mxFingerMatchBase64(unsigned char *mb, unsigned char *tz, int level) 功 能：指纹比对。 参 数：mb - 输入，指向指纹模板的指针，344 字节（Base64 码） ； tz - 输入，指向指纹特征的指针，344 字节（Base64 码） ； Level - 输入，安全等级，1-5 级，级别越高，越安全，一般取 3。 返 回： 0 - 比对成功； 非 0 - 比对失败。
