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.