Package org.lwjgl.openal

Class SOFTDeferredUpdates

  • public class SOFTDeferredUpdates
extends java.lang.Object
    Native bindings to the SOFT_deferred_updates extension.

    This extension allows applications to defer playback state updates. With unextended OpenAL, the playback state would respond to changes as soon as it could handle them, which makes it effectively impossible to ensure multiple changes occur at the same time without the potential of a "partial" update (where one change is heard without the other). This extension provides a way to prevent state updates from occuring until they've all been done, where they will all apply at once.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void alDeferUpdatesSOFT()
      Sometimes it is desirable to ensure multiple state changes take effect at the same time.
      static void alProcessUpdatesSOFT()
      Resumes updates.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • AL_DEFERRED_UPDATES_SOFT

        public static final int AL_DEFERRED_UPDATES_SOFT
        Accepted by the paramName parameter of GetBoolean, GetBooleanv (as well as the Integer, Float, and Double variants).
        See Also:
        Constant Field Values

    • Method Detail

      • alDeferUpdatesSOFT

        public static void alDeferUpdatesSOFT()
        Sometimes it is desirable to ensure multiple state changes take effect at the same time. Normally this isn't possible due to the AL processing updates asychronously, so the playback state can be updated with only part of the changes having been specified. An application can prevent these updates by calling this function.

        When called, samples will continue to render and be sent to the output device, but the effects of changing playback properties, such as the source or listener gain, or auxiliary slot gain or effect if EFX is supported, among others, will be deferred. Multiple changes can be batched so that they all apply at once at a later time.

      • alProcessUpdatesSOFT

        public static void alProcessUpdatesSOFT()
        Resumes updates.

        Once called, all pending deferred updates will be processed. Any following state changes will also apply as normal.