
vtranslat(1)                 Khoros                  vtranslat(1)

PROGRAM
     vtranslat - Translates an image

SYNTAX
     vtranslat

     -i             input image

     -o             resulting output image

     -x             Translation along x axe

     -y             Translation along y axe

     [-w]           if true, wraps the image around, if false
                    pads with a padding value

     [-p]           paddingvalue

     [-V]           Gives the version for vtranslat

     [-U]           Gives the usage for vtranslat

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vtranslat Computes the translation of an image by a vector
     (i,j).

     Includes a Wrap option or a padding value.

     The tranlation is processed in the following manner:
     For each pixel (x,y) of the input image, the algorithm cal-
     culates the transformed coordinates (x+i,y+j) and checks if
     the translated pixel is outside of the output image.

          If the new pixel is inside of the image border, its
          initial value is stored in its new location.

          If the new location does not fit inside of the image, a
          modulo (size of rows and columns) is taken into con-
          sideration to write either the padding value in the
          output image (if wrap flag not selected) or the initial
          value of the pixel (x,y) (if wrap selected).

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: resulting output image

     -x     type: integer
            desc: Translation along x axe

     -y     type: integer
            desc: Translation along y axe

OPTIONAL ARGUMENTS
     -w     type: boolean
            desc: if true, wraps the image around, if false pads
            with a padding value
            default: false

     -p     type: float
            desc: paddingvalue
            default: 0
            bounds: no range checking

EXAMPLES
     LP vtranslat -i image1 -x xt -y yt [-w wflag] [-p pad] -o
     image2
     Translates image1 by a vector (xt,yt) on x and y axes.  The
     image is padded with the padding value, if the wrap flag is
     not selected, otherwise the image is wrapped around.  The
     translated image is stored in image2.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvtranslat(3)
     lvtranslat(3).

RESTRICTIONS
     vtranslat will not operate on Bit data storage types.
     vtranslat does not work on explicit location data.

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

Khoros                    Release: 1.0                          1

