MMACH (lmmach) functions
LIBRARY ROUTINE
lvscanon - Do the n-canonical transformation of an image, with an operation gating mask.
LIBRARY CALL
int
lvncanon(xvimage *img1, mat_str *b1, mat_str *b2, int r, xvimage *img2, int mflg, unsigned long border, xvimage *img3)
INPUT
none
OUTPUT
none
RETURN VALUE
TRUE (1) on success, FALSE (0) on failure
DESCRIPTION
lvncanon
will do the n-canonical transformation of an image by two set structuring elements.
img1, b1 and b2 are, respectively, the input image and the structuring elements; r is the struct. el. rotation step. img2 is the gating image, and mflg should be set to 1 if the gating image is to be used. img3 is the output image.
A non-zero mask pixel in img2 enables the output pixel to contain
the n-canonical transformation. A zero mask pixel in img2 just transfers the value
of the corresponding pixel in img1 to the output pixel.
The input and mask images must be of the same size, data type, and have
the same number of data bands.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
lvncanon
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.
The structuring elements are subsets of the 3x3 matrix and the origin is always at the center of this matrix.
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
none
FILES
$MMACH/objects/library/lmmach/src/lvscanon.c
SEE ALSO
lmmach(3)
COPYRIGHT
Copyright (C) 1993-1997 Junior Barrera, Roberto Lotufo. All rights reserved.