Luxand FaceSDK provides the API to extract face templates and match them. A template extracted from a face can be stored in a database and can then be used to match faces using the FSDK_MatchFaces function.

The FSDK_MatchFaces function returns the facial similarity level. You may consider similarity to be equal to the probability that templates belong to one and same person.

More precisely: if the access control system provides access to a person when similarity is higher of threshold х, the possibility of providing erroneous access to another person is 1-х. For example, if the decision to provide access to a person is based on the code

the possibility of erroneous access to another person is 0.01, or 1%.

A facial template is non-reversible, i.e. there is no way to create the original face image using a template. To determine if the matched templates belong to the same person (with a specified error possibility), you can compare the facial similarity value with a threshold calculated by the FSDK_GetMatchingThresholdAtFAR or FSDK_GetMatchingThresholdAtFRR functions.

Please note: it is also recommended to retain the original face images and their templates in the database. This is because future versions of Luxand FaceSDK may offer an improved template extraction algorithm, together with changes to the template format.

A face template is stored in the FSDK_FaceTemplate data structure.

In .NET, there is no specific data type for a template. Instead, it is stored in an array of bytes of FSDK.TemplateSize length. Below is an example of retrieving facial template in C#.

C# Example:

C++ Declaration:

typedef struct {
    char ftemplate [16384];
} FSDK_FaceTemplate;

Delphi Declaration:

FSDK_FaceTemplate = record
    Template: array[0.. 16384-1] of byte;
end;
PFSDK_FaceTemplate = ^FSDK_FaceTemplate;

Java Declaration:

The class FSDK_FaceTemplate has the following property:

FSDK_FaceTemplate = record
    public byte template[];

FSDK_GetFaceTemplate Function

This function is used to extract a template from a facial image. The function first detects a face, then detects its eye centers and extracts the template. If there is more than one face in the image, the template is extracted for the face with the most clearly visible details. If there is no clearly visible face, the function returns an error code. To set the threshold determining the accepted quality for faces, use the FSDK_SetFaceDetectionThreshold function.

If the face position or its features or eye centers are known, it is more efficient to use the FSDK_GetFaceTemplateInRegion or FSDK_GetFaceTemplateUsingEyes functions. To extract the template for a specific face, use the FSDK_GetFaceTemplateInRegion function.

C++ Syntax:

Delphi Syntax:

C# Syntax:

VB Syntax:

Java Syntax:

CImage Syntax:

Parameters:

Image– handle of the image from which to extract the face template.

FaceTemplate – pointer to the FSDK_FaceTemplate structure, used to receive the face template.

Return Value:

Returns FSDKE_OK if successful. If no faces are found, or the quality of the image is not sufficient, the function returns the FSDKE_FACE_NOT_FOUND code.

FSDK_GetFaceTemplateInRegion Function

Extracts a template for a face located in a specific region returned by FSDK_DetectFace or FSDK_DetectMultipleFaces.

The function detects eye centers in a specific region and extracts a template. The face detection stage is not performed. This function can be useful if an approximate face size and position is known, or to process a specific face returned by FSDK_DetectMultipleFaces. The function produces no error if the face is not clearly visible. This is because it assumes that if face detection functions return a detected face position, the face is of sufficient quality.

If facial features or eye centers are known, it is more efficient to use FSDK_GetFaceTemplateUsingEyes function.

C++ Syntax:

Delphi Syntax:

C# Syntax:

VB Syntax:

Java Syntax:

CImage Syntax:

Parameters:

Image– handle of the image from which to extract the face template.

FacePosition– pointer to the face position structure.

FaceTemplate – pointer to the FSDK_FaceTemplate structure, used to receive the face template.

Return Value:

Returns FSDKE_OK if successful.

FSDK_GetFaceTemplateUsingEyes Function

Extracts a face template using the detected eye centers.

The function receives eye centers coordinates detected by the FSDK_DetectFacialFeatures, FSDK_DetectFacialFeaturesInRegion, FSDK_DetectEyes or FSDK_DetectEyesInRegion functions and extracts a face template. Face detection, facial feature detection, or eye centers detection stage is not performed. This function can be useful when facial features or eye centers for a specific face are already detected. The function produces no error if the face is not clearly visible, since it assumes that if the face and its facial features or eye centers are already detected, the face is of sufficient quality.

C++ Syntax:

Delphi Syntax:

C# Syntax:

VB Syntax:

Java Syntax:

CImage Syntax:

Parameters:

Image– handle of the image to extract the face template from.

eyeCoords– pointer to the FSDK_Features array containing eye centers coordinates.

FaceTemplate – pointer to the FSDK_FaceTemplate structure for receiving the face template.

Return Value:

Returns FSDKE_OK if successful.

FSDK_MatchFaces Function

Match two face templates. The returned value determines the similarity of the faces.

C++ Syntax:

Delphi Syntax:

C# Syntax:

VB Syntax:

Java Syntax:

Parameters:

FaceTemplate1 – pointer to the FSDK_FaceTemplate structure, using the first template for comparison.

FaceTemplate2 – pointer to the FSDK_FaceTemplate structure, using the second template for comparison.

Similarity – pointer to an integer value, used to receive the similarity of the face templates.

Return Value:

Returns FSDKE_OK if successful.

FSDK_GetMatchingThresholdAtFAR Function

This function returns the threshold value for similarity to determine if two matched templates belong to the same person at a given FAR (False Acceptance Rate) value. The FAR determines the acceptable error rate when two different people’s templates are mistakenly recognized as the same person. Decreasing FAR leads to an increase in FRR – i.e. with low FAR it becomes more probable that two templates from the same person will be determined as belonging to different people.

C++ Syntax: