https://github.com/roblourens/facealign

FaceAlign is a tool that can align a set of images containing faces
https://github.com/roblourens/facealign

Last synced: 27 days ago
JSON representation

FaceAlign is a tool that can align a set of images containing faces

• Host: GitHub
• URL: https://github.com/roblourens/facealign
• Owner: roblourens
• Created: 2010-12-18T21:46:12.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2016-01-11T21:40:39.000Z (almost 9 years ago)
• Last Synced: 2024-10-06T12:46:01.213Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 238 KB
• Stars: 52
• Watchers: 6
• Forks: 15
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
FaceAlign

========

FaceAlign is a tool that can be used to align a set of images containing faces. It is particularly useful for creating "time-lapse" face videos, such as this one : http://youtube.com/watch?v=7SXErQ4eYGU

How it works

------------

FaceAlign is a Python script that uses [opencv python bindings](http://opencv.willowgarage.com/wiki/), which requires >= Python 2.6. It detects the location of the face in each image (opencv tends to err on the side of over-detection, and this tool will use the largest detected face) and will scale and offset the image so that the centers of the faces in all images will match up. This is based on parameters that can be easily set in config.py.

Usage

-----

Once python and opencv are installed, open config.py and set HCDIR to the folder containing your opencv installation's Haar cascade files.

Run sizeToFace.py. It takes a required input directory parameter, and an optional output directory parameter. The output directory will be created if it does not already exist. By default, images will be output to the current directory. Output file names will be numbered starting with 0001.jpg.

    $ python src/sizeToFace.py ../in-images

    $ python src/sizeToFace.py ../in-images ../out-images

Eventual plans

--------------

* Brightness/contrast normalization

* Integration with ffmpeg for automatic video generation

* A GUI

Common Errors/Solutions

-----------------------

    ImportError: No module named cv

**Solution**: You have not installed OpenCV or the OpenCV Python bindings

    Traceback (most recent call last):

     File "<...>/src/facealign/src/FaceImage.py", line 133, in runFaceImage

       fi.cropToFace()

     File "<...>/src/facealign/src/FaceImage.py", line 23, in cropToFace

       face = self._getFaceCoords()

     File "<...>/src/facealign/src/FaceImage.py", line 68, in _getFaceCoords

       cascade = cv.Load(HCPATH)

    TypeError: OpenCV returned NULL

**Solution**: This means you have not set your HCDIR variable correctly. Open src/config.py and set HCDIR to

[yourOpenCVDir]/opencv/data/haarcascades/, for example:

HCDIR = '/home/doriad/src/OpenCV/opencv/data/haarcascades/'

So what's up?

-------------

Feedback, ideas, issue reports, and contributions are invited. Welcomed. Demanded, even. FaceAlign is fairly simple at the moment but I would be interested to hear if you found it useful.