maspack.render.GL.GL3

Class GL3SharedObject

java.lang.Object

maspack.util.ReferenceCountedBase

maspack.render.GL.GLResourceBase

maspack.render.GL.GL3.GL3ResourceBase

maspack.render.GL.GL3.GL3SharedObject

All Implemented Interfaces:

GL3Resource, GL3SharedDrawable, GLResource, ReferenceCounted

Direct Known Subclasses:

GL3SharedPrimitive

public class GL3SharedObject
extends GL3ResourceBase
implements GL3SharedDrawable

Holds pointers to VBOs, attribute info, to be used in creating VAOs. These can be shared between contexts, but each context needs to maintain its own VAOs.

Author:

Antonio

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GL3SharedObject.DrawType

Constructor Summary

Constructors

Constructor and Description
GL3SharedObject(GL3VertexAttributeArray[] attributes, GL3ElementAttributeArray elements)
GL3SharedObject(GL3VertexAttributeArray[] attributes, GL3ElementAttributeArray elements, int glMode)
GL3SharedObject(GL3VertexAttributeArray[] attributes, GL3ElementAttributeArray elements, VertexBufferObject[] vbos, IndexBufferObject ibo, int glMode)

Method Summary

Modifier and Type	Method and Description
GL3SharedObject	acquire() Signal the resource that something is holding a reference to it.
void	bind(com.jogamp.opengl.GL3 gl) Binds attributes to the currently active GL object
void	bindAttributes(com.jogamp.opengl.GL3 gl) Bind program attributes to the given program (uses the program's attribute locations)
int	createVAO(com.jogamp.opengl.GL3 gl) Creates and binds a vertex array object attached to a given program.
void	dispose() Release hold on any VBOs/IBOs
void	dispose(com.jogamp.opengl.GL3 gl) Release hold on any VBOs/IBOs
void	draw(com.jogamp.opengl.GL3 gl) Draw to the provided active context
void	draw(com.jogamp.opengl.GL3 gl, int start, int count)
void	draw(com.jogamp.opengl.GL3 gl, int mode, int start, int count)
void	drawArrays(com.jogamp.opengl.GL3 gl, int mode)
void	drawArrays(com.jogamp.opengl.GL3 gl, int mode, int start, int count)
void	drawElements(com.jogamp.opengl.GL3 gl, int mode, int start, int count, int indexType)
void	drawInstanced(com.jogamp.opengl.GL3 gl, int instances) Draw using instanced rendering to the active context
void	drawInstanced(com.jogamp.opengl.GL3 gl, int mode, int instanceCount)
void	drawInstancedArray(com.jogamp.opengl.GL3 gl, int mode, int start, int count, int instances)
void	drawInstancedElements(com.jogamp.opengl.GL3 gl, int mode, int start, int count, int instances)
void	drawWithVAO(com.jogamp.opengl.GL3 gl) Inefficient, generates VAO and destroys it
boolean	equals(GL3SharedDrawable other) Compares to another drawable to see if same
int	getBindVersion() A version number corresponding to the necessary bound state of the drawable's attributes.
int	getCount()
GL3SharedObject.DrawType	getDrawType()
GL3ElementAttributeArray	getGL3ElementAttribute()
GL3VertexAttributeArray[]	getGL3VertexAttributes()
int	getMode()
int	getNumInstances()
int	getStart()
boolean	isDisposed() Returns true if resource has been disposed
boolean	isValid() Checks whether all internal GL resources are still valid
void	setDrawInfo(int start, int count, int glMode)
void	setDrawInfo(int start, int count, int glMode, int numInstances)

Methods inherited from class maspack.render.GL.GL3.GL3ResourceBase

dispose, disposeInvalid, disposeInvalid, disposeUnreferenced, disposeUnreferenced, releaseDispose, releaseDispose

Methods inherited from class maspack.util.ReferenceCountedBase

acquireAndCount, getReferenceCount, release, releaseAndCount

Methods inherited from class java.lang.Object

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

Methods inherited from interface maspack.render.GL.GL3.GL3SharedDrawable

hashCode

Methods inherited from interface maspack.render.GL.GL3.GL3Resource

disposeInvalid, disposeUnreferenced, releaseDispose

Methods inherited from interface maspack.render.GL.GLResource

dispose, disposeInvalid, disposeUnreferenced, releaseDispose

Methods inherited from interface maspack.util.ReferenceCounted

acquireAndCount, getReferenceCount, release, releaseAndCount

Constructor Detail

GL3SharedObject

public GL3SharedObject(GL3VertexAttributeArray[] attributes,
                       GL3ElementAttributeArray elements)

GL3SharedObject

public GL3SharedObject(GL3VertexAttributeArray[] attributes,
                       GL3ElementAttributeArray elements,
                       int glMode)

GL3SharedObject

public GL3SharedObject(GL3VertexAttributeArray[] attributes,
                       GL3ElementAttributeArray elements,
                       VertexBufferObject[] vbos,
                       IndexBufferObject ibo,
                       int glMode)

Method Detail

bindAttributes

public void bindAttributes(com.jogamp.opengl.GL3 gl)

Bind program attributes to the given program (uses the program's attribute locations)

createVAO

public int createVAO(com.jogamp.opengl.GL3 gl)

Creates and binds a vertex array object attached to a given program. Attributes must have common program locations if the provided VAO is to be used for multiple programs.

Returns:

vertex array object index

getGL3VertexAttributes

public GL3VertexAttributeArray[] getGL3VertexAttributes()

getGL3ElementAttribute

public GL3ElementAttributeArray getGL3ElementAttribute()

getMode

public int getMode()

getStart

public int getStart()

getCount

public int getCount()

getNumInstances

public int getNumInstances()

getDrawType

public GL3SharedObject.DrawType getDrawType()

setDrawInfo

public void setDrawInfo(int start,
                        int count,
                        int glMode)

setDrawInfo

public void setDrawInfo(int start,
                        int count,
                        int glMode,
                        int numInstances)

isValid

public boolean isValid()

Checks whether all internal GL resources are still valid

Specified by:

isValid in interface GLResource

Overrides:

isValid in class GLResourceBase

Returns:

true if internal resources are all still valid

dispose

public void dispose()

Release hold on any VBOs/IBOs

dispose

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

Release hold on any VBOs/IBOs

Specified by:

dispose in interface GL3Resource

Specified by:

dispose in class GL3ResourceBase

Parameters:

gl - active context

isDisposed

public boolean isDisposed()

Description copied from interface: GLResource

Returns true if resource has been disposed

Specified by:

isDisposed in interface GLResource

Specified by:

isDisposed in class GLResourceBase

acquire

public GL3SharedObject acquire()

Description copied from interface: ReferenceCounted

Signal the resource that something is holding a reference to it.

Specified by:

acquire in interface GL3Resource

Specified by:

acquire in interface GL3SharedDrawable

Specified by:

acquire in interface GLResource

Specified by:

acquire in interface ReferenceCounted

Overrides:

acquire in class GL3ResourceBase

Returns:

a reference to the acquired object for convenience.

drawWithVAO

public void drawWithVAO(com.jogamp.opengl.GL3 gl)

Inefficient, generates VAO and destroys it

draw

public void draw(com.jogamp.opengl.GL3 gl)

Description copied from interface: GL3SharedDrawable

Draw to the provided active context

Specified by:

draw in interface GL3SharedDrawable

Parameters:

gl - active context

drawArrays

public void drawArrays(com.jogamp.opengl.GL3 gl,
                       int mode)

drawArrays

public void drawArrays(com.jogamp.opengl.GL3 gl,
                       int mode,
                       int start,
                       int count)

drawElements

public void drawElements(com.jogamp.opengl.GL3 gl,
                         int mode,
                         int start,
                         int count,
                         int indexType)

drawInstancedArray

public void drawInstancedArray(com.jogamp.opengl.GL3 gl,
                               int mode,
                               int start,
                               int count,
                               int instances)

drawInstancedElements

public void drawInstancedElements(com.jogamp.opengl.GL3 gl,
                                  int mode,
                                  int start,
                                  int count,
                                  int instances)

drawInstanced

public void drawInstanced(com.jogamp.opengl.GL3 gl,
                          int mode,
                          int instanceCount)

drawInstanced

public void drawInstanced(com.jogamp.opengl.GL3 gl,
                          int instances)

Description copied from interface: GL3SharedDrawable

Draw using instanced rendering to the active context

Specified by:

drawInstanced in interface GL3SharedDrawable

Parameters:

gl - context handle

instances - number of instances

draw

public void draw(com.jogamp.opengl.GL3 gl,
                 int start,
                 int count)

draw

public void draw(com.jogamp.opengl.GL3 gl,
                 int mode,
                 int start,
                 int count)

getBindVersion

public int getBindVersion()

Description copied from interface: GL3SharedDrawable

A version number corresponding to the necessary bound state of the drawable's attributes. If this version number has changed since last use, then attributes need to be re-bound.

Specified by:

getBindVersion in interface GL3SharedDrawable

Returns:

bind version number

bind

public void bind(com.jogamp.opengl.GL3 gl)

Description copied from interface: GL3SharedDrawable

Binds attributes to the currently active GL object

Specified by:

bind in interface GL3SharedDrawable

Parameters:

gl - active context

equals

public boolean equals(GL3SharedDrawable other)

Description copied from interface: GL3SharedDrawable

Compares to another drawable to see if same

Specified by:

equals in interface GL3SharedDrawable

Parameters:

other - drawable to compare to

Returns:

true if identical