Image Pixeler is a platform to replace pixels, or group of pixels in an image, with other images. This program is written in Python 3 mainly based on K-Means and OpenCV tools. You can see how to use this app using:

python main.py -h

Possible commands are:

usage: main.py [-h] [-in INPUT] [-out OUTPUT] [-g GALLERY] [-s SCALE]
               [--grey GREY] [-r RECURSIVE] [-v VERBOSE]

optional arguments:
  -h, --help            show this help message and exit
  -in INPUT, --input INPUT
  -out OUTPUT, --output OUTPUT
                        Name of output file
  -g GALLERY, --gallery GALLERY
  -s SCALE, --scale SCALE
                        Output image will be scaled up by this factor [H *
                        $(scale), W * $(scale)]
  --grey GREY           Work in Greyscale mode
  -r RECURSIVE, --recursive RECURSIVE
                        Scan all images inside Gallery directory recursively
  -v VERBOSE, --verbose VERBOSE
                        Print steps in system log

All dependencies for this program are highlighted in requirements.txt. You can install dependencies using:

pip3 install -r requirements.txt

Examples usage:

python main.py -in ./input.jpg -out ./output.jpg -g ./Gallery/ -r True -s 256 -v True 

This command, loads input.jpg and save the art image to output.jpg. It scans all files and folders inside ./Gallery/ recursively. Those scanned images are going to replace patches in the main image. It makes all scanned images into square images automatically, so you don't have to take care of that part. It also prints the process steps in system log. Argument -s 256 lets this program to scale up each patch of 8x8 pixels in the main image to be scaled up to 256x256 pixel. Some sample input and output:

If you don't have multiple images, and you want to capture many frames from the video and at the same time, you want to preserve the diversity of those captured images, you can use gallery_generator.py.

usage: gallery_generator.py [-h] [-v VIDEO] [-o OUTPUT] [-di DIVERSITY]

optional arguments:
  -h, --help            show this help message and exit
  -v VIDEO, --video VIDEO
                        Path to the file or a publicly available link to video
  -o OUTPUT, --output OUTPUT
                        Output directory to save frames selected diversely
  -di DIVERSITY, --diversity DIVERSITY
                        Diversity index showing how diverse the frames should
                        be [0-1] lowest 0 and highest 1. Suggested value =
                        0.25

• Amin Aghaee