kcat/openal-soft
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
openal-soft/Alc/bformatdec.h

65 lines
2.3 KiB
C
Raw Normal View History

Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
#ifndef BFORMATDEC_H
#define BFORMATDEC_H
#include "alMain.h"
Convert the BFormat decoder to C++
2018-11-03 15:32:09 -07:00
#ifdef __cplusplus
extern "C" {
#endif
Improve the ambisonic upscaling methods This now takes advantage of the differences seen in generated decoder matrices for first-order compared to second- and third-order, such that with the appropriate frequency-dependent scaling applied to first-order content, the result is identical with a higher-order decoder matrix compared to a first- order matrix for the same layout.
2017-01-24 19:03:51 -08:00
/* These are the necessary scales for first-order HF responses to play over
* higher-order 2D (non-periphonic) decoders.
*/
Clarify some macro names using ambisonic mixed-mode notation
2018-02-09 18:43:34 -08:00
#define W_SCALE_2H0P 1.224744871f /* sqrt(1.5) */
#define XYZ_SCALE_2H0P 1.0f
#define W_SCALE_3H0P 1.414213562f /* sqrt(2) */
#define XYZ_SCALE_3H0P 1.082392196f
Improve the ambisonic upscaling methods This now takes advantage of the differences seen in generated decoder matrices for first-order compared to second- and third-order, such that with the appropriate frequency-dependent scaling applied to first-order content, the result is identical with a higher-order decoder matrix compared to a first- order matrix for the same layout.
2017-01-24 19:03:51 -08:00
/* These are the necessary scales for first-order HF responses to play over
* higher-order 3D (periphonic) decoders.
*/
Clarify some macro names using ambisonic mixed-mode notation
2018-02-09 18:43:34 -08:00
#define W_SCALE_2H2P 1.341640787f /* sqrt(1.8) */
#define XYZ_SCALE_2H2P 1.0f
#define W_SCALE_3H3P 1.695486018f
#define XYZ_SCALE_3H3P 1.136697713f
Improve the ambisonic upscaling methods This now takes advantage of the differences seen in generated decoder matrices for first-order compared to second- and third-order, such that with the appropriate frequency-dependent scaling applied to first-order content, the result is identical with a higher-order decoder matrix compared to a first- order matrix for the same layout.
2017-01-24 19:03:51 -08:00
Avoid duplicating some scale tables
2018-02-13 13:47:35 -08:00
/* NOTE: These are scale factors as applied to Ambisonics content. Decoder
* coefficients should be divided by these values to get proper N3D scalings.
*/
Convert the BFormat decoder to C++
2018-11-03 15:32:09 -07:00
extern const ALfloat N3D2N3DScale[MAX_AMBI_COEFFS];
extern const ALfloat SN3D2N3DScale[MAX_AMBI_COEFFS];
extern const ALfloat FuMa2N3DScale[MAX_AMBI_COEFFS];
Avoid duplicating some scale tables
2018-02-13 13:47:35 -08:00
Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
struct AmbDecConf;
struct BFormatDec;
Add a stand-alone upsampler for higher-order ambisonic oputput
2016-07-30 09:29:21 -07:00
struct AmbiUpsampler;
Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
Add a config option for distance compensation
2016-03-26 17:52:42 -07:00
Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
struct BFormatDec *bformatdec_alloc();
Make bformatdec_free and ambiup_free clear the freed pointer
2018-02-12 20:48:28 -08:00
void bformatdec_free(struct BFormatDec **dec);
Apply distance compensation when writing to the output
2017-02-19 22:47:59 -08:00
void bformatdec_reset(struct BFormatDec *dec, const struct AmbDecConf *conf, ALsizei chancount, ALuint srate, const ALsizei chanmap[MAX_OUTPUT_CHANNELS]);
Up-sample first-order content when using a higher order HQ decoder
2016-03-23 12:53:36 -07:00
/* Decodes the ambisonic input to the given output channels. */
Replace restrict with RESTRICT
2018-10-29 11:32:50 -07:00
void bformatdec_process(struct BFormatDec *dec, ALfloat (*RESTRICT OutBuffer)[BUFFERSIZE], ALsizei OutChannels, const ALfloat (*RESTRICT InSamples)[BUFFERSIZE], ALsizei SamplesToDo);
Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
Up-sample first-order content when using a higher order HQ decoder
2016-03-23 12:53:36 -07:00
/* Up-samples a first-order input to the decoder's configuration. */
Replace restrict with RESTRICT
2018-10-29 11:32:50 -07:00
void bformatdec_upSample(struct BFormatDec *dec, ALfloat (*RESTRICT OutBuffer)[BUFFERSIZE], const ALfloat (*RESTRICT InSamples)[BUFFERSIZE], ALsizei InChannels, ALsizei SamplesToDo);
Up-sample first-order content when using a higher order HQ decoder
2016-03-23 12:53:36 -07:00
Band-split the HRIRs when building the ambisonic decoder filters This allows each HRIR to contribute a frequency-dependent response, essentially acting like a dual-band decoder playing over the cube speaker array.
2016-08-21 03:05:42 -07:00
Add a stand-alone upsampler for higher-order ambisonic oputput
2016-07-30 09:29:21 -07:00
/* Stand-alone first-order upsampler. Kept here because it shares some stuff
Use an alternate ambisonic HRTF decode layout Similar to the previous, but includes the top and bottom HRTF responses. The higher-order decode (for the "basic" HRTF output) also now uses 2H1P mixed- order instead of 2H1V, which seems more stable.
2018-02-13 03:03:26 -08:00
* with bformatdec. Assumes a periphonic (4-channel) input mix!
Add a stand-alone upsampler for higher-order ambisonic oputput
2016-07-30 09:29:21 -07:00
*/
struct AmbiUpsampler *ambiup_alloc();
Make bformatdec_free and ambiup_free clear the freed pointer
2018-02-12 20:48:28 -08:00
void ambiup_free(struct AmbiUpsampler **ambiup);
Use an alternate ambisonic HRTF decode layout Similar to the previous, but includes the top and bottom HRTF responses. The higher-order decode (for the "basic" HRTF output) also now uses 2H1P mixed- order instead of 2H1V, which seems more stable.
2018-02-13 03:03:26 -08:00
void ambiup_reset(struct AmbiUpsampler *ambiup, const ALCdevice *device, ALfloat w_scale, ALfloat xyz_scale);
Add a stand-alone upsampler for higher-order ambisonic oputput
2016-07-30 09:29:21 -07:00
Replace restrict with RESTRICT
2018-10-29 11:32:50 -07:00
void ambiup_process(struct AmbiUpsampler *ambiup, ALfloat (*RESTRICT OutBuffer)[BUFFERSIZE], ALsizei OutChannels, const ALfloat (*RESTRICT InSamples)[BUFFERSIZE], ALsizei SamplesToDo);
Add a stand-alone upsampler for higher-order ambisonic oputput
2016-07-30 09:29:21 -07:00
Convert the BFormat decoder to C++
2018-11-03 15:32:09 -07:00
#ifdef __cplusplus
} // extern "C"
#endif
Add a dual-band ambisonic decoder This uses a virtual B-Format buffer for mixing, and then uses a dual-band decoder for improved positional quality. This currently only works with first- order output since first-order input (from the AL_EXT_BFROMAT extension) would not sound correct when fed through a second- or third-order decoder. This also does not currently implement near-field compensation since near-field rendering effects are not implemented.
2016-03-15 05:08:05 -07:00
#endif /* BFORMATDEC_H */
Reference in New Issue Copy Permalink