Package com.jogamp.graph.curve.opengl

Class RegionRenderer

java.lang.Object

com.jogamp.graph.curve.opengl.RegionRenderer

public class RegionRenderer
extends Object

OpenGL Region renderer

All OpenGL related operations regarding Regions are passed through an instance of this class.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	RegionRenderer.GLCallback	May be passed to RegionRenderer ctor, e.g.

Field Summary

Fields

Modifier and Type	Field	Description
static RegionRenderer.GLCallback	defaultBlendDisable	Default GL.GL_BLEND disable RegionRenderer.GLCallback, simply turning-off the GL.GL_BLEND state and turning-on depth writing via GL.glDepthMask(boolean) if RenderState.BITHINT_GLOBAL_DEPTH_TEST_ENABLED is set.
static RegionRenderer.GLCallback	defaultBlendEnable	Default GL.GL_BLEND enable RegionRenderer.GLCallback, turning-off depth writing via GL.glDepthMask(boolean) if RenderState.BITHINT_GLOBAL_DEPTH_TEST_ENABLED is set and turning-on the GL.GL_BLEND state.

Method Summary

Modifier and Type	Method	Description
static RegionRenderer	create(RenderState rs, RegionRenderer.GLCallback enableCallback, RegionRenderer.GLCallback disableCallback)	Create a Hardware accelerated Region Renderer.
void	destroy(GL2ES2 gl)
void	enable(GL2ES2 gl, boolean enable)	Enabling or disabling the RenderState's shader program.
int	getHeight()	Return height of current viewport
PMVMatrix	getMatrix()
RenderState	getRenderState()
int	getWidth()	Return width of current viewport
void	init(GL2ES2 gl, int renderModes)	Initialize shader and bindings for GPU based rendering bound to the given GL object's GLContext if not initialized yet.
boolean	isInitialized()
boolean	isVBOSupported()
void	reshapeNotify(int width, int height)	No PMVMatrix operation is performed here.
void	reshapeOrtho(int width, int height, float near, float far)
void	reshapePerspective(float angle, int width, int height, float near, float far)
boolean	useShaderProgram(GL2ES2 gl, int renderModes, boolean pass1, int quality, int sampleCount, TextureSequence colorTexSeq)

Methods inherited from class java.lang.Object

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

Field Detail

defaultBlendEnable

public static final RegionRenderer.GLCallback defaultBlendEnable

Default GL.GL_BLEND enable RegionRenderer.GLCallback, turning-off depth writing via GL.glDepthMask(boolean) if RenderState.BITHINT_GLOBAL_DEPTH_TEST_ENABLED is set and turning-on the GL.GL_BLEND state.

Implementation also sets RenderState's blending bit-hint, which will cause GLRegion's draw-method to set the proper blend-function and the clear-color to transparent-black in case of multipass FBO rendering.

See Also:

create(RenderState, GLCallback, GLCallback), enable(GL2ES2, boolean)

defaultBlendDisable

public static final RegionRenderer.GLCallback defaultBlendDisable

Default GL.GL_BLEND disable RegionRenderer.GLCallback, simply turning-off the GL.GL_BLEND state and turning-on depth writing via GL.glDepthMask(boolean) if RenderState.BITHINT_GLOBAL_DEPTH_TEST_ENABLED is set.

Implementation also clears RenderState's blending bit-hint.

See Also:

create(RenderState, GLCallback, GLCallback), enable(GL2ES2, boolean)

Method Detail

create

public static RegionRenderer create(RenderState rs,
                                    RegionRenderer.GLCallback enableCallback,
                                    RegionRenderer.GLCallback disableCallback)

Create a Hardware accelerated Region Renderer.

The optional RegionRenderer.GLCallbacks enableCallback and disableCallback maybe used to issue certain tasks at enable(GL2ES2, boolean).
For example, instances defaultBlendEnable and defaultBlendDisable can be utilized to enable and disable GL.GL_BLEND.

Parameters:

rs - the used RenderState

enableCallback - optional RegionRenderer.GLCallback, if not null will be issued at init(gl) and enable(gl, true).

disableCallback - optional RegionRenderer.GLCallback, if not null will be issued at enable(gl, false).

Returns:

an instance of Region Renderer

See Also:

enable(GL2ES2, boolean)

isInitialized

public final boolean isInitialized()

getWidth

public final int getWidth()

Return width of current viewport

getHeight

public final int getHeight()

Return height of current viewport

getMatrix

public final PMVMatrix getMatrix()

isVBOSupported

public final boolean isVBOSupported()

init

public final void init(GL2ES2 gl,
                       int renderModes)
                throws GLException

Initialize shader and bindings for GPU based rendering bound to the given GL object's GLContext if not initialized yet.

Leaves the renderer enabled, ie ShaderState.

Shall be called by a draw() method, e.g. RegionRenderer#draw(GL2ES2, Region, int)

Parameters:

gl - referencing the current GLContext to which the ShaderState is bound to

renderModes -

Throws:

GLException - if initialization failed

destroy

public final void destroy(GL2ES2 gl)

getRenderState

public final RenderState getRenderState()

enable

public final void enable(GL2ES2 gl,
                         boolean enable)

Enabling or disabling the RenderState's shader program.

In case enable and disable RegionRenderer.GLCallbacks are setup via create(RenderState, GLCallback, GLCallback), they will be called before toggling the shader program.

See Also:

create(RenderState, GLCallback, GLCallback)

reshapeNotify

public final void reshapeNotify(int width,
                                int height)

No PMVMatrix operation is performed here. PMVMatrix is marked dirty.

reshapePerspective

public final void reshapePerspective(float angle,
                                     int width,
                                     int height,
                                     float near,
                                     float far)

reshapeOrtho

public final void reshapeOrtho(int width,
                               int height,
                               float near,
                               float far)

useShaderProgram

public final boolean useShaderProgram(GL2ES2 gl,
                                      int renderModes,
                                      boolean pass1,
                                      int quality,
                                      int sampleCount,
                                      TextureSequence colorTexSeq)

Parameters:

gl -

renderModes -

pass1 -

quality -

sampleCount -

colorTexSeq -

Returns:

true if a new shader program is being used and hence external uniform-data and -location, as well as the attribute-location must be updated, otherwise false.