USAGE: emboss [-m method] [-a azimuth] [-e elevation] [-d depth] [-i intensity] [-c compose] infile outfile
USAGE: emboss [-h or -help]

-m .... method .......... method of embossing; choices are 1 or 2;
......................... 1 simulates the GIMP approach;
......................... 2 simulates the Photoshop approach; default=1
-a .... azimuth ......... azimuth angle for light source; 0<=integer<=360;
......................... counterclockwise from positive x axis (East);
......................... default=135 (NorthWest)
-e .... elevation ....... elevation angle for light source; 0<=integer<=90;
......................... upwards from x-y plane; default=45; only for method=1
-d .... depth ........... depth of emboss effect; integer>0; default=1
-i .... intensity ....... intensity of emboss effect; -50<=integer<=50;
......................... default=0; only for method=2
-c .... compose ......... compose method to use to composite emboss result
......................... with input image. The default is no composite.
-g .... gray ............ desired base graylevel for method=1; 0<float<1;
......................... default is no adjustment from normal shading

PURPOSE: To apply an emboss effect to an image.

DESCRIPTION: EMBOSS applies an emboss effect to an image. Two methods are available. The first simulates the GIMP approach. The second simulates the Photoshop approach.

ARGUMENTS:

-m method ... METHOD of embossing. The choices are 1 or 2. Method 1 simulates the GIMP approach and uses parameters of azimuth, elevation and depth. The second simulates the Photoshop approach and uses parameters of azimuth, depth and intensity. The default=1.

-a azimuth ... AZIMUTH is the angle in degrees in the x-y plane measured counterclockwise from EAST to the light source. Values are integers in the range 0<=azimuth<=360. The default=135 (NorthWest).

-e elevation ... ELEVATION is the angle in degrees upwards from the x-y plane to the light source. Values are integers in the range 0<=elevation<=90. The default=45. Note this parameter is only used with method=1

-d depth ... DEPTH controls the depth effect in the embossing. For method=1, it adjust the contrast of the emboss effect. For method=2, it adjust the separation in pixels of the dark and light parts. Values are integers>0. The default=1

-i intensity ... INTENSITY controls the contrast of the emboss effect in method=2. Values are integers in the range of -50<=intensity<=50. Positive values increase the contrast and negative values decrease the contrast. The default=0

-c compose ... COMPOSE method to use to composite emboss result with input image. Valid compose methods include: bumpmap, multiply, color_burn, color_dodge, linear_burn, linear_dodge, linear_light, hard_light, soft_light, pegtop_light, pin_light, vivid_light, overlay. The default is no composite.

-g gray ... GRAY is the desired base graylevel for method=1. Values are 0<float<1. The default is no adjustment from the normal shading base level which gets brighter as the elevation angle increases according to the sin(elevation). Nominal value for elevation=45 is gray=.707

REQUIREMENTS: IM 6.5.3-4 in order to support -set option:compose:args in method 2 and IM 6.4.8-8 in order to support -function polynomial in method 1.

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.