maspack.render.GL

Class GLSharedResources

java.lang.Object

maspack.render.GL.GLSharedResources

All Implemented Interfaces:

com.jogamp.opengl.GLEventListener, java.util.EventListener, GLGarbageSource

Direct Known Subclasses:

GL2SharedResources, GL3SharedResources

public abstract class GLSharedResources
extends java.lang.Object
implements com.jogamp.opengl.GLEventListener, GLGarbageSource

Container class for resources tied to a particular context. There should one set of resources per context.

Author:

antonio

Constructor Summary

Constructors

Constructor and Description
GLSharedResources(com.jogamp.opengl.GLCapabilities cap)

Method Summary

Modifier and Type	Method and Description
com.jogamp.opengl.awt.GLCanvas	createCanvas() Creates a canvas with the same capabilities and shared context as other viewers using this set of resources.
GLJPanel	createPanel() Creates a canvas with the same capabilities and shared context as other viewers using this set of resources.
void	deregisterViewer(java.lang.Object viewer) Unregisters a particular viewer with this set of resources.
void	display(com.jogamp.opengl.GLAutoDrawable drawable)
void	dispose(com.jogamp.opengl.GL gl) Clears all resources with the associated with the master
void	dispose(com.jogamp.opengl.GLAutoDrawable drawable)
void	disposeResource(GLResource res)
void	garbage(com.jogamp.opengl.GL gl)
long	getGarbageCollectionInterval()
com.jogamp.opengl.GLCapabilities	getGLCapabilities() Returns the capabilities of the underlying GL context
GLTexture	getOrLoadTexture(com.jogamp.opengl.GL gl, TextureContent content)
GLTexture	getTexture(com.jogamp.opengl.GL gl, TextureContent content)
void	init(com.jogamp.opengl.GLAutoDrawable drawable)
boolean	isGarbageTimerEnabled()
boolean	maybeRunGarbageCollection(com.jogamp.opengl.GL gl) Runs garbage collection if sufficient time has passed since the last collection, as specified by the garbage collection interval
void	registerViewer(java.lang.Object viewer) Register a particular viewer with this set of resources.
void	reshape(com.jogamp.opengl.GLAutoDrawable drawable, int x, int y, int width, int height)
void	runGarbageCollection(com.jogamp.opengl.GL gl)
void	setGarbageCollectionInterval(long ms) Time interval for running garbage collection, either with a separate timed thread, or by manual calls to maybeRunGarbageCollection(GL).
void	setGarbageTimerEnabled(boolean set) Enables or disables an automatic garbage timer.
void	track(GLResource res)

Methods inherited from class java.lang.Object

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

Constructor Detail

GLSharedResources

public GLSharedResources(com.jogamp.opengl.GLCapabilities cap)

Method Detail

getGLCapabilities

public com.jogamp.opengl.GLCapabilities getGLCapabilities()

Returns the capabilities of the underlying GL context

Returns:

the GL capabilities

garbage

public void garbage(com.jogamp.opengl.GL gl)

Specified by:

garbage in interface GLGarbageSource

createCanvas

public com.jogamp.opengl.awt.GLCanvas createCanvas()

Creates a canvas with the same capabilities and shared context as other viewers using this set of resources. This ensures that the sharing of resources is properly initialized.

Returns:

the created canvas

createPanel

public GLJPanel createPanel()

Creates a canvas with the same capabilities and shared context as other viewers using this set of resources. This ensures that the sharing of resources is properly initialized. MUST BE CALLED IN THE GLViewer's CONSTRUCTOR!!

Returns:

the created canvas

registerViewer

public void registerViewer(java.lang.Object viewer)

Register a particular viewer with this set of resources. MUST BE CALLED IN THE GLViewer's CONSTRUCTOR!!

Parameters:

viewer - the viewer with which to share resources.

deregisterViewer

public void deregisterViewer(java.lang.Object viewer)

Unregisters a particular viewer with this set of resources. MUST BE CALLED IN THE GLViewer's dispose() METHOD.

dispose

public void dispose(com.jogamp.opengl.GL gl)

Clears all resources with the associated with the master

Specified by:

dispose in interface GLGarbageSource

getTexture

public GLTexture getTexture(com.jogamp.opengl.GL gl,
                            TextureContent content)

getOrLoadTexture

public GLTexture getOrLoadTexture(com.jogamp.opengl.GL gl,
                                  TextureContent content)

init

public void init(com.jogamp.opengl.GLAutoDrawable drawable)

Specified by:

init in interface com.jogamp.opengl.GLEventListener

dispose

public void dispose(com.jogamp.opengl.GLAutoDrawable drawable)

Specified by:

dispose in interface com.jogamp.opengl.GLEventListener

track

public void track(GLResource res)

disposeResource

public void disposeResource(GLResource res)

runGarbageCollection

public void runGarbageCollection(com.jogamp.opengl.GL gl)

maybeRunGarbageCollection

public boolean maybeRunGarbageCollection(com.jogamp.opengl.GL gl)

Runs garbage collection if sufficient time has passed since the last collection, as specified by the garbage collection interval

Returns:

true if garbage collection run

setGarbageTimerEnabled

public void setGarbageTimerEnabled(boolean set)

Enables or disables an automatic garbage timer. This timer runs on a separate thread.

isGarbageTimerEnabled

public boolean isGarbageTimerEnabled()

setGarbageCollectionInterval

public void setGarbageCollectionInterval(long ms)

Time interval for running garbage collection, either with a separate timed thread, or by manual calls to maybeRunGarbageCollection(GL).

Parameters:

ms - time interval for collection in ms

getGarbageCollectionInterval

public long getGarbageCollectionInterval()

display

public void display(com.jogamp.opengl.GLAutoDrawable drawable)

Specified by:

display in interface com.jogamp.opengl.GLEventListener

reshape

public void reshape(com.jogamp.opengl.GLAutoDrawable drawable,
                    int x,
                    int y,
                    int width,
                    int height)

Specified by:

reshape in interface com.jogamp.opengl.GLEventListener