12 #define LOWPASSFREQREF (5000.0f)
13 #define HIGHPASSFREQREF (250.0f)
16 /* Filters implementation is based on the "Cookbook formulae for audio
17 * EQ biquad filter coefficients" by Robert Bristow-Johnson
18 * http://www.musicdsp.org/files/Audio-EQ-Cookbook.txt
20 /* Implementation note: For the shelf filters, the specified gain is for the
21 * reference frequency, which is the centerpoint of the transition band. This
22 * better matches EFX filter design. To set the gain for the shelf itself, use
23 * the square root of the desired linear gain (or halve the dB gain).
26 typedef enum ALfilterType
{
27 /** EFX-style low-pass filter, specifying a gain and reference frequency. */
28 ALfilterType_HighShelf
,
29 /** EFX-style high-pass filter, specifying a gain and reference frequency. */
30 ALfilterType_LowShelf
,
31 /** Peaking filter, specifying a gain and reference frequency. */
34 /** Low-pass cut-off filter, specifying a cut-off frequency. */
36 /** High-pass cut-off filter, specifying a cut-off frequency. */
37 ALfilterType_HighPass
,
38 /** Band-pass filter, specifying a center frequency. */
39 ALfilterType_BandPass
,
42 typedef struct ALfilterState
{
43 ALfloat x
[2]; /* History of two last input samples */
44 ALfloat y
[2]; /* History of two last output samples */
45 ALfloat a1
, a2
; /* Transfer function coefficients "a" (a0 is pre-applied) */
46 ALfloat b0
, b1
, b2
; /* Transfer function coefficients "b" */
48 void (*process
)(struct ALfilterState
*self
, ALfloat
*restrict dst
, const ALfloat
*restrict src
, ALuint numsamples
);
50 #define ALfilterState_process(a, ...) ((a)->process((a), __VA_ARGS__))
52 /* Calculates the rcpQ (i.e. 1/Q) coefficient for shelving filters, using the
53 * reference gain and shelf slope parameter.
57 inline ALfloat
calc_rcpQ_from_slope(ALfloat gain
, ALfloat slope
)
59 return sqrtf((gain
+ 1.0f
/gain
)*(1.0f
/slope
- 1.0f
) + 2.0f
);
61 /* Calculates the rcpQ (i.e. 1/Q) coefficient for filters, using the frequency
62 * multiple (i.e. ref_freq / sampling_freq) and bandwidth.
63 * 0 < freq_mult < 0.5.
65 inline ALfloat
calc_rcpQ_from_bandwidth(ALfloat freq_mult
, ALfloat bandwidth
)
67 ALfloat w0
= F_TAU
* freq_mult
;
68 return 2.0f
*sinhf(logf(2.0f
)/2.0f
*bandwidth
*w0
/sinf(w0
));
71 inline void ALfilterState_clear(ALfilterState
*filter
)
79 void ALfilterState_setParams(ALfilterState
*filter
, ALfilterType type
, ALfloat gain
, ALfloat freq_mult
, ALfloat rcpQ
);
81 void ALfilterState_processC(ALfilterState
*filter
, ALfloat
*restrict dst
, const ALfloat
*restrict src
, ALuint numsamples
);
83 inline void ALfilterState_processPassthru(ALfilterState
*filter
, const ALfloat
*src
, ALuint numsamples
)
87 filter
->x
[1] = src
[numsamples
-2];
88 filter
->x
[0] = src
[numsamples
-1];
89 filter
->y
[1] = src
[numsamples
-2];
90 filter
->y
[0] = src
[numsamples
-1];
92 else if(numsamples
== 1)
94 filter
->x
[1] = filter
->x
[0];
95 filter
->x
[0] = src
[0];
96 filter
->y
[1] = filter
->y
[0];
97 filter
->y
[0] = src
[0];
102 typedef struct ALfilter
{
103 // Filter type (AL_FILTER_NULL, ...)
112 void (*SetParami
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALint val
);
113 void (*SetParamiv
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, const ALint
*vals
);
114 void (*SetParamf
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALfloat val
);
115 void (*SetParamfv
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, const ALfloat
*vals
);
117 void (*GetParami
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALint
*val
);
118 void (*GetParamiv
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALint
*vals
);
119 void (*GetParamf
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALfloat
*val
);
120 void (*GetParamfv
)(struct ALfilter
*filter
, ALCcontext
*context
, ALenum param
, ALfloat
*vals
);
126 #define ALfilter_SetParami(x, c, p, v) ((x)->SetParami((x),(c),(p),(v)))
127 #define ALfilter_SetParamiv(x, c, p, v) ((x)->SetParamiv((x),(c),(p),(v)))
128 #define ALfilter_SetParamf(x, c, p, v) ((x)->SetParamf((x),(c),(p),(v)))
129 #define ALfilter_SetParamfv(x, c, p, v) ((x)->SetParamfv((x),(c),(p),(v)))
131 #define ALfilter_GetParami(x, c, p, v) ((x)->GetParami((x),(c),(p),(v)))
132 #define ALfilter_GetParamiv(x, c, p, v) ((x)->GetParamiv((x),(c),(p),(v)))
133 #define ALfilter_GetParamf(x, c, p, v) ((x)->GetParamf((x),(c),(p),(v)))
134 #define ALfilter_GetParamfv(x, c, p, v) ((x)->GetParamfv((x),(c),(p),(v)))
136 inline void LockFiltersRead(ALCdevice
*device
)
137 { LockUIntMapRead(&device
->FilterMap
); }
138 inline void UnlockFiltersRead(ALCdevice
*device
)
139 { UnlockUIntMapRead(&device
->FilterMap
); }
140 inline void LockFiltersWrite(ALCdevice
*device
)
141 { LockUIntMapWrite(&device
->FilterMap
); }
142 inline void UnlockFiltersWrite(ALCdevice
*device
)
143 { UnlockUIntMapWrite(&device
->FilterMap
); }
145 inline struct ALfilter
*LookupFilter(ALCdevice
*device
, ALuint id
)
146 { return (struct ALfilter
*)LookupUIntMapKeyNoLock(&device
->FilterMap
, id
); }
147 inline struct ALfilter
*RemoveFilter(ALCdevice
*device
, ALuint id
)
148 { return (struct ALfilter
*)RemoveUIntMapKeyNoLock(&device
->FilterMap
, id
); }
150 ALvoid
ReleaseALFilters(ALCdevice
*device
);