Direct3D10TextureTarget - allows rendering to Direct3D 10 textures. More...

Inheritance diagram for CEGUI::Direct3D10TextureTarget:

Collaboration diagram for CEGUI::Direct3D10TextureTarget:

Public Member Functions
	Direct3D10TextureTarget (Direct3D10Renderer &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...

bool	isImageryCache () const
	Return whether the RenderTarget is an implementation that caches actual rendered imagery. More...

void	clear ()
	Clear the surface of the underlying texture.

Texture &	getTexture () const
	Return a pointer to the CEGUI::Texture that the TextureTarget is using. More...

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

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::Direct3D10RenderTarget
	Direct3D10RenderTarget (Direct3D10Renderer &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	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 for rendering.

void	cleanupRenderTexture ()
	clean up the texture used for rendering.

void	resizeRenderTexture ()
	resize the texture

void	enableRenderTexture ()
	switch to the texture surface & depth buffer

void	disableRenderTexture ()
	switch back to previous surface

Protected Member Functions inherited from CEGUI::Direct3D10RenderTarget
void	updateMatrix () const
	helper that initialises the cached matrix

void	setupViewport (D3D10_VIEWPORT &vp) const
	helper to initialise the D3D10_VIEWPORT vp for this target.

Protected Attributes
ID3D10Texture2D *	d_texture
	Direct3D10 texture that's rendered to.

ID3D10RenderTargetView *	d_renderTargetView
	render target view for d_texture

Direct3D10Texture *	d_CEGUITexture
	we use this to wrap d_texture so it can be used by the core CEGUI lib.

ID3D10RenderTargetView *	d_previousRenderTargetView
	render target view that was bound before this target was activated

ID3D10DepthStencilView *	d_previousDepthStencilView
	depth stencil view that was bound before this target was activated

Protected Attributes inherited from CEGUI::Direct3D10RenderTarget
Direct3D10Renderer &	d_owner
	Renderer that created and owns the render target.

ID3D10Device &	d_device
	D3D10Device interface.

Rect	d_area
	holds defined area for the RenderTarget

D3DXMATRIX	d_matrix
	projection / view matrix cache

bool	d_matrixValid
	true when d_matrix is valid and up to date

float	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

Direct3D10TextureTarget - allows rendering to Direct3D 10 textures.

Member Function Documentation

void CEGUI::Direct3D10TextureTarget::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.

Reimplemented from CEGUI::Direct3D10RenderTarget.

void CEGUI::Direct3D10TextureTarget::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.

Reimplemented from CEGUI::Direct3D10RenderTarget.

void CEGUI::Direct3D10TextureTarget::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.

Texture& CEGUI::Direct3D10TextureTarget::getTexture ( ) const

virtual

Return a pointer to the CEGUI::Texture that the TextureTarget is using.

Returns: Texture object that the TextureTarget uses when rendering imagery.

Implements CEGUI::TextureTarget.

bool CEGUI::Direct3D10TextureTarget::isImageryCache ( ) const

virtual

Return whether the RenderTarget is an implementation that caches actual rendered imagery.

Typically it is expected that texture based RenderTargets would return
true in response to this call.  Other types of RenderTarget, like
view port based targets, will more likely return false.

Returns

true if the RenderTarget does cache rendered imagery.
false if the RenderTarget does not cache rendered imagery.

Implements CEGUI::RenderTarget.

bool CEGUI::Direct3D10TextureTarget::isRenderingInverted ( ) const

virtual

Return whether rendering done on the target texture is inverted in relation to regular textures.

This is intended to be used when generating geometry for rendering the
TextureTarget onto another surface.

Returns

true if the texture content should be considered as inverted vertically in comparison with other regular textures.
false if the texture content has the same orientation as regular textures.

Implements CEGUI::TextureTarget.

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Member Function Documentation