An in memory cache of the OpenGL ES state. More...

#include <OgreGLES2StateCacheManager.h>

Inheritance diagram for Ogre::GLES2StateCacheManager:

Public Member Functions
	GLES2StateCacheManager (void)

	~GLES2StateCacheManager (void)

bool	activateGLTextureUnit (unsigned char unit)
	Activate an OpenGL texture unit. More...

void	bindGLBuffer (GLenum target, GLuint buffer, bool force=false)
	Bind an OpenGL buffer of any type. More...

void	bindGLTexture (GLenum target, GLuint texture)
	Bind an OpenGL texture of any type. More...

void	clearCache ()
	Clears all cached values. More...

void	deleteGLBuffer (GLenum target, GLuint buffer, bool force=false)
	Delete an OpenGL buffer of any type. More...

GLenum	getBlendEquation (void) const
	Gets the current blend equation setting. More...

GLclampf	getClearDepth (void) const
	Gets the clear depth in the range from [0..1]. More...

vector< GLboolean >::type &	getColourMask (void) const
	Gets the current colour mask setting. More...

GLenum	getCullFace (void) const
	Sets the face culling mode. More...

GLenum	getDepthFunc (void) const
	Gets the current depth test function. More...

GLboolean	getDepthMask (void) const
	Gets the current depth mask setting. More...

unsigned int	getDiscardBuffers (void) const
	Gets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported. More...

GLenum	getPolygonMode (void) const
	Gets the current polygon rendering mode, fill, wireframe, points, etc. More...

GLuint	getStencilMask (void) const
	Gets the current stencil mask. More...

void	getTexParameterfv (GLenum target, GLenum pname, GLfloat *param)
	Sets a float parameter value per texture target. More...

void	initializeCache ()
	Initialize our cache variables and sets the GL states on the current context. More...

void	invalidateStateForTexture (GLuint texture)
	Invalidates the state associated with a particular texture ID. More...

void	operator delete (void *ptr)

void	operator delete (void ptr, void )

void	operator delete (void ptr, const char , int, const char *)

void	operator delete[] (void *ptr)

void	operator delete[] (void ptr, const char , int, const char *)

void *	operator new (size_t sz, const char file, int line, const char func)
	operator new, with debug line info More...

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *ptr)
	placement operator new More...

void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info More...

void *	operator new[] (size_t sz)

void	setBlendEquation (GLenum eq)
	Sets the current blend equation setting. More...

void	setBlendFunc (GLenum source, GLenum dest)
	Sets the blending function. More...

void	setClearColour (GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha)
	Sets the color to clear to. More...

void	setClearDepth (GLclampf depth)
	Sets the clear depth in the range from [0..1]. More...

void	setColourMask (GLboolean red, GLboolean green, GLboolean blue, GLboolean alpha)
	Sets the current colour mask. More...

void	setCullFace (GLenum face)
	Sets the face culling setting. More...

void	setDepthFunc (GLenum func)
	Sets the current depth test function. More...

void	setDepthMask (GLboolean mask)
	Sets the current depth mask setting. More...

void	setDisabled (GLenum flag)
	Disables a piece of OpenGL functionality. More...

void	setDiscardBuffers (unsigned int flags)
	Sets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported. More...

void	setEnabled (GLenum flag)
	Enables a piece of OpenGL functionality. More...

void	setPolygonMode (GLenum mode)
	Sets the current polygon rendering mode. More...

void	setStencilMask (GLuint mask)
	Sets the stencil mask. More...

void	setTexParameterf (GLenum target, GLenum pname, GLfloat param)
	Sets a float parameter value per texture target. More...

void	setTexParameteri (GLenum target, GLenum pname, GLint param)
	Sets an integer parameter value per texture target. More...

void	setVertexAttribDisabled (GLuint attrib)
	Disables a vertex attribute. More...

void	setVertexAttribEnabled (GLuint attrib)
	Enables a vertex attribute. More...

Private Attributes
GLES2StateCacheManagerImp *	mImp

Detailed Description

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.

: 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.

Definition at line 53 of file OgreGLES2StateCacheManager.h.

Constructor & Destructor Documentation

◆ GLES2StateCacheManager()

Ogre::GLES2StateCacheManager::GLES2StateCacheManager ( void )

◆ ~GLES2StateCacheManager()

Ogre::GLES2StateCacheManager::~GLES2StateCacheManager ( void )

Member Function Documentation

◆ activateGLTextureUnit()

bool Ogre::GLES2StateCacheManager::activateGLTextureUnit ( unsigned char unit )

Activate an OpenGL texture unit.

Parameters

unit	The texture unit to activate.

Returns: Whether or not the texture unit was successfully activated.

◆ bindGLBuffer()

void Ogre::GLES2StateCacheManager::bindGLBuffer	(	GLenum	target,
		GLuint	buffer,
		bool	force = `false`
	)

Bind an OpenGL buffer of any type.

Parameters

target	The buffer target.
buffer	The buffer ID.
force	Optional parameter to force an update.

◆ bindGLTexture()

void Ogre::GLES2StateCacheManager::bindGLTexture	(	GLenum	target,
		GLuint	texture
	)

Bind an OpenGL texture of any type.

Parameters

target	The texture target.
texture	The texture ID.

◆ clearCache()

void Ogre::GLES2StateCacheManager::clearCache ( )

Clears all cached values.

◆ deleteGLBuffer()

void Ogre::GLES2StateCacheManager::deleteGLBuffer	(	GLenum	target,
		GLuint	buffer,
		bool	force = `false`
	)

Delete an OpenGL buffer of any type.

Parameters

target	The buffer target.
buffer	The buffer ID.
force	Optional parameter to force an update.

◆ getBlendEquation()

GLenum Ogre::GLES2StateCacheManager::getBlendEquation ( void ) const

Gets the current blend equation setting.

Returns: The blend equation.

◆ getClearDepth()

GLclampf Ogre::GLES2StateCacheManager::getClearDepth ( void ) const

Gets the clear depth in the range from [0..1].

Returns: The current clearing depth.

◆ getColourMask()

vector<GLboolean>::type& Ogre::GLES2StateCacheManager::getColourMask ( void ) const

Gets the current colour mask setting.

Returns: An array containing the mask in RGBA order.

◆ getCullFace()

GLenum Ogre::GLES2StateCacheManager::getCullFace ( void ) const

Sets the face culling mode.

Returns: The current face culling mode

◆ getDepthFunc()

GLenum Ogre::GLES2StateCacheManager::getDepthFunc ( void ) const

Gets the current depth test function.

Returns: The current depth test function.

◆ getDepthMask()

GLboolean Ogre::GLES2StateCacheManager::getDepthMask ( void ) const

Gets the current depth mask setting.

Returns: The current depth mask.

◆ getDiscardBuffers()

unsigned int Ogre::GLES2StateCacheManager::getDiscardBuffers ( void ) const

Gets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported.

Returns: The buffer mask.

◆ getPolygonMode()

GLenum Ogre::GLES2StateCacheManager::getPolygonMode ( void ) const

Gets the current polygon rendering mode, fill, wireframe, points, etc.

Returns: The current polygon rendering mode.

◆ getStencilMask()

GLuint Ogre::GLES2StateCacheManager::getStencilMask ( void ) const

Gets the current stencil mask.

Returns: The stencil mask.

◆ getTexParameterfv()

void Ogre::GLES2StateCacheManager::getTexParameterfv	(	GLenum	target,
		GLenum	pname,
		GLfloat *	param
	)

Sets a float parameter value per texture target.

Parameters

target	The texture target.
pname	The parameter name.
params	The parameter value.

◆ initializeCache()

void Ogre::GLES2StateCacheManager::initializeCache ( )

Initialize our cache variables and sets the GL states on the current context.

◆ invalidateStateForTexture()

void Ogre::GLES2StateCacheManager::invalidateStateForTexture ( GLuint texture )

Invalidates the state associated with a particular texture ID.

Parameters

texture The texture ID.

◆ operator delete() [1/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr )

inherited

Definition at line 96 of file OgreMemoryAllocatedObject.h.

◆ operator delete() [2/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		void *
	)

inherited

Definition at line 102 of file OgreMemoryAllocatedObject.h.

◆ operator delete() [3/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)

inherited

Definition at line 108 of file OgreMemoryAllocatedObject.h.

◆ operator delete[]() [1/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr )

inherited

Definition at line 113 of file OgreMemoryAllocatedObject.h.

◆ operator delete[]() [2/2]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[]	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)

inherited

Definition at line 119 of file OgreMemoryAllocatedObject.h.

◆ operator new() [1/3]

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)

inherited

operator new, with debug line info

Definition at line 68 of file OgreMemoryAllocatedObject.h.

◆ operator new() [2/3]

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz )

inherited

Definition at line 73 of file OgreMemoryAllocatedObject.h.

◆ operator new() [3/3]

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		void *	ptr
	)

inherited

placement operator new

Definition at line 79 of file OgreMemoryAllocatedObject.h.

◆ operator new[]() [1/2]

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[]	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)

inherited

array operator new, with debug line info

Definition at line 86 of file OgreMemoryAllocatedObject.h.

◆ operator new[]() [2/2]

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz )

inherited

Definition at line 91 of file OgreMemoryAllocatedObject.h.

◆ setBlendEquation()

void Ogre::GLES2StateCacheManager::setBlendEquation ( GLenum eq )

Sets the current blend equation setting.

Parameters

eq	The blend equation to use.

◆ setBlendFunc()

void Ogre::GLES2StateCacheManager::setBlendFunc	(	GLenum	source,
		GLenum	dest
	)

Sets the blending function.

Parameters

source	The blend mode for the source.
dest	The blend mode for the destination

◆ setClearColour()

void Ogre::GLES2StateCacheManager::setClearColour	(	GLclampf	red,
		GLclampf	green,
		GLclampf	blue,
		GLclampf	alpha
	)

Sets the color to clear to.

Parameters

red	The red component.
green	The green component.
blue	The blue component.
alpha	The alpha component.

◆ setClearDepth()

void Ogre::GLES2StateCacheManager::setClearDepth ( GLclampf depth )

Sets the clear depth in the range from [0..1].

Parameters

depth The clear depth to use.

◆ setColourMask()

void Ogre::GLES2StateCacheManager::setColourMask	(	GLboolean	red,
		GLboolean	green,
		GLboolean	blue,
		GLboolean	alpha
	)

Sets the current colour mask.

Parameters

red	The red component.
green	The green component.
blue	The blue component.
alpha	The alpha component.

◆ setCullFace()

void Ogre::GLES2StateCacheManager::setCullFace ( GLenum face )

Sets the face culling setting.

Parameters

face	The face culling mode to use.

◆ setDepthFunc()

void Ogre::GLES2StateCacheManager::setDepthFunc ( GLenum func )

Sets the current depth test function.

Parameters

func	The depth test function to use.

◆ setDepthMask()

void Ogre::GLES2StateCacheManager::setDepthMask ( GLboolean mask )

Sets the current depth mask setting.

Parameters

mask	The depth mask to use.

◆ setDisabled()

void Ogre::GLES2StateCacheManager::setDisabled ( GLenum flag )

Disables a piece of OpenGL functionality.

Parameters

flag	The function to disable.

◆ setDiscardBuffers()

void Ogre::GLES2StateCacheManager::setDiscardBuffers ( unsigned int flags )

Sets the mask of buffers to be discarded if GL_EXT_discard_framebuffer is supported.

Parameters

flags The bit mask of buffers to be discarded. Stored as Ogre::FrameBufferType.

◆ setEnabled()

void Ogre::GLES2StateCacheManager::setEnabled ( GLenum flag )

Enables a piece of OpenGL functionality.

Parameters

flag	The function to enable.

◆ setPolygonMode()

void Ogre::GLES2StateCacheManager::setPolygonMode ( GLenum mode )

Sets the current polygon rendering mode.

Parameters

mode	The polygon mode to use.

◆ setStencilMask()

void Ogre::GLES2StateCacheManager::setStencilMask ( GLuint mask )

Sets the stencil mask.

Parameters

mask	The stencil mask to use

◆ setTexParameterf()

void Ogre::GLES2StateCacheManager::setTexParameterf	(	GLenum	target,
		GLenum	pname,
		GLfloat	param
	)

Sets a float parameter value per texture target.

Parameters

target	The texture target.
pname	The parameter name.
params	The parameter value.

◆ setTexParameteri()

void Ogre::GLES2StateCacheManager::setTexParameteri	(	GLenum	target,
		GLenum	pname,
		GLint	param
	)

Sets an integer parameter value per texture target.

Parameters

target	The texture target.
pname	The parameter name.
param	The parameter value.

◆ setVertexAttribDisabled()

void Ogre::GLES2StateCacheManager::setVertexAttribDisabled ( GLuint attrib )

Disables a vertex attribute.

Parameters

attrib The attribute to disable.

◆ setVertexAttribEnabled()

void Ogre::GLES2StateCacheManager::setVertexAttribEnabled ( GLuint attrib )

Enables a vertex attribute.

Parameters

attrib The attribute to enable.

Member Data Documentation

◆ mImp

GLES2StateCacheManagerImp* Ogre::GLES2StateCacheManager::mImp

private

Definition at line 56 of file OgreGLES2StateCacheManager.h.

The documentation for this class was generated from the following file:

OgreGLES2StateCacheManager.h

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ GLES2StateCacheManager()

◆ ~GLES2StateCacheManager()

Member Function Documentation

◆ activateGLTextureUnit()

◆ bindGLBuffer()

◆ bindGLTexture()

◆ clearCache()

◆ deleteGLBuffer()

◆ getBlendEquation()

◆ getClearDepth()

◆ getColourMask()

◆ getCullFace()

◆ getDepthFunc()

◆ getDepthMask()

◆ getDiscardBuffers()

◆ getPolygonMode()

◆ getStencilMask()

◆ getTexParameterfv()

◆ initializeCache()

◆ invalidateStateForTexture()

◆ operator delete() [1/3]

◆ operator delete() [2/3]

◆ operator delete() [3/3]

◆ operator delete[]() [1/2]

◆ operator delete[]() [2/2]

◆ operator new() [1/3]

◆ operator new() [2/3]

◆ operator new() [3/3]

◆ operator new[]() [1/2]

◆ operator new[]() [2/2]

◆ setBlendEquation()

◆ setBlendFunc()

◆ setClearColour()

◆ setClearDepth()

◆ setColourMask()

◆ setCullFace()

◆ setDepthFunc()

◆ setDepthMask()

◆ setDisabled()

◆ setDiscardBuffers()

◆ setEnabled()

◆ setPolygonMode()

◆ setStencilMask()

◆ setTexParameterf()

◆ setTexParameteri()

◆ setVertexAttribDisabled()

◆ setVertexAttribEnabled()

Member Data Documentation

◆ mImp