ZKFinger SDK 包括指纹采集库和指纹算法库。指纹采集库从指纹采集器中采集图像， 文件名为ZKFPCap.dll。指纹算法库从指纹图像中提取指纹模板。ZKFinger10.0 算法(ZKFinger10.dll)。如果用户有自己的指纹算法库只需通过指纹采集库采集指纹图像即可。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.Threading;
using System.Runtime.InteropServices;
using System.IO;
namespace Sample
{
public partial class MainFrm : Form
{
bool gConnected = false;
byte[] g_FPBuffer;
int g_FPBufferSize = 0;
bool g_bIsTimeToDie = false;
IntPtr g_Handle = IntPtr.Zero;
IntPtr g_biokeyHandle = IntPtr.Zero;
IntPtr g_FormHandle = IntPtr.Zero;
int g_nWidth = 0;
int g_nHeight = 0;
bool g_IsRegister = false;
int g_RegisterTimeCount = 0;
int g_RegisterCount = 0;
const int REGISTER_FINGER_COUNT = 3;
byte[][] g_RegTmps = new byte[3][];
byte[] g_RegTmp = new byte[2048];
byte[] g_VerTmp = new byte[2048];
const int MESSAGE_FP_RECEIVED = 0x0400 + 6;
[DllImport("user32.dll", EntryPoint = "SendMessageA")]
public static extern int SendMessage(IntPtr hwnd, int wMsg, IntPtr wParam, IntPtr lParam);
public MainFrm()
{
InitializeComponent();
}
private void btnConnect_Click(object sender, EventArgs e)
{
if(!gConnected)
{
int ret = 0;
byte[] paramValue = new byte[64];
// Enable log
Array.Clear(paramValue, 0, paramValue.Length);
paramValue[0] = 1;
ZKFPCap.sensorSetParameterEx(g_Handle, 1100, paramValue, 4);
ret = ZKFPCap.sensorInit();
if(ret != 0)
{
MessageBox.Show("初始化失败, ret=" + ret.ToString());
return;
}
g_Handle = ZKFPCap.sensorOpen(0);
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetVersion(paramValue, paramValue.Length);
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 1, paramValue, ref ret);
g_nWidth = BitConverter.ToInt32(paramValue, 0);
this.picFP.Width = g_nWidth;
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 2, paramValue, ref ret);
g_nHeight = BitConverter.ToInt32(paramValue, 0);
this.picFP.Height = g_nHeight;
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 106, paramValue, ref ret);
g_FPBufferSize = BitConverter.ToInt32(paramValue, 0);
g_FPBuffer = new byte[g_FPBufferSize];
Array.Clear(g_FPBuffer, 0, g_FPBuffer.Length);
// get vid&pid
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 1015, paramValue, ref ret);
int nVid = BitConverter.ToInt16(paramValue, 0);
int nPid = BitConverter.ToInt16(paramValue, 2);
// Manufacturer
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 1101, paramValue, ref ret);
string manufacturer = System.Text.Encoding.ASCII.GetString(paramValue);
// Product
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 1102, paramValue, ref ret);
string product = System.Text.Encoding.ASCII.GetString(paramValue);
// SerialNumber
ret = paramValue.Length;
Array.Clear(paramValue, 0, paramValue.Length);
ZKFPCap.sensorGetParameterEx(g_Handle, 1103, paramValue, ref ret);
string serialNumber = System.Text.Encoding.ASCII.GetString(paramValue);
// Fingerprint Alg
short[] iSize = new short[24];
iSize[0] = (short)g_nWidth;
iSize[1] = (short)g_nHeight;
iSize[20] = (short)g_nWidth;
iSize[21] = (short)g_nHeight; ;
g_biokeyHandle = ZKFinger10.BIOKEY_INIT(0, iSize, null, null, 0);
if (g_biokeyHandle == IntPtr.Zero)
{
MessageBox.Show("BIOKEY_INIT failed");
return;
}
// Set allow 360 angle of Press Finger
ZKFinger10.BIOKEY_SET_PARAMETER(g_biokeyHandle, 4, 180);
// Set Matching threshold
ZKFinger10.BIOKEY_MATCHINGPARAM(g_biokeyHandle, 0, ZKFinger10.THRESHOLD_MIDDLE);
// Init RegTmps
for (int i = 0; i < 3; i++)
{
g_RegTmps[i] = new byte[2048];
}
Thread captureThread = new Thread(new ThreadStart(DoCapture));
captureThread.IsBackground = true;
captureThread.Start();
g_bIsTimeToDie = false;
gConnected = true;
btnRegister.Enabled = true;
btnVerify.Enabled = true;
btnConnect.Text = "断开传感器";
txtPrompt.Text = "请把你的手指在传感器";
}
else
{
FreeSensor();
ZKFinger10.BIOKEY_DB_CLEAR(g_biokeyHandle);
ZKFinger10.BIOKEY_CLOSE(g_biokeyHandle);
gConnected = false;
btnRegister.Enabled = false;
btnVerify.Enabled = false;
btnConnect.Text = "连接传感器";
}
}
private void FreeSensor()
{
g_bIsTimeToDie = true;
Thread.Sleep(1000);
ZKFPCap.sensorClose(g_Handle);
// Disable log
byte[] paramValue = new byte[4];
paramValue[0] = 0;
ZKFPCap.sensorSetParameterEx(g_Handle, 1100, paramValue, 4);
ZKFPCap.sensorFree();
}
private void DoCapture()
{
while (!g_bIsTimeToDie)
{
int ret = ZKFPCap.sensorCapture(g_Handle, g_FPBuffer, g_FPBufferSize);
if (ret > 0)
{
SendMessage(g_FormHandle, MESSAGE_FP_RECEIVED, IntPtr.Zero, IntPtr.Zero);
}
}
}
protected override void DefWndProc(ref Message m)
{
switch (m.Msg)
{
case MESSAGE_FP_RECEIVED:
{
try
{
MemoryStream ms = new MemoryStream();
BitmapFormat.GetBitmap(g_FPBuffer, g_nWidth, g_nHeight, ref ms);
Bitmap bmp = new Bitmap(ms);
this.picFP.Image = bmp;
txtStatus.Text = "图片准备好了";
int ret = 0;
int id = 0;
int score = 0;
int quality = 0;
if (g_IsRegister)
{
Array.Clear(g_RegTmp, 0, g_RegTmp.Length);
ret = ZKFinger10.BIOKEY_EXTRACT(g_biokeyHandle, g_FPBuffer, g_RegTmp, 0);
if (ret > 0)
{
Array.Copy(g_RegTmp, g_RegTmps[g_RegisterTimeCount++], ret);
// Get fingerprint quality
quality = ZKFinger10.BIOKEY_GETLASTQUALITY();
txtQuality.Text = quality.ToString();
txtPrompt.Text = string.Format("请在按手指 {0} 次", REGISTER_FINGER_COUNT - g_RegisterTimeCount);
if (g_RegisterTimeCount == REGISTER_FINGER_COUNT)
{
Array.Clear(g_RegTmp, 0, g_RegTmp.Length);
int size = 0;
/*unsafe
{
fixed (byte* Template1 = g_RegTmps[0])
{
fixed (byte* Template2 = g_RegTmps[1])
{
fixed (byte* Template3 = g_RegTmps[2])
{
byte*[] pTemplate = new byte*[3] { Template1, Template2, Template3 };
size = ZKFinger10.BIOKEY_GENTEMPLATE(g_biokeyHandle, pTemplate, 3, g_RegTmp);
}
}
}
}*/
size = ZKFinger10.BIOKEY_GENTEMPLATE_SP(g_biokeyHandle, g_RegTmps[0], g_RegTmps[1], g_RegTmps[2], 3, g_RegTmp);
if (size > 0)
{
ZKFinger10.BIOKEY_DB_ADD(g_biokeyHandle, ++g_RegisterCount, size, g_RegTmp);
txtPrompt.Text = string.Format("注册成功, fid={0}, totalCount={1}", g_RegisterCount, ZKFinger10.BIOKEY_DB_COUNT(g_biokeyHandle));
textBox1.Text = BitConverter.ToString(g_RegTmp).Replace("-", string.Empty);
g_IsRegister = false;
}
else
{
txtPrompt.Text = "注册失败";
}
g_RegisterTimeCount = 0;
}
}
else
{
txtPrompt.Text = "抽取模板失败1";
}
}
else
{
int size = 0;
size = ZKFinger10.BIOKEY_GENTEMPLATE_SP(g_biokeyHandle, HexToByte(textBox1.Text.Trim()), HexToByte(textBox1.Text.Trim()), HexToByte(textBox1.Text.Trim()), 3, HexToByte(textBox1.Text.Trim()));
ZKFinger10.BIOKEY_DB_ADD(g_biokeyHandle, 1, size, g_RegTmp);
Array.Clear(g_VerTmp, 0, g_VerTmp.Length);
if ((ret = ZKFinger10.BIOKEY_EXTRACT(g_biokeyHandle, g_FPBuffer, g_VerTmp, 0)) > 0)
{
// Get fingerprint quality
quality = ZKFinger10.BIOKEY_GETLASTQUALITY();
txtQuality.Text = quality.ToString();
//ret = ZKFinger10.BIOKEY_IDENTIFYTEMP(g_biokeyHandle, HexToByte(textBox1.Text.Trim()), ref id, ref score);
ret = ZKFinger10.BIOKEY_IDENTIFYTEMP(g_biokeyHandle, g_VerTmp, ref id, ref score);
if (ret > 0)
{
txtPrompt.Text = string.Format("识别成功, id={0}, score={1}", id, score);
}
else
{
txtPrompt.Text = string.Format("识别失败, score={0}", score);
}
}
else
{
txtPrompt.Text = "抽取模板失败2";
}
}
}
catch (Exception ex)
{
MessageBox.Show(ex.Message.ToString());
}
}
break;
default:
base.DefWndProc(ref m);
break;
}
}
private void MainFrm_Load(object sender, EventArgs e)
{
g_FormHandle = this.Handle;
}
private void btnRegister_Click(object sender, EventArgs e)
{
txtPrompt.Text = "指纹登记，请按手指3次";
g_RegisterTimeCount = 0;
g_IsRegister = true;
}
private void btnVerify_Click(object sender, EventArgs e)
{
txtPrompt.Text = "请把你的手指在传感器";
g_IsRegister = false;
}
#region byte[]转16进制格式string：
private static byte[] HexToByte(string hexString)
{
byte[] returnBytes = new byte[hexString.Length / 2];
for (int i = 0; i < returnBytes.Length; i++)
returnBytes[i] = Convert.ToByte(hexString.Substring(i * 2, 2), 16);
return returnBytes;
}
#endregion
}
}