Manual Pages for UNIX Operating System command usage for man mlib_ImageFourierTransform

mediaLib Library Functions      mlib_ImageFourierTransform(3MLIB)



NAME
     mlib_ImageFourierTransform - Fourier transform

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     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 destina-
     tion 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 dis-
     carded. 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.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions      mlib_ImageFourierTransform(3MLIB)



     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5)































SunOS 5.11           Last change: 2 Mar 2007                    2