CEGUI::Direct3D10Texture Class Reference

Texture implementation for the Direct3D10Renderer. More...

Inheritance diagram for CEGUI::Direct3D10Texture:

Collaboration diagram for CEGUI::Direct3D10Texture:

Public Member Functions
void	setDirect3DTexture (ID3D10Texture2D *tex)
	set the D3D10 texture that this Texture is based on to the specified texture.
ID3D10Texture2D *	getDirect3DTexture () const
	Return the internal D3D10 texture used by this Texture object. More...
ID3D10ShaderResourceView *	getDirect3DShaderResourceView () const
	Return the internal D3D10 shader resource view for the texture. More...
void	setOriginalDataSize (const Size &sz)
	Sets what the texture should consider as the original data size. More...
const Size &	getSize () const
	Returns the current pixel size of the texture. More...
const Size &	getOriginalDataSize () const
	Returns the original pixel size of the data loaded into the texture. More...
const Vector2 &	getTexelScaling () const
	Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords. More...
void	loadFromFile (const String &filename, const String &resourceGroup)
	Loads the specified image file into the texture. The texture is resized as required to hold the image. More...
void	loadFromMemory (const void *buffer, const Size &buffer_size, PixelFormat pixel_format)
	Loads (copies) an image in memory into the texture. The texture is resized as required to hold the image. More...
void	saveToMemory (void *buffer)
	Save / dump the content of the texture to a memory buffer. The dumped pixel format is always RGBA (4 bytes per pixel). More...
Public Member Functions inherited from CEGUI::Texture
virtual	~Texture ()
	Destructor for Texture base class.

Protected Member Functions
	Direct3D10Texture (ID3D10Device &device)
	Basic constructor.
	Direct3D10Texture (ID3D10Device &device, const String &filename, const String &resourceGroup)
	Construct texture from an image file.
	Direct3D10Texture (ID3D10Device &device, const Size &sz)
	Construct texture with a given size.
	Direct3D10Texture (ID3D10Device &device, ID3D10Texture2D *tex)
	Construct texture that wraps an existing D3D10 texture.
virtual	~Direct3D10Texture ()
	Destructor.
void	cleanupDirect3D10Texture ()
	clean up the internal texture.
void	updateCachedScaleValues ()
	updates cached scale value used to map pixels to texture co-ords.
void	updateTextureSize ()
	set d_size to actual texture size (d_dataSize is used if query fails)
void	initialiseShaderResourceView ()
	creates shader resource view for the current D3D texture

Protected Attributes
ID3D10Device &	d_device
	D3D device used to do the business.
ID3D10Texture2D *	d_texture
	The D3D 10 texture we're wrapping.
ID3D10ShaderResourceView *	d_resourceView
	Shader resource view for the texture.
Size	d_size
	Size of the texture.
Size	d_dataSize
	original pixel of size data loaded into texture
Vector2	d_texelScaling
	cached pixel to texel mapping scale values.

Friends
Texture &	Direct3D10Renderer::createTexture ()
Texture &	Direct3D10Renderer::createTexture (const String &, const String &)
Texture &	Direct3D10Renderer::createTexture (const Size &)
void	Direct3D10Renderer::destroyTexture (Texture &)

Additional Inherited Members
Public Types inherited from CEGUI::Texture
enum	PixelFormat { PF_RGB, PF_RGBA }
	Enumerated type containing the supported pixel formats that can be passed to loadFromMemory. More...

Detailed Description

Texture implementation for the Direct3D10Renderer.

Member Function Documentation

ID3D10ShaderResourceView* CEGUI::Direct3D10Texture::getDirect3DShaderResourceView

(

)

const

Return the internal D3D10 shader resource view for the texture.

Returns

Pointer to the ID3D10ShaderResourceView interface.

ID3D10Texture2D* CEGUI::Direct3D10Texture::getDirect3DTexture

(

)

const

Return the internal D3D10 texture used by this Texture object.

Returns

Pointer to the D3D10 texture interface that this object is using.

const Size& CEGUI::Direct3D10Texture::getOriginalDataSize ( ) const

virtual

Returns the original pixel size of the data loaded into the texture.

Returns

reference to a Size object that describes the original size, in pixels, of the data loaded into the texture.

Implements CEGUI::Texture.

const Size& CEGUI::Direct3D10Texture::getSize ( ) const

virtual

Returns the current pixel size of the texture.

Returns

Reference to a Size object that describes the size of the texture in pixels.

Implements CEGUI::Texture.

const Vector2& CEGUI::Direct3D10Texture::getTexelScaling ( ) const

virtual

Returns pixel to texel scale values that should be used for converting pixel values to texture co-ords.

Returns

Reference to a Vector2 object that describes the scaling values required to accurately map pixel positions to texture co-ordinates.

Implements CEGUI::Texture.

void CEGUI::Direct3D10Texture::loadFromFile ( const String &  filename, const String &  resourceGroup  )

virtual

Loads the specified image file into the texture. The texture is resized as required to hold the image.

Parameters

filename	The filename of the image file that is to be loaded into the texture
resourceGroup	Resource group identifier to be passed to the resource provider when loading the image file.

Returns

Nothing.

Implements CEGUI::Texture.

void CEGUI::Direct3D10Texture::loadFromMemory ( const void *  buffer, const Size &  buffer_size, PixelFormat  pixel_format  )

virtual

Loads (copies) an image in memory into the texture. The texture is resized as required to hold the image.

Parameters

buffer	Pointer to the buffer containing the image data.
buffer_size	Size of the buffer (in pixels as specified by pixelFormat)
pixel_format	PixelFormat value describing the format contained in buffPtr.

Returns

Nothing.

Implements CEGUI::Texture.

void CEGUI::Direct3D10Texture::saveToMemory ( void *  buffer )

virtual

Save / dump the content of the texture to a memory buffer. The dumped pixel format is always RGBA (4 bytes per pixel).

Parameters

buffer

Pointer to the buffer that is to receive the image data. You must make sure that this buffer is large enough to hold the dumped texture data, the required pixel dimensions can be established by calling getSize.

Implements CEGUI::Texture.

void CEGUI::Direct3D10Texture::setOriginalDataSize

(

const Size &

sz

)

Sets what the texture should consider as the original data size.

Note

This also causes the texel scaling values to be updated.