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 destination images are one-channel images, then MLIB_FAILURE is returned.

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

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:

See Also

attributes(5)