kcat/openal-soft
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
openal-soft/OpenAL32/Include/alListener.h

68 lines
1.3 KiB
C
Raw Normal View History

Initial import
2007-11-13 18:02:18 -08:00
#ifndef _AL_LISTENER_H_
#define _AL_LISTENER_H_
Fix up some more header includes
2012-09-14 02:42:36 -07:00
#include "alMain.h"
Add explicit matrix and vector types to operate with
2014-12-16 06:29:31 -08:00
#include "alu.h"
Initial import
2007-11-13 18:02:18 -08:00
#ifdef __cplusplus
extern "C" {
#endif
Update the context state properties separately The context state properties are less likely to change compared to the listener state, and future changes may prefer more infrequent updates to the context state. Note that this puts the MetersPerUnit in as a context state, even though it's handled through the listener functions. Considering the infrequency that it's updated at (generally set just once for the context's lifetime), it makes more sense to put it there than with the more frequently updated listener properties. The aforementioned future changes would also prefer MetersPerUnit to not be updated unnecessarily.
2017-09-27 08:55:42 -07:00
struct ALcontextProps {
ALfloat DopplerFactor;
ALfloat DopplerVelocity;
ALfloat SpeedOfSound;
ALboolean SourceDistanceModel;
enum DistanceModel DistanceModel;
ALfloat MetersPerUnit;
ATOMIC(struct ALcontextProps*) next;
};
Use a lockless method for updating listener and context properties This uses a separate container to provide the relevant properties to the internal update method, using atomic pointer swaps. A free-list is used to avoid having too many individual containers. This allows the mixer to update the internal listener properties without requiring the lock to protect against async updates. It also allows concurrent read access to the user-facing property values, even the multi-value ones (e.g. the vectors).
2016-05-11 18:40:17 -07:00
struct ALlistenerProps {
Remove unnecessary atomic members
2017-03-08 03:38:28 -08:00
ALfloat Position[3];
ALfloat Velocity[3];
ALfloat Forward[3];
ALfloat Up[3];
ALfloat Gain;
Use a lockless method for updating listener and context properties This uses a separate container to provide the relevant properties to the internal update method, using atomic pointer swaps. A free-list is used to avoid having too many individual containers. This allows the mixer to update the internal listener properties without requiring the lock to protect against async updates. It also allows concurrent read access to the user-facing property values, even the multi-value ones (e.g. the vectors).
2016-05-11 18:40:17 -07:00
ATOMIC(struct ALlistenerProps*) next;
};
Don't include alListener.h from alMain.h
2012-10-09 04:48:12 -07:00
typedef struct ALlistener {
Store the default effect slot in the context
2017-07-13 21:30:05 -07:00
alignas(16) ALfloat Position[3];
Remove unnecessary atomic members
2017-03-08 03:38:28 -08:00
ALfloat Velocity[3];
ALfloat Forward[3];
ALfloat Up[3];
ALfloat Gain;
Build the listener matrix separately
2012-10-09 06:19:36 -07:00
Don't update context and listener props unnecessarily
2017-09-27 09:36:34 -07:00
ATOMIC_FLAG PropsClean;
Use a lockless method for updating listener and context properties This uses a separate container to provide the relevant properties to the internal update method, using atomic pointer swaps. A free-list is used to avoid having too many individual containers. This allows the mixer to update the internal listener properties without requiring the lock to protect against async updates. It also allows concurrent read access to the user-facing property values, even the multi-value ones (e.g. the vectors).
2016-05-11 18:40:17 -07:00
/* Pointer to the most recent property values that are awaiting an update.
*/
ATOMIC(struct ALlistenerProps*) Update;
Build the listener matrix separately
2012-10-09 06:19:36 -07:00
struct {
Use floats for the listener transforms
2016-05-16 18:28:46 -07:00
aluMatrixf Matrix;
Use doubles for the constructed listener matrix This helps the stability of transforms to local space for sources that are at or near the listener. With a single-precision matrix, even FLT_EPSILON might not be enough to detect matching positions.
2015-11-11 08:19:33 -08:00
aluVector Velocity;
Store more "active" listener and context properties separately This helps ensure async listener/context property changes affect all playing sources at the same time.
2016-05-09 11:26:49 -07:00
ALfloat Gain;
ALfloat MetersPerUnit;
ALfloat DopplerFactor;
Add an option to ignore the app's speed of sound for reverb decay
2017-09-22 05:42:04 -07:00
ALfloat SpeedOfSound; /* in units per sec! */
ALfloat ReverbSpeedOfSound; /* in meters per sec! */
Don't pass the context's distance model as the source's
2016-08-23 19:17:17 -07:00
ALboolean SourceDistanceModel;
enum DistanceModel DistanceModel;
Build the listener matrix separately
2012-10-09 06:19:36 -07:00
} Params;
Initial import
2007-11-13 18:02:18 -08:00
} ALlistener;
Use a lockless method for updating listener and context properties This uses a separate container to provide the relevant properties to the internal update method, using atomic pointer swaps. A free-list is used to avoid having too many individual containers. This allows the mixer to update the internal listener properties without requiring the lock to protect against async updates. It also allows concurrent read access to the user-facing property values, even the multi-value ones (e.g. the vectors).
2016-05-11 18:40:17 -07:00
void UpdateListenerProps(ALCcontext *context);
Initial import
2007-11-13 18:02:18 -08:00
#ifdef __cplusplus
}
#endif
#endif
Reference in New Issue Copy Permalink