Class EXTCapture
- java.lang.Object
-
- org.lwjgl.openal.EXTCapture
-
public class EXTCapture extends java.lang.Object
Native bindings to theALC_EXT_CAPTURE
extension.An OpenAL 1.1 implementation will always support the
ALC_EXT_CAPTURE
extension. This allows an application written to the OpenAL 1.0 specification to access the capture abilities.
-
-
Field Summary
Fields Modifier and Type Field and Description static int
ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER
ALC_CAPTURE_DEVICE_SPECIFIERString queries.static int
ALC_CAPTURE_SAMPLES
Integer queries.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method and Description static boolean
alcCaptureCloseDevice(long device)
Allows the application to disconnect from a capture device.static long
alcCaptureOpenDevice(java.nio.ByteBuffer devicename, int frequency, int format, int buffersize)
Allows the application to connect to a capture device.static long
alcCaptureOpenDevice(java.lang.CharSequence devicename, int frequency, int format, int buffersize)
Allows the application to connect to a capture device.static void
alcCaptureSamples(long device, java.nio.ByteBuffer buffer)
Obtains captured audio samples from the AL.static void
alcCaptureStart(long device)
Starts recording audio on the specific capture device.static void
alcCaptureStop(long device)
Halts audio capturing without closing the capture device.
-
-
-
Field Detail
-
ALC_CAPTURE_DEVICE_SPECIFIER
public static final int ALC_CAPTURE_DEVICE_SPECIFIER
String queries.- See Also:
- Constant Field Values
-
ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER
public static final int ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER
String queries.- See Also:
- Constant Field Values
-
ALC_CAPTURE_SAMPLES
public static final int ALC_CAPTURE_SAMPLES
Integer queries.- See Also:
- Constant Field Values
-
-
Method Detail
-
alcCaptureOpenDevice
public static long alcCaptureOpenDevice(java.nio.ByteBuffer devicename, int frequency, int format, int buffersize)
Allows the application to connect to a capture device.The
deviceName
argument is a null terminated string that requests a certain device or device configuration. IfNULL
is specified, the implementation will provide an implementation specific default.- Parameters:
devicename
- the device or device configurationfrequency
- the audio frequencyformat
- the audio formatbuffersize
- the number of sample frame to buffer in the AL
-
alcCaptureOpenDevice
public static long alcCaptureOpenDevice(java.lang.CharSequence devicename, int frequency, int format, int buffersize)
Allows the application to connect to a capture device.The
deviceName
argument is a null terminated string that requests a certain device or device configuration. IfNULL
is specified, the implementation will provide an implementation specific default.- Parameters:
devicename
- the device or device configurationfrequency
- the audio frequencyformat
- the audio formatbuffersize
- the number of sample frame to buffer in the AL
-
alcCaptureCloseDevice
public static boolean alcCaptureCloseDevice(long device)
Allows the application to disconnect from a capture device.- Parameters:
device
- the capture device to close
-
alcCaptureStart
public static void alcCaptureStart(long device)
Starts recording audio on the specific capture device.Once started, the device will record audio to an internal ring buffer, the size of which was specified when opening the device. The application may query the capture device to discover how much data is currently available via the alcGetInteger with the ALC_CAPTURE_SAMPLES token. This will report the number of sample frames currently available.
- Parameters:
device
- the capture device
-
alcCaptureStop
public static void alcCaptureStop(long device)
Halts audio capturing without closing the capture device.The implementation is encouraged to optimize for this case. The amount of audio samples available after restarting a stopped capture device is reset to zero. The application does not need to stop the capture device to read from it.
- Parameters:
device
- the capture device
-
alcCaptureSamples
public static void alcCaptureSamples(long device, java.nio.ByteBuffer buffer)
Obtains captured audio samples from the AL.The implementation may defer conversion and resampling until this point. Requesting more sample frames than are currently available is an error.
- Parameters:
device
- the capture devicebuffer
- the buffer that will receive the samples
-
-