
vblend(1)                    Khoros                     vblend(1)

PROGRAM
     vblend - Blend two images using  X*image1 + (1-X)*image2
     where X is the blend ratio.

SYNTAX
     vblend

     -i1            input image 1

     -i2            input image 2

     -o             resulting output image

     [-m]           blend mask image
                                        -OR-

     [-x]           Blending ratio

     [-V]           Gives the version for vblend

     [-U]           Gives the usage for vblend

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     vblend forms a blend of two images by adding X*(image1)+(1-
     X)*(image2).  The two input images must be single band
     images of the same size.  The two input images may be of the
     same or different data types.  If the input images are of
     different data types, then both 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.

     The optional blending mask image should be of type FLOAT.
     If it is not of type FLOAT, then lvconvert is called to
     upcast the mask image to data type FLOAT.  The blending mask
     image must have the same number of rows and columns as the
     -i1 and -i2 images. At each pixel, the value X in the above
     expression is obtained from the corresponding pixel in the
     blend mask image.

     If both a blend mask image and a blend ratio are specified
     on a command line, then the blend mask image is dominant,
     and the ratio is ignored.

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

     -i2    type: infile
            desc: input image 2

     -o     type: outfile
            desc: resulting output image

OPTIONAL ARGUMENTS

     ***   These arguments are MUTUALLY EXCLUSIVE   ***
      If desired, you may provide ONE AND ONLY ONE of:

     -m     desc: blend mask image

     -x     desc: Blending ratio
            default: 0.5
            bounds: 0.000000 < [-x] < 1.000000

            ********

EXAMPLES
     vblend -i1 input.image1 -i2 input.image2 -o output.image -x
     .5

     This command blends the pixel values in input.image1 with
     those in input.image2 and store the result in output.image.
     The formula used in this case is (.5*pixel value 1) +
     (.5*pixel value 2).

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

RESTRICTIONS
     vblend does not work on VFF_TYP_DOUBLE and multi band
     images.

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

Khoros                    Release: 1.0                          1

