
vadd(1)                      Khoros                       vadd(1)

PROGRAM
     vadd - Adds two images pixel by pixel.

SYNTAX
     vadd

     -i1            first input image

     -i2            second input image

     -o             resulting output image

     [-m]           add operation masking image

     [-V]           Gives the version for vadd

     [-U]           Gives the usage for vadd

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vadd will add two input images pixel by pixel.  The optional
     input mask image is used to gate the operation.

     A non-zero mask pixel enables the output pixel to contain
     the sum. A zero mask pixel just transfers the value of the
     corresponding pixel in the first input image to the output
     pixel.

     The two input images must be of the same size and have the
     same number of data bands, as must the optional mask image.
     The input images may be of the same or different data types.
     If the input images are of different data types, then all
     input images will be upcast to the highest input image data
     type.  The output image data type will be the same as that
     of the highest data type of the input images.

REQUIRED ARGUMENTS
     -i1    type: infile
            desc: first input image

     -i2    type: infile
            desc: second input image

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS
     -m     type: infile
            desc: add operation masking image

EXAMPLES
     vadd -i1 ball.xv -i2 ball.xv -o outimage.xv

     Will add image 1 "ball.xv" and image 2 "ball.xv" with the
     resulting image written to "outimage.xv".

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

RESTRICTIONS
     vadd will not operate on BIT data storage types.

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

Khoros                    Release: 1.0                          1

