This repo contains an implementation of the algorithm described in the paper, `A Method for Automatically Animating Children's Drawings of the Human Figure' (currenly under peer review).
In addition, this repo aims to be a useful creative tool in its own right, allowing you to flexibly create animations starring your own drawn characters.
If you do create something fun with this, let us know! Use hashtag #FAIRAnimatedDrawings
Installation is quick and easy! You can install with these simple commands:
git clone firstname.lastname@example.org:fairinternal/AnimatedDrawings.git cd AnimatedDrawings pip install -e .
See the README for more details.
Once you've installed AnimatedDrawings, using it is as simple as importing the package and specifying a configuration file. Here's an example:
from animated_drawings import render render.start('./examples/config/mvc/interactive_window_example.yaml')
And the resulting window:
By modifying the configuration files, you can switch characters, apply different motions, change output formats, and more! Here are a couple examples:
from animated_drawings import render render.start('./examples/config/mvc/export_gif_example.yaml')
from animated_drawings import render render.start('./examples/config/mvc/multiple_characters_example.yaml')
Suppose you'd like to add a background to the animation. You can do so by specifying the image path within the config. Run the following commands from a Python interpreter within the AnimatedDrawings root directory:
from animated_drawings import render render.start('./examples/config/mvc/background_example.yaml')
We also provide scripts and models so you can animate your own drawings with a single command:
python image_to_animation.py drawings/garlic.png garlic_out
If you want to learn how to do all this and more, see the GitHub Readme :)
Alternatively, if you just want to quickly animate your own drawing, try out our browser-based demo, sketch.metademolab.com.
If you want to contact the project author directly, you can reach me on Twitter: @hjessmith.