mediaLib Library Functions      mlibImageFourierTransform(3MLIB)



NAME
     mlibImageFourierTransform - Fourier transform

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

     mlibstatus mlibImageFourierTransform(mlibimage *dst,
          const mlibimage *src, mlibfouriermode mode);


DESCRIPTION
     The mlibImageFourierTransform() 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  MLIBYTE, MLIBSHORT,
     MLIBUSHORT,  MLIBINT,  MLIBFLOAT,  or  MLIBDOUBLE.   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 MLIBFAILURE is returned.


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



                Mode                             Description
     
     MLIBDFTSCALENONE           Forward DFT without scaling
     MLIBDFTSCALEMXN            Forward DFT with scaling of 1/(M*N)
     MLIBDFTSCALESQRT           Forward DFT with scaling of 1/sqrt(M*N)
     MLIBIDFTSCALENONE          Inverse DFT without scaling
     MLIBIDFTSCALEMXN           Inverse DFT with scaling of 1/(M*N)
     MLIBIDFTSCALESQRT          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      mlibImageFourierTransform(3MLIB)



     mode    Mode of the transform.


RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     attributes(5)































SunOS 5.11           Last change: 2 Mar 2007                    2