https://github.com/PanagiotisIatrou/Photo-Mosaic-Maker
A python command line tool for creating photo mosaics effortlessly
https://github.com/PanagiotisIatrou/Photo-Mosaic-Maker
image-processing mosaic python
Last synced: about 1 month ago
JSON representation
A python command line tool for creating photo mosaics effortlessly
- Host: GitHub
- URL: https://github.com/PanagiotisIatrou/Photo-Mosaic-Maker
- Owner: PanagiotisIatrou
- License: mit
- Created: 2022-05-25T09:03:22.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-05-28T19:13:44.000Z (over 3 years ago)
- Last Synced: 2025-01-10T07:36:37.916Z (10 months ago)
- Topics: image-processing, mosaic, python
- Language: Python
- Homepage:
- Size: 15.3 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Photo-Mosaic-Maker
A python command line tool for creating photo mosaics effortlessly
(Download the mosaic and zoom in to see the cells.)
## How to install
Clone the repository or just download the repository as a .zip
## How to use
Open a terminal and navigate to the project directory.
Depending on the platform, you can run the program by:
**Linux:** ```python3 mosaic.py```
**Windows:** ```py mosaic.py```
The only needed arguments are the:
* ```--input filename.jpg``` which sets the image to create a mosaic out of.
* ```--input_cells_path path/to/Images``` which sets the path that contains all the images that will be used as cells.
Put all the images that are going to be used as cells in the specified path/to/Images folder.
Also, see the examples below.
## List of configurations
* ```--output filename.jpg```
Saves the output image as filename.jpg.
* ```--input filename.jpg```
Takes filename.jpg as the input image.
* ```--input_cells_path path/to/Images```
Sets the path that contains all the images that will be used as cells
* ```--mode mode_selected```
Sets the current mode to mode_selected. There are currently 2 modes available, **blend** and **original**. When ```--mode``` is not specified, **blend** mode is selected by default. **blend** mode uses a random image from the Images/ folder and applies a tint in each cell to match the input image color. **original** mode takes the average color for each image in the Images/ folder and tries to match the input image pixels as close as possible without tampering with the color.
* ```--blend_amount number```
This argument is only valid when the ```--mode``` is set to blend. It defaults to 0.8 and specifies how much color tint is used in each cell of the mosaic. Smaller value leads to clearer cells but more crude output image, while bigger values lead to fainted cells but smoother output image.
* ```--resolution_scale number```
This argument is only valid when neither ```--grid_x``` or ```--grid_y``` are specified (Also read ```--grid_x``` argument). It applies a factor to the total number of cells of the mosaic (which by default is 10000). For example, a value of 2 would set the total number of cells of the mosaic to 20000, while a value of 0.5 would set the total number of cells of the mosaic to 5000.
* ```--cell_x number```
Sets the width of each cell. The program shrinks each image from the Images/ folder so that each cell of the output image is the same. By default, if not specified, ```--cell_x``` is set to 50.
* ```--cell_y number```
Sets the width of each cell. By default, if not specified, ```--cell_y``` is set to 50.
* ```--grid_x number```
Sets the width of the mosaic grid. By default, if neither ```--grid_x``` or ```--grid_y``` are specified, the program tries to match the input image aspect ratio such that the total number of cells in the mosaic does not exceed 10000.
* ```--grid_y number```
Sets the height of the mosaic grid.
## Supported image formats
* .jpg
* .jpeg
* .png
## Examples
```python3 mosaic.py --input Examples/photo1.jpg --input_cells_path Examples/Images --output Examples/out1.jpg```
This creates the image above.