mlib_imagefouriertransform(3mlib) [opensolaris man page]

mlib_ImageFourierTransform(3MLIB)			    mediaLib Library Functions				 mlib_ImageFourierTransform(3MLIB)

NAME

       mlib_ImageFourierTransform - Fourier transform

SYNOPSIS

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

       mlib_status mlib_ImageFourierTransform(mlib_image *dst,
	    const mlib_image *src, mlib_fourier_mode mode);

DESCRIPTION

       The  mlib_ImageFourierTransform() function performs a two-dimensional Fourier transformation. The source and destination images must be the
       same type and the same size. The data type of the images can be MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT,  or  MLIB_DOUBLE.
       The height and width of the images must be some positive power of 2 (but they do not have to be equal).

       They  can  have	1  or  2 channels. If the source image has just one channel the imaginary parts are assumed to be zero. If the destination
       image has just one channel, then it is assumed that the imaginary parts of the output can be discarded. But in case both source and  desti-
       nation images are one-channel images, then MLIB_FAILURE is returned.

       The predefined modes used in the image Fourier transform function are as follows:

		  Mode				   Description
       ----------------------------------------------------------------------
       MLIB_DFT_SCALE_NONE	     Forward DFT without scaling
       MLIB_DFT_SCALE_MXN	     Forward DFT with scaling of 1/(M*N)
       MLIB_DFT_SCALE_SQRT	     Forward DFT with scaling of 1/sqrt(M*N)
       MLIB_IDFT_SCALE_NONE	     Inverse DFT without scaling
       MLIB_IDFT_SCALE_MXN	     Inverse DFT with scaling of 1/(M*N)
       MLIB_IDFT_SCALE_SQRT	     Inverse DFT with scaling of 1/sqrt(M*N)

PARAMETERS

       The function takes the following arguments:

       dst     Pointer to destination image.

       src     Pointer to source image.

       mode    Mode of the transform.

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

       attributes(5)

SunOS 5.11							    2 Mar 2007					 mlib_ImageFourierTransform(3MLIB)

Check Out this Related Man Page

mlib_ImageBlendColor(3MLIB)				    mediaLib Library Functions				       mlib_ImageBlendColor(3MLIB)

NAME

       mlib_ImageBlendColor - blend an image and a color

SYNOPSIS

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

       mlib_status mlib_ImageBlendColor(mlib_image *dst, const mlib_image *src,
	    const mlib_s32 *color, mlib_s32 cmask);

DESCRIPTION

       The mlib_ImageBlendColor() function blends an image and a color with the alpha channel.

       It uses the following equation:

	 Cd = Cs*As + Cc*(1 - As)
	 Ad = 1.0

       where, Cs and Cd are the RGB color components of the source and destination images, respectively. As and Ad are the alpha components of the
       source and destination images, respectively. Cc is the color component of the constant color.

       For MLIB_BYTE images, the alpha coefficients are in Q8 format. For MLIB_SHORT images, the alpha coefficients are in Q15 format and must	be
       positive.  For  MLIB_USHORT images, the alpha coefficients are in Q16 format. For MLIB_INT images, the alpha coefficients are in Q31 format
       and must be positive.

       The images can have two to four channels. The length of color array must not be less than the number of channels in the images.

PARAMETERS

       The function takes the following arguments:

       dst	Pointer to destination image.

       src	Pointer to source image.

       color	Array of constant color components.

       cmask	Channel mask to indicate the alpha channel. Each bit of cmask represents a channel in the image. The channel corresponding to  the
		highest bit with value 1 is the alpha channel.

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_ImageBlendColor_Inp(3MLIB), mlib_ImageBlendColor_Fp(3MLIB), mlib_ImageBlendColor_Fp_Inp(3MLIB), attributes(5)

SunOS 5.11							    2 Mar 2007					       mlib_ImageBlendColor(3MLIB)

Linux and UNIX Man Pages

mlib_imagefouriertransform(3mlib) [opensolaris man page]

Check Out this Related Man Page