Fingerprint API > BS2_GetFingerTemplateQuality

[+ 2.6.3] Checks the quality score of the fingerprint from the fingerprint template data.
Validates and measures and returns quality scores for Suprema template only.
For unsupported or unrecognized formats, return an error.

Should define template within 384 Bytes,
The score, out parameter is defined as below.

score Quality
0 - 20 Worst
21 - 40 Bad
41 - 60 Normal
61 - 80 Good
81 - 100 Best


#include "BS_API.h"
int BS2_GetFingerTemplateQuality(const uint8_t* templateBuffer, const int32_t templateSize, int32_t* score);


  • [In] templateBuffer : The address of template data within 384 bytes
  • [In] templateSize : Size of real template
  • [Out] score : Address of memory where template quality score is to be returned

Return Value

If successfully done, BS_SDK_SUCCESS will be returned.
BS_SDK_ERROR_UNKNOWN_FINGER_TEMPLATE is returned if an unsupported or unusual template is passed.
If NULL is returned for score or templateBuffer, BS_SDK_ERROR_NULL_POINTER is returned.
If templateSize is less than 0 or exceeds 384, BS_SDK_ERROR_INVALID_PARAM is returned.

See Also