org.jsfml.internal

Class SFMLNative

java.lang.Object

org.jsfml.internal.SFMLNative

public final class SFMLNative
extends Object

Native library loader.

This class contains the "self-containedness" functionality of JSFML.

See Also:

for more information.

Field Summary

Fields

Modifier and Type	Field and Description
static String	OS_NAME_LINUX The substring of the os.name system property to look for to detect Linux systems.
static String	OS_NAME_MACOSX The substring of the os.name system property to look for to detect Mac OS X systems.
static String	OS_NAME_WINDOWS The substring of the os.name system property to look for to detect Windows systems.

Constructor Summary

Constructors

Constructor and Description
SFMLNative()

Method Summary

Methods

Modifier and Type	Method and Description
static void	ensureDisplay() Ensures that a display is available on this system.
static void	loadNativeLibraries() Loads the native JSFML libraries if it has not been done yet.

Methods inherited from class java.lang.Object

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

Field Detail

OS_NAME_WINDOWS

public static final String OS_NAME_WINDOWS

The substring of the os.name system property to look for to detect Windows systems.

See Also:

Constant Field Values

OS_NAME_LINUX

public static final String OS_NAME_LINUX

The substring of the os.name system property to look for to detect Linux systems.

See Also:

Constant Field Values

OS_NAME_MACOSX

public static final String OS_NAME_MACOSX

The substring of the os.name system property to look for to detect Mac OS X systems.

See Also:

Constant Field Values

Constructor Detail

SFMLNative

public SFMLNative()

Method Detail

loadNativeLibraries

public static void loadNativeLibraries()

Loads the native JSFML libraries if it has not been done yet.

This must be done before any SFML class representations can be used. All affected classes will call this method when they are loaded, so this does not have to be done manually.

This method will scan the os.name and os.arch system properties and compile a list of libraries to load if the platform is supported. The libraries will then be looked for in the classpath, extracted to the user directory and loaded.

The libraries will be extracted to ~/.jsfml. If the files already exist, their MD5 hashes (which are provided in separate files) will be tested against the ones in the classpath. If the MD5 hashes differ, the existing file in the user directory will be overridden.

If loading the native libraries fails, a JSFMLError will be raised with a brief description of what went wrong.

ensureDisplay

public static void ensureDisplay()

Ensures that a display is available on this system.

If that is not the case, a HeadlessException is thrown to indicate that the desired JSFML feature is not available.