
vreplace(1)                  Khoros                   vreplace(1)

PROGRAM
     vreplace - Replace pixels in an image with pixels from
     another image using a mask.

SYNTAX
     vreplace

     -i1            first input image

     -i2            second input image

     -o             resulting output image

     -m             replace operation masking image

     [-V]           Gives the version for vreplace

     [-U]           Gives the usage for vreplace

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vreplace replaces pixels of the first input image with pix-
     els of the second input image according to a mask image.

     An output pixel receives the value of the first input image
     if the corresponding mask image pixel is zero.  The output
     pixel gets the value of the corresponding pixel in the
     second image if the mask image pixel value is non-zero.

     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

     -m     type: infile
            desc: replace operation masking image

OPTIONAL ARGUMENTS
     none

EXAMPLES
     vreplace -i1 input.image1 -i2 input.image2 -m mask.image -o
     output.image.

     This command replaces pixels in input.image1 with pixels
     from input.image2 selected by the mask image.  The result is
     stored in output.image.

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

RESTRICTIONS
     vreplace will not operate on transform, BIT data storage
     types.

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

Khoros                    Release: 1.0                          1

