SR::DX9WeaverBase Class Reference

#include <dx9weaver.h>

Inheritance diagram for SR::DX9WeaverBase:

Public Member Functions
	DX9WeaverBase ()
	~DX9WeaverBase ()
IDirect3DSurface9 *	getFrameBuffer ()
	Returns the buffer that will be used to create a weaved image. This buffer expects a side-by-side image. When a frame buffer is provided by calling setInputFrameBuffer(), the internally created buffer will be released. More...
void	setInputFrameBuffer (IDirect3DTexture9 *frameBuffer)
	Sets the buffer that will be used to create a weaved image. This will release the internally created frame buffer. More...
void	setWindowHandle (HWND handle)
	Sets the window handle of the application window. More...
bool	canWeave (unsigned int width, unsigned int height)
	Used to determine if software weaving is possible for certain size and visibility to the currently bound framebuffer. More...
bool	canWeave (unsigned int width, unsigned int height, unsigned int xOffset, unsigned int yOffset)
	Used to determine if software weaving is possible for certain size and visibility to the currently bound framebuffer. More...
void	weave (unsigned int width, unsigned int height)
	Can be called to render a weaved image of a certain size to the currently bound framebuffer A framebuffer must be set before calling this function. More...
void	weave (unsigned int width, unsigned int height, unsigned int xOffset, unsigned int yOffset)
	Can be called to render a weaved image of a certain size to the currently bound framebuffer A framebuffer must be set before calling this function. More...
void	invalidateDeviceObjects ()
	Free all resources that were created in the default memory pool. This method should be called before IDirect3DDevice9::Reset(). More...
void	restoreDeviceObjects ()
	Allocate all resources that are created in the default memory pool. This method should be called after IDirect3DDevice9::Reset(). More...

Protected Attributes
std::unique_ptr< Impl >	pimpl

Constructor & Destructor Documentation

DX9WeaverBase()

SR::DX9WeaverBase::DX9WeaverBase

(

)

~DX9WeaverBase()

SR::DX9WeaverBase::~DX9WeaverBase

(

)

Member Function Documentation

canWeave() [1/2]

bool SR::DX9WeaverBase::canWeave	(	unsigned int	width,
		unsigned int	height
	)

Used to determine if software weaving is possible for certain size and visibility to the currently bound framebuffer.

Parameters

width	of the image to be rendered to the bound framebuffer
height	of the image to be rendered to the bound framebuffer

Exceptions

std::runtime_error

if the window handle (HWND) becomes invalid during the execution of canWeave

Returns

bool indicating whether weaving can be done. Returns true when software weaving can be performed by DX9Weaver. When false is returned, you can output side-by-side manually or let DX9Weaver handle this.

canWeave() [2/2]

bool SR::DX9WeaverBase::canWeave	(	unsigned int	width,
		unsigned int	height,
		unsigned int	xOffset,
		unsigned int	yOffset
	)

Used to determine if software weaving is possible for certain size and visibility to the currently bound framebuffer.

Parameters

width	of the image to be rendered to the bound framebuffer
height	of the image to be rendered to the bound framebuffer
xOffset	of the image to be rendered to the bound framebuffer
yOffset	of the image to be rendered to the bound framebuffer

Exceptions

std::runtime_error

if the window handle (HWND) becomes invalid during the execution of canWeave

Returns

bool indicating whether weaving can be done. Returns true when software weaving can be performed by DX9Weaver. When false is returned, you can output side-by-side manually or let DX9Weaver handle this.

getFrameBuffer()

IDirect3DSurface9 * SR::DX9WeaverBase::getFrameBuffer

(

)

Returns the buffer that will be used to create a weaved image. This buffer expects a side-by-side image. When a frame buffer is provided by calling setInputFrameBuffer(), the internally created buffer will be released.

The buffer identifier can be bound using SetRenderTarget to start rendering to it. Rendering to the buffer is identical to normal rendering and often starts with calling Clear.

Returns

IDirect3DSurface9 identifying a buffer generated with CreateTexture

invalidateDeviceObjects()

void SR::DX9WeaverBase::invalidateDeviceObjects

(

)

Free all resources that were created in the default memory pool. This method should be called before IDirect3DDevice9::Reset().

restoreDeviceObjects()

void SR::DX9WeaverBase::restoreDeviceObjects

(

)

Allocate all resources that are created in the default memory pool. This method should be called after IDirect3DDevice9::Reset().

setInputFrameBuffer()

void SR::DX9WeaverBase::setInputFrameBuffer

(

IDirect3DTexture9 *

frameBuffer

)

Sets the buffer that will be used to create a weaved image. This will release the internally created frame buffer.

Parameters

frameBuffer

Frame buffer to set

setWindowHandle()

void SR::DX9WeaverBase::setWindowHandle

(

HWND

handle

)

Sets the window handle of the application window.

Parameters

window

Handle of the application window

weave() [1/2]

void SR::DX9WeaverBase::weave	(	unsigned int	width,
		unsigned int	height
	)

Can be called to render a weaved image of a certain size to the currently bound framebuffer A framebuffer must be set before calling this function.

Parameters

width	of the image to be rendered to the bound framebuffer
height	of the image to be rendered to the bound framebuffer

weave() [2/2]

void SR::DX9WeaverBase::weave	(	unsigned int	width,
		unsigned int	height,
		unsigned int	xOffset,
		unsigned int	yOffset
	)

Can be called to render a weaved image of a certain size to the currently bound framebuffer A framebuffer must be set before calling this function.

Parameters

width	of the image to be rendered to the bound framebuffer
height	of the image to be rendered to the bound framebuffer
xOffset	of the image to be rendered to the bound framebuffer
yOffset	of the image to be rendered to the bound framebuffer

Member Data Documentation

pimpl

std::unique_ptr<Impl> SR::DX9WeaverBase::pimpl

protected

Suppressing warning because if we don't want to export everything then solving the underlying problem requires modification of the API Warning Description: 'type' : class 'type1' needs to have dll-interface to be used by clients of class 'type2' Candidate for deprecation

---

The documentation for this class was generated from the following file:

• dx9weaver.h