General

Before you can call the SDK functions, you must first initialize the SDK with your desired configuration options. These configuration options will ultimately impact the behaviour of the SDK, so be sure to read through what each one does carefully.

Once you have initialized the SDK, then proceed to the the License section.

Trueface::SDK::SDK()

Initialize the SDK using default configuration options.

See

ConfigurationOptions

Trueface::SDK::SDK(const ConfigurationOptions &options)

Initialize the SDK using custom configuration options.

Parameters

• options: custom configuration options.

std::string Trueface::SDK::getVersion()

Gets the version-build number of the SDK.

Return

Version Number as a std::string.

enum Trueface::FacialRecognitionModel

Facial recognition models

Values:

enumerator LITE

Lightweight model with faster inference time and reduced length, ideal for embedded systems or CPU only deployments, and for 1 to 1 matching use cases.

enumerator FULL

Full model with improved accuracy. Ideal for GPU deployments, and for 1 to N use cases.

enum Trueface::ObjectDetectionModel

Object detection models

Values:

enumerator ACCURATE

enumerator FAST

enum Trueface::FaceDetectionMode

Face detection modes

Values:

enumerator ROBUST

The ROBUST mode is optimized for face recognition, smallestFaceHeight less than 80 pixels will be overridden.

enumerator VERSATILE

The VERSATILE mode can detect small faces (as small as 16x16 pixel) and can be faster than the ROBUST mode.

enum Trueface::FaceDetectionFilter

Face detection filter

Values:

enumerator HIGH_RECALL

The detected face scores are thresholded to have a low precision and a high recall rate.

enumerator HIGH_PRECISION

The detected face scores are thresholded to have a high precision and a low recall rate.

enumerator BALANCED

The detected face scores are thresholded to have a medium precision and recall rate.

enumerator UNFILTERED

The detected face scores are not thresholded.

enum Trueface::DatabaseManagementSystem

Database Management System for storing Faceprints

Values:

enumerator SQLITE

Use sqlite backend. Write Faceprints to local disk. Ideal for embedded systems or use cases where only one process connects to the database.

enumerator POSTGRESQL

Use a PostgreSQL backend. Ideal for distributed systems requiring synchronization. Not available in Windows SDK.

enumerator NONE

Do not write Faceprints to disk, only store in ram. Warning, enrolled Faceprints will not be saved after the program terminates

struct Trueface::ConfigurationOptions

SDK configuration options

Public Members

FacialRecognitionModel frModel = FacialRecognitionModel::LITE

The model to be used for facial recognition (default is LITE model)

ObjectDetectionModel objModel = ObjectDetectionModel::ACCURATE

The model to be used for object detection (default is ACCURATE model)

int smallestFaceHeight = 40

The smallest face height that the face detector can detect. (default is 40 pixels, min value is 16 pixels). The face detector has a detection scale range of about 5 octaves. Ex. 40 pixels yields the detection scale range of ~40 pixels to 1280 (=40x2^5) pixels. If set to -1, will dynamically adjusts the face detection scale range from image-height/32 to image-height to ensure that large faces are detected in high resolution images.

FaceDetectionMode fdMode = FaceDetectionMode::VERSATILE

The face detection mode (default is VERSATILE)

FaceDetectionFilter fdFilter = FaceDetectionFilter::BALANCED

The face detection precision-recall mode (default is BALANCED)

DatabaseManagementSystem dbms = DatabaseManagementSystem::SQLITE

Database management system for storing Faceprints (default is SQLITE)

std::string modelsPath = "./"

The directory path containing the model files

bool frVectorCompression = false

Improves the computation speed for 1 to 1 comparisons and 1 to N searches by compressing the feature vector and enabling additional optimizations.

bool enableGPU = false

Enable GPU support (default is false). Note, GPU support requires a different version of the SDK.

unsigned int deviceIndex = 0

GPU device index

enum Trueface::ErrorCode

Error codes returned by methods

Values:

enumerator NO_ERROR

enumerator INVALID_LICENSE

enumerator FILE_READ_FAIL

enumerator UNSUPPORTED_IMAGE_FORMAT

enumerator UNSUPPORTED_MODEL

enumerator NO_FACE_IN_FRAME

enumerator FAILED

enumerator COLLECTION_CREATION_ERROR

enumerator DATABASE_CONNECTION_ERROR

enumerator ENROLLMENT_ERROR

enumerator MAX_COLLECTION_SIZE_EXCEEDED

enumerator NO_RECORD_FOUND