Package org.lwjgl.openal
Class ALC
- java.lang.Object
-
- org.lwjgl.openal.ALC
-
public final class ALC extends java.lang.Object
This class must be used before any OpenAL function is called. It has the following responsibilities:- Loads the OpenAL native library into the JVM process.
- Creates instances of
ALCCapabilities
classes. AnALCCapabilities
instance contains flags for functionality that is available for an OpenAL device. Internally, it also contains function pointers that are only valid for that specific OpenAL device.
Library lifecycle
The OpenAL library is loaded automatically when this class is initialized. Set the
Configuration.OPENAL_EXPLICIT_INIT
option to override this behavior. Manual loading/unloading can be achieved with thecreate()
anddestroy()
functions. The name of the library loaded can be overridden with theConfiguration.OPENAL_LIBRARY_NAME
option.ALCCapabilities creation
Instances of
ALCCapabilities
can be created with thecreateCapabilities(long)
method. Calling this method is expensive, soALCCapabilities
instances should be cached in user code.- See Also:
AL
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static void
create()
Loads the OpenAL native library, using the default library name.static void
create(java.lang.String libName)
Loads the OpenAL native library, using the specified library name.static void
create(org.lwjgl.system.FunctionProviderLocal functionProvider)
Initializes ALC with the specifiedFunctionProviderLocal
.static ALCCapabilities
createCapabilities(long device)
Creates a newALCCapabilities
instance for the specified OpenAL device.static void
destroy()
Unloads the OpenAL native library.static org.lwjgl.system.FunctionProviderLocal
getFunctionProvider()
Returns theFunctionProviderLocal
for the OpenAL native library.
-
-
-
Method Detail
-
create
public static void create()
Loads the OpenAL native library, using the default library name.
-
create
public static void create(java.lang.String libName)
Loads the OpenAL native library, using the specified library name.- Parameters:
libName
- the native library name
-
create
public static void create(org.lwjgl.system.FunctionProviderLocal functionProvider)
Initializes ALC with the specifiedFunctionProviderLocal
. This method can be used to implement custom ALC library loading.- Parameters:
functionProvider
- the provider of ALC function addresses
-
destroy
public static void destroy()
Unloads the OpenAL native library.
-
getFunctionProvider
public static org.lwjgl.system.FunctionProviderLocal getFunctionProvider()
Returns theFunctionProviderLocal
for the OpenAL native library.
-
createCapabilities
public static ALCCapabilities createCapabilities(long device)
Creates a newALCCapabilities
instance for the specified OpenAL device.- Returns:
- the
ALCCapabilities
instance
-
-