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 pixels 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.