Face Morpher ============ | Warp, average and morph human faces! | Scripts will automatically detect frontal faces and skip images if none is detected. Built with Python, `dlib`_, Numpy, Scipy, dlib. | Supported on Python 2.7, Python 3.6+ | Tested on macOS Mojave and 64bit Linux (dockerized). Requirements -------------- - ``pip install -r requirements.txt`` - Download `http://dlib.net/files/shape_predictor_68_face_landmarks.dat.bz2` and extract file. - Export environment variable ``DLIB_DATA_DIR`` to the folder where ``shape_predictor_68_face_landmarks.dat`` is located. Default ``data``. E.g ``export DLIB_DATA_DIR=/Downloads/data`` Either: - `Use as local command-line utility`_ - `Use as pip library`_ - `Try out in a docker container`_ .. _`Use as local command-line utility`: Use as local command-line utility --------------------------------- :: $ git clone https://github.com/alyssaq/face_morpher Morphing Faces -------------- Morph from a source to destination image: :: python facemorpher/morpher.py --src= --dest= --plot Morph through a series of images in a folder: :: python facemorpher/morpher.py --images= --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= --dest= | --images=) [--width=] [--height=] [--num=] [--fps=] [--out_frames=] [--out_video=] [--plot] [--background=(black|transparent|average)] Options: -h, --help Show this screen. --src= Filepath to source image (.jpg, .jpeg, .png) --dest= Filepath to destination image (.jpg, .jpeg, .png) --images= Folderpath to images --width= Custom width of the images/video [default: 500] --height= Custom height of the images/video [default: 600] --num= Number of morph frames [default: 20] --fps= Number frames per second for the video [default: 10] --out_frames= Folder path to save all image frames --out_video= Filename to save a video --plot Flag to plot images to result.png [default: False] --background= Background of images to be one of (black|transparent|average) [default: black] --version Show version. Averaging Faces --------------- Average faces from all images in a folder: :: python facemorpher/averager.py --images= --out=average.png All options listed in ``averager.py`` (pasted below): :: Face averager Usage: averager.py --images= [--blur] [--plot] [--background=(black|transparent|average)] [--width=] [--height=] [--out=] [--destimg=] Options: -h, --help Show this screen. --images= Folder to images (.jpg, .jpeg, .png) --blur Flag to blur edges of image [default: False] --width= Custom width of the images/video [default: 500] --height= Custom height of the images/video [default: 600] --out= Filename to save the average face [default: result.png] --destimg= Destination face image to overlay average face --plot Flag to display the average face [default: False] --background= Background of image to be one of (black|transparent|average) [default: black] --version Show version. Steps (facemorpher folder) -------------------------- 1. Locator ^^^^^^^^^^ - Locates face points - For a different locator, return an array of (x, y) control face points 2. Aligner ^^^^^^^^^^ - Align faces by resizing, centering and cropping to given size 3. Warper ^^^^^^^^^ - Given 2 images and its face points, warp one image to the other - Triangulates face points - Affine transforms each triangle with bilinear interpolation 4a. Morpher ^^^^^^^^^^^ - Morph between 2 or more images 4b. Averager ^^^^^^^^^^^^ - Average faces from 2 or more images Blender ^^^^^^^ Optional blending of warped image: - Weighted average - Alpha feathering - Poisson blend Examples - `Being John Malkovich`_ ---------------------------------- Create a morphing video between the 2 images: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ``> python facemorpher/morpher.py --src=alyssa.jpg --dest=john_malkovich.jpg`` | ``--out_video=out.avi`` (out.avi played and recorded as gif) .. figure:: https://raw.github.com/alyssaq/face_morpher/master/examples/being_john_malvokich.gif :alt: gif Save the frames to a folder: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ``> python facemorpher/morpher.py --src=alyssa.jpg --dest=john_malkovich.jpg`` | ``--out_frames=out_folder --num=30`` Plot the frames: ^^^^^^^^^^^^^^^^ | ``> python facemorpher/morpher.py --src=alyssa.jpg --dest=john_malkovich.jpg`` | ``--num=12 --plot`` .. figure:: https://raw.github.com/alyssaq/face_morpher/master/examples/plot.png :alt: plot Average all face images in a folder: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 85 images used | ``> python facemorpher/averager.py --images=images --blur --background=transparent`` | ``--width=220 --height=250`` .. figure:: https://raw.github.com/alyssaq/face_morpher/master/examples/average_faces.png :alt: average\_faces .. _`Use as pip library`: Use as pip library --------------------------------- :: $ pip install facemorpher Examples ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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) Once pip installed, 2 binaries are also available as a command line utility: :: $ facemorpher --src= --dest= --plot $ faceaverager --images= --plot Try out in a docker container --------------------------------- Mount local folder to `/images` in docker container, run it and enter a bash session. --rm removes the container when you close it. :: $ docker run -v /Users/alyssa/Desktop/images:/images --name py3 --rm -it jjanzic/docker-python3-opencv bash Once you're in the container, install ``facemorpher`` and try the examples listed above :: root@0dad0912ebbe:/# pip install facemorpher root@0dad0912ebbe:/# facemorpher --src= --dest= --plot Documentation ------------- http://alyssaq.github.io/face_morpher Build & publish Docs ^^^^^^^^^^^^^^^^^^^^ :: ./scripts/publish_ghpages.sh License ------- `MIT`_ .. _Being John Malkovich: http://www.rottentomatoes.com/m/being_john_malkovich .. _Mac installation steps: https://gist.github.com/alyssaq/f60393545173379e0f3f#file-4-opencv3-with-python3-md .. _MIT: http://alyssaq.github.io/mit-license .. _OpenCV: http://opencv.org .. _Homebrew: https://brew.sh .. _source: https://github.com/opencv/opencv .. _dlib: http://dlib.net