/* ----------------------------------------------------------------------------- This source file is part of OGRE (Object-oriented Graphics Rendering Engine) For the latest info, see http://www.ogre3d.org/ Copyright (c) 2000-2013 Torus Knot Software Ltd Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ----------------------------------------------------------------------------- */ #ifndef __GLES2StateCacheManager_H__ #define __GLES2StateCacheManager_H__ #include "OgreGLES2Prerequisites.h" typedef Ogre::GeneralAllocatedObject StateCacheAlloc; namespace Ogre { class GLES2StateCacheManagerImp; /** An in memory cache of the OpenGL ES state. @remarks State changes can be particularly expensive time wise. This is because a change requires OpenGL to re-evaluate and update the state machine. Because of the general purpose nature of OGRE we often set the state for a specific texture, material, buffer, etc. But this may be the same as the current status of the state machine and is therefore redundant and causes unnecessary work to be performed by OpenGL. @par Instead we are caching the state so that we can check whether it actually does need to be updated. This leads to improved performance all around and can be somewhat dramatic in some cases. */ class _OgreGLES2Export GLES2StateCacheManager : public StateCacheAlloc { private: GLES2StateCacheManagerImp* mImp; public: GLES2StateCacheManager(void); ~GLES2StateCacheManager(void); /** Initialize our cache variables and sets the GL states on the current context. */ void initializeCache(); /** Clears all cached values */ void clearCache(); /** Bind an OpenGL buffer of any type. @param target The buffer target. @param buffer The buffer ID. @param force Optional parameter to force an update. */ void bindGLBuffer(GLenum target, GLuint buffer, bool force = false); /** Delete an OpenGL buffer of any type. @param target The buffer target. @param buffer The buffer ID. @param force Optional parameter to force an update. */ void deleteGLBuffer(GLenum target, GLuint buffer, bool force = false); /** Bind an OpenGL texture of any type. @param target The texture target. @param texture The texture ID. */ void bindGLTexture(GLenum target, GLuint texture); /** Invalidates the state associated with a particular texture ID. @param texture The texture ID. */ void invalidateStateForTexture(GLuint texture); /** Sets an integer parameter value per texture target. @param target The texture target. @param pname The parameter name. @param param The parameter value. */ void setTexParameteri(GLenum target, GLenum pname, GLint param); /** Sets a float parameter value per texture target. @param target The texture target. @param pname The parameter name. @param params The parameter value. */ void setTexParameterf(GLenum target, GLenum pname, GLfloat param); /** Sets a float parameter value per texture target. @param target The texture target. @param pname The parameter name. @param params The parameter value. */ void getTexParameterfv(GLenum target, GLenum pname, GLfloat *param); /** Activate an OpenGL texture unit. @param unit The texture unit to activate. @return Whether or not the texture unit was successfully activated. */ bool activateGLTextureUnit(unsigned char unit); /** Gets the current blend equation setting. @return The blend equation. */ GLenum getBlendEquation(void) const; /** Sets the current blend equation setting. @param eq The blend equation to use. */ void setBlendEquation(GLenum eq); /** Sets the blending function. @param source The blend mode for the source. @param dest The blend mode for the destination */ void setBlendFunc(GLenum source, GLenum dest); /** Gets the current depth mask setting. @return The current depth mask. */ GLboolean getDepthMask(void) const; /** Sets the current depth mask setting. @param mask The depth mask to use. */ void setDepthMask(GLboolean mask); /** Gets the current depth test function. @return The current depth test function. */ GLenum getDepthFunc(void) const; /** Sets the current depth test function. @param func The depth test function to use. */ void setDepthFunc(GLenum func); /** Gets the clear depth in the range from [0..1]. @return The current clearing depth. */ GLclampf getClearDepth(void) const; /** Sets the clear depth in the range from [0..1]. @param depth The clear depth to use. */ void setClearDepth(GLclampf depth); /** Sets the color to clear to. @param red The red component. @param green The green component. @param blue The blue component. @param alpha The alpha component. */ void setClearColour(GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha); /** Gets the current colour mask setting. @return An array containing the mask in RGBA order. */ vector::type & getColourMask(void) const; /** Sets the current colour mask. @param red The red component. @param green The green component. @param blue The blue component. @param alpha The alpha component. */ void setColourMask(GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha); /** Gets the current stencil mask. @return The stencil mask. */ GLuint getStencilMask(void) const; /** Sets the stencil mask. @param mask The stencil mask to use */ void setStencilMask(GLuint mask); /** Enables a piece of OpenGL functionality. @param flag The function to enable. */ void setEnabled(GLenum flag); /** Disables a piece of OpenGL functionality. @param flag The function to disable. */ void setDisabled(GLenum flag); /** Enables a vertex attribute. @param attrib The attribute to enable. */ void setVertexAttribEnabled(GLuint attrib); /** Disables a vertex attribute. @param attrib The attribute to disable. */ void setVertexAttribDisabled(GLuint attrib); /** Gets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported @return The buffer mask. */ unsigned int getDiscardBuffers(void) const; /** Sets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported @param flags The bit mask of buffers to be discarded. Stored as Ogre::FrameBufferType. */ void setDiscardBuffers(unsigned int flags); /** Gets the current polygon rendering mode, fill, wireframe, points, etc. @return The current polygon rendering mode. */ GLenum getPolygonMode(void) const; /** Sets the current polygon rendering mode. @param mode The polygon mode to use. */ void setPolygonMode(GLenum mode); /** Sets the face culling mode. @return The current face culling mode */ GLenum getCullFace(void) const; /** Sets the face culling setting. @param face The face culling mode to use. */ void setCullFace(GLenum face); }; } #endif