public interface GLDrawable extends NativeSurfaceHolder
GLAutoDrawabledo so upon creation.
|Modifier and Type||Method and Description|
Creates a new context for drawing to this drawable that will optionally share buffer objects, textures and other server-side OpenGL objects with the specified GLContext.
Indicates to GLDrawable implementations whether the underlying
Swaps the front and back buffers of this drawable.
share need not be associated with this
GLDrawable and may be null if sharing of display lists and other
objects is not desired. See the note in the overview
as well as
void setRealized(boolean realized)
surfacehas been created and can be drawn into.
End users do not need to call this method; it is not necessary to
setRealized on a
as these perform the appropriate calls on their underlying GLDrawables internally.
Developers implementing new OpenGL components for various window
toolkits need to call this method against GLDrawables obtained
from the GLDrawableFactory via the
It must typically be
called with an argument of
true when the component
associated with the GLDrawable is realized and with an argument
false just before the component is unrealized.
For the AWT, this means calling
addNotify method and with an argument of
false in the
GLDrawable implementations should handle multiple
setRealized(false) calls. Most, if not all, Java
window toolkits have a persistent object associated with a given
component, regardless of whether that component is currently
GLDrawable object associated with a
particular component is intended to be similarly persistent. A
GLDrawable is intended to be created for a given
component when it is constructed and live as long as that
setRealized allows the
GLDrawable to re-initialize and destroy any
associated resources as the component becomes realized and
With an argument of
the minimum implementation shall call
NativeSurface's lockSurface() and if successful:
GLCapabilities, which are associated with the attached
NativeSurface's lockSurface()ensures resolving the window/surface handles, and the drawable's
GLCapabilitiesmight have changed.
Calling this method has no other effects. For example, if
removeNotify is called on a Canvas implementation
for which a GLDrawable has been created, it is also necessary to
destroy all OpenGL contexts associated with that GLDrawable. This
is not done automatically by the implementation.
trueif this drawable is realized, otherwise
A drawable can be realized and unrealized via
trueif the drawable is rendered in OpenGL's coordinate system, origin at bottom left. Otherwise returns
false, i.e. origin at top left.
Default impl. is
true, i.e. OpenGL coordinate system.
Currently only MS-Windows bitmap offscreen drawable uses a non OpenGL orientation and hence returns
This removes the need of a vertical flip when used in AWT or Windows applications.
void swapBuffers() throws GLException
GLAutoDrawableimplementations, when automatic buffer swapping is enabled (as is the default), this method is called automatically and should not be called by the end user.
GLCapabilitiesImmutablecorresponding to the chosen OpenGL capabilities (pixel format / visual / GLProfile) for this drawable.
This query only returns the chosen capabilities if
On some platforms, the pixel format is not directly associated with the drawable; a best attempt is made to return a reasonable value in this case.
GLCapabilitiesImmutablecorresponding to the user requested OpenGL capabilities (pixel format / visual / GLProfile) for this drawable.
GLProfilefor this drawable. Returns the GLProfile object, no copy.
realizationand while it's
On EGL it is represented by the EGLSurface.
On X11/GLX it is represented by either the Window XID, GLXPixmap, or GLXPbuffer.
On Windows it is represented by the HDC, which may change with each
GLDrawableFactorybeing used to create this instance.
Copyright 2010 JogAmp Community.