
vrotate(1)                   Khoros                    vrotate(1)

PROGRAM
     vrotate - Rotate an image by an arbitrary angle

SYNTAX
     vrotate

     -i             input image

     -o             resulting output image

     [-x]           X coord of center of rotation

     [-y]           Y coord of center of rotation

     [-d]           specifies the clockwise rotation angle in
                    degrees

     [-V]           Gives the version for vrotate

     [-U]           Gives the usage for vrotate

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called vrotate.ans or
                    file1

     [-a [file1]]   Uses vrotate.ans or file1 as the answer file

DESCRIPTION
     vrotate rotates an image by a specfied angle, about a speci-
     fied point. The rotation is performed using bilinear inter-
     polation. Portions of the output image that do not have a
     corresponding pixel in the input image are set to zero.

     The angle is specified in degrees. Positive angles are
     clockwise.

     The center of rotation is can be specified to be anywhere in
     the X-Y plane, even off the image. The default center of
     rotation is the center of the image.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -x     type: integer
            desc: X coord of center of rotation
            default: 0
            bounds: no range checking

     -y     type: integer
            desc: Y coord of center of rotation
            default: 0
            bounds: no range checking

     -d     type: float
            desc: specifies the clockwise rotation angle in
            degrees
            default: 45
            bounds: no range checking

EXAMPLES
     vrotate -i feath.xv -o rotated.xv -d 37.063

     produces a version of "feath.xv" rotated clockwise by 37.063
     degrees.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvrotate(3)
     vresize(1), vwarp(1), vshrink(1), vexpand(1)

RESTRICTIONS
     vrotate does not work on BIT or COMPLEX data types.  vrotate
     does not work on explicit location data.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

