biokeysdk程序開發手冊(編輯修改稿)

　

【文章內容簡介】 ader平面圖像Fingerprint ImageBiokey SDK 開發手冊53. 軟件安裝 光盤文件及目錄打開 Biokey SDK 光盤，目錄和文件信息如下圖所示： 4000driver：指紋采集器驅動和加密狗驅動的安裝程序；SDK：指紋采集器開發包；打開 SDK 目錄，目錄和文件信息如下圖所示：Samples：多種開發語言的例程；：指紋識別算法核心控件庫文件。Biokey SDK 開發手冊6：SDK 說明手冊； 軟件的安裝在安裝 Biokey SDK 之前，請確定您的操作系統和計算機的配置符合軟件運行的要求。在進行安裝之前，如果您的計算機接上了指紋采集器，最好將它拔下來。如果您的計算機已經安裝過 URU 驅動程序，請首先卸載。Windows98 系統下詳細的卸載步驟如下：a：運行控制面板中的‘添加/刪除’程序，卸載指紋采集設備的驅動程序；b：在開始菜單中的‘運行’中運行注冊表，將HKEY_LOCAL_MACHINE\Software\DigitalPersona 鍵值刪除； c：將 Windows\system 目錄下的 DP*.dll 全部刪除；d：將 Program files\DigitalPersona 目錄整個刪除。將安裝光盤放入計算機的光驅之中，安裝軟件將自動運行。彈出窗口如下圖所示：Biokey SDK 開發手冊7 點擊下一步按鈕，可以進入如下操作步驟： Biokey SDK 開發手冊8點下一步可以完成安裝指紋儀驅動。拷貝光盤 SDK 目錄下面文件到 用戶指定目錄，建議拷貝到c:\windows\system32 系統目錄。 控件庫文件注冊控件 ：c:\windows\system32\ c:\windows\system32\注意：Biokey SDK 開發手冊9裝程序安裝的只是指紋采集器的驅動程序，其它開發所需的文件需要用戶手動拷貝至相應的目錄下Biokey SDK 開發手冊10ActiveX 控件參考Biokey SDK 同時具備 1:1 和 1:N 兩種功能，以下都采用 VB 語法說明，其中指紋模板 Variant 變量代表一維字節數組。 屬性 Active as BooleanRead only當前 SensorIndex 設定的指紋采集器是否準備就緒。 EngineValid as BooleanRead only指紋識別系統是否正常工作。調用過函數 initEngine 后會返回有效結果 EnrollIndex As LongRead only登記指紋時取樣的序號，即表示當前手指登記已經取到的有效次數。 EnrollCount As Long登記指紋時取樣的次數，取值范圍為 14 次Biokey SDK 開發手冊11 FPEngineVersion AS Stringread only指紋識別系統版本號 ImageHeight AS integerRead only指紋圖像的高度 ImageWidth AS integerRead only指紋圖像的寬度 IsRegister As BooleanRead only是否正登記指紋 OneToOneThreshold As Boolean設定 Biokey 低速指紋 1：1 比對的識別閥值分數(1100) ，默認為 10，值越大，誤判率越低同時拒絕率變大 RegTplFileName As String設置當事件 OnEnrollToFile 發生時，保存指紋登記模版的文件名稱。Biokey SDK 開發手冊12 SensorCount As LongRead only當前連接到計算記得指紋采集器的個數，當 EngineValid 無效時，返回0 SensorIndex AS Long連接多個指紋采集器時，選擇指紋頭的序號，從 0 開始；小于零時指紋采集器不工作。 SensorSN As String指紋采集器的硬件序列號 TemplateLen As LongRead only指紋登記模版的字節長度。該屬性為兼容舊版本保留，該版本放棄使用，在程序設計時按照如下規定分配變量即可，當用 Base64 格式字符串方式操作指紋模版時不用考慮如下長度：系統缺省模板最大長度為 1152 字節，當 UsingXTFTemplate 為 True 時，最大模版長度為 2288 字節。 Threshold As Long設定指紋識別系統比對識別閥值分數(1100)，默認為 10，值越大，誤判率越低同時拒絕率變大Biokey SDK 開發手冊13 VerTplFileName As String設置當事件 OnCaptureToFile 發生時，保存指紋驗證模版的文件名稱。 方法 Sub BeginEnroll()開始登記指紋，登記結束后發生 OnEnroll 事件。 Sub CancelEnroll()取消當前的指紋登記狀態，即由 BeginEnroll 開始的操作可由此函數中斷。 Function DongleIsExist As Boolean檢查加密狗是否存在* 版本中已取消此函數的功能，為了兼容，暫保留了此函數。 Function DongleSeed(Byval lp2 As Long, Byval p1, p2, p3, p4 As Integer) As Boolean得到種子碼 lp2 的四個 16 位整數 (p1,p2,p3,p4)返回值，加密狗可以通過內部算法計算一個種子碼，得到四個返回碼。種子碼算法是不公開的，可以通過檢查返回碼是否是期望的值來檢查加密狗是否存在。* 版本中已取消此函數的功能，為了兼容，暫保留了此函數 Function DongleUserID As Long讀出加密狗中的用戶 ID，用戶 ID 不會重復相同。保存在加密狗內部特定位置。Biokey SDK 開發手冊14* 版本中已取消此函數的功能，為了兼容，暫保留了此函數 Function DongleMemRead(Byval p1, p2 As Integer, buf) As Boolean讀出加密狗內存區位置 p1 開始的 p2 個字節到 Variant 變量 buf(一維字節數組) 。內存區共有 24 個字節，位置為 023* 版本中已取消此函數的功能，為了兼容，暫保留了此函數 Function DongleMemWrite(Byval p1, p2 As Integer, buf) As Boolean寫入 Variant 變量 buf(一維字節數組) 到加密狗內存區位置 p1 開始的 p2個字節內。內存區共有 24 個字節，位置為 023* 版本中已取消此函數的功能，為了兼容，暫保留了此函數 Function GetTemplate()得到最近一次獲得的指紋模板。 Function GetFingerImage(Byval AFingerImage) As Boolean得到最近一次獲得的指紋圖像(BMP 格式) 。 Function InitEngine() As Long初始化指紋識別系統。SensorCount、SensorSN 、EngineValid、ImageHeight 、ImageWidth 等屬性需在該函數被調用后才能返回正確結果。返回值:0 初始化成功1 指紋識別驅動程序加載失敗2 沒有連接指紋識別儀3 屬性 SensorIndex 指定的指紋儀不存在（注意：在調用之前設置屬性SensorIndex）可以使用方法 EndEngine 釋放指紋設備系統Biokey SDK 開發手冊15 Function VerFinger(byval regTemplate, verTemplate, AdoLearning As Boolean, byval AregFeatureChanged As Boolean) As Boolean比對兩枚指紋的特征模版是否匹配。其中 regTemplate 表示指紋登記特征模版，verTemplate 表示現場采集的指紋驗證特征模版， AdoLearning 表示是否進行指紋特征模版學習更新。AregFeatureChanged 表示登記模版regTemplate 是否改變，兩枚指紋匹配時返回 True，不匹配時返回 False說明： 手指特征隨時間可能會發生一定程度的變化，通常不會影響指紋的比對，但通過進行指紋特征模版學習更新，系統會綜合得到新的模版，從而可以降低拒絕率。 Function VerFingerFromFile(regTemplateFile As String, verTemplateFile As String, AdoLearning As Boolean, byval AregFeatureChanged As Boolean) As Boolean比對兩枚指紋的特征模版文件是否匹配。其中 regTemplateFile 表示指紋登記特征模版文件，verTemplateFile 表示現場采集的指紋驗證特征模版文件，AdoLearning 表示是否進行指紋特征模版學習更新。AregFeatureChanged 表示登記模版文件 regTemplateFile 是否改變。兩枚指紋匹配時返回 True，不匹配時返回 False Function VerRegFingerFile(RegTemplateFile As String, verTemplate, AdoLearning As Boolean, byval AregFeatureChanged As Boolean) As Boolean比對兩枚指紋的特征模版是否匹配。其中 regTemplate 表示由 FileName 指定文件中的以前登記指紋特征模版，verTemplate 表示現場采集的指紋的特征模版，AdoLearning 表示是否進行指紋特征模版學習更新。AregFeatureChanged 表示登記模版文件 regTemplateFile 是否改變。兩枚指紋匹配時返回 True，不匹配時返回 False Sub PrintImageAt(HDC As OLE_HANDLE, X As Long, Y As Long, Biokey SDK 開發手冊16aWidth As Long, aHeight As Long)在由（x,y）指定的位置上按照（aWidth, aHeight）指定的大小顯示指紋圖像，HDC 表示要顯示指紋的窗口的設備描述表句柄 Sub PrintImageEllipseAt(HDC As OLE_HANDLE, X As Long, Y As Long, aWidth As Long, aHeight As Long, bkColor As OLE_COLOR)在由（x,y）指定的位置上按照（aWidth, aHeight）指定的大小顯示指紋圖像，HDC 表示要顯示指紋的窗口的設備描述表句柄。這里的指紋圖像被一橢圓形包圍。 Sub SaveBitmap(FileName As String)保存最后一次采集到的指紋的圖像到 FileName 指定的位圖文件中。 Sub SaveJPG(FileName As String)保存最后一次采集到的指紋的圖像到 FileName 指定的 Jpeg 文件中。 Function SaveTemplate(FileName As String, Template) As Boolean保存 Template 指紋的特征模版到 FileName 指定的文件中。 function EncodeTemplate(ASour, var ADest As String) As Boolean將控件使用的 Variant 模板 ASour 轉換為 BASE64 格式的模板字符串ADest。 function DecodeTemplate(const ASour As String, ADest) As Boolean將 BASE64 格式的模板字符串 ASour 轉換為控件使用的 Variant 類型ADset 模板。 以上兩個方法主要用于模板的數據庫保存，Variant 類型模板是以二進制格式數組方式存放，在 PB, VB 等語言中操作比較困難，方法Biokey SDK 開發手冊17EncodeTemplate 可以將 Variant 類型編碼轉換為字符串類型，方法DecodeTemplate 可以將字符串類型編碼轉換為 Variant 類型，需要注意的是，模板變量 BASE64 編碼為字符串后，模板長度將變長。 function EncodeTemplate1(ASour) As String將控件使用的 Variant 模板 ASour 轉換為 BASE64 格式的模板字符串。參考 EncodeTemplate，主要方便 PB, VC 中調用 function DecodeTemplate1(const ASour As String) As Variant將 BASE64 格式的模板字符串 ASour 轉換為控件使用的 Variant 類型模板。參考 DecodeTemplate，主要方便 PB, VC 中調用 Sub BeginCapture()設置當前指紋