USAGE: shapemorph [-f frames] [-d delay] [-p pause] [-r] [-m] "x1,y1 x2,y2" infile1 infile2 outfile
USAGE: shapemorph [-h or -help]

-f .... frames number of frames in animation; frames>1; default=20
-d .... delay delay between frames; delay>0; default=10
-p .... pause pause delay for two undistorted input images;
...................... pause>0; default=100
-r ................... reverse the animation sequence and append it to the end
-m ................... enable progress monitoring of the generation of each frame
"x1,y1 x2,y2" ........ control point location in infile1 and infile2, respectively;
...................... MUST be specified just prior to infile1 and outfile1 and
...................... enclosed in quotes

PURPOSE: To create a shape morphing animation sequence between two images.

DESCRIPTION: SHAPEMORPH creates a shape morphing animation sequence between two images using one corresponding control point specified from each of the input images. The control point along with the fixed corners actually form 5 control points that are used to fill out X and Y displacement maps (images) that are then used to transform the geometry of each image to the other. The corresponding frames from the transformation of each image are then blended proportional to the progression of frames.

ARGUMENTS:

-f frames ... FRAMES is the total number of frames in the animation (including infile1 and infile2 as the start and end frames. Values are integers > 1. The default is 20.

-d delay ... DELAY between frames. Values are integers>0. The default=10

-p pause ... PAUSE is the delay to use for the first and last frame of the animation, i.e. the delay for each of the input images. The default=100

-r ... If supplied, then reverse the animation sequence, remove the first and last frames of the reversed sequence and append these reversed frames to the end of the animation.

-m ... If supplied, then enable monitoring of -fx as it creates each frame.

"x1,y1 x2,y2" ... The corresponding control point locations in infile1 and infile2 respectively. Only one control point in each image may be used. These coordinates MUST be provided after all the optional arguments and just prior to the declaration of infile1 infile2.

NOTE: Thanks to Anthony Thyssen's improvements, the script has a 10x speed increase for IM version prior to 6.4.3-4 and is now even faster for IM version after 6.4.3-4 due to the use of the new -distort shepards.

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.