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 calculates 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 consideration 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.