FingerPrint API

API Overview

When the third party application to use these API, it must create its' store space to store the fingerpirnt. The API are some utility methods.

open

int fp_open()

Open the fingerprint.

Returns
int	The result code, >= 0, success; <0 error code.

close

int fp_close()

Close the fingerprint device. The open and close API are pair operations. If you don’t want to use this device, you should call the close API to release this device.

Returns
int	The result code, >= 0, success; <0 error code.

get_fea

int fp_get_fea(unsigned char *pFeaBuffer, int nFeaLength, int *pRealFeaLength, int n_TimeOut_S)

Get the feature of fingerprint. When the finger touch the fingerprint device, the feature of the fingerprint will be return.

Parameters
pFeaBuffer	char *: The buffer to store the feature, not null
nFeaLength	int: The length of the buffer
pRealFeaLength	int *: Reture the real length of the buffer
nTimeOut_S	int: Timeout, unit of time:s

Returns
int	The result code, >= 0, success; <0 error code.

getLastImage

int fp_getLastImage(unsigned char *pImgBuffer,int nImgLength, int *pRealImaLength, int *pImgWidth, int *pImgHeight)

Get the image of fingerprint. When the finger touch the fingerprint device, the image of the fingerprint will be return.

Parameters
pImgBuffer	char *: The image buffer
nImgLength	int: The length of image buffer
pRealImaLength	int *: The real length of the image buffer
pImgWidth	int *: The width of the image
pImgHeight	int *: The height of the image

Returns
int	The result code, >= 0, success; <0 error code.

match

int fp_match(unsigned char *pFeaBuffer1, int nFea1Length, unsigned char *pFealBuffer2, int nFea2Length)

Match the fingerprint. Input the two feature of the fingerprint, it will get the result of match .

Parameters
pFeaBuffer1	char *: The feature of the old fingerprint
nFea1Length	int: The length of the feature
pFeaBuffer2	char *: The feature of the new fingerprint
nFea2Lenghth	int: The length of the feature

Returns
int	The result code, >= 0, success, the percent of matched similarity; <0 error code.

cancel

int fp_cancel ()

Cancel the fingerprint device operation.

Returns
int	The result code, >= 0, success; <0 error code.