杭州中正光學(xué)指紋采集儀開發(fā)手冊

1、 光學(xué)指紋采集儀開發(fā)手冊一、產(chǎn)品介紹光學(xué)指紋采集儀是杭州中正生物認(rèn)證技術(shù)有限公司(MIAXIS研制的一款桌面應(yīng)用型指紋產(chǎn)品,其特點(diǎn)是采集速度快,圖像質(zhì)量高,主要技術(shù)指標(biāo)如下:<1>圖像采集速度:8 幀/s。<2>圖像精度:500DPI<3>圖像大小:256*304 像素<4>免驅(qū)動,在Win98以上Windows操作系統(tǒng)不需要安裝USB驅(qū)動。該指紋儀適用于各種基于PC的安全控制系統(tǒng),如本機(jī)用戶身份確認(rèn)、局域網(wǎng)用戶身份確認(rèn)、各種應(yīng)用系統(tǒng)用戶身份確認(rèn)等。通過指紋來取代傳統(tǒng)的密碼,可增加系統(tǒng)的安全性和方便性。與指紋儀配套的軟件庫如下:<1>

2、 MXOTDLL.dll包含Win32指紋儀驅(qū)動接口、指紋算法接口,實(shí)現(xiàn)指紋圖像的采集、從指紋儀獲取指紋特征、從指紋儀獲取指紋模板、比對等功能。適用于CS架構(gòu)客戶端程序。<2> MXOTOCX.ocx包含指紋儀驅(qū)動接口、指紋算法接口,實(shí)現(xiàn)指紋圖像的采集、從指紋儀獲取指紋特征、從指紋儀獲取指紋模板、比對等功能。適用于BS架構(gòu)瀏覽器端程序。<3>MXOTFingerMatch.soUnix或Linux指紋比對算法動態(tài)庫,實(shí)現(xiàn)比對功能。適用于服務(wù)器端程序。 二、MXOTDLL.dll接口說明1、 函 數(shù):int IsMxUsbDevice(功 能:是否正確連接參 數(shù):返回值:

3、 0 - 成功;-1 - 失敗。2、 函 數(shù): int mxUsbGetImage(unsigned char* imageBuf,long nTimeOut功 能: 從指紋儀中,獲取指紋圖像。參 數(shù): imageBuf - 輸出,指紋圖像緩存,大小:256*304字節(jié)(二進(jìn)制碼。nTimeOut - 輸入,超時(shí)時(shí)間,單位:毫秒。如果nTimeOut=0,則表示無限時(shí)等待返回值: 0 - 成功;其他 - 失敗。失敗說明: -1 - 打開指紋儀失敗;-2 - 用戶取消操作;-3 - 等待手指超時(shí);-4 - 采集圖像失敗;-5 - 上傳圖像失敗。3、 函 數(shù): void mxCancelGetIm

4、age(功 能: 取消正在進(jìn)行獲取指紋圖像操作4、 函 數(shù): int IsMxGetImage(功 能: 是否正在進(jìn)行獲取指紋圖像操作參 數(shù):返回值: 0 - 是-1 - 否5、 函 數(shù): void mxGetDeviceVersion(char szVersion256功 能: 獲取版本信息參 數(shù): szVersion -獲取版本信息(256字節(jié)返回值:6、 函 數(shù): int mxWriteDevSN(char* pData,int nLength功 能: 寫設(shè)備序列號參 數(shù): pData - 序列號,長度小于256字節(jié)nLength - 序列號長度返回值: 0 - 成功其他 - 失敗7、

5、函 數(shù): int mxReadDevSN(char* pData,int *nLength功 能: 讀設(shè)備序列號參 數(shù): pData - 序列號,長度小于256字節(jié)nLength - 序列號長度返回值: 0 - 成功其他 - 失敗8、 函 數(shù):int mxRaw2Bmp(unsigned char* pBmp,unsigned char* pRaw,int X,int Y功 能:原始圖像數(shù)據(jù),轉(zhuǎn)換成bmp格式數(shù)據(jù)(包含文件頭參 數(shù):pBmp - bmp格式數(shù)據(jù)(大小:圖像數(shù)據(jù)大小+1078pRaw - 原始圖像數(shù)據(jù)X - 圖像寬度Y - 圖像高度返 回: 0 - 成功;非 0 - 失敗。9、

6、函 數(shù):int mxBmp2Raw(unsigned char* pBmp, unsigned char* pRaw,int *pW,int *pH功 能:bmp格式數(shù)據(jù),轉(zhuǎn)換成原始圖像數(shù)據(jù)(不包含文件頭參 數(shù):pBmp - bmp格式數(shù)據(jù)(大小:圖像數(shù)據(jù)大小+1078pRaw - 原始圖像數(shù)據(jù)X - 圖像寬度Y - 圖像高度返 回: 0 - 成功;非 0 - 失敗。10、函 數(shù):unsigned int mxBase64Encode(unsigned char *pInput,unsigned int inputLen,unsigned char *pOutput,unsigned int

7、outputbufsize功 能:對數(shù)據(jù)塊進(jìn)行base64編碼參 數(shù):pInput - 輸入,編碼前數(shù)據(jù)塊inputLen - 輸入,輸入數(shù)據(jù)塊(pInput長度pOutput - 輸出,base64編碼后數(shù)據(jù)塊,大小為輸入數(shù)據(jù)的4/3倍, 輸出數(shù)據(jù)塊pInput 和輸入數(shù)據(jù)塊pOutput 起始地址可以相同 outputbufsize - 輸入,存放編碼后數(shù)據(jù)(pOutput的緩沖區(qū)大小 返 回: 0 - 用于存放編碼后數(shù)據(jù)的緩沖區(qū)不夠,編碼失敗。大于0 - 編碼后數(shù)據(jù)長度,值為(inputLen+2/3*411、函 數(shù):unsigned int mxBase64Decode(unsigne

8、d char *pInput,unsigned int inputLen,unsigned char *pOutput功 能:對輸入的base64編碼數(shù)據(jù)塊進(jìn)行base64解碼參 數(shù):pInput - 輸入,base64編碼數(shù)據(jù)塊inputLen - 輸入,base64編碼數(shù)據(jù)塊長度pOutput - 輸出,base64解碼后的數(shù)據(jù)塊輸出數(shù)據(jù)塊pInput和輸入數(shù)據(jù)塊pOutput起始地址可以相同 返 回: 0 - 用于存放編碼后數(shù)據(jù)的緩沖區(qū)不夠,編碼失敗。大于0 - 編碼后數(shù)據(jù)長度,值為(inputLen+2/3*412、 函 數(shù):int mxGetTzBase64 (unsigned ch

9、ar *input, unsigned char *tzBuf功 能:從指紋圖象中獲取特征。參 數(shù):input - 輸入,指紋圖象緩沖,大小為256*304字節(jié)(二進(jìn)制碼;tzBuf - 輸出,指針指向現(xiàn)場錄入的指紋特征,344字節(jié)(Base64碼。返 回: 0 - 獲取特征成功;-1 - 獲取特征失敗。13、 函 數(shù):int mxGetMBBase64 (unsigned char *tzBuf1,unsigned char *tzBuf2,unsigned char *tzBuf3,unsigned char *mbBuf功 能:從三個(gè)指紋特征中合并指紋模板。參 數(shù):tzBuf1 - 輸入

10、,指向指紋特征1的指針,344字節(jié)(Base64碼;tzBuf2 - 輸入,指向指紋特征2的指針,344字節(jié)(Base64碼;tzBuf3 - 輸入,指向指紋特征3的指針,344字節(jié)(Base64碼;mbBuf - 輸出,指向指紋模板的指針 ,344字節(jié)(Base64碼。返 回: 0 - 合并模板成功;-1 - 合并模板失敗。14、 函 數(shù): int mxFingerMatchBase64 (unsigned char *mb,unsigned char *tz,int level 功 能:比對指紋特征和指紋模板。參 數(shù):mb - 輸入,指向指紋模板的指針,344字節(jié)(Base64碼;tz -

11、 輸入,指向指紋特征的指針,344字節(jié)(Base64碼;level - 輸入,安全等級,1-5級,級別越高,越安全,一般取3。 返 回: 0 - 比對成功;-1 - 比對失敗。 三、 MXOTOCX.ocx 接口說明控件名控件名: MXOTOCX.ocx類IDID: 4E16E1BD-B562-48E3-813E-DC5CA566D94C兩點(diǎn)說明兩點(diǎn)說明: 1、采集指紋過程,可看到指紋圖像,用于輔助判斷所采集指紋圖像的質(zhì)量。2、返回值為String 的函數(shù)失敗返回時(shí),失敗返回值為字符串,不是整型。 控件控件方法方法方法說明說明說明: 1、 函數(shù):String IsMxUsbDevice(功能:

12、是否正確連接設(shè)備參數(shù):返回:成功: 0失敗: -12、 函數(shù):String mxUsbGetImage (DWORD dwWaitTime功能:獲取指紋圖像。參數(shù):dwWaitTime-輸入,超時(shí)時(shí)間(單位:毫秒。返回:成功:指紋圖像信息(指紋圖像數(shù)據(jù)進(jìn)行Base64編碼后的字符串;失敗: -1 - 打開指紋儀失敗;-2 - 用戶取消操作;-3 - 等待手指超時(shí);-4 - 采集圖像失敗;-5 - 上傳圖像失敗。3、 函數(shù):String mxUsbGetTz (DWORD dwWaitTime功能:獲取指紋特征。參數(shù):dwWaitTime-輸入,超時(shí)時(shí)間(單位:毫秒。返回:成功:指紋特征;失敗:

13、 -1 - 打開指紋儀失敗;-2 - 用戶取消操作;-3 - 等待手指超時(shí);-4 - 采集圖像失敗;-5 - 上傳圖像失敗;-6 - 提取指紋特征失敗。4、 函數(shù):String mxUsbGetMb (DWORD dwWaitTime功能:獲取指紋模板參數(shù):dwWaitTime-輸入,超時(shí)時(shí)間(單位:毫秒。返回:成功:指紋模板;失敗: -1 - 打開指紋儀失敗;-2 - 用戶取消操作;-3 - 等待手指超時(shí);-4 - 采集圖像失敗;-5 - 上傳圖像失敗;-6 - 提取指紋特征失敗;-7 - 合并指紋模板失敗。5、 函數(shù):int mxFingerMatch(char *mb, char *tz

14、,int level 功能:指紋比對。參數(shù):mb - 輸入,指向指紋模板的指針,256字節(jié)(Base64碼;tz - 輸入,指向指紋特征的指針,344字節(jié)(Base64碼;level - 輸入,安全等級,1-5級,級別越高,越安全,一般取3。 返回: 0 - 比對成功;非 0 - 比對失敗。 6、 函 數(shù): String mxGetDeviceVersion( 功 能: 獲取版本信息 參 數(shù): 返回值: 版本信息 7、 函 數(shù): String mxGetDeviceSN( 功 能: 獲取設(shè)備序列號 參 數(shù): 返回值: 成功：設(shè)備序列號 失敗：-1 打開設(shè)備失敗 -2 寫入操作失敗 8、 函 數(shù): short mxSetDeviceSN(char* szDevSN, short nLength 功 能: 獲取版本信息 參 數(shù): szDevSN - 輸入，設(shè)備序列號，長度小于 256 字節(jié) nLength - 輸入，設(shè)備序列號長度 返回值: 0 成功 其他 失敗 第 6 頁 共 7 頁 四、 MXOTFingerMatch.so 接口說明 函 數(shù)：unsigned int m