mlib_ImageDilate4(3MLIB)				    mediaLib Library Functions					  mlib_ImageDilate4(3MLIB)

NAME

       mlib_ImageDilate4 - four neighbor dilate

SYNOPSIS

       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       mlib_status mlib_ImageDilate4(mlib_image *dst, const mlib_image *src);

DESCRIPTION

       The mlib_ImageDilate4() function performs a dilation operation on an image by using each pixel's four orthogonal neighbors.  The source and
       destination images must be single-channel images.  The data type can be MLIB_BIT, MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, or MLIB_INT.

       For 4-neighbor binary images, it uses the following equation:

       dst[x][y][0] = OR{ src[x][y][0],
			  src[x-1][y][0], src[x+1][y][0],
			  src[x][y-1][0], src[x][y+1][0] }

       For 4-neighbor grayscale images, it uses the following equation:

       dst[x][y][0] = MAX{ src[x][y][0],
			   src[x-1][y][0], src[x+1][y][0],
			   src[x][y-1][0], src[x][y+1][0] }

       where x = 1, ..., w-2; y = 1, ..., h-2.

PARAMETERS

       The function takes the following arguments:

       dst	       Pointer to destination image

       src	       Pointer to source image.

RETURN VALUES

       The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       mlib_ImageDilate4_Fp(3MLIB), mlib_ImageDilate8(3MLIB), mlib_ImageDilate8_Fp(3MLIB), attributes(5)

SunOS 5.10							    10 Nov 2004 					  mlib_ImageDilate4(3MLIB)