org.lwjgl

Class LWJGLUtil

java.lang.Object

org.lwjgl.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 and Description
static interface	LWJGLUtil.TokenFilter Simple interface for Field filtering.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	CHECKS
static boolean	DEBUG Debug flag.
static java.nio.ByteBuffer	LWJGLIcon16x16 LWJGL Logo - 16 by 16 pixels
static java.nio.ByteBuffer	LWJGLIcon32x32 LWJGL Logo - 32 by 32 pixels
static int	PLATFORM_LINUX
static java.lang.String	PLATFORM_LINUX_NAME
static int	PLATFORM_MACOSX
static java.lang.String	PLATFORM_MACOSX_NAME
static int	PLATFORM_WINDOWS
static java.lang.String	PLATFORM_WINDOWS_NAME

Constructor Summary

Constructors

Constructor and Description
LWJGLUtil()

Method Summary

Methods

Modifier and Type	Method and 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	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

public static final int PLATFORM_LINUX

See Also:

Constant Field Values

PLATFORM_MACOSX

public static final int PLATFORM_MACOSX

See Also:

Constant Field Values

PLATFORM_WINDOWS

public static final int PLATFORM_WINDOWS

See Also:

Constant Field Values

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

getPlatform

public static int getPlatform()

Returns:

the current platform type

See Also:

PLATFORM_WINDOWS, PLATFORM_LINUX, PLATFORM_MACOSX

getPlatformName

public static java.lang.String getPlatformName()

Returns:

current platform name

See Also:

PLATFORM_WINDOWS_NAME, PLATFORM_LINUX_NAME, PLATFORM_MACOSX_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