~~NOTOC~~
[[fingerprint_api]] > [[BS2_GetFingerTemplateQuality]]

----

===== BS2_GetFingerTemplateQuality =====
[+ 2.6.4] Checks the quality score of the fingerprint from the fingerprint template data.\\
Validates fingerprint templates for Suprema, ANSI and ISO types, and measures and returns quality scores. \\
For unsupported or unrecognized formats, return an error. \\

<WRAP info>
**NOTE**\\
Should define template within 384 Bytes, \\
The score, out parameter is defined as below.\\
<WRAP group 50%>
^score ^Quality ^
|0 - 20 |Worst |
|21 - 40 |Bad |
|41 - 60 |Normal |
|61 - 80 |Good |
|81 - 100 |Best |
</WRAP>
</WRAP>
==== Declaration ====
<code cpp>
#include "BS_API.h"

int BS2_GetFingerTemplateQuality(const uint8_t* templateBuffer, const int32_t templateSize, int32_t* score);
</code>

==== Parameter ====
  * [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 ====
[[BS2_ScanFingerprint]]\\ [[BS2_ScanFingerprintEx]]\\ [[BS2_VerifyFingerprint]]\\ [[BS2_GetLastFingerprintImage]]