pyrainboweffect

apply the animated rainbow effect to images


License
MIT
Install
pip install pyrainboweffect==0.1.0

Documentation

pyrainboweffect

中文指南

Documentación en español

Documentation en français

Introduction

Take an image like this:

Loading...

And transform it to this:

Loading...

Quick Start

  • Install the package:
pip install pyrainboweffect

Python API

In a Python console, import the package:

>>> import pyrainboweffect

Apply the effect to an image file and save the result as a gif:

>>> pyrainboweffect.psychedelic_gif('input.png', 'output.gif')

Apply the effect to an image file and save the result as an mp4:

>>> pyrainboweffect.psychedelic_mp4('input.png', 'output.gif')

CLI

To use the CLI:

$ python -m pyrainboweffect input.png output.gif

API Documentation

For the complete API documentation, click here.

Theory of Operation

This effect can be generated as follows:

  1. Convert the image to greyscale.
  2. Partition the intensity space into the same number of partitions as colors in the color scheme.
  3. Set the intensity regions to their corresponding colors
  4. Increase the intensity of all pixels in the original image (restarting at 0 intensity if overflow occurs).
  5. Go to step 2 and repeat until there are enough sequential frames to make an animation.

Dependencies

Only Python version 3.6 and greater are supported. This package should run on any POSIX system as well as Windows 7 and greater.

The following Pypi packages are required:

  • moviepy
  • numpy
  • opencv-python

Contributing

Suggestions and pull requests are welcome. If you find a bug and don't have time to fix it yourself, feel free to open an issue.

Future Tasks

  • TODO: Apply the psychedelic effect to an animated image or video.