Class GLContext
- Version:
- $Revision$ $Id$
- Author:
- elias_naur invalid input: '<'elias_naur@users.sourceforge.net>
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic ContextCapabilities
Get the current capabilities instance.static void
If the OpenGL reference count is 0, the library is loaded.static void
The OpenGL library reference count is decremented, and if it reaches 0, the library is unloaded.static void
useContext
(Object context) Makes a GL context the current LWJGL context by loading GL function pointers.static void
useContext
(Object context, boolean forwardCompatible) Makes a GL context the current LWJGL context by loading GL function pointers.
-
Constructor Details
-
GLContext
public GLContext()
-
-
Method Details
-
getCapabilities
Get the current capabilities instance. It contains the flags used to test for support of a particular extension.- Returns:
- The current capabilities instance.
-
useContext
Makes a GL context the current LWJGL context by loading GL function pointers. The context must be current before a call to this method! Instead it simply ensures that the current context is reflected accurately by GLContext's extension caps and function pointers. Use useContext(null) when no context is active.If the context is the same as last time, then this is a no-op.
If the context has not been encountered before it will be fully initialized from scratch. Otherwise a cached set of caps and function pointers will be used.
The reference to the context is held in a weak reference; therefore if no strong reference exists to the GL context it will automatically be forgotten by the VM at an indeterminate point in the future, freeing up a little RAM.
- Parameters:
context
- The context object, which uniquely identifies a GL context. If context is null, the native stubs are unloaded.- Throws:
LWJGLException
- if context non-null, and the gl library can't be loaded or the basic GL11 functions can't be loaded
-
useContext
Makes a GL context the current LWJGL context by loading GL function pointers. The context must be current before a call to this method! Instead it simply ensures that the current context is reflected accurately by GLContext's extension caps and function pointers. Use useContext(null) when no context is active.If the context is the same as last time, then this is a no-op.
If the context has not been encountered before it will be fully initialized from scratch. Otherwise a cached set of caps and function pointers will be used.
The reference to the context is held in a weak reference; therefore if no strong reference exists to the GL context it will automatically be forgotten by the VM at an indeterminate point in the future, freeing up a little RAM.
If forwardCompatible is true, function pointers of deprecated GL11-GL21 functionality will not be loaded. Calling a deprecated function using the specified context will result in an
IllegalStateException
.- Parameters:
context
- The context object, which uniquely identifies a GL context. If context is null, the native stubs are unloaded.forwardCompatible
- If the context is a forward compatible context (does not expose deprecated functionality, see XGL_ARB_create_context)- Throws:
LWJGLException
- if context non-null, and the gl library can't be loaded or the basic GL11 functions can't be loaded
-
loadOpenGLLibrary
If the OpenGL reference count is 0, the library is loaded. The reference count is then incremented.- Throws:
LWJGLException
-
unloadOpenGLLibrary
public static void unloadOpenGLLibrary()The OpenGL library reference count is decremented, and if it reaches 0, the library is unloaded.
-