Class GLAutoDrawableDelegate
- All Implemented Interfaces:
NativeSurfaceHolder
,FPSCounter
,GLAutoDrawable
,GLDrawable
,GLSharedContextSetter
,GLStateKeeper
GLAutoDrawable
implementation
utilizing already created GLDrawable
and GLContext
instances.
Since no native windowing system events are being processed, it is recommended
to handle at least the window events
:
repaint
usingwindowRepaintOp()
resize
using#windowResizedOp()
custom toolkit destruction
issuing windowDestroyNotifyOp()
.
See example TestGLAutoDrawableDelegateNEWT
.
OpenGL Context Sharing
To share a GLContext
see the following note in the documentation overview:
context sharing
as well as GLSharedContextSetter
.
-
Nested Class Summary
Nested classes/interfaces inherited from interface com.jogamp.opengl.GLStateKeeper
GLStateKeeper.Listener
-
Field Summary
Fields inherited from class jogamp.opengl.GLAutoDrawableBase
DEBUG
Fields inherited from interface com.jogamp.opengl.FPSCounter
DEFAULT_FRAMES_PER_INTERVAL
Fields inherited from interface com.jogamp.opengl.GLAutoDrawable
SCREEN_CHANGE_ACTION_ENABLED
-
Constructor Summary
ConstructorsConstructorDescriptionGLAutoDrawableDelegate
(GLDrawable drawable, GLContext context, Object upstreamWidget, boolean ownDevice, com.jogamp.common.util.locks.RecursiveLock lock) TheGLContext
can be assigned later manually viasetContext(ctx)
or it will be created lazily at the 1stdisplay()
method call.
LazyGLContext
creation will take a sharedGLContext
into account which has been setdirectly
orvia another GLAutoDrawable
. -
Method Summary
Modifier and TypeMethodDescriptionfinal void
destroy()
Destroys all resources associated with this GLAutoDrawable, inclusive the GLContext.void
display()
Causes OpenGL rendering to be performed for this GLAutoDrawable in the following order: Callingdisplay(..)
for all registeredGLEventListener
s.final GLDrawableFactory
Return theGLDrawableFactory
being used to create this instance.final com.jogamp.common.util.locks.RecursiveLock
Returns the recursive lock object of theupstream widget
to synchronize multithreaded access on top ofNativeSurface.lockSurface()
.final Object
Method may return the upstream UI toolkit object holding thisGLAutoDrawable
instance, if exist.final void
setUpstreamWidget
(Object newUpstreamWidget) Set the upstream UI toolkit object.final void
Swaps the front and back buffers of this drawable.toString()
final void
Implementation to handle destroy notifications from the windowing system.final void
Default implementation to handle repaint events from the windowing systemfinal void
windowResizedOp
(int newWidth, int newHeight) Handling resize events from the windowing system.Methods inherited from class jogamp.opengl.GLAutoDrawableBase
addGLEventListener, addGLEventListener, areAllGLEventListenerInitialized, clearPreservedGLState, createContext, defaultSwapBuffers, disposeGLEventListener, flushGLRunnables, getAnimator, getAutoSwapBufferMode, getChosenGLCapabilities, getContext, getContextCreationFlags, getDelegatedDrawable, getExclusiveContextThread, getFPSStartTime, getGL, getGLEventListener, getGLEventListenerCount, getGLEventListenerInitState, getGLProfile, getHandle, getLastFPS, getLastFPSPeriod, getLastFPSUpdateTime, getNativeSurface, getPreservedGLState, getRequestedGLCapabilities, getSurfaceHeight, getSurfaceWidth, getTotalFPS, getTotalFPSDuration, getTotalFPSFrames, getUpdateFPSFrames, invoke, invoke, invokeOnCurrentThread, invokeOnNewThread, isGLOriented, isGLStatePreservationSupported, isRealized, isThreadGLCapable, preserveGLStateAtDestroy, removeGLEventListener, resetFPSCounter, setAnimator, setAutoSwapBufferMode, setContext, setContextCreationFlags, setExclusiveContextThread, setGL, setGLEventListenerInitState, setGLStateKeeperListener, setRealized, setSharedAutoDrawable, setSharedContext, setUpdateFPSFrames
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.jogamp.opengl.GLAutoDrawable
addGLEventListener, addGLEventListener, areAllGLEventListenerInitialized, createContext, disposeGLEventListener, flushGLRunnables, getAnimator, getAutoSwapBufferMode, getContext, getContextCreationFlags, getDelegatedDrawable, getExclusiveContextThread, getGL, getGLEventListener, getGLEventListenerCount, getGLEventListenerInitState, invoke, invoke, isThreadGLCapable, removeGLEventListener, setAnimator, setAutoSwapBufferMode, setContext, setContextCreationFlags, setExclusiveContextThread, setGL, setGLEventListenerInitState
Methods inherited from interface com.jogamp.opengl.GLDrawable
getChosenGLCapabilities, getGLProfile, getHandle, getNativeSurface, getRequestedGLCapabilities, getSurfaceHeight, getSurfaceWidth, isGLOriented, isRealized, setRealized
-
Constructor Details
-
GLAutoDrawableDelegate
public GLAutoDrawableDelegate(GLDrawable drawable, GLContext context, Object upstreamWidget, boolean ownDevice, com.jogamp.common.util.locks.RecursiveLock lock) The
GLContext
can be assigned later manually viasetContext(ctx)
or it will be created lazily at the 1stdisplay()
method call.
LazyGLContext
creation will take a sharedGLContext
into account which has been setdirectly
orvia another GLAutoDrawable
.- Parameters:
drawable
- a validGLDrawable
, may not berealized
yet.context
- a validGLContext
, may not have been made current (created) yet, may not be associated w/drawable
yet, may be
null
for lazy initialization at 1stdisplay()
.upstreamWidget
- optional UI element holding this instance, seegetUpstreamWidget()
.ownDevice
- passtrue
ifAbstractGraphicsDevice.close()
shall be issued, otherwise passfalse
. Closing the device is required in case the drawable is created w/ it's own new instance, e.g. offscreen drawables, and no further lifecycle handling is applied.lock
- optional customRecursiveLock
.
-
-
Method Details
-
windowRepaintOp
public final void windowRepaintOp()Default implementation to handle repaint events from the windowing system -
windowResizedOp
public final void windowResizedOp(int newWidth, int newHeight) Handling resize events from the windowing system.Implementation:
- resizes
the GLDrawable
, if offscreen, - triggers a pending
reshape events
, and - issues a
display()
call, if no animator is present.
All required locks are being claimed.
- Parameters:
newWidth
- new width in pixel unitsnewWidth
- new height in pixel units
- resizes
-
windowDestroyNotifyOp
public final void windowDestroyNotifyOp()Implementation to handle destroy notifications from the windowing system.If the
NativeSurface
does not implementWindowClosingProtocol
orWindowClosingProtocol.WindowClosingMode.DISPOSE_ON_CLOSE
is enabled (default), a thread safe destruction is being induced. -
getUpstreamLock
public final com.jogamp.common.util.locks.RecursiveLock getUpstreamLock()Description copied from interface:GLAutoDrawable
Returns the recursive lock object of theupstream widget
to synchronize multithreaded access on top ofNativeSurface.lockSurface()
.- Specified by:
getUpstreamLock
in interfaceGLAutoDrawable
-
getUpstreamWidget
Description copied from interface:GLAutoDrawable
Method may return the upstream UI toolkit object holding thisGLAutoDrawable
instance, if exist.Currently known Java UI toolkits and it's known return types are:
Toolkit GLAutoDrawable Implementation ~ Return Type of getUpstreamWidget()</td NEWT GLWindow
has a Window
</tdSWT GLCanvas
is a Canvas
</tdAWT GLCanvas
is a Canvas
</tdAWT GLJPanel
is a JPanel
</tdThis method may also return
null
if no UI toolkit is being used, as common for offscreen rendering.- Specified by:
getUpstreamWidget
in interfaceGLAutoDrawable
-
setUpstreamWidget
Set the upstream UI toolkit object.- See Also:
-
destroy
public final void destroy()Destroys all resources associated with this GLAutoDrawable, inclusive the GLContext. If a window is attached to it's implementation, it shall be closed. Causes disposing of all OpenGL resources by callingdispose(..)
for all registeredGLEventListener
s. Called automatically by the window system toolkit upon receiving a destroy notification. This routine may be called manually.This implementation calls
GLAutoDrawableBase.defaultDestroy()
.User still needs to destroy the upstream window, which details are hidden from this aspect. This can be performed by overriding
destroyImplInLock()
.- Specified by:
destroy
in interfaceGLAutoDrawable
-
display
public void display()Description copied from interface:GLAutoDrawable
Causes OpenGL rendering to be performed for this GLAutoDrawable in the following order:
- Calling
display(..)
for all registeredGLEventListener
s. - Executes all one-shot
GLRunnable
, enqueued viaGLAutoDrawable.invoke(boolean, GLRunnable)
.
May be called periodically by a running
GLAnimatorControl
implementation,
which must register itself withGLAutoDrawable.setAnimator(com.jogamp.opengl.GLAnimatorControl)
.Called automatically by the window system toolkit upon receiving a repaint() request,
except anGLAnimatorControl
implementationGLAnimatorControl.isAnimating()
.This routine may also be called manually for better control over the rendering process. It is legal to call another GLAutoDrawable's display method from within the
display(..)
callback.In case of a new generated OpenGL context, the implementation shall call
init(..)
for all registeredGLEventListener
s before making the actualdisplay(..)
calls, in case this has not been done yet.- Specified by:
display
in interfaceGLAutoDrawable
- See Also:
- Calling
-
getFactory
Description copied from interface:GLDrawable
Return theGLDrawableFactory
being used to create this instance.- Specified by:
getFactory
in interfaceGLDrawable
-
swapBuffers
Description copied from interface:GLDrawable
Swaps the front and back buffers of this drawable. ForGLAutoDrawable
implementations, when automatic buffer swapping is enabled (as is the default), this method is called automatically and should not be called by the end user.- Specified by:
swapBuffers
in interfaceGLDrawable
- Throws:
GLException
-
toString
- Specified by:
toString
in interfaceGLDrawable
- Overrides:
toString
in classjogamp.opengl.GLAutoDrawableBase
-