Class 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 Detail

      • DEBUG

        public static final boolean DEBUG
      • PREFER_SYSTEM_OPENAL

        public static final boolean PREFER_SYSTEM_OPENAL
        If true, prefer System-OpenAL, otherwise bundled Soft-OpenAL (default).
    • 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