1mlib_ImageFourierTransform(m3eMdLiIaBL)ib Library Funmcltiibo_nIsmageFourierTransform(3MLIB)
2
3
4

NAME

6       mlib_ImageFourierTransform - Fourier transform
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageFourierTransform(mlib_image *dst,
13            const mlib_image *src, mlib_fourier_mode mode);
14
15

DESCRIPTION

17       The  mlib_ImageFourierTransform()  function  performs a two-dimensional
18       Fourier transformation. The source and destination images must  be  the
19       same  type  and  the  same  size.  The  data  type of the images can be
20       MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or  MLIB_DOU‐
21       BLE.  The height and width of the images must be some positive power of
22       2 (but they do not have to be equal).
23
24
25       They can have 1 or 2 channels. If the source image has just one channel
26       the  imaginary  parts  are assumed to be zero. If the destination image
27       has just one channel, then it is assumed that the  imaginary  parts  of
28       the  output  can  be discarded. But in case both source and destination
29       images are one-channel images, then MLIB_FAILURE is returned.
30
31
32       The predefined modes used in the image Fourier transform  function  are
33       as follows:
34
35
36
37
38                  Mode                             Description
39       ──────────────────────────────────────────────────────────────────────
40       MLIB_DFT_SCALE_NONE           Forward DFT without scaling
41       MLIB_DFT_SCALE_MXN            Forward DFT with scaling of 1/(M*N)
42       MLIB_DFT_SCALE_SQRT           Forward DFT with scaling of 1/sqrt(M*N)
43       MLIB_IDFT_SCALE_NONE          Inverse DFT without scaling
44       MLIB_IDFT_SCALE_MXN           Inverse DFT with scaling of 1/(M*N)
45       MLIB_IDFT_SCALE_SQRT          Inverse DFT with scaling of 1/sqrt(M*N)
46
47

PARAMETERS

49       The function takes the following arguments:
50
51       dst     Pointer to destination image.
52
53
54       src     Pointer to source image.
55
56
57       mode    Mode of the transform.
58
59

RETURN VALUES

61       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
62       MLIB_FAILURE.
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │Interface Stability          │Committed                    │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │MT-Level                     │MT-Safe                      │
76       └─────────────────────────────┴─────────────────────────────┘
77

SEE ALSO

79       attributes(5)
80
81
82
83SunOS 5.11                        2 Mar 2007 mlib_ImageFourierTransform(3MLIB)
Impressum