javax.media.opengl
Class GLContext

java.lang.Object
  extended by javax.media.opengl.GLContext

public abstract class GLContext
extends Object

Abstraction for an OpenGL rendering context. In order to perform OpenGL rendering, a context must be "made current" on the current thread. OpenGL rendering semantics specify that only one context may be current on the current thread at any given time, and also that a given context may be current on only one thread at any given time. Because components can be added to and removed from the component hierarchy at any time, it is possible that the underlying OpenGL context may need to be destroyed and recreated multiple times over the lifetime of a given component. This process is handled by the implementation, and the GLContext abstraction provides a stable object which clients can use to refer to a given context.


Field Summary
protected  long context
           
static int CONTEXT_CURRENT
          Indicates that the context was made current during the last call to makeCurrent.
static int CONTEXT_CURRENT_NEW
          Indicates that a newly-created context was made current during the last call to makeCurrent.
static int CONTEXT_NOT_CURRENT
          Indicates that the context was not made current during the last call to makeCurrent.
protected static int CTX_IS_ARB_CREATED
          ARB_create_context related: created via ARB_create_context
protected static int CTX_OPTION_ANY
          ARB_create_context related: not flag forward compatible
protected static int CTX_OPTION_DEBUG
          ARB_create_context related: flag debug
protected static int CTX_OPTION_FORWARD
          ARB_create_context related: flag forward compatible
protected static int CTX_PROFILE_COMPAT
          ARB_create_context related: compatibility profile
protected static int CTX_PROFILE_CORE
          ARB_create_context related: core profile
protected static int CTX_PROFILE_ES
          ARB_create_context related: ES profile
protected  int ctxMajorVersion
           
protected  int ctxMinorVersion
           
protected  int ctxOptions
           
protected  String ctxVersionString
           
static int[][] GL_VERSIONS
           
protected static com.jogamp.common.util.IntIntHashMap mappedVersionsAvailable
           
protected static Object mappedVersionsAvailableLock
           
protected static boolean mappedVersionsAvailableSet
           
 
Constructor Summary
GLContext()
           
 
Method Summary
protected static int compose8bit(int one, int two, int three, int four)
           
protected static String composed8BitToString(int bits32, boolean hex1, boolean hex2, boolean hex3, boolean hex4)
           
abstract  void copy(GLContext source, int mask)
          Copies selected groups of OpenGL state variables from the supplied source context into this one.
static boolean decrementGLVersion(int[] major, int[] minor)
           
abstract  void destroy()
          Destroys this OpenGL context and frees its associated resources.
 Object getAttachedObject(int name)
          Returns the attached user object for the given name to this GLContext.
 Object getAttachedObject(String name)
          Returns the attached user object for the given name to this GLContext.
protected static int getComposed8bit(int bits32, int which)
           
static GLContext getCurrent()
          Returns this thread current context.
static GL getCurrentGL()
          Returns the GL object bound to this thread current context.
abstract  GL getGL()
          Returns the GL pipeline object for this GLContext.
abstract  GLDrawable getGLDrawable()
          Returns the GLDrawable to which this context may be used to draw.
abstract  GLDrawable getGLDrawableRead()
          Returns the GLDrawable from which this context may be used to read.
 String getGLVersion()
          Returns a valid OpenGL version string, ie major.minor ([option]?[options,]*) - gl-version options old refers to the non ARB_create_context created context new refers to the ARB_create_context created context compatible profile core profile forward compatible any refers to the non forward compatible context ES refers to the GLES context variant gl-version the GL_VERSION string e.g.: row 2, cell 1 row 2, cell 2
ES2 2.0 (ES, any, new) - 2.0 ES Profile ATIGL2 3.0 (compatibility profile, any, new) - 3.2.9704 Compatibility Profile Context ATIGL3 3.3 (core profile, any, new) - 1.4 (3.2.9704 Compatibility Profile Context) ATIGL3bc3.3 (compatibility profile, any, new) - 1.4 (3.2.9704 Compatibility Profile Context) NVGL2 3.0 (compatibility profile, any, new) - 3.0.0 NVIDIA 195.36.07.03 NVGL3 3.3 (core profile, any, new) - 3.3.0 NVIDIA 195.36.07.03 NVGL3bc 3.3 (compatibility profile, any, new) - 3.3.0 NVIDIA 195.36.07.03
static String getGLVersion(int major, int minor, int ctp, String gl_version)
           
static String getGLVersionAvailable(int major, int profile)
           
static boolean getGLVersionAvailable(int reqMajor, int reqProfile, int[] major, int[] minor, int[] ctp)
           
 int getGLVersionMajor()
           
 int getGLVersionMinor()
           
static int getMaxMajor()
           
static int getMaxMinor(int major)
           
abstract  String getPlatformExtensionsString()
          Returns a non-null (but possibly empty) string containing the space-separated list of available platform-dependent (e.g., WGL, GLX) extensions.
 boolean hasGLSL()
           
 boolean isCreatedWithARBMethod()
           
 boolean isCurrent()
           
 boolean isGL2()
           
static boolean isGL2Available()
           
 boolean isGL2ES1()
           
 boolean isGL2ES2()
           
 boolean isGL2GL3()
           
 boolean isGL3()
           
static boolean isGL3Available()
           
 boolean isGL3bc()
           
static boolean isGL3bcAvailable()
           
 boolean isGL4()
           
static boolean isGL4Available()
           
 boolean isGL4bc()
           
static boolean isGL4bcAvailable()
           
 boolean isGLCompatibilityProfile()
           
 boolean isGLCoreProfile()
           
 boolean isGLEmbeddedProfile()
           
 boolean isGLES()
           
 boolean isGLES1()
           
 boolean isGLES2()
           
 boolean isGLForwardCompatible()
           
static boolean isGLVersionAvailable(int major, int profile)
           
abstract  boolean isSynchronized()
          Returns true if 'makeCurrent' will exhibit synchronized behavior.
static boolean isValidGLVersion(int major, int minor)
           
abstract  int makeCurrent()
          Makes this GLContext current on the calling thread.
protected static void mapVersionAvailable(int reqMajor, int profile, int resMajor, int resMinor, int resCtp)
          Called by GLContextImpl#createContextARBMapVersionsAvailable not intendet to be used by implementations.
 Object putAttachedObject(int name, Object obj)
          Sets the attached user object for the given name to this GLContext.
 Object putAttachedObject(String name, Object obj)
          Sets the attached user object for the given name to this GLContext.
abstract  void release()
          Releases control of this GLContext from the current thread.
protected static void setCurrent(GLContext cur)
          Sets the thread-local variable returned by getCurrent() and has no other side-effects.
abstract  GL setGL(GL gl)
          Sets the GL pipeline object for this GLContext.
abstract  void setGLDrawableRead(GLDrawable read)
          Set the GLDrawable from which this context may be used to read.
If read is null, the default write drawable will be used.
abstract  void setSynchronized(boolean isSynchronized)
          Determines whether 'makeCurrent' will exhibit synchronized behavior.
protected static String toHexString(int hex)
           
protected static String toHexString(long hex)
           
 String toString()
          Classname, GL, GLDrawable
protected static String toString(int val, boolean hex)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CONTEXT_NOT_CURRENT

public static final int CONTEXT_NOT_CURRENT
Indicates that the context was not made current during the last call to makeCurrent.

See Also:
Constant Field Values

CONTEXT_CURRENT

public static final int CONTEXT_CURRENT
Indicates that the context was made current during the last call to makeCurrent.

See Also:
Constant Field Values

CONTEXT_CURRENT_NEW

public static final int CONTEXT_CURRENT_NEW
Indicates that a newly-created context was made current during the last call to makeCurrent.

See Also:
Constant Field Values

context

protected long context

ctxMajorVersion

protected int ctxMajorVersion

ctxMinorVersion

protected int ctxMinorVersion

ctxOptions

protected int ctxOptions

ctxVersionString

protected String ctxVersionString

CTX_IS_ARB_CREATED

protected static final int CTX_IS_ARB_CREATED
ARB_create_context related: created via ARB_create_context

See Also:
Constant Field Values

CTX_PROFILE_COMPAT

protected static final int CTX_PROFILE_COMPAT
ARB_create_context related: compatibility profile

See Also:
Constant Field Values

CTX_PROFILE_CORE

protected static final int CTX_PROFILE_CORE
ARB_create_context related: core profile

See Also:
Constant Field Values

CTX_PROFILE_ES

protected static final int CTX_PROFILE_ES
ARB_create_context related: ES profile

See Also:
Constant Field Values

CTX_OPTION_FORWARD

protected static final int CTX_OPTION_FORWARD
ARB_create_context related: flag forward compatible

See Also:
Constant Field Values

CTX_OPTION_ANY

protected static final int CTX_OPTION_ANY
ARB_create_context related: not flag forward compatible

See Also:
Constant Field Values

CTX_OPTION_DEBUG

protected static final int CTX_OPTION_DEBUG
ARB_create_context related: flag debug

See Also:
Constant Field Values

GL_VERSIONS

public static final int[][] GL_VERSIONS

mappedVersionsAvailable

protected static final com.jogamp.common.util.IntIntHashMap mappedVersionsAvailable

mappedVersionsAvailableSet

protected static volatile boolean mappedVersionsAvailableSet

mappedVersionsAvailableLock

protected static Object mappedVersionsAvailableLock
Constructor Detail

GLContext

public GLContext()
Method Detail

getGLDrawable

public abstract GLDrawable getGLDrawable()
Returns the GLDrawable to which this context may be used to draw.


setGLDrawableRead

public abstract void setGLDrawableRead(GLDrawable read)
Set the GLDrawable from which this context may be used to read.
If read is null, the default write drawable will be used.


getGLDrawableRead

public abstract GLDrawable getGLDrawableRead()
Returns the GLDrawable from which this context may be used to read.


makeCurrent

public abstract int makeCurrent()
                         throws GLException
Makes this GLContext current on the calling thread. There are two return values that indicate success and one that indicates failure. A return value of CONTEXT_CURRENT_NEW indicates that that context has been made current, and that this is the first time this context has been made current, or that the state of the underlying context or drawable may have changed since the last time this context was made current. In this case, the application may wish to initialize the state. A return value of CONTEXT_CURRENT indicates that the context has been made currrent, with its previous state restored. If the context could not be made current (for example, because the underlying drawable has not ben realized on the display) , a value of CONTEXT_NOT_CURRENT is returned. If the context is in use by another thread at the time of the call, then if isSynchronized() is true the call will block. If isSynchronized() is false, an exception will be thrown and the context will remain current on the other thread.

Returns:
CONTEXT_CURRENT if the context was successfully made current
Throws:
GLException - if synchronization is disabled and the context is current on another thread, or because the context could not be created or made current due to non-recoverable, window system-specific errors.

release

public abstract void release()
                      throws GLException
Releases control of this GLContext from the current thread.

Throws:
GLException - if the context had not previously been made current on the current thread

copy

public abstract void copy(GLContext source,
                          int mask)
                   throws GLException
Copies selected groups of OpenGL state variables from the supplied source context into this one. The mask parameter indicates which groups of state variables are to be copied. mask contains the bitwise OR of the same symbolic names that are passed to the GL command glPushAttrib. The single symbolic constant GL_ALL_ATTRIB_BITS can be used to copy the maximum possible portion of rendering state.

Not all values for GL state can be copied. For example, pixel pack and unpack state, render mode state, and select and feedback state are not copied. The state that can be copied is exactly the state that is manipulated by the GL command glPushAttrib.

On most platforms, this context may not be current to any thread, including the calling thread, when this method is called. Some platforms have additional requirements such as whether this context or the source context must occasionally be made current in order for the results of the copy to be seen; these requirements are beyond the scope of this specification.

Parameters:
source - the source OpenGL context from which to copy state
mask - a mask of symbolic names indicating which groups of state to copy
Throws:
GLException - if an OpenGL-related error occurred

getCurrentGL

public static GL getCurrentGL()
                       throws GLException
Returns the GL object bound to this thread current context. If no context is current, throw an GLException

Returns:
the current context's GL object on this thread
Throws:
GLException - if no context is current

getCurrent

public static GLContext getCurrent()
Returns this thread current context. If no context is current, returns null.

Returns:
the context current on this thread, or null if no context is current.

isCurrent

public final boolean isCurrent()
Returns:
true if this GLContext is current on this thread

setCurrent

protected static void setCurrent(GLContext cur)
Sets the thread-local variable returned by getCurrent() and has no other side-effects. For use by third parties adding new GLContext implementations; not for use by end users.


destroy

public abstract void destroy()
Destroys this OpenGL context and frees its associated resources. The context should have been released before this method is called.


isSynchronized

public abstract boolean isSynchronized()
Returns true if 'makeCurrent' will exhibit synchronized behavior.


setSynchronized

public abstract void setSynchronized(boolean isSynchronized)
Determines whether 'makeCurrent' will exhibit synchronized behavior.


getGL

public abstract GL getGL()
Returns the GL pipeline object for this GLContext.


setGL

public abstract GL setGL(GL gl)
Sets the GL pipeline object for this GLContext.

Returns:
the set GL pipeline or null if not successful

getAttachedObject

public Object getAttachedObject(int name)
Returns the attached user object for the given name to this GLContext.


getAttachedObject

public Object getAttachedObject(String name)
Returns the attached user object for the given name to this GLContext.


putAttachedObject

public Object putAttachedObject(int name,
                                Object obj)
Sets the attached user object for the given name to this GLContext. Returns the previously set object or null.


putAttachedObject

public Object putAttachedObject(String name,
                                Object obj)
Sets the attached user object for the given name to this GLContext. Returns the previously set object or null.


toString

public final String toString()
Classname, GL, GLDrawable

Overrides:
toString in class Object

getPlatformExtensionsString

public abstract String getPlatformExtensionsString()
Returns a non-null (but possibly empty) string containing the space-separated list of available platform-dependent (e.g., WGL, GLX) extensions. Can only be called while this context is current.


getGLVersionMajor

public final int getGLVersionMajor()

getGLVersionMinor

public final int getGLVersionMinor()

isGLCompatibilityProfile

public final boolean isGLCompatibilityProfile()

isGLCoreProfile

public final boolean isGLCoreProfile()

isGLEmbeddedProfile

public final boolean isGLEmbeddedProfile()

isGLForwardCompatible

public final boolean isGLForwardCompatible()

isCreatedWithARBMethod

public final boolean isCreatedWithARBMethod()

getGLVersion

public final String getGLVersion()
Returns a valid OpenGL version string, ie major.minor ([option]?[options,]*) - gl-version
  • options
    • old refers to the non ARB_create_context created context
    • new refers to the ARB_create_context created context
    • compatible profile
    • core profile
    • forward compatible
    • any refers to the non forward compatible context
    • ES refers to the GLES context variant
  • gl-version the GL_VERSION string
e.g.:
row 2, cell 1 row 2, cell 2
ES2 2.0 (ES, any, new) - 2.0 ES Profile
ATIGL2 3.0 (compatibility profile, any, new) - 3.2.9704 Compatibility Profile Context
ATIGL3 3.3 (core profile, any, new) - 1.4 (3.2.9704 Compatibility Profile Context)
ATIGL3bc3.3 (compatibility profile, any, new) - 1.4 (3.2.9704 Compatibility Profile Context)
NVGL2 3.0 (compatibility profile, any, new) - 3.0.0 NVIDIA 195.36.07.03
NVGL3 3.3 (core profile, any, new) - 3.3.0 NVIDIA 195.36.07.03
NVGL3bc 3.3 (compatibility profile, any, new) - 3.3.0 NVIDIA 195.36.07.03


isGL4bc

public final boolean isGL4bc()

isGL4

public final boolean isGL4()

isGL3bc

public final boolean isGL3bc()

isGL3

public final boolean isGL3()

isGL2

public final boolean isGL2()

isGL2GL3

public final boolean isGL2GL3()

isGLES1

public final boolean isGLES1()

isGLES2

public final boolean isGLES2()

isGLES

public final boolean isGLES()

isGL2ES1

public final boolean isGL2ES1()

isGL2ES2

public final boolean isGL2ES2()

hasGLSL

public final boolean hasGLSL()

getMaxMajor

public static final int getMaxMajor()

getMaxMinor

public static final int getMaxMinor(int major)

isValidGLVersion

public static final boolean isValidGLVersion(int major,
                                             int minor)

decrementGLVersion

public static final boolean decrementGLVersion(int[] major,
                                               int[] minor)

getGLVersionAvailable

public static final String getGLVersionAvailable(int major,
                                                 int profile)
Parameters:
major - Key Value either 1, 2, 3 or 4
profile - Key Value either CTX_PROFILE_COMPAT, CTX_PROFILE_CORE or CTX_PROFILE_ES

getGLVersionAvailable

public static final boolean getGLVersionAvailable(int reqMajor,
                                                  int reqProfile,
                                                  int[] major,
                                                  int[] minor,
                                                  int[] ctp)
Parameters:
reqMajor - Key Value either 1, 2, 3 or 4
reqProfile - Key Value either CTX_PROFILE_COMPAT, CTX_PROFILE_CORE or CTX_PROFILE_ES
major - if not null, returns the used major version
minor - if not null, returns the used minor version
ctp - if not null, returns the used context profile

isGLVersionAvailable

public static final boolean isGLVersionAvailable(int major,
                                                 int profile)
Parameters:
major - Key Value either 1, 2, 3 or 4
profile - Key Value either CTX_PROFILE_COMPAT, CTX_PROFILE_CORE or CTX_PROFILE_ES

isGL4bcAvailable

public static final boolean isGL4bcAvailable()

isGL4Available

public static final boolean isGL4Available()

isGL3bcAvailable

public static final boolean isGL3bcAvailable()

isGL3Available

public static final boolean isGL3Available()

isGL2Available

public static final boolean isGL2Available()

getGLVersion

public static String getGLVersion(int major,
                                  int minor,
                                  int ctp,
                                  String gl_version)

mapVersionAvailable

protected static void mapVersionAvailable(int reqMajor,
                                          int profile,
                                          int resMajor,
                                          int resMinor,
                                          int resCtp)
Called by GLContextImpl#createContextARBMapVersionsAvailable not intendet to be used by implementations. However, if #createContextARB is not being used within the GLDrawableImpl constructor, GLProfile has to map the available versions.

Parameters:
reqMajor - Key Value either 1, 2, 3 or 4
profile - Key Value either CTX_PROFILE_COMPAT, CTX_PROFILE_CORE or CTX_PROFILE_ES
See Also:
#createContextARBMapVersionsAvailable

compose8bit

protected static int compose8bit(int one,
                                 int two,
                                 int three,
                                 int four)

getComposed8bit

protected static int getComposed8bit(int bits32,
                                     int which)

composed8BitToString

protected static String composed8BitToString(int bits32,
                                             boolean hex1,
                                             boolean hex2,
                                             boolean hex3,
                                             boolean hex4)

toString

protected static String toString(int val,
                                 boolean hex)

toHexString

protected static String toHexString(int hex)

toHexString

protected static String toHexString(long hex)


Copyright 2010 JogAmp Community.