A simple 3D face alignment and warping demo.
C++ CMake
Switch branches/tags
Nothing to show
Clone or download
Latest commit af12745 Jun 8, 2018
Failed to load latest commit information.
clm FaceDemo release Jan 2, 2016
data update README.md; add gif Sep 29, 2016
model FaceDemo release Jan 2, 2016
src update README.md; add gif Sep 29, 2016
.gitignore update README.md Sep 29, 2016
CMakeLists.txt FaceDemo release Jan 2, 2016
LICENSE Initial commit Jan 2, 2016
README.md update README Jun 7, 2018


FaceDemo: a simple 3D face alignment and warping demo

Input: face image/video

Output: Textured 3D face model


This is the author's implementation of 3D face alignment and warping method described in:
Mirror Mirror: Crowdsourcing Better Portraits
Jun-Yan Zhu, Aseem Agarwala, Alexei A. Efros, Eli Shechtman, Jue Wang
In ACM Transactions on Graphics (Proceedings of SIGGRAPH Asia 2014)

Please cite our paper if you use our code for your research.

Given an image or a video sequence that contains a face, the program can align and warp the face to a 3D face model. The user can further rotate/translate the face, and adjust the camera projection (perspective projection or orthogonal projection). The program also provides different OpenGL rendering options. See "Usage" for details.

Contact: Jun-Yan Zhu (junyanz@berkeley.edu)


  • OpenCV:
sudo apt-get install libopencv-dev
  • OpenGL and GLUT:
sudo apt-get install libglu1-mesa-dev freeglut3-dev mesa-common-dev
sudo apt-get install libxmu-dev libxi-dev
  • CLM Tracker by Jason Saragih (included)

Getting Started (Linux)

  • Download and unzip the code.

  • Run the following command.

mkdir cbuild
cd cbuild
cmake -DCMAKE_BUILD_TYPE=Release  ../


  1. Command line interface: ./FaceDemo mode filePath
    • Example (image): ./FaceDemo image ./data/bush.jpg
    • Example (video): ./FaceDemo video ./data/eli.avi
  2. The program displays three windows:
  • The "Detected Points" window shows the original input frame with the detected feature points.
  • The "3D Face" window shows a 3D face model rendered by OpenGL.
  • The "Projected Face" window shows a 2D projection result of the 3D face model. The program projects the 3D face back to the original image.
  1. User Interaction: "3D Face" window takes the user's keyboard input.
    • shift + arrow keys: translate the face.
    • arrow keys: rotate the face.
    • +/-: zoom in/out
    • p: toggle between a perspective projection and an orthogonal projection.
    • s: toggle between flat and smooth shading.
    • w: toggle between filled and wireframe mode.
    • t: toggle between static mode and transformation mode: for static mode, the 3D face model doesn't rotate and translate.
    • q: quit the program