MMACH (lmmach) functions


LIBRARY ROUTINE

lvunion - Do the supremum of two images pixel by pixel with an operation gating mask.

LIBRARY CALL

int
lvsup(xvimage *img1, xvimage *img2, int img2_flg, int c, xvimage *img3, int mflg, xvimage *img4)

INPUT

none

OUTPUT

none

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

vsup will do the supremum of two images pixel by pixel. img1 and img2 are the input images; img3 is the gating image, and mflg should be set to 1 if the gating image is to be used. img4 is the output image. Note that img1 or img2 can be used for both the input and the resulting output xvimage structure, in order to save space. An optional parameter (that will represent a constant image) can be entered instead of img2. A non-zero mask pixel in img3 enables the output pixel to contain the supremum. A zero mask pixel in img3 just transfers the value of the corresponding pixel in img1 to the output pixel.

The two input images must have the same size, data type and number of data bands, as must the optional mask and output images.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

lvsup can be defined for all data types supported by Khoros, but at the moment it has been implemented just for the bit and unsigned char types.

Due to the simultaneous processing of 32 pixels in BIT images, input images of the BIT data type must be converted to a special data structure before the library is called. This can be accomplished by using the format routine. After the library call, the unformat routine can convert the image back to the BIT data type.

MODIFICATION

Port to new toolbox version and constant image option added by Adriano Nagelschmidt Rodrigues & Luiz Fernando Vieira

FILES

$MMACH/objects/library/lmmach/src/lvunion.c

SEE ALSO

lmmach(3)

COPYRIGHT

Copyright (C) 1993-1997 Junior Barrera, Roberto Lotufo. All rights reserved.