指紋識別指導(dǎo)

1、指紋開發(fā)包函數(shù)說明Polymath USB Fingerprint SDK Version 3.1 Polymath Technology Development Co., Ltd 寶利銘科技發(fā)展有限公司地址：廈門軟件園二期57號902單元 電話：592-5310833、5310273傳真：592-5310259網(wǎng)址：電郵：managerDocument version 1.0 Copyright 2007 Polymath Corporation. All right reserved.一、概述本開發(fā)包以動態(tài)連接庫(DLL)的方式提供，SDK光盤配備以下項(xiàng)目： Dll 庫文件。您的應(yīng)用程序必

2、須把這些庫文件包含在應(yīng)用程序目錄中。 Driver USB指紋采集儀驅(qū)動文件。 Samples 演示代碼，包括 VC+，VB。在您運(yùn)行演示程序之前，請務(wù)必先連接好USB指紋儀及安裝其驅(qū)動程序。本演示涉及到文件操作，請將程序從光盤中拷貝到硬盤上再運(yùn)行。以下將以VC+ 函數(shù)聲明方式說明方法，關(guān)于VB的函數(shù)具體聲明應(yīng)用請參考VB Sample程序，關(guān)于其他編程語言請依據(jù)具體程序語言如何調(diào)用動態(tài)連接庫進(jìn)行應(yīng)用。二、函數(shù)說明 2.1 錯(cuò)誤碼表常量值說明RUN_SUCCESS0成功ERR_FAILED_INIT1初始化失敗ERR_FAILED_CALLDB2數(shù)據(jù)庫操作失敗ERR_MISTAKE_PARAM

3、3參數(shù)錯(cuò)誤ERR_FAILED_FUNCTION4方法執(zhí)行失敗ERR_OVERFLOW_MEMORY5內(nèi)存溢出ERR_OVERFLOW_TIME6超時(shí)ERR_VERIFICATION_FAILED7驗(yàn)證失敗ERR_UNKOWN_ERROR8未知錯(cuò)誤ERR_ABSENCE_DEVICE9沒有設(shè)備 2.2 常量值表 常量值說明DEVTYPE_7621641762164設(shè)備類型MAX_FP_WIDTH512指紋圖象寬度MAX_FP_HEIGHT512指紋圖象高度DEF_EXT_MINSIZE1024指紋特征值大小DEF_REG_MINSIZE1024指紋特征值大小2.3 結(jié)構(gòu) typedef str

4、uct tagFPMINDBINFO DWORDfmdIndex; / 用戶ID DWORDfmdValid; / 指紋是否有效，有效值為1 BYTEfmdDataDEF_REG_MINSIZE; / 登記的指紋特征值 FPMINDBINFO , FAR *LPFPMINDBINFO, *PFPMINDBINFO;指紋特征值庫結(jié)構(gòu)。此結(jié)構(gòu)為 FPMIndentify 方法所用。2.4 函數(shù)說明2.4.1 DWORD FPMInit(DWORD deviceType)功能：初始化設(shè)備參數(shù)：deviceType 設(shè)備類型,取值 1（或用常量 DEVTYPE_762164） 返回：成功返回 0 (R

5、UN_SUCCESS)備注：應(yīng)用程序啟動后必須先調(diào)用此方法才能進(jìn)行后續(xù)方法使用。2.4.2 DWORD FPMExit()功能：關(guān)閉設(shè)備參數(shù)：無 返回：成功返回 0 (RUN_SUCCESS)備注：應(yīng)用程序退出之前必須先調(diào)用此方法關(guān)閉設(shè)備。2.4.3 DWORD FPMGetBrightness(BYTE* val)功能：獲得亮度值參數(shù)：val 亮度的返回值，值范圍 0 255返回：成功返回 0 (RUN_SUCCESS)備注：2.4.4 DWORD FPMGetContrast(BYTE* val)功能：獲得對比度值參數(shù)：val 對比度的返回值，值范圍 0 255返回：成功返回 0 (RUN

6、_SUCCESS)備注：2.4.5 DWORD FPMSetBrightness(BYTE val)功能：設(shè)置亮度參數(shù)：val 亮度值，值范圍 0 255返回：成功返回 0 (RUN_SUCCESS)備注：亮度值建議設(shè)置在180 255，推薦255 。2.4.6 DWORD FPMSetContrast(BYTE val)功能：設(shè)置對比度參數(shù)：val 對比值，值范圍 0 255返回：成功返回 0 (RUN_SUCCESS)備注：對比度值建議設(shè)置在 200 以上，推薦255 。2.4.7 DWORD FPMGetLiveImage(BYTE *imgBuff, DWORD time, HWND

7、dispWnd, DWORD quality)功能：采集指紋圖象參數(shù)：imgBuff 返回指紋圖象的緩沖區(qū)，大小為 512 * 512 字節(jié)； time 采集超時(shí)時(shí)間，單位秒，建議 5 10 。 dispWnd 要顯示指紋圖象的window句柄，一般使用圖片框，也可Panel等。 quality 指紋圖象質(zhì)量要求，取值 0 255，建議50 75 ，推薦 65 或 70 。 取值太低將會使采集的圖象不完整便返回，不足以提取有效的指紋特征。取值太高（超過80）將無法采集到確切的指紋圖象。返回：成功返回 0 (RUN_SUCCESS)備注：提取指紋特征值之前，必須先采集指紋圖象。2.4.8 DWO

8、RD FPMGetMinutiae(BYTE *imgBuff, BYTE *min)功能：從指紋圖象中提取指紋特征值參數(shù)：imgBuff 指紋圖象的緩沖區(qū)（通過FPMGetLiveImage返回的imgBuff）; min 指紋特征值，大小為 1024 字節(jié) 。返回：成功返回 0 (RUN_SUCCESS)備注：提取指紋特征值，以便進(jìn)行指紋注冊、比對。2.4.9 DWORD FPMMatchForRegister(BYTE *min1, BYTE *min2, BYTE *min3, BYTE *regMin,DWORD secuLevel)功能：注冊指紋參數(shù)：min1 第一次采集的指紋特征

9、值（通過FPMGetMinutiae獲得）； min2 第二次采集的指紋特征值； min3 第三次采集的指紋特征值; regMin 輸出的注冊成功的指紋特征值，大小為 1024 字節(jié)； secuLevel 安全等級，取值 1 9 ，推薦 3 。返回：成功返回 0 (RUN_SUCCESS)備注：注冊登記指紋時(shí)，每枚手指要采集3次，經(jīng)過3次采集后的min，調(diào)用此方法進(jìn)行注冊驗(yàn)證，如 果3次采集的指紋不匹配，則登記失敗，如能匹配，則登記成功，將把最終的特征值返回在regMin中，大小是1024。請保存該regMin到文件或數(shù)據(jù)庫中，或其他您自定義的存儲方式，以備以后進(jìn)行指紋比對。存儲時(shí)，務(wù)必將該特

10、征值與用戶ID號綁定在一起，例如如以文件方式保存，則可用用戶ID做文件名。存儲在數(shù)據(jù)庫中時(shí)，可以將指紋特征值轉(zhuǎn)換為文本形式。每次指紋采集時(shí)，請先移開手指，再按下，這樣有利于采集到同一枚指紋更多的特征面。2.4.10 DWORD FPMVerification(BYTE *inMin, BYTE *regMin, DWORD secuLevel)功能：驗(yàn)證指紋 參數(shù)：inMin 要驗(yàn)證的指紋特征值； regMin 已登記的指紋特征值； secuLevel 安全等級，推薦值 3 。 返回：成功返回 0 (RUN_SUCCESS)備注：該方法也稱 1:1 比對方式。 先根據(jù)用戶ID，提取用戶已登記的

11、指紋特征值 regMin；調(diào)用 FPMGetLiveImage 和 FPMGetMinutiae 獲得當(dāng)前要比對的用戶的指紋特征值 inMin；然后使用該方法進(jìn)行比對，如返回成功，則說明當(dāng)前用戶就是該ID的用戶。1：1比對方式快捷、安全度高，但不能自動識別出用戶，需要用戶輸入ID，類似于傳統(tǒng)的密碼驗(yàn)證方式，由用戶ID獲取密碼段，與當(dāng)前的輸入密碼進(jìn)行比對以確定用戶是否正確。2.4.11 DWORD FPMIdentify(BYTE *inMin, BYTE *regMinArray, DWORD regMinCount, DWORD *matchedIndex, DWORD secuLevel)

12、功能：識別指紋 參數(shù)：inMin 要識別的指紋特征值； regMinArray 已登記的指紋特征值庫，F(xiàn)PMINDBINFO結(jié)構(gòu)數(shù)組（參見2.3）； regMinCount 指紋特征值庫中的指紋特征值總數(shù)。 matchedIndex 匹配到的用戶編號(fmdIndex)。 secuLevel 安全等級，推薦值 3 。 返回：成功返回 0 (RUN_SUCCESS)備注：該方法也稱 1:N 比對方式。程序應(yīng)先將所有指紋特征值（包括用戶ID）組織到FPMINDBINFO結(jié)構(gòu)數(shù)組中，將當(dāng)前要比對的用戶的指紋特征值 inMin使用該方法進(jìn)行比對，如返回成功，則在matchedIndex中返回用戶ID。

13、1：N比對方式也可以考慮使用1:1方式代替，即使用1：1方式逐一驗(yàn)證用戶。建議使用1:1方式代替1:N。2.4.12 DWORD FPMSaveLiveImageAsBMP(BYTE *imgBuff, LPCSTR filename)功能：保存指紋圖象為BMP文件參數(shù)：imgBuff 指紋圖象的緩沖區(qū)（通過FPMGetLiveImage返回的imgBuff）; filename 要保存的文件位置與名稱。返回：成功返回 0 (RUN_SUCCESS)備注： 2.4.13 DWORD FPMSaveLiveImageAsJPG(BYTE *imgBuff, LPCSTR filename)功能：

14、保存指紋圖象為JPG文件參數(shù)：imgBuff 指紋圖象的緩沖區(qū)（通過FPMGetLiveImage返回的imgBuff）; filename 要保存的文件位置與名稱。返回：成功返回 0 (RUN_SUCCESS)備注：以下部分為使用內(nèi)置指紋數(shù)據(jù)庫的相關(guān)方法2.4.14 DWORD FPMSetDBPath(LPCSTR dbPath)功能：設(shè)置指紋數(shù)據(jù)庫存儲位置參數(shù)：dbPath 要存儲數(shù)據(jù)庫的路徑;返回：成功返回 0 (RUN_SUCCESS)備注：要使用內(nèi)置指紋數(shù)據(jù)庫的其他相關(guān)方法，必須先調(diào)用此方法。2.4.15 DWORD FPMSetDataToDB(DWORD id, BYTE *r

15、egMin)功能：將登記的指紋特征值添加到內(nèi)置數(shù)據(jù)庫參數(shù)：id 用戶編號; regMin 登記的指紋特征值;返回：成功返回 0 (RUN_SUCCESS)備注：如果數(shù)據(jù)庫中已存在與該指紋特征值匹配的指紋，將返回失敗。數(shù)據(jù)庫中不允許出現(xiàn)串指的情況。此種情況下一般要求用戶換用另外的手指登記。2.4.16 DWORD FPMGetDataFromDB(DWORD id, BYTE *regMin)功能：從內(nèi)置數(shù)據(jù)庫中提取指紋特征值參數(shù)：id 要提取指紋特征值的用戶編號; regMin 返回的指紋特征值;返回：成功返回 0 (RUN_SUCCESS)備注： 2.4.17 DWORD FPMDelete

16、DataInDB(DWORD id)功能：從內(nèi)置數(shù)據(jù)庫中刪除指紋特征值數(shù)據(jù)參數(shù)：id 要?jiǎng)h除的用戶編號;返回：成功返回 0 (RUN_SUCCESS)備注： 2.4.18 DWORD FPMClearDB()功能：清空數(shù)據(jù)庫 參數(shù)：返回：成功返回 0 (RUN_SUCCESS)備注：2.4.19 DWORD FPMDBVerification(DWORD id, BYTE *inMin, DWORD secuLevel)功能：在內(nèi)置數(shù)據(jù)庫中驗(yàn)證指紋參數(shù)：id 要驗(yàn)證的用戶編號; inMin 要驗(yàn)證的用戶的指紋特征值； secuLevel 比對安全等級，建議 3 。返回：成功返回 0 (RUN_

17、SUCCESS)備注：2.4.20 DWORD FPMDBIdentify(DWORD *id, BYTE *inMin, DWORD secuLevel)功能：從內(nèi)置數(shù)據(jù)庫中識別指紋參數(shù)：id 返回匹配的用戶編號; inMin 要識別的用戶指紋特征值； secuLevel 比對安全等級，建議 3 。返回：成功返回 0 (RUN_SUCCESS)備注：該方法免除了用戶自己組織指紋特征值數(shù)組，是比較方便的應(yīng)用方式。三、通用指紋處理流程3.1 初始化及關(guān)閉流程應(yīng)用前初始化設(shè)備 FPMInit如果使用內(nèi)置數(shù)據(jù)庫方式，則需設(shè)置數(shù)據(jù)庫路徑 FPMSetDBPath結(jié)束程序時(shí)關(guān)閉設(shè)備 FPMExit3.2 登記指紋流程輸入用戶ID* 采集3次采集指紋圖象 FPMGetLiveImage提取指紋特征值 FPMGetMinutiae保存用戶ID和注冊的指紋特征值( 如果采用內(nèi)置數(shù)據(jù)庫方式，用FPMSetDataToDB )注冊指紋 FPMMatchForRegister 保存用戶ID和注冊的指紋特征值，既可以使用用戶自定義的存儲方式（如保存到二進(jìn)制文件或用戶自定義的數(shù)據(jù)庫），也可以使用本開發(fā)包提供的內(nèi)置數(shù)據(jù)庫存儲方法（參見2.4.14 2.4.20 部分）。3.2 1:1比對方式流程輸入用戶