annotate libaf/filter.h @ 25986:0d369275fb20

Make -af-pre, -af-add, -af-del and -af-clr available. For this -af-adv must be moved below af* to match first.
author reimar
date Sun, 17 Feb 2008 15:14:54 +0000
parents 3baf6a2283da
children 4129c8cfa742
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
1 /*=============================================================================
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
2 //
13602
14090f7300a8 The full name of the GPL is GNU General Public License.
diego
parents: 8957
diff changeset
3 // This software has been released under the terms of the GNU General Public
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
4 // license. See http://www.gnu.org/copyleft/gpl.html for details.
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
5 //
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
6 // Copyright 2001 Anders Johansson ajh@atri.curtin.edu.au
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
7 //
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
8 //=============================================================================
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
9 */
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
10
23689
3f0d00abc073 Do not use leading underscores in multiple inclusion guards, they are reserved.
diego
parents: 14275
diff changeset
11 #if !defined DSP_H
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
12 # error "Never use <filter.h> directly; include <dsp.h> instead"
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
13 #endif
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
14
23689
3f0d00abc073 Do not use leading underscores in multiple inclusion guards, they are reserved.
diego
parents: 14275
diff changeset
15 #ifndef FILTER_H
3f0d00abc073 Do not use leading underscores in multiple inclusion guards, they are reserved.
diego
parents: 14275
diff changeset
16 #define FILTER_H
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
17
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
18
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
19 // Design and implementation of different types of digital filters
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
20
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
21
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
22 // Flags used for filter design
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
23
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
24 // Filter characteristics
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
25 #define LP 0x00010000 // Low pass
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
26 #define HP 0x00020000 // High pass
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
27 #define BP 0x00040000 // Band pass
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
28 #define BS 0x00080000 // Band stop
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
29 #define TYPE_MASK 0x000F0000
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
30
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
31 // Window types
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
32 #define BOXCAR 0x00000001
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
33 #define TRIANG 0x00000002
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
34 #define HAMMING 0x00000004
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
35 #define HANNING 0x00000008
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
36 #define BLACKMAN 0x00000010
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
37 #define FLATTOP 0x00000011
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
38 #define KAISER 0x00000012
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
39 #define WINDOW_MASK 0x0000001F
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
40
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
41 // Parallel filter design
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
42 #define FWD 0x00000001 // Forward indexing of polyphase filter
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
43 #define REW 0x00000002 // Reverse indexing of polyphase filter
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
44 #define ODD 0x00000010 // Make filter HP
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
45
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
46 // Exported functions
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
47 extern _ftype_t af_filter_fir(unsigned int n, _ftype_t* w, _ftype_t* x);
8832
a1578b329cc0 Adding sub-woofer filter, use this filter to add a sub channel to the audio stream
anders
parents: 7568
diff changeset
48
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
49 extern _ftype_t* af_filter_pfir(unsigned int n, unsigned int k, unsigned int xi, _ftype_t** w, _ftype_t** x, _ftype_t* y, unsigned int s);
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
50
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
51 //extern int af_filter_updateq(unsigned int n, unsigned int xi, _ftype_t* xq, _ftype_t* in);
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
52 extern int af_filter_updatepq(unsigned int n, unsigned int k, unsigned int xi, _ftype_t** xq, _ftype_t* in, unsigned int s);
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
53
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
54 extern int af_filter_design_fir(unsigned int n, _ftype_t* w, _ftype_t* fc, unsigned int flags, _ftype_t opt);
8832
a1578b329cc0 Adding sub-woofer filter, use this filter to add a sub channel to the audio stream
anders
parents: 7568
diff changeset
55
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
56 extern int af_filter_design_pfir(unsigned int n, unsigned int k, _ftype_t* w, _ftype_t** pw, _ftype_t g, unsigned int flags);
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
57
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
58 extern int af_filter_szxform(_ftype_t* a, _ftype_t* b, _ftype_t Q, _ftype_t fc, _ftype_t fs, _ftype_t *k, _ftype_t *coef);
8832
a1578b329cc0 Adding sub-woofer filter, use this filter to add a sub channel to the audio stream
anders
parents: 7568
diff changeset
59
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
60 /* Add new data to circular queue designed to be used with a FIR
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
61 filter. xq is the circular queue, in pointing at the new sample, xi
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
62 current index for xq and n the length of the filter. xq must be n*2
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
63 long.
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
64 */
14275
de13fd557440 less namespace pollution #2 (prefixed globals in filter.c with af_filter_)
alex
parents: 13602
diff changeset
65 #define af_filter_updateq(n,xi,xq,in)\
8957
36a5cdca733b bunkus: Encapsulated arguments to #define in ( ... ) so that the #defines can be safely used like functions: mydef(flag ? val1 : val2)
mosu
parents: 8832
diff changeset
66 xq[xi]=(xq)[(xi)+(n)]=*(in);\
36a5cdca733b bunkus: Encapsulated arguments to #define in ( ... ) so that the #defines can be safely used like functions: mydef(flag ? val1 : val2)
mosu
parents: 8832
diff changeset
67 xi=(++(xi))&((n)-1);
7568
d08513b9fed6 Adding new audio output filter layer libaf
anders
parents:
diff changeset
68
25535
3baf6a2283da Add explanatory comments to the #endif part of multiple inclusion guards.
diego
parents: 23689
diff changeset
69 #endif /* FILTER_H */