/* * Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * - Redistribution of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * - Redistribution 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. * * Neither the name of Sun Microsystems, Inc. or the names of * contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * This software is provided "AS IS," without a warranty of any kind. ALL * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, * INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A * PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN * MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR * ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR * DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE * DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, * ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF * SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. * * You acknowledge that this software is not designed or intended for use * in the design, construction, operation or maintenance of any nuclear * facility. * * Sun gratefully acknowledges that this software was originally authored * and developed by Kenneth Bradley Russell and Christopher John Kline. */ package jogamp.opengl; import com.jogamp.opengl.*; import com.jogamp.common.util.IntIntHashMap; import java.nio.IntBuffer; import java.util.ArrayList; /** * Tracks as closely as possible OpenGL states. * GLStateTracker objects are allocated on a per-OpenGL-context basis. *

* Currently supported states: PixelStorei */ public class GLStateTracker { /** Minimum value of MAX_CLIENT_ATTRIB_STACK_DEPTH */ public static final int MIN_CLIENT_ATTRIB_STACK_DEPTH = 16; /** * PixelStorei states */ public static class PixelStateMap { /** static size of pixel state map private static final int PIXEL_STATE_MAP_SIZE = 16; */ /** avoid rehash of static size pixel state map */ private static final int PIXEL_STATE_MAP_CAPACITY = 32; private final IntIntHashMap states; public PixelStateMap() { states = new IntIntHashMap(PIXEL_STATE_MAP_CAPACITY, 0.75f); states.setKeyNotFoundValue(0xFFFFFFFF); } /** Copy constructor */ public PixelStateMap(final PixelStateMap src) { this.states = (IntIntHashMap) src.states.clone(); } /** Set this instance's state using OpenGL default values. */ public final void clearStates() { states.clear(); // 16 values -> PIXEL_STATE_MAP_SIZE states.put(GL.GL_PACK_ALIGNMENT, 4); states.put(GL2GL3.GL_PACK_SWAP_BYTES, GL.GL_FALSE); states.put(GL2GL3.GL_PACK_LSB_FIRST, GL.GL_FALSE); states.put(GL2ES3.GL_PACK_ROW_LENGTH, 0); states.put(GL2ES3.GL_PACK_SKIP_ROWS, 0); states.put(GL2ES3.GL_PACK_SKIP_PIXELS, 0); states.put(GL2GL3.GL_PACK_IMAGE_HEIGHT, 0); states.put(GL2GL3.GL_PACK_SKIP_IMAGES, 0); states.put(GL.GL_UNPACK_ALIGNMENT, 4); states.put(GL2GL3.GL_UNPACK_SWAP_BYTES, GL.GL_FALSE); states.put(GL2GL3.GL_UNPACK_LSB_FIRST, GL.GL_FALSE); states.put(GL2ES2.GL_UNPACK_ROW_LENGTH, 0); states.put(GL2ES2.GL_UNPACK_SKIP_ROWS, 0); states.put(GL2ES2.GL_UNPACK_SKIP_PIXELS, 0); states.put(GL2ES3.GL_UNPACK_IMAGE_HEIGHT, 0); states.put(GL2ES3.GL_UNPACK_SKIP_IMAGES, 0); } } /** * Blending function and equation states per output draw buffer without color and enable. *

* GL_MAX_DRAW_BUFFERS >= 8 *

*/ public static class BlendFuncEq { /** * Set via {@link GL#glBlendFunc(int, int)}, {@link GL#glBlendFuncSeparate(int, int, int, int)} * or {@link GL2ES3#glBlendFunci(int, int, int)}, {@link GL2ES3#glBlendFuncSeparatei(int, int, int, int, int)}. *

* Values are one of * * GL_ZERO (dest default), GL_ONE (source default), * GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, * GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, * GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, GL_ONE_MINUS_CONSTANT_ALPHA, * GL_SRC_ALPHA_SATURATE, GL_SRC1_COLOR, GL_ONE_MINUS_SRC1_COLOR, GL_SRC1_ALPHA, and GL_ONE_MINUS_SRC1_ALPHA * *

*/ int dst_alpha; /** See {@link #dst_alpha}. */ int dst_rgb; /** See {@link #dst_alpha}. */ int src_alpha; /** See {@link #dst_alpha}. */ int src_rgb; /** * Set via {@link GL#glBlendEquation(int)}, {@link GL#glBlendEquationSeparate(int, int)} * or {@link GL2ES3#glBlendEquationi(int, int)}, {@link GL2ES3#glBlendEquationSeparatei(int, int, int)}. *

* Values are on of * * GL_FUNC_ADD (default), GL_FUNC_SUBTRACT, GL_FUNC_REVERSE_SUBTRACT, GL_MIN, GL_MAX. * *

*/ int eq_alpha; /** See {@link #eq_alpha}. */ int eq_rgb; public BlendFuncEq() { clearStates(); } /** Copy constructor */ public BlendFuncEq(final BlendFuncEq src) { set(src); } /** Set this instance's state using OpenGL default values. */ public final void clearStates() { dst_alpha = GL.GL_ZERO; dst_rgb = GL.GL_ZERO; src_alpha = GL.GL_ONE; src_rgb = GL.GL_ONE; eq_alpha = GL.GL_FUNC_ADD; eq_rgb = GL.GL_FUNC_ADD; } /** Set this instance's state using given src values */ public final void set(final BlendFuncEq src) { dst_alpha = src.dst_alpha; dst_rgb = src.dst_rgb; src_alpha = src.src_alpha; src_rgb = src.src_rgb; eq_alpha = src.eq_alpha; eq_rgb = src.eq_rgb; } } /** Global blending states color and enabled. */ public static class BlendGlobal { /** glBlendColor(..) */ public float r, g, b, a; public boolean enabled; public BlendFuncEq state; public BlendGlobal() { state = new BlendFuncEq(); clearStates(); } /** Copy constructor */ public BlendGlobal(final BlendGlobal src) { set(src); } /** Set this instance's state using OpenGL default values. */ public final void clearStates() { r=0f; g=0f; b=0f; a=0f; enabled = false; state.clearStates(); } /** Set this instance's state using given src values */ public final void set(final BlendGlobal src) { r = src.r; g = src.g; b = src.b; a = src.a; enabled = src.enabled; state.set(src.state); } } private volatile boolean enabled = true; private PixelStateMap pixelStateMap; private final BlendGlobal blendGlobalState; private final ArrayList blendStatePerOutput; private final ArrayList stack; static class SavedState { /** * Empty pixel-store state */ private PixelStateMap pixelStateMap; // private BlendGlobal blendState; // private ArrayList blendStatePerOutput; /** * set (client) pixel-store state, deep copy */ final void setPixelStateMap(final PixelStateMap pixelStateMap) { this.pixelStateMap = new PixelStateMap(pixelStateMap); } /** * set (client) pixel-store state, deep copy final void setPixelStateMap(final PixelStateMap pixelStateMap, final BlendGlobal blendState, final ArrayList blendStatePerOutput) { this.pixelStateMap = new PixelStateMap(pixelStateMap); this.blendState = new BlendGlobal(blendState); this.blendStatePerOutput = new ArrayList(blendStatePerOutput.size()); for(final BlendFuncEq bfeq : blendStatePerOutput) { this.blendStatePerOutput.add(new BlendFuncEq(bfeq)); } } */ /** * get (client) pixel-store state, return reference */ final PixelStateMap getPixelStateMap() { return pixelStateMap; } // final BlendGlobal getBlendGlobal() { return blendState; } // final ArrayList getBlendStatePerOutput() { return blendStatePerOutput; } } public GLStateTracker() { pixelStateMap = new PixelStateMap(); blendGlobalState = new BlendGlobal(); blendStatePerOutput = new ArrayList(0); // FIXME stack = new ArrayList(MIN_CLIENT_ATTRIB_STACK_DEPTH); clearStates(); } public final void setEnabled(final boolean on) { enabled = on; } public final boolean isEnabled() { return enabled; } /** Return the local {@link PixelStateMap} */ public final PixelStateMap getPixelStateMap() { return this.pixelStateMap; } /** Return the local {@link BlendGlobal} */ public final BlendGlobal getBlendGlobal() { return blendGlobalState; } /** Return the local array of {@link BlendFuncEq} */ public final ArrayList getBlendStatePerOutput() { return this.blendStatePerOutput; } /** @return true if found in our map, otherwise false, * which forces the caller to query GL. */ public final boolean getInt(final int pname, final int[] params, final int params_offset) { if(enabled) { final int value = pixelStateMap.states.get(pname); if(0xFFFFFFFF != value) { params[params_offset] = value; return true; } } return false; } /** @return true if found in our map, otherwise false, * which forces the caller to query GL. */ public final boolean getInt(final int pname, final IntBuffer params, final int dummy) { if(enabled) { final int value = pixelStateMap.states.get(pname); if(0xFFFFFFFF != value) { params.put(params.position(), value); return true; } } return false; } public final void setInt(final int pname, final int param) { if(enabled) { pixelStateMap.states.put(pname, param); } } /** * GL_CLIENT_PIXEL_STORE_BIT * @param flags */ public final void pushAttrib(final int flags) { if(enabled) { final SavedState state = new SavedState(); // empty-slot if( 0 != (flags&GL2.GL_CLIENT_PIXEL_STORE_BIT) ) { // save client pixel-store state state.setPixelStateMap(pixelStateMap); } stack.add(stack.size(), state); // push } } public final void popAttrib() { if(enabled) { if(stack.isEmpty()) { throw new GLException("stack contains no elements"); } final SavedState state = stack.remove(stack.size()-1); // pop if(null==state) { throw new GLException("null stack element (remaining stack size "+stack.size()+")"); } final PixelStateMap savedPixelStateMap = state.getPixelStateMap(); if ( null != savedPixelStateMap ) { // use pulled client pixel-store state from stack pixelStateMap = savedPixelStateMap; } // else: empty-slot, not pushed by GL_CLIENT_PIXEL_STORE_BIT } } public final void clearStates() { stack.clear(); pixelStateMap.clearStates(); blendGlobalState.clearStates(); blendStatePerOutput.clear(); } }