CEGUI::OpenGLFBOTextureTarget Class Reference

OpenGLFBOTextureTarget - allows rendering to an OpenGL texture via FBO. More...

Inheritance diagram for CEGUI::OpenGLFBOTextureTarget:

Collaboration diagram for CEGUI::OpenGLFBOTextureTarget:

Public Member Functions
	OpenGLFBOTextureTarget (OpenGLRenderer &owner)
void	activate ()
	Activate the render target and put it in a state ready to be drawn to. More...
void	deactivate ()
	Deactivate the render target after having completed rendering. More...
void	clear ()
	Clear the surface of the underlying texture.
void	declareRenderSize (const Size &sz)
	Used to declare to the TextureTarget the largest size, in pixels, of the next set of incoming rendering operations. More...
void	grabTexture ()
	Grab the texture to a local buffer. More...
void	restoreTexture ()
	Restore the texture from the locally buffered copy previously create by a call to grabTexture.
Public Member Functions inherited from CEGUI::OpenGLTextureTarget
	OpenGLTextureTarget (OpenGLRenderer &owner)
	constructor.
virtual	~OpenGLTextureTarget ()
	destructor
bool	isImageryCache () const
	Return whether the RenderTarget is an implementation that caches actual rendered imagery. More...
Texture &	getTexture () const
	Return a pointer to the CEGUI::Texture that the TextureTarget is using. More...
bool	isRenderingInverted () const
	Return whether rendering done on the target texture is inverted in relation to regular textures. More...
Public Member Functions inherited from CEGUI::OpenGLRenderTarget
	OpenGLRenderTarget (OpenGLRenderer &owner)
	Constructor.
void	draw (const GeometryBuffer &buffer)
	Draw geometry from the given GeometryBuffer onto the surface that this RenderTarget represents. More...
void	draw (const RenderQueue &queue)
	Draw geometry from the given RenderQueue onto the surface that this RenderTarget represents. More...
void	setArea (const Rect &area)
	Set the area for this RenderTarget. The exact action this function will take depends upon what the concrete class is representing. For example, with a 'view port' style RenderTarget, this should set the area that the view port occupies on the display (or rendering window). More...
const Rect &	getArea () const
	Return the area defined for this RenderTarget. More...
void	activate ()
	Activate the render target and put it in a state ready to be drawn to. More...
void	deactivate ()
	Deactivate the render target after having completed rendering. More...
void	unprojectPoint (const GeometryBuffer &buff, const Vector2 &p_in, Vector2 &p_out) const
	Take point p_in unproject it and put the result in p_out. Resulting point is local to GeometryBuffer buff.
Public Member Functions inherited from CEGUI::RenderTarget
virtual	~RenderTarget ()
	Destructor.

Protected Member Functions
void	initialiseRenderTexture ()
	allocate and set up the texture used with the FBO.
void	resizeRenderTexture ()
	resize the texture

Protected Attributes
GLuint	d_frameBuffer
	Frame buffer object.
Protected Attributes inherited from CEGUI::OpenGLTextureTarget
GLuint	d_texture
	Associated OpenGL texture ID.
OpenGLTexture *	d_CEGUITexture
	we use this to wrap d_texture so it can be used by the core CEGUI lib.
Protected Attributes inherited from CEGUI::OpenGLRenderTarget
OpenGLRenderer &	d_owner
	OpenGLRenderer that created this object.
Rect	d_area
	holds defined area for the RenderTarget
double	d_matrix [16]
	saved copy of projection matrix
bool	d_matrixValid
	true if saved matrix is up to date
double	d_viewDistance
	tracks viewing distance (this is set up at the same time as d_matrix)

Static Protected Attributes
static const float	DEFAULT_SIZE
	default size of created texture objects

Detailed Description

OpenGLFBOTextureTarget - allows rendering to an OpenGL texture via FBO.

Member Function Documentation

void CEGUI::OpenGLFBOTextureTarget::activate ( )

virtual

Activate the render target and put it in a state ready to be drawn to.

Note

You MUST call this before doing any rendering - if you do not call this, in the unlikely event that your application actually works, it will likely stop working in some future version.

Implements CEGUI::RenderTarget.

void CEGUI::OpenGLFBOTextureTarget::deactivate ( )

virtual

Deactivate the render target after having completed rendering.

Note

You MUST call this after you finish rendering to the target - if you do not call this, in the unlikely event that your application actually works, it will likely stop working in some future version.

Implements CEGUI::RenderTarget.

void CEGUI::OpenGLFBOTextureTarget::declareRenderSize ( const Size &  sz )

virtual

Used to declare to the TextureTarget the largest size, in pixels, of the next set of incoming rendering operations.

Note

The main purpose of this is to allow for the implemenatation to resize the underlying texture so that it can hold the imagery that will be drawn.

Parameters

sz	Size object describing the largest area that will be rendererd in the next batch of rendering operations.

Exceptions

InvalidRequestException

May be thrown if the TextureTarget would not be able to handle the operations rendering content of the given size.

Implements CEGUI::TextureTarget.

void CEGUI::OpenGLFBOTextureTarget::grabTexture ( )

virtual

Grab the texture to a local buffer.

This will destroy the OpenGL texture, and restoreTexture must be called before using it again.

Reimplemented from CEGUI::OpenGLTextureTarget.