On a cross-country drive from Connecticut to Seattle, my girlfriend and I found ourselves in Crescent City, CA. We got some coffee and stopped for a walk on the beach, where we ran into an incredible mural of an ocean wave made entirely of repurposed plastic lids, bottle caps, and other similar items. I had been enjoying the trip very much, but was in need of a project to think about, and the inspiration was immediate. I wanted to write a program to do something similar -- create murals of discrete circular elements from an image.
The goal of transforming an input image into a discrete set of circular "bottle caps" is achieved through a couple steps.
- Simplify the coloration of the image. There may be hundreds or thousands of unique colors in an image. This should be reduced to a couple dozen or fewer for any hope of constructing this image out of bottle caps.
- Mask off the pixels between the bottle caps, and ensure that the pixels occupying the position of the same bottle cap have the same color.
Step (1.) is handled by pix_sort.py, and step (2.) is handled by lens_mask.py. To simplify execution of the process, image_pipeline.py runs these two steps after each other.
Additionally, gif_pipeline.py creates many images from a single input with different levels of detail due to different sized bottle caps being used. These images are then composed into a single gif, which has the appearance of details fading in and out of abstract forms. In my opinion this is the most interesting output of the program.
- Pillow
- numpy
- tqdm
$ apt install python3-pil python3-numpy python3-tqdm
$ python3 pix_sort.py will run the program with default options and display the resultant image
$ python3 lens_mask.py will run the program with default options and display the resultant image
$ python3 image_pipeline.py runs the two prior commands and saves the output in the output_images directory.
$ python3 gif_pipeline.py creates an interesting gif representation of the input image using different sized bottle caps.
-f [filename] allows the user to select a file from the input_images directory to use.
-t [integer] allows the user to specify a threshold to use when simplifying the colors in the image.
-b [true or false] allows the user to add a preprocessing blur before the image colors are updated.
-l [integer] allows the user to select what size lens to use when making the bottlecaps. This option is ignored by gif_pipeline.py, as this pipeline has specific sizes already specified.
-c [true or false] allows coloring book mode, where the resultant image is a color by numbers.
-v [true or false] allows toggling verbose mode, where more information about the recoloring is given.
$ python3 gif_pipeline.py -t 25 -f burlington-sunset.jpg -b false
This command will take the example image included in the repository, "burlington-sunset.jpg", not apply any input blur, and simplify the color palette with color threshold 25. From this simplified color input, a .gif image will be generated using a "bottle cap" mask, and the output will be saved in the output_gifs directory.
$ python3 image_pipeline.py -t 30 -l 16 -f burlington-sunset.jpg -c true
This command will take the example image included in the repository, "burlington-sunset.jpg" and simplify the color palette using color threshold 30. From this simplified color input, a color-by-numbers style image will be generated which can be printed and colored in.