morpholib

Morpho

A general-purpose programmatic animation tool

Features

• Animate basic figures like Points, Paths, Polygons, Splines, Images, and Text
• Helper functions to build more complex composite figures like grids
• Tools for quickly creating custom figures that animate in precisely specified ways
• Support for rendering and animating LaTeX.
  • Requires a LaTeX distribution to be preinstalled, as well as dvisvgm
• Multiple tweening options and the ability to define custom tweens
• Apply custom transformations to figures to create complex patterns
• Support for multiple layers each with its own independent dynamic camera
• Ability to use layers as masks for other layers
• Color gradients, both as fills and as color gradients along paths
• Some primitive 3D animation capability
• Preview animations along with the ability to locate positions on screen with a click
• Export animations as MP4, GIF, and PNG sequences at arbitrary framerates and resolutions
  • (Note: FFmpeg required to create MP4s, and Gifsicle required to make small size GIFs)

Gallery and Documentation

A gallery of animations made with Morpho is available here. For more, you can also take a look at the YouTube channels Morphocular and Serpentine Integral, which use Morpho to create most of the animations.

Documentation is currently limited, but there are a few guides you can look thru which will help you learn how to use Morpho and get you started making your own animations.

Installation

Morpho is a library for Python and works on Python 3.8 or higher and requires Pycairo to run. For Windows users, Morpho and all its basic dependencies, including Pycairo, should be installable via a simple pip command:

pip3 install morpholib

Installation on other platforms has not been well-tested, unfortunately, and does not appear to be as straightforward. For now, I think the best method is to first see if you can install Pycairo separately (for instructions on how to do so, see this), test that the Pycairo installation is working, and then attempt to install Morpho via the above pip command.

Softer requirements

If you want to export animations as MP4s or small-sized GIFs, you will need to install FFmpeg for MP4 and/or Gifsicle for GIF. But if that doesn't matter to you (or if you just want to try out Morpho), you can still preview animations and export them as PNG sequences and large-sized GIFs just using the base installation of Morpho.

Please note that FFmpeg and Gifsicle will need to be added to your PATH environment variable for Morpho to be able to access them by default.

For Morpho to be able to parse LaTeX code, you must have a LaTeX distribution installed along with dvisvgm. But if you're okay with not using Morpho's LaTeX features, this requirement is optional.

SciPy is an optional, but recommended, dependency that is necessary currently for only few features (flowStreamer and FlowField). SciPy can be installed via pip with the command pip install scipy

Testing the installation

To see if it installed correctly, try running the following Python code:

import morpholib as morpho
morpho.importAll()
morpho.sample.play()

If you see an animation of a morphing grid appear on your screen, congratulations! Morpho should be installed and working properly.

License

This project is licensed under the terms of the MIT license.