com.jme3.renderer.opengl

Class GLDebug

java.lang.Object

com.jme3.renderer.opengl.GLDebug

All Implemented Interfaces:

java.lang.reflect.InvocationHandler

public class GLDebug
extends java.lang.Object
implements java.lang.reflect.InvocationHandler

This class uses Reflection to intercept method calls to the Proxy Object (createProxy(GL, Object, Class[]) and extends them with the Error Checking in checkError().
This means we don't have to generate a class with overrides for every possible method just to add a checkError() call.
Note that we should not call checkError() for GL.glGetError(), it doesn't make sense.
Note that this class is general purpose and as such every class instance (every object) can be guarded as long as the passed gl instance is valid.

Field Summary

Fields

Modifier and Type	Field and Description
protected GL	gl
protected java.lang.reflect.Method	methodGlGetError
protected java.lang.Object	obj

Method Summary

Modifier and Type	Method and Description
protected void	checkError()
static java.lang.Object	createProxy(GL gl, java.lang.Object obj, java.lang.Class<?>... implementedInterfaces) Creates a debug-proxied object, which will call GL.glGetError() after every method invocation and throw a RendererException if there was a GL Error.
protected java.lang.String	decodeError(int err)
java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)

Methods inherited from class java.lang.Object

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

Field Detail

obj

protected java.lang.Object obj

gl

protected GL gl

methodGlGetError

protected java.lang.reflect.Method methodGlGetError

Method Detail

decodeError

protected java.lang.String decodeError(int err)

checkError

protected void checkError()

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:

invoke in interface java.lang.reflect.InvocationHandler

Throws:

java.lang.Throwable

createProxy

public static java.lang.Object createProxy(GL gl,
                                           java.lang.Object obj,
                                           java.lang.Class<?>... implementedInterfaces)

Creates a debug-proxied object, which will call GL.glGetError() after every method invocation and throw a RendererException if there was a GL Error.

Parameters:

gl - The GL Context, required to call GL.glGetError()

obj - The object which methods will be proxied

implementedInterfaces - The interfaces/class this object implements

Returns:

The Proxy object (or null if an error occurred)