convert images to sound waves
pumila is an image-to-sound converter. It transforms variations in color, brightness, saturation and opacity into different sounds.
pumila is free software under the terms of the GNU Affero General Public License version 3 (or any later version). This is version 0.1.0 of the program.
The author of pumila is Niels Serup. Bug reports and suggestions should be sent to email@example.com for the time being.
Extract pumila from the downloaded file, cd into it and run this in a terminal:
# python3 setup.py install
Examples are available in the examples directory.
Just run this:
# pip-3.1 install pumila
Note that this will not make any examples available.
Under normal circumstances, you would do something like this:
However, the PyGame 1.9.1 release doesn’t work perfectly with Python 3, which means you’ll have to compile PyGame from svn yourself, see http://pygame.org/wiki/Compilation
It’s best to get the newest version from http://cython.org/ — pumila works with v0.15, but earlier versions haven’t been tested very much.
What affects what:
bottom <-- frequency --> top bright <-- amplitude --> dark no saturation <-- amplitude --> full saturation transparent <-- amplitude --> opaque
hue 0 to 90, red to ······ chartreuse: sine to triangle hue 90 to 180, chartreuse to cyan: triangle to square hue 180 to 270, cyan to ····· purple: square to sawtooth hue 270 to 360 (0), purple to ··· red: sawtooth to sine
Run pumila to use it. Run pumila --help to see how to use it.
To find out how to use it, run:
$ pydoc3 pumila
$ pydoc3 pumila.core $ pydoc3 pumila.primitives
And so on.
There are a few examples in the examples directory. All example images are available under the Creative Commons Zero 1.0 license.
pumila uses Git for code management. The newest (and sometimes unstable) code is available at:
$ git clone git://gitorious.org/pumila/pumila.git
Copyright (C) 2011 Niels Serup
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.