opensolaris man page for mlib_imageconvkernelconvert

mlib_ImageConvKernelConvert(3MLIB)			    mediaLib Library Functions				mlib_ImageConvKernelConvert(3MLIB)

NAME
       mlib_ImageConvKernelConvert - convolution kernel conversion

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

       mlib_status mlib_ImageConvKernelConvert(mlib_s32 *ikernel, mlib_s32 *iscale,
	    const mlib_d64 *fkernel, mlib_s32 m, mlib_s32 n, mlib_type type);

DESCRIPTION
       The  mlib_ImageConvKernelConvert() function converts a floating-point convolution kernel to an integer kernel with its scaling factor suit-
       able to be used in convolution functions.

PARAMETERS
       The function takes the following arguments:

       ikernel	  Pointer to integer convolution kernel, in row major order.

       iscale	  Pointer to scaling factor of the integer convolution kernel.

       fkernel	  Pointer to floating-point convolution kernel, in row major order.

       m	  Width of the convolution kernel. m >= 1.

       n	  Height of the convolution kernel. n >= 1.

       type	  The image type. It can be one of the following:

		    MLIB_BIT
		    MLIB_BYTE
		    MLIB_SHORT
		    MLIB_USHORT
		    MLIB_INT

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_ImageConv2x2(3MLIB),     mlib_ImageConv2x2_Fp(3MLIB),     mlib_ImageConv2x2Index(3MLIB),	 mlib_ImageConv3x3(3MLIB),     mlib_Image-
       Conv3x3_Fp(3MLIB),  mlib_ImageConv3x3Index(3MLIB),  mlib_ImageConv4x4(3MLIB),  mlib_ImageConv4x4_Fp(3MLIB),  mlib_ImageConv4x4Index(3MLIB),
       mlib_ImageConv5x5(3MLIB),     mlib_ImageConv5x5_Fp(3MLIB),     mlib_ImageConv5x5Index(3MLIB),	 mlib_ImageConv7x7(3MLIB),     mlib_Image-
       Conv7x7_Fp(3MLIB),  mlib_ImageConv7x7Index(3MLIB),  mlib_ImageConvMxN(3MLIB),  mlib_ImageConvMxN_Fp(3MLIB),  mlib_ImageConvMxNIndex(3MLIB),
       mlib_ImageConvolveMxN(3MLIB),	   mlib_ImageConvolveMxN_Fp(3MLIB),	   mlib_ImageSConv3x3(3MLIB),	     mlib_ImageSConv3x3_Fp(3MLIB),
       mlib_ImageSConv5x5(3MLIB), mlib_ImageSConv5x5_Fp(3MLIB), mlib_ImageSConv7x7(3MLIB), mlib_ImageSConv7x7_Fp(3MLIB), mlib_ImageSConvKernelCon-
       vert(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					mlib_ImageConvKernelConvert(3MLIB)