* Since no native windowing system events are being processed, it is recommended * to handle at least the {@link com.jogamp.newt.event.WindowEvent window events}: *
* See example {@link com.jogamp.opengl.test.junit.jogl.acore.TestGLAutoDrawableDelegateNEWT TestGLAutoDrawableDelegateNEWT}. *
*
* OpenGL Context Sharing
* To share a {@link GLContext} see the following note in the documentation overview:
* context sharing
* as well as {@link GLSharedContextSetter}.
*
* The {@link GLContext} can be assigned later manually via {@link GLAutoDrawable#setContext(GLContext, boolean) setContext(ctx)}
* or it will be created lazily at the 1st {@link GLAutoDrawable#display() display()} method call.
* Lazy {@link GLContext} creation will take a shared {@link GLContext} into account
* which has been set {@link #setSharedContext(GLContext) directly}
* or {@link #setSharedAutoDrawable(GLAutoDrawable) via another GLAutoDrawable}.
*
drawable yet,
* may be null for lazy initialization at 1st {@link #display()}.
* @param upstreamWidget optional UI element holding this instance, see {@link #getUpstreamWidget()}.
* @param ownDevice pass true if {@link AbstractGraphicsDevice#close()} shall be issued,
* otherwise pass false. 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.
* @param lock optional custom {@link RecursiveLock}.
*/
public GLAutoDrawableDelegate(final GLDrawable drawable, final GLContext context, final Object upstreamWidget, final boolean ownDevice, final RecursiveLock lock) {
super((GLDrawableImpl)drawable, (GLContextImpl)context, ownDevice);
if(null == drawable) {
throw new IllegalArgumentException("null drawable");
}
this.upstreamWidget = upstreamWidget;
this.lock = ( null != lock ) ? lock : LockFactory.createRecursiveLock() ;
}
//
// expose default methods
//
/** Default implementation to handle repaint events from the windowing system */
public final void windowRepaintOp() {
super.defaultWindowRepaintOp();
}
/**
* Handling resize events from the windowing system.
*
* Implementation:
*
* - resizes {@link #getDelegatedDrawable() the GLDrawable}, if offscreen,
* - triggers a pending {@link GLEventListener#reshape(GLAutoDrawable, int, int, int, int) reshape events}, and
* - issues a {@link #display()} call, if no animator is present.
*
*
*
* All required locks are being claimed.
*
* @param newWidth new width in pixel units
* @param newWidth new height in pixel units
*/
public final void windowResizedOp(final int newWidth, final int newHeight) {
super.defaultWindowResizedOp(newWidth, newHeight);
}
/**
* Implementation to handle destroy notifications from the windowing system.
*
*
* If the {@link NativeSurface} does not implement {@link WindowClosingProtocol}
* or {@link WindowClosingMode#DISPOSE_ON_CLOSE} is enabled (default),
* a thread safe destruction is being induced.
*
*/
public final void windowDestroyNotifyOp() {
super.defaultWindowDestroyNotifyOp();
}
//
// Complete GLAutoDrawable
//
private Object upstreamWidget;
private final RecursiveLock lock;
@Override
public final RecursiveLock getUpstreamLock() { return lock; }
@Override
public final Object getUpstreamWidget() {
return upstreamWidget;
}
/**
* Set the upstream UI toolkit object.
* @see #getUpstreamWidget()
*/
public final void setUpstreamWidget(final Object newUpstreamWidget) {
upstreamWidget = newUpstreamWidget;
}
/**
* {@inheritDoc}
*
* This implementation calls {@link #defaultDestroy()}.
*
*
* User still needs to destroy the upstream window, which details are hidden from this aspect.
* This can be performed by overriding {@link #destroyImplInLock()}.
*
*/
@Override
public final void destroy() {
defaultDestroy();
}
@Override
protected void destroyImplInLock() {
super.destroyImplInLock();
}
@Override
public void display() {
defaultDisplay();
}
//
// GLDrawable delegation
//
@Override
public final GLDrawableFactory getFactory() {
return drawable.getFactory();
}
@Override
public final void swapBuffers() throws GLException {
defaultSwapBuffers();
}
@Override
public String toString() {
return getClass().getSimpleName()+"[ \n\tHelper: " + helper + ", \n\tDrawable: " + drawable +
", \n\tContext: " + context + ", \n\tUpstreamWidget: "+upstreamWidget+ /** ", \n\tFactory: "+factory+ */ "]";
}
}