mlib_ImageFourierTransformmediaLib Library Fumlib_ImageFourierTransform(3MLIB)NAMEmlib_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_DOU‐
BLE. 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 destination
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 ALSOattributes(5)SunOS 5.10 2 Mar 2007 mlib_ImageFourierTransform(3MLIB)