matthiasm@27: /*
matthiasm@27:  * Copyright (c) 2003, 2007-11 Matteo Frigo
matthiasm@27:  * Copyright (c) 2003, 2007-11 Massachusetts Institute of Technology
matthiasm@27:  *
matthiasm@27:  * The following statement of license applies *only* to this header file,
matthiasm@27:  * and *not* to the other files distributed with FFTW or derived therefrom:
matthiasm@27:  * 
matthiasm@27:  * Redistribution and use in source and binary forms, with or without
matthiasm@27:  * modification, are permitted provided that the following conditions
matthiasm@27:  * are met:
matthiasm@27:  *
matthiasm@27:  * 1. Redistributions of source code must retain the above copyright
matthiasm@27:  *    notice, this list of conditions and the following disclaimer.
matthiasm@27:  *
matthiasm@27:  * 2. Redistributions in binary form must reproduce the above copyright
matthiasm@27:  *    notice, this list of conditions and the following disclaimer in the
matthiasm@27:  *    documentation and/or other materials provided with the distribution.
matthiasm@27:  *
matthiasm@27:  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
matthiasm@27:  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
matthiasm@27:  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
matthiasm@27:  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
matthiasm@27:  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
matthiasm@27:  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
matthiasm@27:  * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
matthiasm@27:  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
matthiasm@27:  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
matthiasm@27:  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
matthiasm@27:  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
matthiasm@27:  */
matthiasm@27: 
matthiasm@27: /***************************** NOTE TO USERS *********************************
matthiasm@27:  *
matthiasm@27:  *                 THIS IS A HEADER FILE, NOT A MANUAL
matthiasm@27:  *
matthiasm@27:  *    If you want to know how to use FFTW, please read the manual,
matthiasm@27:  *    online at http://www.fftw.org/doc/ and also included with FFTW.
matthiasm@27:  *    For a quick start, see the manual's tutorial section.
matthiasm@27:  *
matthiasm@27:  *   (Reading header files to learn how to use a library is a habit
matthiasm@27:  *    stemming from code lacking a proper manual.  Arguably, it's a
matthiasm@27:  *    *bad* habit in most cases, because header files can contain
matthiasm@27:  *    interfaces that are not part of the public, stable API.)
matthiasm@27:  *
matthiasm@27:  ****************************************************************************/
matthiasm@27: 
matthiasm@27: #ifndef FFTW3_H
matthiasm@27: #define FFTW3_H
matthiasm@27: 
matthiasm@27: #include <stdio.h>
matthiasm@27: 
matthiasm@27: #ifdef __cplusplus
matthiasm@27: extern "C"
matthiasm@27: {
matthiasm@27: #endif /* __cplusplus */
matthiasm@27: 
matthiasm@27: /* If <complex.h> is included, use the C99 complex type.  Otherwise
matthiasm@27:    define a type bit-compatible with C99 complex */
matthiasm@27: #if !defined(FFTW_NO_Complex) && defined(_Complex_I) && defined(complex) && defined(I)
matthiasm@27: #  define FFTW_DEFINE_COMPLEX(R, C) typedef R _Complex C
matthiasm@27: #else
matthiasm@27: #  define FFTW_DEFINE_COMPLEX(R, C) typedef R C[2]
matthiasm@27: #endif
matthiasm@27: 
matthiasm@27: #define FFTW_CONCAT(prefix, name) prefix ## name
matthiasm@27: #define FFTW_MANGLE_DOUBLE(name) FFTW_CONCAT(fftw_, name)
matthiasm@27: #define FFTW_MANGLE_FLOAT(name) FFTW_CONCAT(fftwf_, name)
matthiasm@27: #define FFTW_MANGLE_LONG_DOUBLE(name) FFTW_CONCAT(fftwl_, name)
matthiasm@27: #define FFTW_MANGLE_QUAD(name) FFTW_CONCAT(fftwq_, name)
matthiasm@27: 
matthiasm@27: /* IMPORTANT: for Windows compilers, you should add a line
matthiasm@27:         #define FFTW_DLL
matthiasm@27:    here and in kernel/ifftw.h if you are compiling/using FFTW as a
matthiasm@27:    DLL, in order to do the proper importing/exporting, or
matthiasm@27:    alternatively compile with -DFFTW_DLL or the equivalent
matthiasm@27:    command-line flag.  This is not necessary under MinGW/Cygwin, where
matthiasm@27:    libtool does the imports/exports automatically. */
matthiasm@27: #if defined(FFTW_DLL) && (defined(_WIN32) || defined(__WIN32__))
matthiasm@27:    /* annoying Windows syntax for shared-library declarations */
matthiasm@27: #  if defined(COMPILING_FFTW) /* defined in api.h when compiling FFTW */
matthiasm@27: #    define FFTW_EXTERN extern __declspec(dllexport) 
matthiasm@27: #  else /* user is calling FFTW; import symbol */
matthiasm@27: #    define FFTW_EXTERN extern __declspec(dllimport) 
matthiasm@27: #  endif
matthiasm@27: #else
matthiasm@27: #  define FFTW_EXTERN extern
matthiasm@27: #endif
matthiasm@27: 
matthiasm@27: enum fftw_r2r_kind_do_not_use_me {
matthiasm@27:      FFTW_R2HC=0, FFTW_HC2R=1, FFTW_DHT=2,
matthiasm@27:      FFTW_REDFT00=3, FFTW_REDFT01=4, FFTW_REDFT10=5, FFTW_REDFT11=6,
matthiasm@27:      FFTW_RODFT00=7, FFTW_RODFT01=8, FFTW_RODFT10=9, FFTW_RODFT11=10
matthiasm@27: };
matthiasm@27: 
matthiasm@27: struct fftw_iodim_do_not_use_me {
matthiasm@27:      int n;                     /* dimension size */
matthiasm@27:      int is;			/* input stride */
matthiasm@27:      int os;			/* output stride */
matthiasm@27: };
matthiasm@27: 
matthiasm@27: #include <stddef.h> /* for ptrdiff_t */
matthiasm@27: struct fftw_iodim64_do_not_use_me {
matthiasm@27:      ptrdiff_t n;                     /* dimension size */
matthiasm@27:      ptrdiff_t is;			/* input stride */
matthiasm@27:      ptrdiff_t os;			/* output stride */
matthiasm@27: };
matthiasm@27: 
matthiasm@27: typedef void (*fftw_write_char_func_do_not_use_me)(char c, void *);
matthiasm@27: typedef int (*fftw_read_char_func_do_not_use_me)(void *);
matthiasm@27: 
matthiasm@27: /*
matthiasm@27:   huge second-order macro that defines prototypes for all API
matthiasm@27:   functions.  We expand this macro for each supported precision
matthiasm@27:  
matthiasm@27:   X: name-mangling macro
matthiasm@27:   R: real data type
matthiasm@27:   C: complex data type
matthiasm@27: */
matthiasm@27: 
matthiasm@27: #define FFTW_DEFINE_API(X, R, C)					   \
matthiasm@27: 									   \
matthiasm@27: FFTW_DEFINE_COMPLEX(R, C);						   \
matthiasm@27: 									   \
matthiasm@27: typedef struct X(plan_s) *X(plan);					   \
matthiasm@27: 									   \
matthiasm@27: typedef struct fftw_iodim_do_not_use_me X(iodim);			   \
matthiasm@27: typedef struct fftw_iodim64_do_not_use_me X(iodim64);			   \
matthiasm@27: 									   \
matthiasm@27: typedef enum fftw_r2r_kind_do_not_use_me X(r2r_kind);			   \
matthiasm@27: 									   \
matthiasm@27: typedef fftw_write_char_func_do_not_use_me X(write_char_func);		   \
matthiasm@27: typedef fftw_read_char_func_do_not_use_me X(read_char_func);		   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(execute)(const X(plan) p);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft)(int rank, const int *n,			   \
matthiasm@27: 		    C *in, C *out, int sign, unsigned flags);		   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_1d)(int n, C *in, C *out, int sign,	   \
matthiasm@27: 		       unsigned flags);					   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_2d)(int n0, int n1,			   \
matthiasm@27: 		       C *in, C *out, int sign, unsigned flags);	   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_3d)(int n0, int n1, int n2,		   \
matthiasm@27: 		       C *in, C *out, int sign, unsigned flags);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_many_dft)(int rank, const int *n,		   \
matthiasm@27:                          int howmany,					   \
matthiasm@27:                          C *in, const int *inembed,			   \
matthiasm@27:                          int istride, int idist,			   \
matthiasm@27:                          C *out, const int *onembed,			   \
matthiasm@27:                          int ostride, int odist,			   \
matthiasm@27:                          int sign, unsigned flags);			   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_dft)(int rank, const X(iodim) *dims,	   \
matthiasm@27: 			 int howmany_rank,				   \
matthiasm@27: 			 const X(iodim) *howmany_dims,			   \
matthiasm@27: 			 C *in, C *out,					   \
matthiasm@27: 			 int sign, unsigned flags);			   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_split_dft)(int rank, const X(iodim) *dims, \
matthiasm@27: 			 int howmany_rank,				   \
matthiasm@27: 			 const X(iodim) *howmany_dims,			   \
matthiasm@27: 			 R *ri, R *ii, R *ro, R *io,			   \
matthiasm@27: 			 unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_dft)(int rank,			   \
matthiasm@27:                          const X(iodim64) *dims,			   \
matthiasm@27: 			 int howmany_rank,				   \
matthiasm@27: 			 const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			 C *in, C *out,					   \
matthiasm@27: 			 int sign, unsigned flags);			   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_split_dft)(int rank,			   \
matthiasm@27:                          const X(iodim64) *dims,			   \
matthiasm@27: 			 int howmany_rank,				   \
matthiasm@27: 			 const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			 R *ri, R *ii, R *ro, R *io,			   \
matthiasm@27: 			 unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(execute_dft)(const X(plan) p, C *in, C *out);	   \
matthiasm@27: FFTW_EXTERN void X(execute_split_dft)(const X(plan) p, R *ri, R *ii,	   \
matthiasm@27:                                       R *ro, R *io);			   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_many_dft_r2c)(int rank, const int *n,	   \
matthiasm@27:                              int howmany,				   \
matthiasm@27:                              R *in, const int *inembed,			   \
matthiasm@27:                              int istride, int idist,			   \
matthiasm@27:                              C *out, const int *onembed,		   \
matthiasm@27:                              int ostride, int odist,			   \
matthiasm@27:                              unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_r2c)(int rank, const int *n,		   \
matthiasm@27:                         R *in, C *out, unsigned flags);			   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_r2c_1d)(int n,R *in,C *out,unsigned flags); \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_r2c_2d)(int n0, int n1,			   \
matthiasm@27: 			   R *in, C *out, unsigned flags);		   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_r2c_3d)(int n0, int n1,			   \
matthiasm@27: 			   int n2,					   \
matthiasm@27: 			   R *in, C *out, unsigned flags);		   \
matthiasm@27: 									   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_many_dft_c2r)(int rank, const int *n,	   \
matthiasm@27: 			     int howmany,				   \
matthiasm@27: 			     C *in, const int *inembed,			   \
matthiasm@27: 			     int istride, int idist,			   \
matthiasm@27: 			     R *out, const int *onembed,		   \
matthiasm@27: 			     int ostride, int odist,			   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_c2r)(int rank, const int *n,		   \
matthiasm@27:                         C *in, R *out, unsigned flags);			   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_c2r_1d)(int n,C *in,R *out,unsigned flags); \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_c2r_2d)(int n0, int n1,			   \
matthiasm@27: 			   C *in, R *out, unsigned flags);		   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_dft_c2r_3d)(int n0, int n1,			   \
matthiasm@27: 			   int n2,					   \
matthiasm@27: 			   C *in, R *out, unsigned flags);		   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_dft_r2c)(int rank, const X(iodim) *dims,   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim) *howmany_dims,		   \
matthiasm@27: 			     R *in, C *out,				   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_dft_c2r)(int rank, const X(iodim) *dims,   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim) *howmany_dims,		   \
matthiasm@27: 			     C *in, R *out,				   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_split_dft_r2c)(				   \
matthiasm@27:                              int rank, const X(iodim) *dims,		   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim) *howmany_dims,		   \
matthiasm@27: 			     R *in, R *ro, R *io,			   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_split_dft_c2r)(				   \
matthiasm@27:                              int rank, const X(iodim) *dims,		   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim) *howmany_dims,		   \
matthiasm@27: 			     R *ri, R *ii, R *out,			   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_dft_r2c)(int rank,			   \
matthiasm@27:                              const X(iodim64) *dims,			   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			     R *in, C *out,				   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_dft_c2r)(int rank,			   \
matthiasm@27:                              const X(iodim64) *dims,			   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			     C *in, R *out,				   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_split_dft_r2c)(			   \
matthiasm@27:                              int rank, const X(iodim64) *dims,		   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			     R *in, R *ro, R *io,			   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_split_dft_c2r)(			   \
matthiasm@27:                              int rank, const X(iodim64) *dims,		   \
matthiasm@27: 			     int howmany_rank,				   \
matthiasm@27: 			     const X(iodim64) *howmany_dims,		   \
matthiasm@27: 			     R *ri, R *ii, R *out,			   \
matthiasm@27: 			     unsigned flags);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(execute_dft_r2c)(const X(plan) p, R *in, C *out);	   \
matthiasm@27: FFTW_EXTERN void X(execute_dft_c2r)(const X(plan) p, C *in, R *out);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(execute_split_dft_r2c)(const X(plan) p,		   \
matthiasm@27:                                           R *in, R *ro, R *io);		   \
matthiasm@27: FFTW_EXTERN void X(execute_split_dft_c2r)(const X(plan) p,		   \
matthiasm@27:                                           R *ri, R *ii, R *out);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_many_r2r)(int rank, const int *n,		   \
matthiasm@27:                          int howmany,					   \
matthiasm@27:                          R *in, const int *inembed,			   \
matthiasm@27:                          int istride, int idist,			   \
matthiasm@27:                          R *out, const int *onembed,			   \
matthiasm@27:                          int ostride, int odist,			   \
matthiasm@27:                          const X(r2r_kind) *kind, unsigned flags);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_r2r)(int rank, const int *n, R *in, R *out,	   \
matthiasm@27:                     const X(r2r_kind) *kind, unsigned flags);		   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_r2r_1d)(int n, R *in, R *out,		   \
matthiasm@27:                        X(r2r_kind) kind, unsigned flags);		   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_r2r_2d)(int n0, int n1, R *in, R *out,	   \
matthiasm@27:                        X(r2r_kind) kind0, X(r2r_kind) kind1,		   \
matthiasm@27:                        unsigned flags);					   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_r2r_3d)(int n0, int n1, int n2,		   \
matthiasm@27:                        R *in, R *out, X(r2r_kind) kind0,		   \
matthiasm@27:                        X(r2r_kind) kind1, X(r2r_kind) kind2,		   \
matthiasm@27:                        unsigned flags);					   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru_r2r)(int rank, const X(iodim) *dims,	   \
matthiasm@27:                          int howmany_rank,				   \
matthiasm@27:                          const X(iodim) *howmany_dims,			   \
matthiasm@27:                          R *in, R *out,					   \
matthiasm@27:                          const X(r2r_kind) *kind, unsigned flags);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN X(plan) X(plan_guru64_r2r)(int rank, const X(iodim64) *dims,   \
matthiasm@27:                          int howmany_rank,				   \
matthiasm@27:                          const X(iodim64) *howmany_dims,		   \
matthiasm@27:                          R *in, R *out,					   \
matthiasm@27:                          const X(r2r_kind) *kind, unsigned flags);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(execute_r2r)(const X(plan) p, R *in, R *out);	   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(destroy_plan)(X(plan) p);				   \
matthiasm@27: FFTW_EXTERN void X(forget_wisdom)(void);				   \
matthiasm@27: FFTW_EXTERN void X(cleanup)(void);					   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(set_timelimit)(double t);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(plan_with_nthreads)(int nthreads);			   \
matthiasm@27: FFTW_EXTERN int X(init_threads)(void);					   \
matthiasm@27: FFTW_EXTERN void X(cleanup_threads)(void);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN int X(export_wisdom_to_filename)(const char *filename);	   \
matthiasm@27: FFTW_EXTERN void X(export_wisdom_to_file)(FILE *output_file);		   \
matthiasm@27: FFTW_EXTERN char *X(export_wisdom_to_string)(void);			   \
matthiasm@27: FFTW_EXTERN void X(export_wisdom)(X(write_char_func) write_char,   	   \
matthiasm@27:                                   void *data);				   \
matthiasm@27: FFTW_EXTERN int X(import_system_wisdom)(void);				   \
matthiasm@27: FFTW_EXTERN int X(import_wisdom_from_filename)(const char *filename);	   \
matthiasm@27: FFTW_EXTERN int X(import_wisdom_from_file)(FILE *input_file);		   \
matthiasm@27: FFTW_EXTERN int X(import_wisdom_from_string)(const char *input_string);	   \
matthiasm@27: FFTW_EXTERN int X(import_wisdom)(X(read_char_func) read_char, void *data); \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(fprint_plan)(const X(plan) p, FILE *output_file);	   \
matthiasm@27: FFTW_EXTERN void X(print_plan)(const X(plan) p);			   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void *X(malloc)(size_t n);					   \
matthiasm@27: FFTW_EXTERN R *X(alloc_real)(size_t n);					   \
matthiasm@27: FFTW_EXTERN C *X(alloc_complex)(size_t n);				   \
matthiasm@27: FFTW_EXTERN void X(free)(void *p);					   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN void X(flops)(const X(plan) p,				   \
matthiasm@27:                           double *add, double *mul, double *fmas);	   \
matthiasm@27: FFTW_EXTERN double X(estimate_cost)(const X(plan) p);			   \
matthiasm@27: FFTW_EXTERN double X(cost)(const X(plan) p);				   \
matthiasm@27: 									   \
matthiasm@27: FFTW_EXTERN const char X(version)[];					   \
matthiasm@27: FFTW_EXTERN const char X(cc)[];						   \
matthiasm@27: FFTW_EXTERN const char X(codelet_optim)[];
matthiasm@27: 
matthiasm@27: 
matthiasm@27: /* end of FFTW_DEFINE_API macro */
matthiasm@27: 
matthiasm@27: FFTW_DEFINE_API(FFTW_MANGLE_DOUBLE, double, fftw_complex)
matthiasm@27: FFTW_DEFINE_API(FFTW_MANGLE_FLOAT, float, fftwf_complex)
matthiasm@27: FFTW_DEFINE_API(FFTW_MANGLE_LONG_DOUBLE, long double, fftwl_complex)
matthiasm@27: 
matthiasm@27: /* __float128 (quad precision) is a gcc extension on i386, x86_64, and ia64
matthiasm@27:    for gcc >= 4.6 (compiled in FFTW with --enable-quad-precision) */
matthiasm@27: #if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)) \
matthiasm@27:  && (defined(__i386__) || defined(__x86_64__) || defined(__ia64__))
matthiasm@27: #  if !defined(FFTW_NO_Complex) && defined(_Complex_I) && defined(complex) && defined(I)
matthiasm@27: /* note: __float128 is a typedef, which is not supported with the _Complex
matthiasm@27:          keyword in gcc, so instead we use this ugly __attribute__ version.
matthiasm@27:          However, we can't simply pass the __attribute__ version to
matthiasm@27:          FFTW_DEFINE_API because the __attribute__ confuses gcc in pointer
matthiasm@27:          types.  Hence redefining FFTW_DEFINE_COMPLEX.  Ugh. */
matthiasm@27: #    undef FFTW_DEFINE_COMPLEX
matthiasm@27: #    define FFTW_DEFINE_COMPLEX(R, C) typedef _Complex float __attribute__((mode(TC))) C
matthiasm@27: #  endif
matthiasm@27: FFTW_DEFINE_API(FFTW_MANGLE_QUAD, __float128, fftwq_complex)
matthiasm@27: #endif
matthiasm@27: 
matthiasm@27: #define FFTW_FORWARD (-1)
matthiasm@27: #define FFTW_BACKWARD (+1)
matthiasm@27: 
matthiasm@27: #define FFTW_NO_TIMELIMIT (-1.0)
matthiasm@27: 
matthiasm@27: /* documented flags */
matthiasm@27: #define FFTW_MEASURE (0U)
matthiasm@27: #define FFTW_DESTROY_INPUT (1U << 0)
matthiasm@27: #define FFTW_UNALIGNED (1U << 1)
matthiasm@27: #define FFTW_CONSERVE_MEMORY (1U << 2)
matthiasm@27: #define FFTW_EXHAUSTIVE (1U << 3) /* NO_EXHAUSTIVE is default */
matthiasm@27: #define FFTW_PRESERVE_INPUT (1U << 4) /* cancels FFTW_DESTROY_INPUT */
matthiasm@27: #define FFTW_PATIENT (1U << 5) /* IMPATIENT is default */
matthiasm@27: #define FFTW_ESTIMATE (1U << 6)
matthiasm@27: 
matthiasm@27: /* undocumented beyond-guru flags */
matthiasm@27: #define FFTW_ESTIMATE_PATIENT (1U << 7)
matthiasm@27: #define FFTW_BELIEVE_PCOST (1U << 8)
matthiasm@27: #define FFTW_NO_DFT_R2HC (1U << 9)
matthiasm@27: #define FFTW_NO_NONTHREADED (1U << 10)
matthiasm@27: #define FFTW_NO_BUFFERING (1U << 11)
matthiasm@27: #define FFTW_NO_INDIRECT_OP (1U << 12)
matthiasm@27: #define FFTW_ALLOW_LARGE_GENERIC (1U << 13) /* NO_LARGE_GENERIC is default */
matthiasm@27: #define FFTW_NO_RANK_SPLITS (1U << 14)
matthiasm@27: #define FFTW_NO_VRANK_SPLITS (1U << 15)
matthiasm@27: #define FFTW_NO_VRECURSE (1U << 16)
matthiasm@27: #define FFTW_NO_SIMD (1U << 17)
matthiasm@27: #define FFTW_NO_SLOW (1U << 18)
matthiasm@27: #define FFTW_NO_FIXED_RADIX_LARGE_N (1U << 19)
matthiasm@27: #define FFTW_ALLOW_PRUNING (1U << 20)
matthiasm@27: #define FFTW_WISDOM_ONLY (1U << 21)
matthiasm@27: 
matthiasm@27: #ifdef __cplusplus
matthiasm@27: }  /* extern "C" */
matthiasm@27: #endif /* __cplusplus */
matthiasm@27: 
matthiasm@27: #endif /* FFTW3_H */