Detailed Description

IYIGPUObject implementation for DirectFB textures.

#include <renderer/YiD3D11TextureObject.h>

Inheritance diagram for CYID3D11TextureObject:

Public Member Functions
	CYID3D11TextureObject ()

virtual	~CYID3D11TextureObject ()

virtual void	Load (const std::shared_ptr< CYIAssetHardware > &pAsset) override

virtual void	Unload () override

virtual void	Use () const override

virtual void	Generate () override

virtual void	Free () override

virtual void	InvalidateHandle () override

void	Configure (int32_t width, int32_t height, int32_t format, int32_t type)

ID3D11Texture2D *	GetDirect3D11Texture () const

ID3D11ShaderResourceView *	GetResourceView () const

void	SetDX11Texture (ID3D11Texture2D pTexture, ID3D11ShaderResourceView pResourceView)

void	SetIsRenderTarget (bool bRenderTarget)

void	Bind (uint32_t slot=0) const

Public Member Functions inherited from CYID3D11AbstractBufferObject
	CYID3D11AbstractBufferObject (int32_t handle)

virtual	~CYID3D11AbstractBufferObject ()

virtual uint32_t	GetHandle ()

Public Member Functions inherited from CYIBufferObject
	CYIBufferObject ()

virtual	~CYIBufferObject ()

virtual void *	Map ()

virtual void	Unmap (uint32_t uSize)

Public Member Functions inherited from IYIGPUObject
	IYIGPUObject ()

virtual	~IYIGPUObject ()

YI_GPU_OBJECT_STATUS	GetStatus () const

Friends
class	CYID3D11FramebufferObject

Additional Inherited Members
Public Types inherited from IYIGPUObject
enum	YI_GPU_OBJECT_STATUS { INVALID, UNLOADED, LOADED_FRESH, LOADED_STALE }

Protected Attributes inherited from CYID3D11AbstractBufferObject
uint32_t	m_handle

Protected Attributes inherited from IYIGPUObject
YI_GPU_OBJECT_STATUS	m_status

Constructor & Destructor Documentation

CYID3D11TextureObject::CYID3D11TextureObject ( )

Upon creation, a texture object will generate a valid handle in graphics memory

virtual CYID3D11TextureObject::~CYID3D11TextureObject ( )

virtual

Upon deletion, a texture object will free all of its memory and invalidate its handle

Member Function Documentation

void CYID3D11TextureObject::Bind ( uint32_t slot = 0 ) const

void CYID3D11TextureObject::Configure	(	int32_t	width,
		int32_t	height,
		int32_t	format,
		int32_t	type
	)

Parameters used are identical to those used for OpenGL's glTexImage2D(). Direct3D equivalents are implemented.

virtual void CYID3D11TextureObject::Free ( )

overridevirtual

Deallocates the GPU memory associated with this object.

Implements IYIGPUObject.

virtual void CYID3D11TextureObject::Generate ( )

overridevirtual

Generates a valid handle. No GPU memory is allocated until Load() is called.

Implements IYIGPUObject.

ID3D11Texture2D* CYID3D11TextureObject::GetDirect3D11Texture ( ) const

inline

ID3D11ShaderResourceView* CYID3D11TextureObject::GetResourceView ( ) const

inline

virtual void CYID3D11TextureObject::InvalidateHandle ( )

overridevirtual

This function can be called to invalidate the buffer handle without freeing the associated memory.

This can be used if the GL context is lost and GPU memory is freed implicitly. Calling Free() on this object will result in a crash if the handle is no longer pointing to valid memory, and a new handle may not be created with Generate() if the current handle is valid. This function allows you to inform the buffer object that the GL data has been freed externally and that the handle should be disconnected.

Warning: Calling this function without being sure that the handle has been freed in GPU memory will result in a memory leak. Use at your own risk.

Implements IYIGPUObject.

virtual void CYID3D11TextureObject::Load ( const std::shared_ptr< CYIAssetHardware > & pHWAsset )

overridevirtual

Loads the software data from the associated CYIAsset into graphics memory. If the YI_GPU_OBJECT_STATUS is LOADED_FRESH upon a call to load, meaning that data was previously successfully loaded, the status may become LOADED_STALE in the case where this load failed. See the YI_GPU_OBJECT_STATUS documentation for more details.

Implements IYIGPUObject.