org.lwjgl.openal

Class SOFTPauseDevice

java.lang.Object

org.lwjgl.openal.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

Modifier and Type	Method and 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