maspack.render.GL.jogl

Class GLJPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

maspack.render.GL.jogl.GLJPanel

All Implemented Interfaces:

com.jogamp.nativewindow.awt.AWTPrintLifecycle, com.jogamp.nativewindow.NativeSurfaceHolder, com.jogamp.nativewindow.ScalableSurface, com.jogamp.nativewindow.WindowClosingProtocol, com.jogamp.opengl.awt.AWTGLAutoDrawable, com.jogamp.opengl.awt.ComponentEvents, com.jogamp.opengl.GLAutoDrawable, com.jogamp.opengl.GLDrawable, com.jogamp.opengl.GLSharedContextSetter, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class GLJPanel
extends javax.swing.JPanel
implements com.jogamp.opengl.awt.AWTGLAutoDrawable, com.jogamp.nativewindow.WindowClosingProtocol, com.jogamp.nativewindow.awt.AWTPrintLifecycle, com.jogamp.opengl.GLSharedContextSetter, com.jogamp.nativewindow.ScalableSurface

A lightweight Swing component which provides OpenGL rendering support. Provided for compatibility with Swing user interfaces when adding a heavyweight doesn't work either because of Z-ordering or LayoutManager problems.

The GLJPanel can be made transparent by creating it with a GLCapabilities object with alpha bits specified and calling setOpaque(boolean)(false). Pixels with resulting OpenGL alpha values less than 1.0 will be overlaid on any underlying Swing rendering.

This component attempts to use hardware-accelerated rendering via FBO or pbuffers and falls back on to software rendering if none of the former are available using GLDrawableFactory.createOffscreenDrawable(..).

A vertical-flip is required, if the drawable isGLOriented() and vertical flip is not skipped.
In this case this component performs the required vertical flip to bring the content from OpenGL's orientation into AWT's orientation.
In case GLSL based vertical-flip is not available, the CPU intensive System.arraycopy(..) is used line by line. See details about FBO and GLSL vertical flipping.

For performance reasons, as well as for GL state sideeffects, skipping vertical flip is highly recommended!

The OpenGL path is concluded by copying the rendered pixels an BufferedImage via glReadPixels(..) for later Java2D composition.

Finally the Java2D compositioning takes place via via Graphics.drawImage(...) on the prepared BufferedImage as described above.

Please read Java2D OpenGL Remarks.

FBO / GLSL Vertical Flip

If vertical flip is required, FBO is used, GLSL is available and vertical flip is not skipped, a fragment shader is utilized to flip the FBO texture vertically. This hardware-accelerated step can be disabled via system property jogl.gljpanel.noglsl.

The FBO / GLSL code path uses one texture-unit and binds the FBO texture to it's active texture-target, see setTextureUnit(int) and getTextureUnit().

The active and dedicated texture-unit's GL.GL_TEXTURE_2D state is preserved via TextureState.

The current gl-viewport is preserved.

Warning (Bug 842): Certain GL states other than viewport and texture (see above) influencing rendering, will also influence the GLSL vertical flip, e.g. glFrontFace(GL.GL_CCW). It is recommended to reset those states to default when leaving the GLEventListener.display(GLAutoDrawable) method! We may change this behavior in the future, i.e. preserve all influencing states.

OpenGL Context Sharing

To share a GLContext see the following note in the documentation overview: context sharing as well as GLSharedContextSetter.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Nested classes/interfaces inherited from interface com.jogamp.nativewindow.WindowClosingProtocol

com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode

Nested classes/interfaces inherited from interface com.jogamp.nativewindow.awt.AWTPrintLifecycle

com.jogamp.nativewindow.awt.AWTPrintLifecycle.Context

Field Summary

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface com.jogamp.nativewindow.awt.AWTPrintLifecycle

DEFAULT_PRINT_TILE_SIZE

Fields inherited from interface com.jogamp.opengl.GLAutoDrawable

SCREEN_CHANGE_ACTION_ENABLED

Fields inherited from interface com.jogamp.nativewindow.ScalableSurface

AUTOMAX_PIXELSCALE, IDENTITY_PIXELSCALE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
GLJPanel() Creates a new GLJPanel component with a default set of OpenGL capabilities and using the default OpenGL capabilities selection mechanism.
GLJPanel(com.jogamp.opengl.GLCapabilitiesImmutable userCapsRequest) Creates a new GLJPanel component with the requested set of OpenGL capabilities, using the default OpenGL capabilities selection mechanism.
GLJPanel(com.jogamp.opengl.GLCapabilitiesImmutable userCapsRequest, com.jogamp.opengl.GLCapabilitiesChooser chooser) Creates a new GLJPanel component.

Method Summary

Modifier and Type	Method and Description
void	addGLEventListener(com.jogamp.opengl.GLEventListener listener)
void	addGLEventListener(int index, com.jogamp.opengl.GLEventListener listener)
void	addNotify() Overridden to track when this component is added to a container.
boolean	areAllGLEventListenerInitialized()
com.jogamp.opengl.GLContext	createContext(com.jogamp.opengl.GLContext shareWith)
void	destroy() Just an alias for removeNotify
void	display()
com.jogamp.opengl.GLEventListener	disposeGLEventListener(com.jogamp.opengl.GLEventListener listener, boolean remove)
void	flushGLRunnables()
com.jogamp.opengl.GLAnimatorControl	getAnimator()
boolean	getAutoSwapBufferMode()
com.jogamp.opengl.GLCapabilitiesImmutable	getChosenGLCapabilities()
com.jogamp.opengl.GLContext	getContext()
int	getContextCreationFlags()
float[]	getCurrentSurfaceScale(float[] result)
com.jogamp.opengl.util.awt.AWTGLPixelBuffer.AWTGLPixelBufferProvider	getCustomPixelBufferProvider()
com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode	getDefaultCloseOperation()
com.jogamp.opengl.GLDrawable	getDelegatedDrawable()
java.lang.Thread	getExclusiveContextThread()
com.jogamp.opengl.GLDrawableFactory	getFactory()
com.jogamp.opengl.GL	getGL()
com.jogamp.opengl.GLEventListener	getGLEventListener(int index)
int	getGLEventListenerCount()
boolean	getGLEventListenerInitState(com.jogamp.opengl.GLEventListener listener)
com.jogamp.opengl.GLProfile	getGLProfile()
long	getHandle()
float[]	getMaximumSurfaceScale(float[] result)
float[]	getMinimumSurfaceScale(float[] result)
com.jogamp.nativewindow.NativeSurface	getNativeSurface()
com.jogamp.opengl.GLCapabilitiesImmutable	getRequestedGLCapabilities()
float[]	getRequestedSurfaceScale(float[] result)
boolean	getSkipGLOrientationVerticalFlip() See setSkipGLOrientationVerticalFlip(boolean).
int	getSurfaceHeight()
int	getSurfaceWidth()
int	getTextureUnit() Returns the used texture unit, i.e.
com.jogamp.common.util.locks.RecursiveLock	getUpstreamLock()
java.lang.Object	getUpstreamWidget()
boolean	initializeBackend(boolean offthread) Attempts to initialize the backend, if not initialized yet.
boolean	invoke(boolean wait, com.jogamp.opengl.GLRunnable glRunnable)
boolean	invoke(boolean wait, java.util.List<com.jogamp.opengl.GLRunnable> glRunnables)
boolean	isGLOriented()
boolean	isRealized()
boolean	isThreadGLCapable()
void	print(java.awt.Graphics graphics)
void	releasePrint()
com.jogamp.opengl.GLEventListener	removeGLEventListener(com.jogamp.opengl.GLEventListener listener)
void	removeNotify() Overridden to track when this component is removed from a container.
void	reshape(int x, int y, int width, int height) Overridden to cause GLDrawableHelper.reshape(com.jogamp.opengl.GLAutoDrawable, int, int, int, int) to be called on all registered GLEventListeners.
void	setAnimator(com.jogamp.opengl.GLAnimatorControl animatorControl)
void	setAutoSwapBufferMode(boolean enable)
com.jogamp.opengl.GLContext	setContext(com.jogamp.opengl.GLContext newCtx, boolean destroyPrevCtx)
void	setContextCreationFlags(int flags)
com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode	setDefaultCloseOperation(com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode op)
java.lang.Thread	setExclusiveContextThread(java.lang.Thread t)
com.jogamp.opengl.GL	setGL(com.jogamp.opengl.GL gl)
void	setGLEventListenerInitState(com.jogamp.opengl.GLEventListener listener, boolean initialized)
void	setOpaque(boolean opaque)
void	setPixelBufferProvider(com.jogamp.opengl.util.awt.AWTGLPixelBuffer.AWTGLPixelBufferProvider custom)
void	setRealized(boolean realized)
void	setRequestedGLCapabilities(com.jogamp.opengl.GLCapabilitiesImmutable caps) Set a new requested GLCapabilitiesImmutable for this GLJPanel allowing reconfiguration.
void	setSharedAutoDrawable(com.jogamp.opengl.GLAutoDrawable sharedAutoDrawable)
void	setSharedContext(com.jogamp.opengl.GLContext sharedContext)
void	setSkipGLOrientationVerticalFlip(boolean v) Skip isGLOriented() based vertical flip, which usually is required by the offscreen backend, see details about vertical flip and FBO / GLSL vertical flip.
boolean	setSurfaceScale(float[] pixelScale)
void	setTextureUnit(int v) Allows user to request a texture unit to be used, must be called before the first initialization, i.e.
void	setupPrint(double scaleMatX, double scaleMatY, int numSamples, int tileWidth, int tileHeight)
boolean	shouldPreserveColorBufferIfTranslucent() For a translucent GLJPanel (one for which setOpaque(false) has been called), indicates whether the application should preserve the OpenGL color buffer (GL_COLOR_BUFFER_BIT) for correct rendering of the GLJPanel and underlying widgets which may show through portions of the GLJPanel with alpha values less than 1.
void	swapBuffers()
java.lang.String	toString()

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.jogamp.opengl.awt.AWTGLAutoDrawable

repaint, setSize

Methods inherited from interface com.jogamp.opengl.awt.ComponentEvents

addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener

Constructor Detail

GLJPanel

public GLJPanel()
         throws com.jogamp.opengl.GLException

Creates a new GLJPanel component with a default set of OpenGL capabilities and using the default OpenGL capabilities selection mechanism.

See details about OpenGL context sharing.

Throws:

com.jogamp.opengl.GLException - if no default profile is available for the default desktop device.

GLJPanel

public GLJPanel(com.jogamp.opengl.GLCapabilitiesImmutable userCapsRequest)
         throws com.jogamp.opengl.GLException

Creates a new GLJPanel component with the requested set of OpenGL capabilities, using the default OpenGL capabilities selection mechanism.

See details about OpenGL context sharing.

Throws:

com.jogamp.opengl.GLException - if no GLCapabilities are given and no default profile is available for the default desktop device.

GLJPanel

public GLJPanel(com.jogamp.opengl.GLCapabilitiesImmutable userCapsRequest,
                com.jogamp.opengl.GLCapabilitiesChooser chooser)
         throws com.jogamp.opengl.GLException

Creates a new GLJPanel component. The passed GLCapabilities specifies the OpenGL capabilities for the component; if null, a default set of capabilities is used. The GLCapabilitiesChooser specifies the algorithm for selecting one of the available GLCapabilities for the component; a DefaultGLCapabilitesChooser is used if null is passed for this argument.

See details about OpenGL context sharing.

Throws:

com.jogamp.opengl.GLException - if no GLCapabilities are given and no default profile is available for the default desktop device.

Method Detail

initializeBackend

public final boolean initializeBackend(boolean offthread)

Attempts to initialize the backend, if not initialized yet.

If backend is already initialized method returns true.

If offthread is true, initialization will kicked off on a short lived arbitrary thread and method returns immediately. If platform supports such arbitrary thread initialization method returns true, otherwise false.

If offthread is false, initialization be performed on the current thread and method returns after initialization. Method returns true if initialization was successful, otherwise false.

Parameters:

offthread - current or background thread

setSharedContext

public final void setSharedContext(com.jogamp.opengl.GLContext sharedContext)
                            throws java.lang.IllegalStateException

Specified by:

setSharedContext in interface com.jogamp.opengl.GLSharedContextSetter

Throws:

java.lang.IllegalStateException

setSharedAutoDrawable

public final void setSharedAutoDrawable(com.jogamp.opengl.GLAutoDrawable sharedAutoDrawable)
                                 throws java.lang.IllegalStateException

Specified by:

setSharedAutoDrawable in interface com.jogamp.opengl.GLSharedContextSetter

Throws:

java.lang.IllegalStateException

getCustomPixelBufferProvider

public com.jogamp.opengl.util.awt.AWTGLPixelBuffer.AWTGLPixelBufferProvider getCustomPixelBufferProvider()

setPixelBufferProvider

public void setPixelBufferProvider(com.jogamp.opengl.util.awt.AWTGLPixelBuffer.AWTGLPixelBufferProvider custom)
                            throws java.lang.IllegalArgumentException,
                                   java.lang.IllegalStateException

Parameters:

custom - custom AWTGLPixelBuffer.AWTGLPixelBufferProvider

Throws:

java.lang.IllegalArgumentException - if custom is null

java.lang.IllegalStateException - if backend is already realized, i.e. this instanced already painted once.

getUpstreamWidget

public final java.lang.Object getUpstreamWidget()

Specified by:

getUpstreamWidget in interface com.jogamp.opengl.GLAutoDrawable

getUpstreamLock

public final com.jogamp.common.util.locks.RecursiveLock getUpstreamLock()

Specified by:

getUpstreamLock in interface com.jogamp.opengl.GLAutoDrawable

isThreadGLCapable

public final boolean isThreadGLCapable()

Specified by:

isThreadGLCapable in interface com.jogamp.opengl.GLAutoDrawable

display

public void display()

Specified by:

display in interface com.jogamp.opengl.GLAutoDrawable

destroy

public void destroy()

Just an alias for removeNotify

Specified by:

destroy in interface com.jogamp.opengl.GLAutoDrawable

setSurfaceScale

public final boolean setSurfaceScale(float[] pixelScale)

Specified by:

setSurfaceScale in interface com.jogamp.nativewindow.ScalableSurface

getRequestedSurfaceScale

public final float[] getRequestedSurfaceScale(float[] result)

Specified by:

getRequestedSurfaceScale in interface com.jogamp.nativewindow.ScalableSurface

getCurrentSurfaceScale

public final float[] getCurrentSurfaceScale(float[] result)

Specified by:

getCurrentSurfaceScale in interface com.jogamp.nativewindow.ScalableSurface

getMinimumSurfaceScale

public float[] getMinimumSurfaceScale(float[] result)

Specified by:

getMinimumSurfaceScale in interface com.jogamp.nativewindow.ScalableSurface

getMaximumSurfaceScale

public float[] getMaximumSurfaceScale(float[] result)

Specified by:

getMaximumSurfaceScale in interface com.jogamp.nativewindow.ScalableSurface

addNotify

public void addNotify()

Overridden to track when this component is added to a container. Subclasses which override this method must call super.addNotify() in their addNotify() method in order to function properly.

addNotify in class java.awt.Component

Overrides:

addNotify in class javax.swing.JComponent

removeNotify

public void removeNotify()

Overridden to track when this component is removed from a container. Subclasses which override this method must call super.removeNotify() in their removeNotify() method in order to function properly.

removeNotify in class java.awt.Component

Overrides:

removeNotify in class javax.swing.JComponent

reshape

public void reshape(int x,
                    int y,
                    int width,
                    int height)

Overridden to cause GLDrawableHelper.reshape(com.jogamp.opengl.GLAutoDrawable, int, int, int, int) to be called on all registered GLEventListeners. Subclasses which override this method must call super.reshape() in their reshape() method in order to function properly.

Overrides:

reshape in class javax.swing.JComponent

setupPrint

public void setupPrint(double scaleMatX,
                       double scaleMatY,
                       int numSamples,
                       int tileWidth,
                       int tileHeight)

Specified by:

setupPrint in interface com.jogamp.nativewindow.awt.AWTPrintLifecycle

releasePrint

public void releasePrint()

Specified by:

releasePrint in interface com.jogamp.nativewindow.awt.AWTPrintLifecycle

print

public void print(java.awt.Graphics graphics)

Overrides:

print in class javax.swing.JComponent

setOpaque

public void setOpaque(boolean opaque)

Overrides:

setOpaque in class javax.swing.JComponent

addGLEventListener

public void addGLEventListener(com.jogamp.opengl.GLEventListener listener)

Specified by:

addGLEventListener in interface com.jogamp.opengl.GLAutoDrawable

addGLEventListener

public void addGLEventListener(int index,
                               com.jogamp.opengl.GLEventListener listener)

Specified by:

addGLEventListener in interface com.jogamp.opengl.GLAutoDrawable

getGLEventListenerCount

public int getGLEventListenerCount()

Specified by:

getGLEventListenerCount in interface com.jogamp.opengl.GLAutoDrawable

getGLEventListener

public com.jogamp.opengl.GLEventListener getGLEventListener(int index)
                                                     throws java.lang.IndexOutOfBoundsException

Specified by:

getGLEventListener in interface com.jogamp.opengl.GLAutoDrawable

Throws:

java.lang.IndexOutOfBoundsException

areAllGLEventListenerInitialized

public boolean areAllGLEventListenerInitialized()

Specified by:

areAllGLEventListenerInitialized in interface com.jogamp.opengl.GLAutoDrawable

getGLEventListenerInitState

public boolean getGLEventListenerInitState(com.jogamp.opengl.GLEventListener listener)

Specified by:

getGLEventListenerInitState in interface com.jogamp.opengl.GLAutoDrawable

setGLEventListenerInitState

public void setGLEventListenerInitState(com.jogamp.opengl.GLEventListener listener,
                                        boolean initialized)

Specified by:

setGLEventListenerInitState in interface com.jogamp.opengl.GLAutoDrawable

disposeGLEventListener

public com.jogamp.opengl.GLEventListener disposeGLEventListener(com.jogamp.opengl.GLEventListener listener,
                                                                boolean remove)

Specified by:

disposeGLEventListener in interface com.jogamp.opengl.GLAutoDrawable

removeGLEventListener

public com.jogamp.opengl.GLEventListener removeGLEventListener(com.jogamp.opengl.GLEventListener listener)

Specified by:

removeGLEventListener in interface com.jogamp.opengl.GLAutoDrawable

setAnimator

public void setAnimator(com.jogamp.opengl.GLAnimatorControl animatorControl)

Specified by:

setAnimator in interface com.jogamp.opengl.GLAutoDrawable

getAnimator

public com.jogamp.opengl.GLAnimatorControl getAnimator()

Specified by:

getAnimator in interface com.jogamp.opengl.GLAutoDrawable

setExclusiveContextThread

public final java.lang.Thread setExclusiveContextThread(java.lang.Thread t)
                                                 throws com.jogamp.opengl.GLException

Specified by:

setExclusiveContextThread in interface com.jogamp.opengl.GLAutoDrawable

Throws:

com.jogamp.opengl.GLException

getExclusiveContextThread

public final java.lang.Thread getExclusiveContextThread()

Specified by:

getExclusiveContextThread in interface com.jogamp.opengl.GLAutoDrawable

invoke

public boolean invoke(boolean wait,
                      com.jogamp.opengl.GLRunnable glRunnable)
               throws java.lang.IllegalStateException

Specified by:

invoke in interface com.jogamp.opengl.GLAutoDrawable

Throws:

java.lang.IllegalStateException

invoke

public boolean invoke(boolean wait,
                      java.util.List<com.jogamp.opengl.GLRunnable> glRunnables)
               throws java.lang.IllegalStateException

Specified by:

invoke in interface com.jogamp.opengl.GLAutoDrawable

Throws:

java.lang.IllegalStateException

flushGLRunnables

public void flushGLRunnables()

Specified by:

flushGLRunnables in interface com.jogamp.opengl.GLAutoDrawable

createContext

public com.jogamp.opengl.GLContext createContext(com.jogamp.opengl.GLContext shareWith)

Specified by:

createContext in interface com.jogamp.opengl.GLAutoDrawable

Specified by:

createContext in interface com.jogamp.opengl.GLDrawable

setRealized

public void setRealized(boolean realized)

Specified by:

setRealized in interface com.jogamp.opengl.GLDrawable

isRealized

public boolean isRealized()

Specified by:

isRealized in interface com.jogamp.opengl.GLDrawable

setContext

public com.jogamp.opengl.GLContext setContext(com.jogamp.opengl.GLContext newCtx,
                                              boolean destroyPrevCtx)

Specified by:

setContext in interface com.jogamp.opengl.GLAutoDrawable

getDelegatedDrawable

public final com.jogamp.opengl.GLDrawable getDelegatedDrawable()

Specified by:

getDelegatedDrawable in interface com.jogamp.opengl.GLAutoDrawable

getContext

public com.jogamp.opengl.GLContext getContext()

Specified by:

getContext in interface com.jogamp.opengl.GLAutoDrawable

getGL

public com.jogamp.opengl.GL getGL()

Specified by:

getGL in interface com.jogamp.opengl.GLAutoDrawable

setGL

public com.jogamp.opengl.GL setGL(com.jogamp.opengl.GL gl)

Specified by:

setGL in interface com.jogamp.opengl.GLAutoDrawable

setAutoSwapBufferMode

public void setAutoSwapBufferMode(boolean enable)

Specified by:

setAutoSwapBufferMode in interface com.jogamp.opengl.GLAutoDrawable

getAutoSwapBufferMode

public boolean getAutoSwapBufferMode()

Specified by:

getAutoSwapBufferMode in interface com.jogamp.opengl.GLAutoDrawable

swapBuffers

public void swapBuffers()

Specified by:

swapBuffers in interface com.jogamp.opengl.GLDrawable

setContextCreationFlags

public void setContextCreationFlags(int flags)

Specified by:

setContextCreationFlags in interface com.jogamp.opengl.GLAutoDrawable

getContextCreationFlags

public int getContextCreationFlags()

Specified by:

getContextCreationFlags in interface com.jogamp.opengl.GLAutoDrawable

shouldPreserveColorBufferIfTranslucent

public boolean shouldPreserveColorBufferIfTranslucent()

For a translucent GLJPanel (one for which setOpaque(false) has been called), indicates whether the application should preserve the OpenGL color buffer (GL_COLOR_BUFFER_BIT) for correct rendering of the GLJPanel and underlying widgets which may show through portions of the GLJPanel with alpha values less than 1. Most Swing implementations currently expect the GLJPanel to be completely cleared (e.g., by glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)), but for certain optimized Swing implementations which use OpenGL internally, it may be possible to perform OpenGL rendering using the GLJPanel into the same OpenGL drawable as the Swing implementation uses.

getSurfaceWidth

public int getSurfaceWidth()

Specified by:

getSurfaceWidth in interface com.jogamp.opengl.GLDrawable

getSurfaceHeight

public int getSurfaceHeight()

Specified by:

getSurfaceHeight in interface com.jogamp.opengl.GLDrawable

isGLOriented

public boolean isGLOriented()

Method returns a valid value only after the backend has been initialized, either eagerly or manually via the first display call. Method always returns a valid value when called from within a GLEventListener.

Specified by:

isGLOriented in interface com.jogamp.opengl.GLDrawable

setSkipGLOrientationVerticalFlip

public final void setSkipGLOrientationVerticalFlip(boolean v)

Skip isGLOriented() based vertical flip, which usually is required by the offscreen backend, see details about vertical flip and FBO / GLSL vertical flip.

If set to true, user needs to flip the OpenGL rendered scene if isGLOriented() == true, e.g. via the projection matrix. See constraints of isGLOriented().

getSkipGLOrientationVerticalFlip

public final boolean getSkipGLOrientationVerticalFlip()

See setSkipGLOrientationVerticalFlip(boolean).

getChosenGLCapabilities

public com.jogamp.opengl.GLCapabilitiesImmutable getChosenGLCapabilities()

Specified by:

getChosenGLCapabilities in interface com.jogamp.opengl.GLDrawable

getRequestedGLCapabilities

public final com.jogamp.opengl.GLCapabilitiesImmutable getRequestedGLCapabilities()

Specified by:

getRequestedGLCapabilities in interface com.jogamp.opengl.GLDrawable

setRequestedGLCapabilities

public final void setRequestedGLCapabilities(com.jogamp.opengl.GLCapabilitiesImmutable caps)

Set a new requested GLCapabilitiesImmutable for this GLJPanel allowing reconfiguration.

Method shall be invoked from the AWT-EDT thread. In case it is not invoked on the AWT-EDT thread, an attempt is made to do so.

Method will dispose a previous realized GLContext and offscreen backend!

Parameters:

caps - new capabilities.

getGLProfile

public final com.jogamp.opengl.GLProfile getGLProfile()

Specified by:

getGLProfile in interface com.jogamp.opengl.GLDrawable

getNativeSurface

public com.jogamp.nativewindow.NativeSurface getNativeSurface()

Specified by:

getNativeSurface in interface com.jogamp.nativewindow.NativeSurfaceHolder

Specified by:

getNativeSurface in interface com.jogamp.opengl.GLDrawable

getHandle

public long getHandle()

Specified by:

getHandle in interface com.jogamp.opengl.GLDrawable

getFactory

public final com.jogamp.opengl.GLDrawableFactory getFactory()

Specified by:

getFactory in interface com.jogamp.opengl.GLDrawable

getTextureUnit

public final int getTextureUnit()

Returns the used texture unit, i.e. a value of [0..n], or -1 if non used.

If implementation uses a texture-unit, it will be known only after the first initialization, i.e. display call.

See FBO / GLSL Vertical Flip.

setTextureUnit

public final void setTextureUnit(int v)

Allows user to request a texture unit to be used, must be called before the first initialization, i.e. display() call.

Defaults to 0.

See FBO / GLSL Vertical Flip.

Parameters:

v - requested texture unit

See Also:

getTextureUnit()

getDefaultCloseOperation

public com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode getDefaultCloseOperation()

Specified by:

getDefaultCloseOperation in interface com.jogamp.nativewindow.WindowClosingProtocol

setDefaultCloseOperation

public com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode setDefaultCloseOperation(com.jogamp.nativewindow.WindowClosingProtocol.WindowClosingMode op)

Specified by:

setDefaultCloseOperation in interface com.jogamp.nativewindow.WindowClosingProtocol

toString

public java.lang.String toString()

Specified by:

toString in interface com.jogamp.opengl.GLDrawable

Overrides:

toString in class java.awt.Component