camogen

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. I simply updated and wrote his code in Python instead of PHP.

WARNING The code only works with Python3! WARNING

How to use

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.

Parameters

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 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})