Skip to content

ofirbb/find_face_landmarks

 
 

Repository files navigation

find_face_landmarks

Created by Yuval Nirkin.

nirkin.com

Overview

This library provides video\image sequence functionality for finding face landmarks and bounding boxes.

alt text

Main features:

  • Matlab interface.
  • Saving and loading per sequence.
  • Face tracking across frames in a sequence.
  • Face statistics for finding the most dominant face.

This library is released as part of the face frontalization project: http://www.openu.ac.il/home/hassner/projects/frontalize

Dependencies

Library Minimum Version Notes
Boost 1.47
OpenCV 3.0
dlib 18.18
vsal 1.0
OpenCV's extra modules 3.0 Optional - For the LBP face tracker
protobuf 3.0.0 Optional - For loading and saving
Matlab 2012a Optional - For building the MEX function

Installation

  • Use CMake to build and install the mex function.
  • Add find_face_landmarks/bin to path.
  • Add find_face_landmarks/interfaces/matlab to Matlab's path
  • Download the landmarks model file: shape_predictor_68_face_landmarks.dat
  • Use show_face_landmarks function to display the output from find_face_landmarks

Bibliography

If you find this code useful, please make sure to add suitable references to the original DLIB library and the frontalization paper. Bib items for both are:

DLIB
@article{king2009dlib,
title={Dlib-ml: A machine learning toolkit},
author={King, Davis E},
journal={J. Mach. Learning Research},
volume={10},
pages={1755--1758},
year={2009},
publisher={JMLR. org}
}

Frontalization
@inproceedings{HHPE:CVPR15:frontalize,
author = {Tal Hassner and Shai Harel and Eran Paz and Roee Enbar},
title = {Effective Face Frontalization in Unconstrained Images},
booktitle = {IEEE Conf. on Computer Vision and Pattern Recognition (CVPR)},
month = {June},
year = {2015},
URL = {Available:~http://www.openu.ac.il/home/hassner/projects/frontalize}
}

About

C++ \ Matlab library for finding face landmarks and bounding boxes in video\image sequences.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 87.3%
  • CMake 7.8%
  • MATLAB 4.6%
  • Protocol Buffer 0.3%