% @(#)rotatecloc.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:55 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      rotatecloc.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, ROTATE/CLOCK
%.PURPOSE    On-line help file for the command: ROTATE/CLOCK
%.VERSION    1.0  11-DEC-1984 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./CLOC
\es\co
ROTATE/CLOCK						11-DEC-1984  KB
\oc\su
ROTATE/CLOCK in out [factor]
	rotate an image by multiples of 90 degrees clockwise
\us\pu
Purpose:  
           Rotate an image by multiples of 90 degrees clockwise.
\up\sy
Syntax:  
           ROTATE/CLOCK in out [factor]
\ys\pa
           in = input frame (2-dim image)
\ap\pa
           out = output frame (will be created by this command)
\ap\pa
           factor = 1, 2 or 3 for 90, 180 or 270 degrees rotation;
\\
               defaulted to 1, i.e. 90 degrees
\ap\no
Note:
           This command is not a rotation around a given point but strictly
           speaking just a rearrangement of the image pixels. Values for start
           and stepsize of result frame are adjusted accordingly.
\\
           Using REBIN/ROTATE with a rotation angle of -90.0 degrees will yield
           the same data in the result frame as ROTATE/CLOCK, but start and
           stepsize will be different!
\on\sa
See also:
           ROTATE/COUNTER_CLOCK, REBIN/ROTATE
\as\exs
Examples:
\ex
           ROTATE/CLOCK paloma blanca 
           rotate image paloma.bdf by 90 degrees clockwise and store result
           into frame blanca.bdf
\xe \sxe