Crazy Eddie's GUI System  0.8.4
CEGUI::Direct3D11TextureTarget Class Reference

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

+ Inheritance diagram for CEGUI::Direct3D11TextureTarget:
+ Collaboration diagram for CEGUI::Direct3D11TextureTarget:

List of all members.

Public Member Functions

 Direct3D11TextureTarget (Direct3D11Renderer &owner)
void activate ()
 Activate the render target and put it in a state ready to be drawn to.
void deactivate ()
 Deactivate the render target after having completed rendering.
bool isImageryCache () const
 Return whether the RenderTarget is an implementation that caches actual rendered imagery.
void clear ()
 Clear the surface of the underlying texture.
TexturegetTexture () const
 Return a pointer to the CEGUI::Texture that the TextureTarget is using.
void declareRenderSize (const Sizef &sz)
 Used to declare to the TextureTarget the largest size, in pixels, of the next set of incoming rendering operations.
bool isRenderingInverted () const
 Return whether rendering done on the target texture is inverted in relation to regular textures.

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

Static Protected Member Functions

static String generateTextureName ()
 helper to generate unique texture names

Protected Attributes

ID3D11Texture2D * d_texture
 Direct3D10 texture that's rendered to.
ID3D11RenderTargetView * d_renderTargetView
 render target view for d_texture
Direct3D11Textured_CEGUITexture
 we use this to wrap d_texture so it can be used by the core CEGUI lib.
ID3D11RenderTargetView * d_previousRenderTargetView
 render target view that was bound before this target was activated
ID3D11DepthStencilView * d_previousDepthStencilView
 depth stencil view that was bound before this target was activated

Static Protected Attributes

static const float DEFAULT_SIZE
 default size of created texture objects
static uint s_textureNumber
 static data used for creating texture names

Detailed Description

Direct3D11TextureTarget - allows rendering to Direct3D 10 textures.


Member Function Documentation

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

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

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:
szSize object describing the largest area that will be rendererd in the next batch of rendering operations.
Exceptions:
InvalidRequestExceptionMay be thrown if the TextureTarget would not be able to handle the operations rendering content of the given size.

Implements CEGUI::TextureTarget.

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.

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:

Implements CEGUI::RenderTarget.

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.

 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends