USAGE: texturize [-d dimensions] [-n newseed] [-t threshold] [-b blur]
[-w widen] [-s spread] [-g gnoise] [-f format] [-m mix] [-c contrast]
[infile] outfile

USAGE: texturize [-help or -h]

-d ... dimensions ... dimensions of texture image to create if no input
..................... image is provided; WIDTHxHEIGHT; default=128x128
-n ... newseed ...... seed value to use for random noise generator;
..................... integer>0; default=1
-t ... threshold .... white-threshold percent applied to random noise;
..................... 0<=float<=100; default=2
-b ... blur ......... sigma of 1D Gaussian blur used to create cross-hatch
..................... pattern from the random noise; float>=0; default=9
-w ... widen ........ sigma of 2D blur to apply to noise as a widening
..................... effect; float>=0; default=0 (no widenning)
-s ... spread ....... amount of spread to apply; float>=0; default=0
-g ... gnoise ....... amplitude of additive Gaussian noise added to final
..................... effect; float>=0; default=5
-f ... format ....... format of texture patten; choices are: plain or bump;
..................... default=bump
-m ... mix .......... mix percent of texture with the infile; 0<=float<=100;
..................... default=25; ignored if no infile
-c ... contrast ..... percent contrast increase of image prior to mixing;
..................... float>=0; ignored if no infile

If infile is provided, then -d dimensions will be ignored.

PURPOSE: To create a texture pattern and optionally apply it to the background of an input image

DESCRIPTION: TEXTURIZE creates a noise or cross-hatch texture pattern that can be saved or applied to the background of an image. The cross-hatch pattern is generated from 1D vertical and horizontal blurring of thresholded random noise. The pattern may be widened some or spread to make it more noisy.

ARGUMENTS:

-d dimensions ... DIMENSIONS of texture image to create if no input image is provided. Dimensions are specified as integers WIDTHxHEIGHT. The default=128x128.

-n newseed ... NEWSEED is the seed value to use for the random noise generator. Values are integers>0. The default=1.

-t threshold ... THRESHOLD is the white-threshold percent to apply to the random noise. Values are in the range from 0 to 100. The default=2.

-b blur ... BLUR is the sigma of 1D Gaussian blur used to create the cross-hatch pattern from the random noise. It is applied both vertically and horizontally. Values are floats>=0. The default=9.

-w widen ... WIDEN is the sigma of 2D Gaussian blur used to create a widening effect on the pattern. Values are floats>=0; The default=0.

-s spread ... SPREAD is the amount of the spread effect to apply to the pattern. More spread will dissolve the cross-hatch and create more of a random noise pattern. Values are floats>=0. The default=0.

-g gnoise ... GNOISE is the amplitude of additive Gaussian noise added to the final effect. Values are floats>=0. The default=5.

-f format ... FORMAT is the format of the texture patten. Choices are: plain (p) or bump (b). The default=bump.

-m mix ... MIX is mixing percentage of the texture with the infile. Values are in the range from 0 to 100. The default=25. Mix is ignored, if an infile is not provided.

-c contrast ... CONTRAST is the percent contrast increase of the image prior to mixing. Values are floats>=0. The default=0. Contrast is ignored, if an infile is not provided.

REQUIREMENTS: 1D morphology convolution kernels which probably were introduced at about IM 6.6.2.0

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.