Provide asynchronous property updates for sources
commitb3338d25f6d4fd02935ac83d0d3f227b145307d1
authorChris Robinson <chris.kcat@gmail.com>
Sun, 15 May 2016 06:43:40 +0000 (14 23:43 -0700)
committerChris Robinson <chris.kcat@gmail.com>
Sun, 15 May 2016 06:43:40 +0000 (14 23:43 -0700)
treecb3b14deec8f1298121d61d1fbd2c57b6610dd41
parent0f7e4993237e83ddc53a958a6369924da53c4a99
Provide asynchronous property updates for sources

This necessitates a change in how source updates are handled. Rather than just
being able to update sources when a dependent object state is changed (e.g. a
listener gain change), now all source updates must be proactively provided.
Consequently, apps that do not utilize any deferring (AL_SOFT_defer_updates or
alcSuspendContext/alcProcessContext) may utilize more CPU since it'll be
filling out more update containers for the mixer thread to use.

The upside is that there's less blocking between the app's calling thread and
the mixer thread, particularly for vectors and other multi-value properties
(filters and sends). Deferring behavior when used is also improved, since
updates that shouldn't be applied yet are simply not provided. And when they
are provided, the mixer doesn't have to ignore them, meaning the actual
deferring of a context doesn't have to synchrnously force an update -- the
process call will send any pending updates, which the mixer will apply even if
another deferral occurs before the mixer runs, because it'll still be there
waiting on the next mixer invocation.

There is one slight bug introduced by this commit. When a listener change is
made, or changes to multiple sources while updates are being deferred, it is
possible for the mixer to run while the sources are prepping their updates,
causing some of the source updates to be seen before the other. This will be
fixed in short order.
Alc/ALc.c
Alc/ALu.c
Alc/mixer.c
OpenAL32/Include/alMain.h
OpenAL32/Include/alSource.h
OpenAL32/Include/alu.h
OpenAL32/alAuxEffectSlot.c
OpenAL32/alListener.c
OpenAL32/alSource.c
OpenAL32/alState.c