/**
* Copyright 2010 JogAmp Community. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification, are
* permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this list of
* conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright notice, this list
* of conditions and the following disclaimer in the documentation and/or other materials
* provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* The views and conclusions contained in the software and documentation are those of the
* authors and should not be interpreted as representing official policies, either expressed
* or implied, of JogAmp Community.
*/
package com.jogamp.opengl.util.glsl;
import javax.media.opengl.*;
import com.jogamp.opengl.impl.Debug;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.security.*;
public class ShaderState {
public static final boolean DEBUG = Debug.isPropertyDefined("jogl.debug.GLSLState", true, AccessController.getContext());
public ShaderState() {
}
public boolean verbose() { return verbose; }
public void setVerbose(boolean v) { verbose=v; }
/**
* Fetches the current shader state from the thread local storage (TLS)
*
* @see com.jogamp.opengl.util.glsl.ShaderState#glUseProgram(GL2ES2, boolean)
* @see com.jogamp.opengl.util.glsl.ShaderState#getCurrent()
*/
public static synchronized ShaderState getCurrent() {
GLContext current = GLContext.getCurrent();
if(null==current) {
throw new GLException("No context is current on this thread");
}
return (ShaderState) current.getAttachedObject(ShaderState.class.getName());
}
/**
* Turns the shader program on or off.
* Puts this ShaderState to to the thread local storage (TLS),
* if on
is true
.
*
* @see com.jogamp.opengl.util.glsl.ShaderState#glUseProgram(GL2ES2, boolean)
* @see com.jogamp.opengl.util.glsl.ShaderState#getCurrent()
*/
public synchronized void glUseProgram(GL2ES2 gl, boolean on) {
if(on) {
if(null!=shaderProgram) {
shaderProgram.glUseProgram(gl, true);
} else {
throw new GLException("No program is attached");
}
// update the current ShaderState to the TLS ..
gl.getContext().putAttachedObject(ShaderState.class.getName(), this);
} else if(null!=shaderProgram) {
shaderProgram.glUseProgram(gl, false);
}
}
public boolean linked() {
return (null!=shaderProgram)?shaderProgram.linked():false;
}
public boolean inUse() {
return (null!=shaderProgram)?shaderProgram.inUse():false;
}
/**
* Attach or switch a shader program
*
* Attaching a shader program the first time,
* as well as switching to another program on the fly,
* while managing all attribute and uniform data.
*/
public synchronized void attachShaderProgram(GL2ES2 gl, ShaderProgram prog) {
boolean prgInUse = false; // earmarked state
if(DEBUG) {
int curId = (null!=shaderProgram)?shaderProgram.id():-1;
int newId = (null!=prog)?prog.id():-1;
System.err.println("Info: attachShaderProgram: "+curId+" -> "+newId+"\n\t"+shaderProgram+"\n\t"+prog);
if(verbose) {
Throwable tX = new Throwable("Info: attachShaderProgram: Trace");
tX.printStackTrace();
}
}
if(null!=shaderProgram) {
if(shaderProgram.equals(prog)) {
// nothing to do ..
if(DEBUG) {
System.err.println("Info: attachShaderProgram: NOP: equal id: "+shaderProgram.id());
}
return;
}
prgInUse = shaderProgram.inUse();
shaderProgram.glUseProgram(gl, false);
}
// register new one
shaderProgram = prog;
if(null!=shaderProgram) {
// reinstall all data ..
shaderProgram.glUseProgram(gl, true);
glResetAllVertexAttributes(gl);
glResetAllUniforms(gl);
if(!prgInUse) {
shaderProgram.glUseProgram(gl, false);
}
}
if(DEBUG) {
System.err.println("Info: attachShaderProgram: END");
}
}
public ShaderProgram shaderProgram() { return shaderProgram; }
/**
* Calls release(gl, true, true)
*
* @see #glReleaseAllVertexAttributes
* @see #glReleaseAllUniforms
* @see #release(GL2ES2, boolean, boolean)
*/
public synchronized void destroy(GL2ES2 gl) {
release(gl, true, true);
}
/**
* Calls release(gl, false, false)
*
* @see #glReleaseAllVertexAttributes
* @see #glReleaseAllUniforms
* @see #release(GL2ES2, boolean, boolean)
*/
public synchronized void releaseAllData(GL2ES2 gl) {
release(gl, false, false);
}
/**
* @see #glReleaseAllVertexAttributes
* @see #glReleaseAllUniforms
* @see ShaderProgram#release(GL2ES2, boolean)
*/
public synchronized void release(GL2ES2 gl, boolean releaseProgramToo, boolean releaseShaderToo) {
boolean prgInUse = false;
if(null!=shaderProgram) {
prgInUse = shaderProgram.inUse();
if(!prgInUse) {
shaderProgram.glUseProgram(gl, true);
}
}
glReleaseAllVertexAttributes(gl);
glReleaseAllUniforms(gl);
if(null!=shaderProgram) {
if(releaseProgramToo) {
shaderProgram.release(gl, releaseShaderToo);
} else if(!prgInUse) {
shaderProgram.glUseProgram(gl, false);
}
}
}
//
// Shader attribute handling
//
/**
* Binds an attribute to the shader.
* This must be done before the program is linked !
* n name - 1 idx, where name is a uniq key
*
* @throws GLException is the program is already linked
*
* @see #glBindAttribLocation
* @see javax.media.opengl.GL2ES2#glBindAttribLocation
* @see #glGetAttribLocation
* @see javax.media.opengl.GL2ES2#glGetAttribLocation
* @see #getAttribLocation
* @see ShaderProgram#glReplaceShader
*/
public void glBindAttribLocation(GL2ES2 gl, int index, String name) {
if(null==shaderProgram) throw new GLException("No program is attached");
if(shaderProgram.linked()) throw new GLException("Program is already linked");
Integer idx = new Integer(index);
if(!attribMap2Idx.containsKey(name)) {
attribMap2Idx.put(name, idx);
gl.glBindAttribLocation(shaderProgram.program(), index, name);
}
}
/**
* Gets the index of a shader attribute.
* This must be done after the program is linked !
*
* @return -1 if there is no such attribute available,
* otherwise >= 0
* @throws GLException is the program is not linked
*
* @see #glBindAttribLocation
* @see javax.media.opengl.GL2ES2#glBindAttribLocation
* @see #glGetAttribLocation
* @see javax.media.opengl.GL2ES2#glGetAttribLocation
* @see #getAttribLocation
* @see ShaderProgram#glReplaceShader
*/
public int glGetAttribLocation(GL2ES2 gl, String name) {
if(!shaderProgram.linked()) throw new GLException("Program is not linked");
int index = getAttribLocation(name);
if(0>index) {
index = gl.glGetAttribLocation(shaderProgram.program(), name);
if(0<=index) {
Integer idx = new Integer(index);
attribMap2Idx.put(name, idx);
if(DEBUG) {
System.err.println("Info: glGetAttribLocation: "+name+", loc: "+index);
}
} else if(verbose) {
Throwable tX = new Throwable("Info: glGetAttribLocation failed, no location for: "+name+", index: "+index);
tX.printStackTrace();
}
}
return index;
}
protected int getAttribLocation(String name) {
Integer idx = (Integer) attribMap2Idx.get(name);
return (null!=idx)?idx.intValue():-1;
}
//
// Enabled Vertex Arrays and its data
//
/**
* Enable a vertex attribute array
*
* Even if the attribute is not found in the current shader,
* it is stored in this state.
*
* @return false, if the name is not found, otherwise true
*
* @throws GLException if the program is not in use
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public boolean glEnableVertexAttribArray(GL2ES2 gl, String name) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
enabledVertexAttribArraySet.add(name);
int index = glGetAttribLocation(gl, name);
if(0>index) {
if(verbose) {
Throwable tX = new Throwable("Info: glEnableVertexAttribArray failed, no index for: "+name);
tX.printStackTrace();
}
return false;
}
if(DEBUG) {
System.err.println("Info: glEnableVertexAttribArray: "+name+", loc: "+index);
}
gl.glEnableVertexAttribArray(index);
return true;
}
public boolean isVertexAttribArrayEnabled(String name) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
return enabledVertexAttribArraySet.contains(name);
}
/**
* Disables a vertex attribute array
*
* Even if the attribute is not found in the current shader,
* it is removed from this state.
*
* @return false, if the name is not found, otherwise true
*
* @throws GLException if the program is not in use
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public boolean glDisableVertexAttribArray(GL2ES2 gl, String name) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
enabledVertexAttribArraySet.remove(name);
int index = glGetAttribLocation(gl, name);
if(0>index) {
if(verbose) {
Throwable tX = new Throwable("Info: glDisableVertexAttribArray failed, no index for: "+name);
tX.printStackTrace();
}
return false;
}
if(DEBUG) {
System.err.println("Info: glDisableVertexAttribArray: "+name);
}
gl.glDisableVertexAttribArray(index);
return true;
}
/**
* Set the vertex attribute data.
* Enable the attribute, if it is not enabled yet.
*
* Even if the attribute is not found in the current shader,
* it is stored in this state.
*
* @param data the GLArrayData's name must match the attributes one,
* it's index will be set with the attribute's location,
* if found.
*
* @return false, if the name is not found, otherwise true
*
* @throws GLException if the program is not in use
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public boolean glVertexAttribPointer(GL2ES2 gl, GLArrayData data) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
if(!enabledVertexAttribArraySet.contains(data.getName())) {
if(!glEnableVertexAttribArray(gl, data.getName())) {
if(verbose) {
Throwable tX = new Throwable("Info: glVertexAttribPointer: couldn't enable: "+data);
tX.printStackTrace();
}
}
}
int index = getAttribLocation(data.getName());
if(0>index) {
if(verbose) {
Throwable tX = new Throwable("Info: glVertexAttribPointer failed, no index for: "+data);
tX.printStackTrace();
}
}
data.setLocation(index);
vertexAttribMap2Data.put(data.getName(), data);
if(0<=index) {
// only pass the data, if the attribute exists in the current shader
if(DEBUG) {
System.err.println("Info: glVertexAttribPointer: "+data);
}
gl.glVertexAttribPointer(data);
return true;
}
return false;
}
/**
* Get the vertex attribute data, previously set.
*
* @return the GLArrayData object, null if not previously set.
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public GLArrayData getVertexAttribPointer(String name) {
return (GLArrayData) vertexAttribMap2Data.get(name);
}
/**
* Releases all mapped vertex attribute data,
* disables all enabled attributes and loses all indices
*
* @throws GLException is the program is not in use but the shaderProgram is set
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public void glReleaseAllVertexAttributes(GL2ES2 gl) {
if(null!=shaderProgram) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
for(Iterator iter = vertexAttribMap2Data.keySet().iterator(); iter.hasNext(); ) {
if(!glDisableVertexAttribArray(gl, (String) iter.next())) {
throw new GLException("Internal Error: mapped vertex attribute couldn't be disabled");
}
}
for(Iterator iter = enabledVertexAttribArraySet.iterator(); iter.hasNext(); ) {
if(!glDisableVertexAttribArray(gl, (String) iter.next())) {
throw new GLException("Internal Error: prev enabled vertex attribute couldn't be disabled");
}
}
}
vertexAttribMap2Data.clear();
enabledVertexAttribArraySet.clear();
attribMap2Idx.clear();
}
/**
* Disables all vertex attribute arrays.
*
* Their enabled stated will be removed from this state only
* if 'removeFromState' is true.
*
* This method purpose is more for debugging.
*
* @throws GLException is the program is not in use but the shaderProgram is set
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public void glDisableAllVertexAttributeArrays(GL2ES2 gl, boolean removeFromState) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
for(Iterator iter = enabledVertexAttribArraySet.iterator(); iter.hasNext(); ) {
String name = (String) iter.next();
if(removeFromState) {
enabledVertexAttribArraySet.remove(name);
}
int index = glGetAttribLocation(gl, name);
if(0<=index) {
gl.glDisableVertexAttribArray(index);
}
}
}
/**
* Reset all previously enabled mapped vertex attribute data,
* incl enabling them
*
* @throws GLException is the program is not in use
*
* @see #glEnableVertexAttribArray
* @see #glDisableVertexAttribArray
* @see #glVertexAttribPointer
* @see #getVertexAttribPointer
* @see #glReleaseAllVertexAttributes
* @see #glResetAllVertexAttributes
* @see ShaderProgram#glReplaceShader
*/
public void glResetAllVertexAttributes(GL2ES2 gl) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
attribMap2Idx.clear();
/**
*
for(Iterator iter = enabledVertexAttribArraySet.iterator(); iter.hasNext(); ) {
glEnableVertexAttribArray(gl, (String) iter.next());
}
for(Iterator iter = vertexAttribMap2Data.values().iterator(); iter.hasNext(); ) {
GLArrayData data = (GLArrayData) iter.next();
...
} */
for(Iterator iter = enabledVertexAttribArraySet.iterator(); iter.hasNext(); ) {
// get new location ..
String name = (String) iter.next();
int loc = glGetAttribLocation(gl, name);
// get & update data ..
GLArrayData data = getVertexAttribPointer(name);
data.setLocation(loc);
vertexAttribMap2Data.put(name, data);
if(0>loc) {
// not used in shader
continue;
}
// enable attrib, VBO and pass location/data
gl.glEnableVertexAttribArray(loc);
if( data.isVBO() ) {
gl.glBindBuffer(GL.GL_ARRAY_BUFFER, data.getVBOName());
}
gl.glVertexAttribPointer(data);
}
}
//
// Shader Uniform handling
//
/**
* Gets the index of a shader uniform.
* This must be done when the program is in use !
*
* @return -1 if there is no such attribute available,
* otherwise >= 0
* @throws GLException is the program is not linked
*
* @see #glGetUniformLocation
* @see javax.media.opengl.GL2ES2#glGetUniformLocation
* @see #getUniformLocation
* @see ShaderProgram#glReplaceShader
*/
protected int glGetUniformLocation(GL2ES2 gl, String name) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
int index = getUniformLocation(name);
if(0>index) {
index = gl.glGetUniformLocation(shaderProgram.program(), name);
if(0<=index) {
Integer idx = new Integer(index);
uniformMap2Idx.put(name, idx);
} else if(verbose) {
Throwable tX = new Throwable("Info: glUniform failed, no location for: "+name+", index: "+index);
tX.printStackTrace();
}
}
return index;
}
protected int getUniformLocation(String name) {
Integer idx = (Integer) uniformMap2Idx.get(name);
return (null!=idx)?idx.intValue():-1;
}
/**
* Set the uniform data.
*
* Even if the uniform is not found in the current shader,
* it is stored in this state.
*
* @param data the GLUniforms's name must match the uniform one,
* it's index will be set with the uniforms's location,
* if found.
*
*
* @return false, if the name is not found, otherwise true
*
* @throws GLException if the program is not in use
*
* @see #glGetUniformLocation
* @see javax.media.opengl.GL2ES2#glGetUniformLocation
* @see #getUniformLocation
* @see ShaderProgram#glReplaceShader
*/
public boolean glUniform(GL2ES2 gl, GLUniformData data) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
int location = glGetUniformLocation(gl, data.getName());
data.setLocation(location);
uniformMap2Data.put(data.getName(), data);
if(0<=location) {
// only pass the data, if the uniform exists in the current shader
if(DEBUG) {
System.err.println("Info: glUniform: "+data);
}
gl.glUniform(data);
}
return true;
}
/**
* Get the uniform data, previously set.
*
* @return the GLUniformData object, null if not previously set.
*/
public GLUniformData getUniform(String name) {
return (GLUniformData) uniformMap2Data.get(name);
}
/**
* Releases all mapped uniform data
* and loses all indices
*
* @throws GLException is the program is not in use
*/
public void glReleaseAllUniforms(GL2ES2 gl) {
uniformMap2Data.clear();
uniformMap2Idx.clear();
}
/**
* Reset all previously mapped uniform data
*
* @throws GLException is the program is not in use
*/
public void glResetAllUniforms(GL2ES2 gl) {
if(!shaderProgram.inUse()) throw new GLException("Program is not in use");
uniformMap2Idx.clear();
for(Iterator iter = uniformMap2Data.values().iterator(); iter.hasNext(); ) {
glUniform(gl, (GLUniformData) iter.next());
}
}
public String toString() {
StringBuffer buf = new StringBuffer();
buf.append("ShaderState[");
buf.append(shaderProgram.toString());
buf.append(",EnabledStates: [");
for(Iterator iter = enabledVertexAttribArraySet.iterator(); iter.hasNext(); ) {
buf.append("\n ");
buf.append((String)iter.next());
}
buf.append("], [");
for(Iterator iter = vertexAttribMap2Data.values().iterator(); iter.hasNext(); ) {
GLArrayData data = (GLArrayData) iter.next();
if(data.getLocation()>=0) {
buf.append("\n ");
buf.append(data);
}
}
buf.append("], [");
for(Iterator iter=uniformMap2Data.values().iterator(); iter.hasNext(); ) {
GLUniformData data = (GLUniformData) iter.next();
if(data.getLocation()>=0) {
buf.append("\n ");
buf.append(data);
}
}
buf.append("]");
return buf.toString();
}
protected boolean verbose = false;
protected ShaderProgram shaderProgram=null;
protected HashMap attribMap2Idx = new HashMap();
protected HashSet enabledVertexAttribArraySet = new HashSet();
protected HashMap vertexAttribMap2Data = new HashMap();
protected HashMap uniformMap2Idx = new HashMap();
protected HashMap uniformMap2Data = new HashMap();
}