/wfc-piano-roll

Uses an implementation of mxgmn/WaveFunctionCollapse in Python to create piano rolls and then plays them!

Primary LanguagePython

wfc piano roll

Play images like a piano roll!

Uses ikarth's implementation of mxgmn/WaveFunctionCollapse in Python (https://github.com/ikarth/wfc_python)

Shoutout to this chord playing directory for helpming me figure out how to add sine waves together https://github.com/akkana/scripts/blob/master/play_chord.py

Getting started

The best way to get started is to clone this directory to your machine and dive in! The required packages for this project can be found in requirements.txt and installed to your environment using:

pip install -r requirements.txt

Generate images

To generate an image from WaveFunctionCollapse, you will need an sample image to generate from. You can choose an existing image from wfc/Samples/ or add your own .png there.

Note of caution - images of > 100 pixels will take a looooong time to generate from, so choose something simple.

Here's an example. To generate images based on the Water sample run the following:

python wfc/wfc_main.py -f Water

From one image you will get 5 unique images:

example image ----------> example image

If you would like more output images, to change the output dimensions, etc:

  -h, --help   show this help message and exit
  -f NAME      source file name (located in samples/) to generate from. Do not
               include file type.
  -i [N]       number of images to create. defaults to 5
  -l [LENGTH]  length in pixels of images to create. defaults to 48
  -t [HEIGHT]  height in pixels of images to create. defaults to 13

Play an image

To play an image, run the following with the file path of the desired image:

python soundify.py -f my/file/path.png

This defaults to playing based on a major scale. Chromatic and harmonic are also options.

For additional options:

  -h, --help  show this help message and exit
  -f NAME     path to image to play
  -o OUT      What set of notes to play from. Options are chromatic, major, or
              harmonic.

Here are files you can dowload to hear the output based on the example above:

A Major Scale

*Note - For now, if you would like to use the chromatic or major scale options, the max height of your image is 24 pix.

*Note - The default background is black. If your image's background is not black, you will need to change the background global variable in soundify.py