Built with Python 2.7, OpenCV, Numpy, Scipy, Stasm.

• Install OpenCV: Mac installation steps
• pip install -r requirements.txt

Either use as:

• Local command-line utility
• pip library

$ git clone https://github.com/alyssaq/face_morpher

Morph from a source to destination image:

python facemorpher/morpher.py --src=<src_imgpath> --dest=<dest_imgpath> --plot

Morph through a series of images in a folder:

python facemorpher/morpher.py --images=<folder> --out_video=out.avi

All options listed in morpher.py (pasted below):

Morph from source to destination face or
Morph through all images in a folder

Usage:
  morpher.py (--src=<src_path> --dest=<dest_path> | --images=<folder>)
            [--width=<width>] [--height=<height>]
            [--num=<num_frames>] [--fps=<frames_per_second>]
            [--out_frames=<folder>] [--out_video=<filename>]
            [--alpha] [--plot]

Options:
  -h, --help              Show this screen.
  --src=<src_imgpath>     Filepath to source image (.jpg, .jpeg, .png)
  --dest=<dest_path>      Filepath to destination image (.jpg, .jpeg, .png)
  --images=<folder>       Folderpath to images
  --width=<width>         Custom width of the images/video [default: 500]
  --height=<height>       Custom height of the images/video [default: 600]
  --num=<num_frames>      Number of morph frames [default: 20]
  --fps=<fps>             Number frames per second for the video [default: 10]
  --out_frames=<folder>   Folder path to save all image frames
  --out_video=<filename>  Filename to save a video
  --alpha                 Flag to save transparent background [default: False]
  --plot                  Flag to plot images [default: False]
  --version               Show version.

Average faces from all images in a folder:

python facemorpher/averager.py --images=<images_folder> --out=average.png

All options listed in averager.py (pasted below):

Face averager

Usage:
  averager.py --images=<images_folder> [--blur] [--alpha] [--plot]
            [--width=<width>] [--height=<height>] [--out=<filename>]

Options:
  -h, --help         Show this screen.
  --images=<folder>  Folder to images (.jpg, .jpeg, .png)
  --blur             Flag to blur edges of image [default: False]
  --alpha            Flag to save with transparent background [default: False]
  --width=<width>    Custom width of the images/video [default: 500]
  --height=<height>  Custom height of the images/video [default: 600]
  --out=<filename>   Filename to save the average face [default: result.png]
  --plot             Flag to display the average face [default: False]
  --version          Show version.

• Locates face points (using stasm)
• For a different locator, return an array of (x, y) control face points

• Align faces by resizing, centering and cropping to given size

• Given 2 images and its face points, warp one image to the other
• Triangulates face points
• Affine transforms each triangle with bilinear interpolation

• Morph between 2 or more images

• Average faces from 2 or more images

Optional blending of warped image:

• Weighted average
• Alpha feathering
• Poisson blend

(out.avi played and recorded as gif)

85 images used

$ pip install facemorpher

Additional options are exactly the same as the command line

import facemorpher

# Get a list of image paths in a folder
imgpaths = facemorpher.list_imgpaths('imagefolder')

# To morph, supply an array of face images:
facemorpher.morpher(imgpaths, plot=True)

# To average, supply an array of face images:
facemorpher.averager(['image1.png', 'image2.png'], plot=True)

• Data for the haar face classifiers are in the facemorpher/data folder
• Stasm binary in facemorpher/bin/stasm_util. You can build a new stasm binary with the Stasm 4 build scripts.

http://alyssaq.github.io/face_morpher

./scripts/publish_ghpages.sh

MIT