From 2d969cd2972af2fdf99ba45d9411db2f2cff7fa3 Mon Sep 17 00:00:00 2001 From: julien Lengrand-Lambert Date: Wed, 13 Jun 2012 10:59:54 +0300 Subject: [PATCH] Update gh-pages --- index.html | 187 ++++++++++++++++------------------------------------- 1 file changed, 54 insertions(+), 133 deletions(-) diff --git a/index.html b/index.html index 7570e32..3135557 100644 --- a/index.html +++ b/index.html @@ -21,11 +21,15 @@ + +
@@ -38,38 +42,31 @@ Hosted on GitHub Pages — Theme by mattgraham
-

Take one picture of yourself a day, automatically generate a movie!

+

TimeLapse creation using Face Recognition

-

FaceMovie is a simple project that aims at helping you create videos of yourself over time, using photos as input. -Simply take several pictures of yourself in the same position, and decide when to compile everything into a video. Just indicate the location of your pictures, Facemovie does everything else for you.

+

FaceMovie is a project aiming at helping you create videos of yourself over time. +Simply take pictures of yourself, Facemovie does everything else for you.

-

I see a growing interest for projects where people take one picture of themselves a day for several months (years ?) and compile it into a video. -When searching on the web, I realized that there was only one software allowing people to do this, the everyday paid iphone app. I hope that Facemovie could help some of you! -The main difference with everyday is that Facemovie searches automatically for faces in the input images and compile them in the best possible way, so that your video look awesome.

+

FaceMovie may be used for faces, but also profiles (to show women along pregnancy for example) or full body (for people workouting). The only limitation comes from you !

-

Due to its general implementation, FaceMovie may be used for faces, but also profiles (for projects showing women along pregnancy for example or full body(for people workouting). The only limitation comes from you !

- -

You can check out an example here..

+
+

Installation

-

There are several ways you can choose from to run Facemovie, each being developed below. -Please note that you best pick as this stage would be to choose the executable.

-

Windows executable (Default)

This is the current safest and easiest solution for you.

-

Download the archive available here. By default, choose the full archive. -The light archive is intended for users having Python2.7 already installed on their system. In this case, a python.dll is given with the executable.

+

Download the archive available here.

Uncompress the archive. It contains three elements :

In order to check that everything is ready, open a command line in at the executable location and run the Facemovie helper :

@@ -78,165 +75,89 @@ $ Facemoviefier.exe -h

You are now ready to use the Facemovie !

- -

Github

-

You can also simply clone the project from Github and use it as you wish.

+ +

Ubuntu (12.04)

+ +

Firstly install dependencies :

+ +
$ sudo aptitude install python-opencv libcv2.3 libcvaux2.3 libhighgui2.3 libopencv-contrib2.3 libopencv-gpu2.3 python-numpy
+
+ +

Clone the project from Github:

git clone git://github.com/jlengrand/FaceMovie.git
-

This is a very good solution if you already have Python2.7 and OpenCV installed on your system (see requirements chapter).

- -

To check the code, simply open a command line and try to run the Facemovifier :

- +

Open a command line and try to run the Facemovifier : 

 $ cd my\cloned\folder
  $ python facemovie\Facemoviefier.py -h
-

Scripts are available for Windows and Linux (called run.sh and run_windows.sh) in order to help you run Facemovie.

+

Other distributions

+ + +

Have a look at the (see complete README).

Sample archive

-

So that you can start playing with the FaceMovie even though you do not have a batch of images, I compiled some samples in a archive available here. -Simply uncompress it wherever you want, and use the image as input source !

+

So that you can start playing with the FaceMovie, I compiled some samples in a archive available here. +Simply uncompress it and use the image as input source !

Getting Started

-

Now that FaceMovie is installed on your system, let's start playing with it ! -If you do not have images to play with, note that an [archive including samples] is available.

+

For each of the following commands, Facemovifier should be replaced by FaceMovifier.exe or python Facemovifier depending on your installation method (executable or Source code).

-

For each of the following commands, Facemovifier should be replaced by FaceMovifier.exe or python Facemovifier depending on your installation method (executable or Python egg).

+

First command

-

Once installed, let's start by calling the helper of Facemovie. It can be done by

+

Once installed, let's start by calling the helper of Facemovie. It can be done like this:

$ Facemoviefier -h
-

depending whether you used the installer or the Python egg. -This command will list all the available parameters that can be used.

+

Your first movie!

The next step is to try to create you first video. It is no more complex than running the following in command line :

$ Facemoviefier -i input_folder -o output_folder
-

Where input_folder is the repository where all your images are stored, and output_folder where you want the results to be saved. -If you don't have images, you can still test the application by downloading some samples here.

+

+If you don't have images, you can still test the application by downloading some samples here.

Here is a concrete example : 

$ Facemoviefier.exe -i "../data/input/samples" -o "../data/output"
-

*NOTE : * In order to get good results, your images should contain only one person; and you should try to always keep the same angle with the camera for each of them.

- -

Facemovie needs the list of haar_cascades to correctly detect faces. This means that if you decide to run the Facemovie from another location, you should update the folders accordingly and use the root_folder option:

- -
$ Facemoviefier -i input_folder -o output_folder -r haar_cascades_folder_location
-
- -

Facemovie allows you to choose the type of output you want once the processing is done. This can be done by using the --type (-t) option. Here is the case where I save images instead of a movie in output.

- -
$ Facemoviefier -i "../data/input/Axel" -o "../data/output" -t i
-
- -

By default, Facemovie is searching for frontal faces. You can change this by setting up which profile to use using the --profile (-p) option:

- -
$ Facemoviefier -i "../data/input/Axel" -o "../data/output" -p "profile face"
-
- -

An extensive list of training files is available while calling the helper, or by running the following command.

- -
$ Facemoviefier -p ?
-
- -

Options available in the Facemoviefier

- -

Required :

- -

Optional :

- -

Libraries

- -

The whole aplication is developed using Python2.7.3. Any Python2.7 should be enough though. -To run the application, you'll also need to install Opencv.See the documentation for more information.

- -

I also used the excellent exif library to enhance sorting capabilities. It is embedded in the code, and you will not need to install it.

- -

This project is developed on a Windows (7) platform, but there should (and, as a fanatic Linux User, will) be no compatibility problems with UNIX. -The Linux application will be made available through a Python egg, available on Pypi.

- -

Work in progress

- -

Facemovie is still under development, and you should consider it as work in progress. -Lots of elements still have to be improved.

- -

Here is a list of my next objectives :

- -

Other ressources

- -

A complete documentation for the code is available as an archive here. -Simply uncompress the archive and open the index.html in your browser to access it.

+

If you want to know more about all available options, please check FaceMovie's README.

License

This project is released under the new BSD license (3 clauses version). You can read more about the license in the LICENSE file or direclty on GNU's website.

-

Acknowledgment

+

Issues

-

The idea of this project comes from an idea of Axel Catoire, currently travelling around the world with his girlfriend. -As a starter for my code, I used an excellent example from JAPSKUA, that you can find here -And I used Gene Cash's library to extract information from EXIF metadata in the images.

+

FaceMovie is still a work in progress and is my very first packaged application. I would love to know about your issues or suggestions to make it better !

-

DISCLAIMER

- -

Facemovie works with your images, so I feel like I need to write something about data usage. -Facemovie is a work in progress, and I am not responsible for any corrpution it could cause to your data. -I never experienced any problem using the software, but you should always back up your data before using it.

+

Please post your issues or feature requests here, so that I can correct/implement them !

Contact

I would enjoy having feedback if you like this idea, or even used it. Send me a link to your creations so that I can put them here ! -Feel free to mail me for any comment or request.

+**Feel free to write some words here for any comment or request.

You can contact me at julien at lengrand dot fr, or on my current website.

-

Version : 0.8.1

+

Oh and of course, if you like my work; you may want to show it :)

+ +
+Flattr this
+ +
+

Version : 0.8.2