/image-mosaic

A python program used to create a mosaic of images

Primary LanguagePythonMIT LicenseMIT

image-mosaic

A Image Mosaic generator made with Python

Getting Started

To get up and running, make sure you have Python installed

Prerequisites

This project depends on Numpy , Pillow and scikit-image

to install them:

Numpy:

pip install numpy

Pillow:

pip install pillow

scikit-image

pip install scikit-image

User Defined Variables

In the code, there are variables that can be changed

  1. The name of the input image -> 'mainImageTarget'

  2. Number of tiles to devide image into -> 'numberOfTiles'.

    • For square image you can input 1 number equal to the number of tiles (must be squared number)
    • For non squared images, you input the number of square on x axis, and number of squares on y axis

  3. Comparison Mode ->

    • [1] Compare transformed rgb to transformed rgb (small tiles)
    • [2] Compare transformed rgb to transformed rgb (big tiles)

  4. Transform Mode ->

    • [1] no transformation
    • [2] RGB -> sRGB
    • [3] RGB -> CIE-Lab (my implimentation)
    • [4] RGB -> CIE-Lab (scikit-image)

As of the latest version, this is not required, refer to command line usage. However, if you wish to use it the old way, look for this piece of code.

#& user defined if need be. 
mode = args['mode']						#1
transform = args['transform']			#3
numberOfTiles = args['tiles']			#400
mainImageTarget = args['file']			#"1_in.jpg"
#&

Command-Line Usage

To use the script you need to attached arguments in the command-line,

Refer to above (User Defined Variables) for explination on values,

  • [-m] mode := comparison mode, is int of range [1 -> 2]
  • [-t] tiles := number of tiles, explained in last section.
  • [-tr] or [-trans] transform mode := transformation from RGB to ... , is int of range [1 -> 4]
  • [-f] file := target file, is the filename of the image.

Example usage

#For square image, 400 tiles (20x20)
$	sudo python python_image_mosaic.py -m 1 -t 200 -tr 3 -f 1_in.jpg

#For non-square image, 3750 tiles (50x75)
$	sudo python python_image_mosaic.py -m 1 -t 50, 75 -tr 3 -f 2_in.jpg

Example Output

Target Image Resulting Image

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

  • Imran Paruk - Initial work

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

Thank you to: