Face Detection and Recognition
==============================

.. doxygenfunction:: Trueface::SDK::detectFaces

The recall and precision of the face detection algorithm on the WIDER FACE dataset:

.. image:: ../../shared/images/face_detection_roc.png
   :width: 300pt

The effect of face height on similarity score:

.. image:: ../../shared/images/face_height_match_score_FULL_model.png
   :width: 300pt

.. image:: ../../shared/images/face_height_match_score_LITE_model.png
   :width: 300pt

.. doxygenfunction:: Trueface::SDK::detectLargestFace

.. doxygenfunction:: Trueface::SDK::getFaceLandmarks

The order of the face landmarks:

.. image:: ../../shared/images/landmarks.png
   :width: 300pt

.. doxygenfunction:: Trueface::SDK::extractAlignedFace

.. doxygenfunction:: Trueface::SDK::saveFaceImage

.. doxygenfunction:: Trueface::SDK::getFaceFeatureVector(const FaceBoxAndLandmarks &faceBoxAndLandmarks, Faceprint &faceprint)

.. doxygenfunction:: Trueface::SDK::getFaceFeatureVector(uint8_t *alignedFaceImage, Faceprint &faceprint)

.. doxygenfunction:: Trueface::SDK::getFaceFeatureVectors(std::vector<uint8_t*>&, std::vector<Faceprint>&)

.. doxygenfunction:: Trueface::SDK::getLargestFaceFeatureVector(Faceprint &faceprint, bool &foundFace)

.. doxygenfunction:: Trueface::SDK::faceprintToJson

.. doxygenfunction:: Trueface::SDK::jsonToFaceprint

.. doxygenfunction:: Trueface::SDK::getSimilarity

.. doxygenfunction:: Trueface::SDK::estimateFaceImageQuality

.. doxygenfunction:: Trueface::SDK::estimateHeadOrientation

The accuracy of this method is estimated using 1920x1080 pixel test images. A test image:

.. image:: ../../shared/images/yaw_positive_20.jpg
   :width: 300pt

The accuracy of the head orientation estimation:

.. image:: ../../shared/images/yaw_estimation_accuracy.png
   :width: 300pt

The effect of the face yaw angle on match similarity can be seen in the following figure:

.. image:: ../../shared/images/yaw_vs_sim_score.png
   :width: 300pt

The effect of the face pitch angle on match similarity can be seen in the following figure:

.. image:: ../../shared/images/pitch_vs_sim_score.png
   :width: 300pt

.. doxygenstruct:: Trueface::FaceBoxAndLandmarks
   :members:

.. doxygenstruct:: Trueface::Faceprint
   :members:

.. doxygenstruct:: Trueface::ModelOptions
   :members:

.. doxygenstruct:: Trueface::Point
   :members: