USAGE: woodgrain [-p process] [-d dimensions] [-m maincolor] [-g graincolor]
[-t thickness] [-e elongation] [-D densities] [-I intensities] [-c curviness]
[-w wiggles] [-n newseeds] [-a amplify] [-s sharpen] [-r rotation]
[-B brightness] [-S saturation] [-H hue] outfile

USAGE: woodgrain [-help or -h]

-p ... process ....... processing method; choices are 1 or 2; 1 is 1D expand
...................... and 2 is motion blur; default=1
-d ... dimensions .... dimensions of the output image; integers>0;
...................... WIDTHxHEIGHT; default=300x300
-m ... maincolor ..... main (background) color of image; any valid opaque IM
...................... color; default=burlywood
-g ... graincolor .... grain (foreground) color of image; any valid opaque IM
...................... color; default=tan4
-t ... thickness ..... thickness of coarse grain texture; integer>0; default=1
-e ... elongation .... elongation of grain texture; integer>0; default=30
-D ... densities ..... densities for coarse and fine grain textures;
...................... comma separate integers>0; COARSE,FINE densities;
...................... default=50,50
-I ... intensities ... intensities for coarse and fine grain textures;
...................... comma separate integers>0; COARSE,FINE intesities
...................... default=0,1
-c ... curviness ..... curviness of coarse grain texture; integer>=0;
...................... default=5
-w ... wiggles ....... wiggles of coarse grain texture; integer>=0;
...................... default=5
-n ... newseeds ...... new seed values for coarse and fine grain textures;
...................... comma separate integers>0; COARSE,FINE,NOISE texture
...................... seeds; default=100,200,300
-a ... amplify ....... amplification factor for added noise;
...................... float>=0; default=2
-s ... sharpen ....... sharpening of grain textures; integer>=0; default=5
-r ... rotation ...... rotation of texture pattern; 0<=integer<=360;
...................... default=0
-B ... brightness .... brightness factor for output image; integer>=0;
...................... default=100 (nominal value)
-S ... saturation .... saturation factor for output image; integer>=0;
...................... default=100 (nominal value)
-H ... hue ........... hue factor for output image; integer>=0;
...................... default=100 (nominal value)

PURPOSE: To simulate a woodgrain texture.

DESCRIPTION: WOODGRAIN simulates a woodgrain texture. The user may control main (background) and grain (foreground) colors, coarse grain thickness, elongation, density, curviness and other factors. The newseed values allow the grain patterns to change.

ARGUMENTS:

-p process ... PROCESS is the processing method. Choices are 1 or 2. 1 is using 1D expand and 2 is using motion blur. The results are different but comparable. Method 2 is faster, especially when rotations are involved. The default=1

-d dimensions ... DIMENSIONS of the output image. Values are "x" separated integers>0 in the form of WIDTHxHEIGHT (with no spaces). The default=300x300

-m maincolor ... MAIN (background) COLOR of the texture image. Any valid opaque IM color is allowed. The default=burlywood.

-g graincolor ... GRAIN (foreground) COLOR of the texture image. Any valid opaque IM color is allowed. The default=tan4.

-t thickness ... THICKNESS of the coarse grain texture. Values are integers>0. The default=1.

-e elongation ... ELONGATION of grain texture. Values are integers>0. The default=30.

-D densities ... DENSITIES for coarse and fine grain textures. Values are comma separate integers>=0 in the form COARSE,FINE (densities). (with no spaces). The default=50,50. Note a fine density of 0 will disable any fine grain texture.

-I intensities ... INTENSITIES for coarse and fine grain textures. Values are comma separate integers>=0 in the form COARSE,FINE (intensities) (with no spaces). The default=0,1. Note a fine intensity of 0 will disable any fine grain texture.

-c curviness ... CURVINESS of coarse grain texture. Values are integers>=0. The default=5.

-w wiggles ... WIGGLES are the wiggle amount of the coarse grain texture. Values are integers>=0. The default=5.

-n newseeds ... NEWSEEDS are the new seed values for coarse grain, fine grain and noise textures. Values are comma separate integers>=0 in the form COARSE,FINE,NOISE (seeds) (with no spaces). The default=100,200,300. Note that changing these values causes the grain patterns to change. However, using the same value for all three newseeds should be avoided.

-a amplify ... AMPLIFY is the amplification factor for added noise texture. Values are floast>=0. The default=2. Note a value of zero will disable any noise added to the texture.

-s sharpen ... SHARPEN is the sharpening of the grain textures. Values are integers>=0. The default=5.

-r rotation ... ROTATION of the texture pattern. Values are 0<=integer<=360. The default=0.

-B brightness ... BRIGHTNESS factor for the output image. Values are integers>=0. The default=100 (nominal value).

-S saturation ... SATURATION factor for the output image. Values are integers>=0. The default=100 (nominal value).

-H hue ... HUE factor for the output image. Values are integers>=0. The default=100 (nominal value).

NOTE: Results cannot be tiled without special processing.

REFERENCES:
http://www.myinkblog.com/creating-a-realistic-wood-texture-using-photoshop/
http://www.tutorial9.net/tutorials/photoshop-tutorials/custom-wood-texture-in-adobe-photoshop/
http://www.youtube.com/watch?v=_BfQ7IjWt_4
http://www.youtube.com/watch?v=dyaGb6SK7Cw&feature=relmfu
http://www.youtube.com/watch?v=gEkqe6_ZSFk

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.