
vpad(1)                      Khoros                       vpad(1)

PROGRAM
     vpad - pads a data sequence with a constant.

SYNTAX
     vpad

     -i             input data file (xviff file)

     -o             resulting output file (xviff file)

     [-r]           number of rows in the image to be generated

     [-c]           number of columns in the image to be gen-
                    erated

     [-d]           row offset of image

     [-e]           column offset of image

     [-j]           real part of pad constant

     [-k]           imaginary part of pad constant

     [-V]           Gives the version for vpad

     [-U]           Gives the usage for vpad

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     performs the padding of a data sequence.  Specifying an
     offset other than zero generates a border around the origi-
     nal image.  If the input image type is not complex, the ima-
     ginary pad value will be ignored.  For byte images, pad
     values greater than 255 will be reduced to 255.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input data file (xviff file)

     -o     type: outfile
            desc: resulting output file (xviff file)

OPTIONAL ARGUMENTS
     -r     type: integer
            desc: number of rows in the image to be generated
            default: 512
            bounds: value > 0

     -c     type: integer
            desc: number of columns in the image to be generated
            default: 512
            bounds: value > 0

     -d     type: integer
            desc: row offset of image
            default: 0
            bounds: value >= 0

     -e     type: integer
            desc: column offset of image
            default: 0
            bounds: value >= 0

     -j     type: float
            desc: real part of pad constant
            default: 0
            bounds: no range checking

     -k     type: float
            desc: imaginary part of pad constant
            default: 0
            bounds: no range checking

EXAMPLES
     vpad -i input_file -o output_file

     vpad -i input_file -o output_file -r 512 -c 256 -k 200

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

RESTRICTIONS
     will not operate on transformed or BIT type images.

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

Khoros                    Release: 1.0                          1

