FingerPrint API
API Overview
When the third party application to use these apis, it must creat its' store space to store the fingerpirnts. The apis 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 apis 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. |