Code Layout

• ./lib
  • local - the actual meat of the code where the relevant computer vision algorithms reside
    • CppInterop - wrappers around C++ code for C# bindings
    • LandmarkDetector - The CE-CLM, CLNF, and CLM algorithms together with face tracking code
    • FaceAnalyser - Facial Action Unit detection and some useful code for extracting features for facial analysis
    • GazeAnalyser - Code for extracting eye gaze
    • Utilities - Utility code for image and video reading, result recording, result visualization, and rotation and image manipulation
  • 3rdParty - place for 3rd party libraries
    • CameraEnumerator - useful utility for listing and naming connected webcams
    • OpenCV3.4 - prepackaged OpenCV 3.4 library that is used extensively internally to provide support for basic computer vision functionallity
    • dlib - a header only dlib library (includes the face detector used for in-the-wild images)
    • OpenBLAS - prepackaged OpenBLAS code for fast matrix multiplication
• ./exe - the runner and executables that show how to use the libraries for facial expression and head pose tracking, these best demonstrate how to use the libraries
  • FeatureExtraction - main workhorse executable for sequences - extracting all supported features from faces: landmarks, AUs, head pose, gaze, similarity normalised faces and HOG features
  • FaceLandmarkImg - main workhorse executable for images - extracting all supported features from faces: landmarks, AUs, head pose, gaze, similarity normalised faces and HOG features
  • FaceLandmarkVid - running single person landmark detection and gaze extraction on videos on disk or from a webcam
  • FaceLandmarkVidMulti - tracking multiple faces in sequences and extracting their features (from a webcam, video file or an image sequene)
  • releases - scripts for packaging the Windows binaries into a release
• ./gui - the Windows GUI executables
  • HeadPose-live - tracking and recording head pose, very specialist use
  • OpenFaceDemo - nice visualization of OpenFace results from a webcam
  • OpenFaceOffline - GUI for processing videos, image sequences, collections of images and webcam feeds, same functionallity as that of FeatureExtraction
• ./matlab_runners helper scripts for running the experiments and demos, see ./matlab_runners/readme.txt for more info
• ./matlab_version A Matlab version of parts of OpenFace together with some training code, more details in ./matlab_version/readme.txt
• ./Release The created directory after compilation containing the desired executables for x86 architectures
• ./x64/Release The created directory after compilation containing the desired executables for x64 architectures