Help for ROTATE2

PURPOSE:

ROTATE2 will compute the geometric transformation parameters for rotating a 
picture by any amount about a specified point.

OPERATION:

ROTATE2 cannot called directly by the user since the rotate2 program is
used only to create a parameter data set for input to LGEOM. The parameter
data set's name is given by the PDS parameter. The parameter data
set has a vicar label of 1 line by 512 bytes.

Rotate2 is normally called by the procedure ROTATE which uses the 
parameter data set as an input to LGEOM which does the rotation.

The rotation is about an axis normal to the picture and intersecting it at
the specified pixel center of rotation.

The size field should take into account any increase in the number 
of lines and samples due to the rotation.

EXECUTION:

   For the typical usage, see the HELP for procedure ROTATE.

   The following is the execution statement format for ROTATE2:
        rotate2 inp  params
   where INP,  and PARAMS    are parameters discussed in their
   respective sections.

EXAMPLES:

1) rotate2 IN par size=(1,1,100,160) line=15. samp=35. angl=24.2
----This example will set up to rotate the 100x160 sample file by 24.2 degrees
    about the pixel at line 15 and sample 35.

2) rotate2 IN par size=(1,1,100,160) angl=24.2
----This example does the same but about the center of the picture.

3) rotate2 IN par angl=-1. center=(50.,30.)
----This example will set up to  rotate IN by -1. degrees about its center and
    translate the rotated picture so that the center of rotation in the 
    output occupies line 50, sample 30.
 LIMITATIONS:

  1. The input file must be either BYTE or HALFWORD.

 ORIGINAL PROGRAMMER:    A. R. Gillespie, 25 Jul 1972
 COGNIZANT PROGRAMMER:  Ray Bambery                  
 PORTED TO UNIX: Steve Pohorsky

 REVISION HISTORY
  1993-06-08 SP  Made portable for UNIX.
  2011-04-10 RJB Changed qprint call to xvmessage due to message: 
        [TAE-PRCSTRM] Abnormal process termination; process status code = 11.;
  2013-01-09 LWK Fixed OUT1/OUT2 assignments due to different behaviour
                 with the -e compiler flag on Solaris
  2013-09-02 RJB Update documentation and test procedure.
  2015-12-16 WLB Merged LWK's and RJB's changes. Migrated to MIPL.


PARAMETERS:


INP

The data file to be rotated.

PDS

The output parameter data set.

SIZE

The area to be rotated.

SL

The starting line of the size field.

SS

The starting sample of the size field.

NL

The number of lines in the size field.

NS

The number of samples in the size field.

ANGLE

Amount of rotation in degrees.

LINE

The line number of the center of rotation.

SAMPLE

The sample of the center of rotation.

CENTER

The location of the output center of rotation.

NOINTERP

Indicates no interpolation.

See Examples:


Cognizant Programmer: