mlib_imagegradient3x3_fp(3mlib) [sunos man page]

mlib_ImageGradient3x3_Fp(3MLIB) 			    mediaLib Library Functions				   mlib_ImageGradient3x3_Fp(3MLIB)

NAME

       mlib_ImageGradient3x3_Fp - 3x3 gradient filter

SYNOPSIS

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

       mlib_status  mlib_ImageGradient3x3_Fp(mlib_image *dst, const mlib_image *src, const mlib_d64 *hmask, const mlib_d64 *vmask, mlib_s32 cmask,
       mlib_edge edge);

DESCRIPTION

       The mlib_ImageGradient3x3_Fp() function performs floating-point edge detection by computing the magnitude of the image gradient	vector	in
       two orthogonal directions using 3x3 gradient filtering.

       It uses the following equation:

       dst[x][y][i] = ( SH(x,y,i)**2 + SV(x,y,i)**2 )**0.5

       where  SH() and SV() are the horizontal and vertical gradient images generated from the corresponding channel of the source image by corre-
       lating it with the supplied orthogonal (horizontal and vertical) gradient masks.

PARAMETERS

       The function takes the following arguments:

       dst	       Pointer to destination image.

       src	       Pointer to source image.

       hmask	       Pointer to horizontal mask in row-major order.

       vmask	       Pointer to vertical mask in row-major order.

       cmask	       Channel mask to indicate the channels to be convolved, each bit of which represents a channel in the  image.  The  channels
		       corresponding to 1 bits are those to be processed.  For a single channel image, the channel mask is ignored.

       edge	       Type of edge condition. It can be one of the following:

		       MLIB_EDGE_DST_NO_WRITE
		       MLIB_EDGE_DS_FILL_ZERO
		       MLIB_EDGE_DST_COPY_SRC
		       MLIB_EDGE_SR_EXTEND

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_ImageGradient3x3(3MLIB), mlib_ImageGradientMxN(3MLIB), mlib_ImageGradientMxN_Fp(3MLIB), attributes(5)

SunOS 5.10							    10 Nov 2004 				   mlib_ImageGradient3x3_Fp(3MLIB)

Check Out this Related Man Page

mlib_ImageSobel(3MLIB)					    mediaLib Library Functions					    mlib_ImageSobel(3MLIB)

NAME

       mlib_ImageSobel, mlib_ImageSobel_Fp - Sobel filter

SYNOPSIS

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

       mlib_status mlib_ImageSobel(mlib_image *dst, const mlib_image *src, mlib_s32 cmask, mlib_edge edge);

       mlib_status mlib_ImageSobel_Fp(mlib_image *dst, const mlib_image *src, mlib_s32 cmask, mlib_edge edge);

DESCRIPTION

       Each function is a special case of the gradient filter, which is an edge detector which computes the magnitude of the image gradient vector
       in two orthogonal directions. In this case, the gradient filter uses specific horizontal and vertical masks.

       The Sobel filter is one of the special cases of gradient filter using the following horizontal and vertical masks:

       hmask =	{ -1.0, 0.0, 1.0,
		  -2.0, 0.0, 2.0,
		  -1.0, 0.0, 1.0 }

       vmask =	{ -1.0, -2.0, -1.0,
		   0.0,  0.0,  0.0,
		   1.0,  2.0,  1.0 }

PARAMETERS

       Each function takes the following arguments:

       dst	       Pointer to destination image.

       src	       Pointer to source image.

       cmask	       Channel mask to indicate the channels to be processed, each bit of which represents a channel in the  image.  The  channels
		       corresponding to 1 bits are those to be processed.  For a single channel image, the channel mask is ignored.

       edge	       Type of edge condition. It can be one of the following:

		       MLIB_EDGE_DST_NO_WRITE
		       MLIB_EDGE_DS_FILL_ZERO
		       MLIB_EDGE_DST_COPY_SRC
		       MLIB_EDGE_SR_EXTEND

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_ImageGradient3x3(3MLIB), mlib_ImageGradient3x3_Fp(3MLIB), attributes(5)

SunOS 5.10							    10 Nov 2004 					    mlib_ImageSobel(3MLIB)

Linux and UNIX Man Pages

mlib_imagegradient3x3_fp(3mlib) [sunos man page]

Check Out this Related Man Page