com.jogamp.openal
Class ALFactory

java.lang.Object
  extended by com.jogamp.openal.ALFactory

public class ALFactory
extends Object

This class provides factory methods for generating AL and ALC objects.

Select preferred OpenAL native library type via system properties, i.e. System-OpenAL or bundled Soft-OpenAL.
If the preferred choice fails, implementation falls back to the other.

    -Djoal.openal.lib=auto     Prefer System-OpenAL over bundled Soft-OpenAL for OSX. Prefer bundled Soft-OpenAL over System-OpenAL for all others. This is the default.
    -Djoal.openal.lib=system   Prefer System-OpenAL over bundled Soft-OpenAL for all.
    -Djoal.openal.lib=soft     Prefer bundled Soft-OpenAL over System-OpenAL for all.
   
Note: You may use the 'jnlp.' prefix, allowing using above property names w/ Applets and WebStart, e.g. 'jnlp.joal.openal.lib=system'.

Author:
Athomas Goldberg, Kenneth Russell, et.al.

Field Summary
static boolean DEBUG
           
static boolean PREFER_SYSTEM_OPENAL
          If true, prefer System-OpenAL over bundled Soft-OpenAL, otherwise vice versa.
 
Method Summary
static AL getAL()
          Get the default AL object.
static ALC getALC()
          Get the default ALC object.
static ALExt getALExt()
          Get the default ALExt object.
static boolean getPreferSystemOpenAL()
          If the system property joal.SystemOpenAL is set
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEBUG

public static final boolean DEBUG

PREFER_SYSTEM_OPENAL

public static final boolean PREFER_SYSTEM_OPENAL
If true, prefer System-OpenAL over bundled Soft-OpenAL, otherwise vice versa.

Method Detail

getPreferSystemOpenAL

public static boolean getPreferSystemOpenAL()
                                     throws ALException
If the system property joal.SystemOpenAL is set

Returns:
Throws:
ALException

getAL

public static AL getAL()
                throws ALException
Get the default AL object. This object is used to access most of the OpenAL functionality.

Returns:
the AL object
Throws:
ALException

getALC

public static ALC getALC()
                  throws ALException
Get the default ALC object. This object is used to access most of the OpenAL context functionality.

Returns:
the ALC object
Throws:
ALException

getALExt

public static ALExt getALExt()
                      throws ALException
Get the default ALExt object. This object is used to access most of the OpenAL extension functionality.

Returns:
the ALExt object
Throws:
ALException