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	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.11							    2 Mar 2007						  mlib_ImageDilate4(3MLIB)