This repository is a camouflage generator. The code is originally from Ulf Åström in PHP. You can find his applet here: http://www.happyponyland.net. Sadly, his website is down.
However, gammmalogic decided to rewrite camogen in PHP (the loop is complete) and propose a new webapp. You can find the updated code here: https://github.com/gammalogic/camogen-php
You can also try it directly here: https://camogen-php.com/
If you still want to use the Python version, you need to install the following libraries to run the code:
pip install numpy Pillow
Here is a very simple example how to use the generator:
import camogen
parameters = {'width': 700, 'height': 700, 'polygon_size': 400, 'color_bleed': 0,
'colors': ['#668F46', '#4A6B3A', '#145000', '#003022']}
image = camogen.generate(parameters)
The parameter image corresponds to the object Image from the package PIL.
The parameters given is a python dictionary. The following parameters are mandatory:
| Parameter | Types | Explanation |
|---|---|---|
| width | Int | Width of the image (Minimum value: 0) |
| height | Int | Height of the image (Minim value: 0) |
| polygon_size | Int | Minimum perimeter of a polygon (Minimum value: 0) |
| color_bleed | Int | Bleeding of the colors, i.e. number of neighbouring polygons with the same color (Minimum value: 0) |
| colors | list[String] | List of all the colors. Colors have to be a Hex String. (Minimum size: 1) |
| max_depth | Int | (Optional) Maximum depth for creating the polygons. (Default value: 15) |
The next set of parameters adds spots on the camouflage. In the dictionary, you have to add these parameters with the key
spots. If you want to add spots, all these parameters are mandatory:
| Parameter | Types | Explanation |
|---|---|---|
| amount | Int | Number of spots (Minimum value: 0) |
| radius | dict | Dictionary with the min and max radius (Example: {'min': 0, 'max': 10}), Minimum values: 0) |
| sampling_variation | Int | Variation for the sampling, i.e. how far it goes looking for the color for the spot. |
The next set of parameters pixelizes the camouflage. In the dictionary, you have to add these parameters with the key
pixelize. If you want to pixelize the camouflage, all these parameters are mandatory:
| Parameter | Types | Explanation |
|---|---|---|
| amount | float | Percentage of pixelization (Between 0 and 1) |
| sampling_variation | Int | Variation for the sampling, i.e. how far it goes looking for the color for the spot. |
| density | dict | Density of the pixels, i.e. inverse of the size of the pixels. (Example: {'x': 100, 'y': 200}) |
You can find examples how to generate some camouflage in the file examples.py
If you have questions about the generation of this patterns, you should ask Ulf Åström. He wrote the original code. You can find his contact page here: http://www.happyponyland.net/contact.php
If you have questions about the Python code or if you want to improve it, you can always submit an issue or a PR. You can also contact me using my email adress: [email protected]