ccc195589773147c14fac2dcea186278bcb67a71
[aubio.git] / src / aubio_priv.h
1 /*
2   Copyright (C) 2003-2009 Paul Brossier <piem@aubio.org>
3
4   This file is part of aubio.
5
6   aubio is free software: you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation, either version 3 of the License, or
9   (at your option) any later version.
10
11   aubio is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with aubio.  If not, see <http://www.gnu.org/licenses/>.
18
19 */
20
21 /** @file
22  * Private include file
23  * 
24  * This file is for inclusion from _within_ the library only.
25  */
26
27 #ifndef _AUBIO_PRIV_H
28 #define _AUBIO_PRIV_H
29
30 /*********************
31  *
32  * External includes 
33  *
34  */
35
36 #if 1 //HAVE_CONFIG_H
37 #include "config.h"
38 #endif
39
40 #if HAVE_STDLIB_H
41 #include <stdlib.h>
42 #endif
43
44 #if HAVE_STDIO_H
45 #include <stdio.h>
46 #endif
47
48 /* must be included before fftw3.h */
49 #if HAVE_COMPLEX_H
50 #include <complex.h>
51 #endif
52
53 #if HAVE_FFTW3 || HAVE_FFTW3F
54 #include <fftw3.h>
55 #endif
56
57 #if HAVE_MATH_H
58 #include <math.h>
59 #endif
60
61 #if HAVE_STRING_H
62 #include <string.h>
63 #endif
64
65 #if HAVE_LIMITS_H
66 #include <limits.h> // for CHAR_BIT, in C99 standard
67 #endif
68
69 #include "types.h"
70
71 #define AUBIO_UNSTABLE 1
72
73 #include "mathutils.h"
74
75 /****
76  * 
77  * SYSTEM INTERFACE
78  *
79  */
80
81 /* Memory management */
82 #define AUBIO_MALLOC(_n)             malloc(_n)
83 #define AUBIO_REALLOC(_p,_n)         realloc(_p,_n)
84 #define AUBIO_NEW(_t)                (_t*)calloc(sizeof(_t), 1)
85 #define AUBIO_ARRAY(_t,_n)           (_t*)calloc((_n)*sizeof(_t), 1)
86 #define AUBIO_MEMCPY(_dst,_src,_n)   memcpy(_dst,_src,_n)
87 #define AUBIO_MEMSET(_dst,_src,_t)   memset(_dst,_src,_t)
88 #define AUBIO_FREE(_p)               free(_p)
89
90
91 /* file interface */
92 #define AUBIO_FOPEN(_f,_m)           fopen(_f,_m)
93 #define AUBIO_FCLOSE(_f)             fclose(_f)
94 #define AUBIO_FREAD(_p,_s,_n,_f)     fread(_p,_s,_n,_f)
95 #define AUBIO_FSEEK(_f,_n,_set)      fseek(_f,_n,_set)
96
97 /* strings */
98 #define AUBIO_STRLEN(_s)             strlen(_s)
99 #define AUBIO_STRCMP(_s,_t)          strcmp(_s,_t)
100 #define AUBIO_STRNCMP(_s,_t,_n)      strncmp(_s,_t,_n)
101 #define AUBIO_STRCPY(_dst,_src)      strcpy(_dst,_src)
102 #define AUBIO_STRCHR(_s,_c)          strchr(_s,_c)
103 #ifdef strdup
104 #define AUBIO_STRDUP(s)              strdup(s)
105 #else
106 #define AUBIO_STRDUP(s)              AUBIO_STRCPY(AUBIO_MALLOC(AUBIO_STRLEN(s) + 1), s)
107 #endif
108
109
110 /* Error reporting */
111 typedef enum {
112   AUBIO_OK = 0,
113   AUBIO_FAIL = 1
114 } aubio_status;
115
116 #ifdef HAVE_C99_VARARGS_MACROS
117 #define AUBIO_ERR(...)               fprintf(stderr, "AUBIO ERROR: " __VA_ARGS__)
118 #define AUBIO_MSG(...)               fprintf(stdout, __VA_ARGS__)
119 #define AUBIO_DBG(...)               fprintf(stderr, __VA_ARGS__)
120 #define AUBIO_WRN(...)               fprintf(stderr, "AUBIO WARNING: " __VA_ARGS__)
121 #else
122 #define AUBIO_ERR(format, args...)   fprintf(stderr, "AUBIO ERROR: " format , ##args)
123 #define AUBIO_MSG(format, args...)   fprintf(stdout, format , ##args)
124 #define AUBIO_DBG(format, args...)   fprintf(stderr, format , ##args)
125 #define AUBIO_WRN(format, args...)   fprintf(stderr, "AUBIO WARNING: " format, ##args)
126 #endif
127
128 #define AUBIO_ERROR   AUBIO_ERR
129
130 #define AUBIO_QUIT(_s)               exit(_s)
131 #define AUBIO_SPRINTF                sprintf
132
133 /* Libc shortcuts */
134 #define PI         (M_PI)
135 #define TWO_PI     (PI*2.)
136
137 /* aliases to math.h functions */
138 #if !HAVE_AUBIO_DOUBLE
139 #define EXP        expf
140 #define COS        cosf
141 #define SIN        sinf
142 #define ABS        fabsf
143 #define POW        powf
144 #define SQRT       sqrtf
145 #define LOG10      log10f
146 #define LOG        logf
147 #define FLOOR      floorf
148 #define CEIL       ceilf
149 #define ATAN2      atan2f
150 #else
151 #define EXP        exp
152 #define COS        cos
153 #define SIN        sin
154 #define ABS        fabs
155 #define POW        pow
156 #define SQRT       sqrt
157 #define LOG10      log10
158 #define LOG        log
159 #define FLOOR      floor
160 #define CEIL       ceil
161 #define ATAN2      atan2
162 #endif
163 #define ROUND(x)   FLOOR(x+.5)
164
165 /* aliases to complex.h functions */
166 #if HAVE_AUBIO_DOUBLE || !defined(HAVE_COMPLEX_H) || defined(WIN32)
167 /* mingw32 does not know about c*f functions */
168 #define EXPC      cexp
169 /** complex = CEXPC(complex) */
170 #define CEXPC     cexp
171 /** sample = ARGC(complex) */
172 #define ARGC      carg
173 /** sample = ABSC(complex) norm */
174 #define ABSC      cabs
175 /** sample = REAL(complex) */
176 #define REAL      creal
177 /** sample = IMAG(complex) */
178 #define IMAG      cimag
179 #else
180 /** sample = EXPC(complex) */
181 #define EXPC      cexpf
182 /** complex = CEXPC(complex) */
183 #define CEXPC     cexp
184 /** sample = ARGC(complex) */
185 #define ARGC      cargf
186 /** sample = ABSC(complex) norm */
187 #define ABSC      cabsf
188 /** sample = REAL(complex) */
189 #define REAL      crealf
190 /** sample = IMAG(complex) */
191 #define IMAG      cimagf
192 #endif
193
194 /* handy shortcuts */
195 #define DB2LIN(g) (POW(10.0,(g)*0.05f))
196 #define LIN2DB(v) (20.0*LOG10(v))
197 #define SQR(_a)   (_a*_a)
198
199 #define MAX(a,b)  ( a > b ? a : b)
200 #define MIN(a,b)  ( a < b ? a : b)
201
202 #define ELEM_SWAP(a,b) { register smpl_t t=(a);(a)=(b);(b)=t; }
203
204 #define VERY_SMALL_NUMBER 2.e-42 //1.e-37
205
206 /** if ABS(f) < VERY_SMALL_NUMBER, returns 1, else 0 */
207 #define IS_DENORMAL(f) ABS(f) < VERY_SMALL_NUMBER
208
209 /** if ABS(f) < VERY_SMALL_NUMBER, returns 0., else f */
210 #define KILL_DENORMAL(f)  IS_DENORMAL(f) ? 0. : f
211
212 /** if f > VERY_SMALL_NUMBER, returns f, else returns VERY_SMALL_NUMBER */
213 #define CEIL_DENORMAL(f)  f < VERY_SMALL_NUMBER ? VERY_SMALL_NUMBER : f
214
215 #define SAFE_LOG10(f) LOG10(CEIL_DENORMAL(f))
216 #define SAFE_LOG(f)   LOG(CEIL_DENORMAL(f))
217
218 #define UNUSED __attribute__((unused))
219
220 #endif/*_AUBIO_PRIV_H*/