Package org.lwjgl

Class LWJGLUtil

  • public class LWJGLUtil
extends java.lang.Object

    Internal library methods

    Version:
    $Revision$ $Id$
    Author:
    Brian Matzon

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static interface  LWJGLUtil.TokenFilter
      Simple interface for Field filtering.

    • Constructor Summary

      Constructors 
      Constructor Description
      LWJGLUtil()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.util.Map<java.lang.Integer,​java.lang.String> getClassTokens​(LWJGLUtil.TokenFilter filter, java.util.Map<java.lang.Integer,​java.lang.String> target, java.lang.Class... tokenClasses)
      Returns a map of public static final integer fields in the specified classes, to their String representations.
      static java.util.Map<java.lang.Integer,​java.lang.String> getClassTokens​(LWJGLUtil.TokenFilter filter, java.util.Map<java.lang.Integer,​java.lang.String> target, java.lang.Iterable<java.lang.Class> tokenClasses)
      Returns a map of public static final integer fields in the specified classes, to their String representations.
      static java.lang.String[] getLibraryPaths​(java.lang.String libname, java.lang.String[] platform_lib_names, java.lang.ClassLoader classloader)
      Locates the paths required by a library.
      static java.lang.String[] getLibraryPaths​(java.lang.String libname, java.lang.String platform_lib_name, java.lang.ClassLoader classloader)
      Locates the paths required by a library.
      static int getPlatform()  
      static java.lang.String getPlatformName()  
      static boolean getPrivilegedBoolean​(java.lang.String property_name)
      Gets a boolean property as a privileged action.
      static java.lang.Integer getPrivilegedInteger​(java.lang.String property_name)
      Gets an integer property as a privileged action.
      static java.lang.Integer getPrivilegedInteger​(java.lang.String property_name, int default_val)
      Gets an integer property as a privileged action.
      static boolean isMacOSXEqualsOrBetterThan​(int major_required, int minor_required)
      Method to determine if the current system is running a version of Mac OS X better than the given version.
      static void log​(java.lang.CharSequence msg)
      Prints the given message to System.err if DEBUG is true.
      static java.lang.String mapLibraryName​(java.lang.String name)
      Wraps System.mapLibraryName(java.lang.String).
      static java.lang.String toHexString​(int value)
      Returns a string representation of the integer argument as an unsigned integer in base 16.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • PLATFORM_LINUX_NAME

        public static final java.lang.String PLATFORM_LINUX_NAME
        See Also:
        Constant Field Values

      • PLATFORM_MACOSX_NAME

        public static final java.lang.String PLATFORM_MACOSX_NAME
        See Also:
        Constant Field Values

      • PLATFORM_WINDOWS_NAME

        public static final java.lang.String PLATFORM_WINDOWS_NAME
        See Also:
        Constant Field Values

      • LWJGLIcon16x16

        public static final java.nio.ByteBuffer LWJGLIcon16x16
        LWJGL Logo - 16 by 16 pixels

      • LWJGLIcon32x32

        public static final java.nio.ByteBuffer LWJGLIcon32x32
        LWJGL Logo - 32 by 32 pixels

      • DEBUG

        public static final boolean DEBUG
        Debug flag.

      • CHECKS

        public static final boolean CHECKS

    • Constructor Detail

      • LWJGLUtil

        public LWJGLUtil()

    • Method Detail

      • mapLibraryName

        public static java.lang.String mapLibraryName​(java.lang.String name)
        Wraps System.mapLibraryName(java.lang.String). On OS X with JDK 6, the .jnilib file extension will be replaced with .dylib.
        Parameters:
        name - the name of the library.
        Returns:
        a platform-dependent native library name.

      • getLibraryPaths

        public static java.lang.String[] getLibraryPaths​(java.lang.String libname,
                                                 java.lang.String platform_lib_name,
                                                 java.lang.ClassLoader classloader)
        Locates the paths required by a library.
        Parameters:
        libname - Local Library Name to search the classloader with ("openal").
        platform_lib_name - The native library name ("libopenal.so")
        classloader - The classloader to ask for library paths
        Returns:
        Paths to located libraries, if any

      • getLibraryPaths

        public static java.lang.String[] getLibraryPaths​(java.lang.String libname,
                                                 java.lang.String[] platform_lib_names,
                                                 java.lang.ClassLoader classloader)
        Locates the paths required by a library.
        Parameters:
        libname - Local Library Name to search the classloader with ("openal").
        platform_lib_names - The list of possible library names ("libopenal.so")
        classloader - The classloader to ask for library paths
        Returns:
        Paths to located libraries, if any

      • getPrivilegedBoolean

        public static boolean getPrivilegedBoolean​(java.lang.String property_name)
        Gets a boolean property as a privileged action.

      • getPrivilegedInteger

        public static java.lang.Integer getPrivilegedInteger​(java.lang.String property_name)
        Gets an integer property as a privileged action.
        Parameters:
        property_name - the integer property name
        Returns:
        the property value

      • getPrivilegedInteger

        public static java.lang.Integer getPrivilegedInteger​(java.lang.String property_name,
                                                     int default_val)
        Gets an integer property as a privileged action.
        Parameters:
        property_name - the integer property name
        default_val - the default value to use if the property is not defined
        Returns:
        the property value

      • log

        public static void log​(java.lang.CharSequence msg)
        Prints the given message to System.err if DEBUG is true.
        Parameters:
        msg - Message to print

      • isMacOSXEqualsOrBetterThan

        public static boolean isMacOSXEqualsOrBetterThan​(int major_required,
                                                 int minor_required)
        Method to determine if the current system is running a version of Mac OS X better than the given version. This is only useful for Mac OS X specific code and will not work for any other platform.

      • getClassTokens

        public static java.util.Map<java.lang.Integer,​java.lang.String> getClassTokens​(LWJGLUtil.TokenFilter filter,
                                                                                     java.util.Map<java.lang.Integer,​java.lang.String> target,
                                                                                     java.lang.Class... tokenClasses)
        Returns a map of public static final integer fields in the specified classes, to their String representations. An optional filter can be specified to only include specific fields. The target map may be null, in which case a new map is allocated and returned.

        This method is useful when debugging to quickly identify values returned from the AL/GL/CL APIs.

        Parameters:
        filter - the filter to use (optional)
        target - the target map (optional)
        tokenClasses - an array of classes to get tokens from
        Returns:
        the token map

      • getClassTokens

        public static java.util.Map<java.lang.Integer,​java.lang.String> getClassTokens​(LWJGLUtil.TokenFilter filter,
                                                                                     java.util.Map<java.lang.Integer,​java.lang.String> target,
                                                                                     java.lang.Iterable<java.lang.Class> tokenClasses)
        Returns a map of public static final integer fields in the specified classes, to their String representations. An optional filter can be specified to only include specific fields. The target map may be null, in which case a new map is allocated and returned.

        This method is useful when debugging to quickly identify values returned from the AL/GL/CL APIs.

        Parameters:
        filter - the filter to use (optional)
        target - the target map (optional)
        tokenClasses - the classes to get tokens from
        Returns:
        the token map

      • toHexString

        public static java.lang.String toHexString​(int value)
        Returns a string representation of the integer argument as an unsigned integer in base 16. The string will be uppercase and will have a leading '0x'.
        Parameters:
        value - the integer value
        Returns:
        the hex string representation