maspack.render.GL

Interface GLPipelineRenderer

All Known Implementing Classes:

GL2PipelineRenderer, GL3PipelineRenderer, GLPipelineRendererBase

public interface GLPipelineRenderer

Allows pipeline rendering of primitives. Once a certain number of vertices are reached, these are automatically drawn to the active context.

Author:

Antonio

Method Summary

Modifier and Type	Method and Description
void	begin(com.jogamp.opengl.GL gl, int glMode, int maxVertices) Begins rendering of primitives
void	color(int r, int g, int b, int a) Cues up a color to use for following vertices
void	dispose(com.jogamp.opengl.GL gl) Disposes of any resources.
void	enableColors(boolean set) Enables/disables per-vertex colors.
void	enableNormals(boolean set) Enables/disables per-vertex normals.
void	enableTexCoords(boolean set) Enables/disables per-vertex texture coordinates.
void	end() Ends drawing, flushing the pipeline if necessary
void	flush() Flushes the pipeline
com.jogamp.opengl.GL	getGL() The currently-active GL context if rendering.
boolean	isColorsEnabled()
boolean	isEmpty() Checks whether or not pipeline is empty
boolean	isNormalsEnabled()
boolean	isTexCoordsEnabled()
void	normal(float x, float y, float z) Cues up a normal to use for following vertices
void	setup(boolean hasNormals, boolean hasColors, boolean hasTexcoords) Set up properties of pipeline.
void	texcoord(float x, float y) Cues up a texture coordinate to use for following vertices
void	vertex(float x, float y, float z) Adds a vertex to the pipeline with the currently active attributes.

Method Detail

setup

void setup(boolean hasNormals,
           boolean hasColors,
           boolean hasTexcoords)

Set up properties of pipeline. Properties cannot be changed while rendering.

enableNormals

void enableNormals(boolean set)

Enables/disables per-vertex normals. Cannot be changed while rendering.

isNormalsEnabled

boolean isNormalsEnabled()

enableColors

void enableColors(boolean set)

Enables/disables per-vertex colors. Cannot be changed while rendering.

isColorsEnabled

boolean isColorsEnabled()

enableTexCoords

void enableTexCoords(boolean set)

Enables/disables per-vertex texture coordinates. Cannot be changed while rendering.

isTexCoordsEnabled

boolean isTexCoordsEnabled()

begin

void begin(com.jogamp.opengl.GL gl,
           int glMode,
           int maxVertices)

Begins rendering of primitives

Parameters:

gl - context to use

glMode - draw mode

maxVertices - maximum number of vertices before content is flushed. This should be a valid multiple of the vertices required to complete primitives in the given draw mode.

normal

void normal(float x,
            float y,
            float z)

Cues up a normal to use for following vertices

color

void color(int r,
           int g,
           int b,
           int a)

Cues up a color to use for following vertices

texcoord

void texcoord(float x,
              float y)

Cues up a texture coordinate to use for following vertices

vertex

void vertex(float x,
            float y,
            float z)

Adds a vertex to the pipeline with the currently active attributes.

flush

void flush()

Flushes the pipeline

end

void end()

Ends drawing, flushing the pipeline if necessary

isEmpty

boolean isEmpty()

Checks whether or not pipeline is empty

Returns:

true if there is content that can be flushed

dispose

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

Disposes of any resources. The renderer can no longer be used after it is disposed.

getGL

com.jogamp.opengl.GL getGL()

The currently-active GL context if rendering. Null if not between begin(GL, int, int) and end().

Returns:

the active GL context