USAGE: ripples [-t type ] [-a amplitude] [-w width] [-o offset] [-r rmin] [-c center] [-p power ] [-s shadeval] infile outfile
USAGE: ripples [-h or -help]

-t .... type ............. type of circular ripple effect; displace (or d), modulate (or m)
.......................... blend (or b); default=displace
-a .... amplitude ........ amplitude or height of displace ripple; integer>=0; default=20
-w .... width ............ width of single ripple; integer>0; default=25
-o .... offset ........... offset or extra spacing between ripples; integer>=0; default=0
-r .... rmin ............. minimum distance from center to first ripple; integer>=0; default=25
-c .... center ........... center point for circular ripples; center=cx,cy; integer>=0
-p .... power ............ power or exponent controlling tapering of ripples; float>=0;
.......................... power=1 is linear taper; default=0 or no taper
-s .... shadeval ......... shading effect; shadeval=AzimuthxElevation angles;
.......................... integers; 0<=azimuth<=360; 0<=elevation<=90; default is no shading;

PURPOSE: To apply various circular ripple effects to an image.

DESCRIPTION: RIPPLES applies various circular ripple effects to an image. The effects are displacement which produces water-like ripples, modulation and blend. The latter are more suited for creating wavy patterns.

ARGUMENTS:

-t type ... TYPE of circular ripple/wave effect. Choices are: displace or (d), modulate (or m) and blend (or b). The displace option produces water-like ripples. The modulate and blend options are better at producing wavy patterns. The default is displace.

-a amplitude ... AMPLITUDE or height of ripple. Values are integers>=0. The default=20. Types of modulate and blend are not sensitive to this parameter.

-w width ... WIDTH is the width or wavelength of a single ripple. Values are integers>0. The default=25.

-r rmin ... RMIN is the spacing from the center to the first ripple. Values are integers>=0. The default=25.

-c center ... CENTER=cx,cy are the comma separated coordinates in the image from where the circular ripples eminate. Values are integers>=0. The default is the center of the image.

-p power ... POWER is the exponent that controls the tapering of the ripples/waves. Values are floats>=0. Power=0 is no taper. Power=1 is linear taper. The default=1

-s shadeval ... SHADEVAL=AZIMUTHxELEVATION are the optional x separated shading angles of azimulth (around) and elevation (up) for the lighting effect. Values are integers, 0<=azimuth<=360 degree and 0<=elevation<=90 degrees. See -shade for more details.

NOTE: Requires IM 6.4.2-8 or higher due to the use of -t distort polar/depolar.

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.