USAGE: stainedglass [-k kind] [-s size] [-o offset] [-n ncolors] [-b bright] [-e ecolor] [-t thick] [-r rseed] infile outfile
USAGE: stainedglass [-h or -help]

-k .... kind ....... kind of stainedglass cell shape; choices are: square
.................... (or s), hexagon (or h), random (or r); default=random
-s .... size ....... size of cell; integer>0; default=16
-o .... offset ..... random offset amount; integer>=0; default=6;
.................... only applies to kind=random
-n .... ncolors .... number of desired reduced colors for the output;
.................... integer>0; default is no color reduction
-b .... bright ..... brightness value in percent for output image;
.................... integer>=0; default=100
-e .... ecolor ..... color for edge or border around each cell; any valid
.................... IM color; default=black
-t .... thick ...... thickness for edge or border around each cell;
.................... integer>=0; default=1; zero means no edge or border
-r .... rseed ...... random number seed value; integer>=0; if seed provided,
.................... then image will reproduce; default is no seed, so that
.................... each image will be randomly different; only applies
.................... to kind=random

PURPOSE: Applies a stained glass cell effect to an image.

DESCRIPTION: STAINEDGLASS applies a stained glass cell effect to an image. The choices of cell shapes are hexagon, square and randomized square. The cell size and border around the cell can be specified.

ARGUMENTS:

-k kind ... KIND of stainedglass cell shape; choices are: square (or s), hexagon (or h), random (or r). The latter is a square with each corner randomly offset. The default=random.

-s size ... SIZE of stained glass cells. Values are integers>=0. The default=16.

-o offset ... OFFSET is the random offset amount for the case of kind=random. Values are integers>=0. The default=6.

-n ncolors ... NCOLORS is the number of desired reduced colors in the output. Values are integers>0. The default is no color reduction. Larger number of colors takes more time to color reduce.

-b bright ... BRIGHTNESS value in percent for the output image. Values are integers>=0. The default=100 means no change in brightness.

-e ecolor ... ECOLOR is the color for the edge or border around each cell. Any valid IM color is allowed. The default=black.

-t thick ... THICK is the thickness for the edge or border around each cell. Values are integers>=0. The default=1. A value of zero means no edge or border will be included.

-r rseed ... RSEED is the random number seed value for kind=random. Values are integers>=0. If a seed is provided, then the resulting image will be reproducable. The default is no seed. In that case, each resulting image will be randomly different.

Thanks to Anthony Thyssen for critiqing the original version and for several useful suggestions for improvement.

NOTE: This script will be slow due to the need to extract color values for each cell center point across the input image. A progress meter is therefore provided to the terminal. A speed-up is available via a -process function, getColors. To obtain getColors, contact me. It requires IM 6.6.2-10 or higher.

CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk.