Package org.lwjgl.openal

Class SOFTPauseDevice

  • public class SOFTPauseDevice
extends java.lang.Object
    Native bindings to the SOFT_pause_device extension.

    This extension allows applications to pause a playback device. The main purpose of this is to silence output, stop processing, and allow the audio hardware to go into a low-power mode. On a mobile device, for instance, apps may want to silence output and not waste battery life with unneeded processing when in the background.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void alcDevicePauseSOFT​(long device)
      Pauses a playback device.
      static void alcDeviceResumeSOFT​(long device)
      Resumes playback of a paused device.

      • Methods inherited from class java.lang.Object

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

    • Method Detail

      • alcDevicePauseSOFT

        public static void alcDevicePauseSOFT​(long device)
        Pauses a playback device.

        When paused, no contexts associated with the device will be processed or updated. Playing sources will not produce sound, have their offsets incremented, or process any more buffers, until the device is resumed. Pausing a device that is already paused is a legal no-op.

        Parameters:
        device - the device to pause

      • alcDeviceResumeSOFT

        public static void alcDeviceResumeSOFT​(long device)
        Resumes playback of a paused device.

        This will restart processing on the device -- sources will resume playing sound as normal. Resuming playback on a device that is not paused is a legal no-op.

        These functions are not reference counted. alcDeviceResumeSOFT only needs to be called once to resume playback, regardless of how many times DevicePauseSOFT was called.

        Parameters:
        device - the device to resume