AnimatedDrawings: Children's hand-drawn doodles converted to animations, automated children's drawing animation generation tool

General Introduction

AnimatedDrawings is an open source project developed by Facebook Research to transform children's drawings into animated characters through automation techniques. The project is based on an algorithmic implementation of the paper "A Method for Animating Children's Drawings of the Human Figure", which provides a flexible authoring tool that allows users to generate animations using their own drawings. The project code is hosted on GitHub and can be freely downloaded and used by users.

Demo address: https://sketch.metademolab.com/

Function List

• Automated animation generation: transforming children's drawings into dynamic animated characters
• Flexible Configuration: Supports a variety of profiles to meet different animation requirements
• Interactive Window: Provides an interactive interface for users to adjust the animation effect in real time.
• Export function: supports exporting animated GIFs with transparent backgrounds.
• Open source code: Provide complete source code for secondary development and learning

Using Help

Installation process

1. Creating a Virtual Environment: It is recommended to create a virtual environment using Conda to avoid dependency conflicts. Run the following command to create and activate a virtual environment:

   conda create --name animated_drawings python=3.8.13
conda activate animated_drawings

2. Cloning Project Code: Clone the project code from GitHub and install the dependencies:

   git clone https://github.com/facebookresearch/AnimatedDrawings.git
cd AnimatedDrawings
pip install -e .

3. Installation of dependencies: Ensure that all dependent packages required for the project are installed.

Usage Process

1. Launching Interactive Windows::
   • Open a terminal and activate the virtual environment:

    conda activate animated_drawings
   

   • Go to the project root directory and start the Python interpreter:

    cd {AnimatedDrawings project path}
   python
   

   • Run the following command in the Python interpreter to launch the interactive window:

    from animated_drawings import render
   render.start('. /examples/config/mvc/interactive_window_example.yaml')
   

   • Once the interactive window is launched, the user can pause/play the animation using the spacebar, move the timeline back and forth using the arrow keys, press the q key to close the window.
2. Generate animation::
   • Users can modify the configuration file according to their needs, which is located in the . /examples/config/ Catalog.
   • By modifying the parameters in the configuration file, you can adjust the movement, speed, and other attributes of the animated character.
3. Exporting Animation::
   • After the animation is generated, users can export it as a GIF file with transparent background for easy use in other video editing software.

common problems

• Dependency installation error: Ensure that the version of Python installed in your virtual environment is 3.8.13 and that all dependent packages are correctly versioned.
• Interactive windows do not start: Check that the configuration file path is correct and make sure that all dependent packages have been installed correctly.