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)