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: