|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.media.opengl.GLContext
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 | |
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 . |
Constructor Summary | |
GLContext()
|
Method Summary | |
abstract void |
destroy()
Destroys this OpenGL context and frees its associated resources. |
static GLContext |
getCurrent()
Returns the context which is current on the current thread. |
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 boolean |
isSynchronized()
Returns true if 'makeCurrent' will exhibit synchronized behavior. |
abstract int |
makeCurrent()
Makes this GLContext current on the calling thread. |
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 void |
setGL(GL gl)
Sets the GL pipeline object for this GLContext. |
abstract void |
setSynchronized(boolean isSynchronized)
Determines whether 'makeCurrent' will exhibit synchronized behavior. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int CONTEXT_NOT_CURRENT
makeCurrent
.
public static final int CONTEXT_CURRENT
makeCurrent
.
public static final int CONTEXT_CURRENT_NEW
makeCurrent
.
Constructor Detail |
public GLContext()
Method Detail |
public abstract GLDrawable getGLDrawable()
public abstract int makeCurrent() throws GLException
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.public abstract void release() throws GLException
GLException
- if the context had not previously been made
current on the current threadpublic static GLContext getCurrent()
protected static void setCurrent(GLContext cur)
getCurrent()
and has no other side-effects. For use by third parties adding
new GLContext implementations; not for use by end users.
public abstract void destroy()
public abstract boolean isSynchronized()
public abstract void setSynchronized(boolean isSynchronized)
public abstract GL getGL()
public abstract void setGL(GL gl)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |