Chain of compositor effects applying to one viewport. More...

#include <OgreCompositorChain.h>

Inheritance diagram for Ogre::CompositorChain:

Classes
class	RQListener
	Render queue listener used to set up rendering events. More...
Public Types
typedef VectorIterator< Instances >	InstanceIterator
typedef vector < CompositorInstance * >::type	Instances
	Data types.
Public Member Functions
	CompositorChain (Viewport *vp)
virtual	~CompositorChain ()
	Another gcc warning here, which is no problem because RenderTargetListener is never used to delete an object.
void	_compile ()
	Compile this Composition chain into a series of RenderTarget operations.
CompositorInstance *	_getOriginalSceneCompositor (void)
	Get the original scene compositor instance for this chain (internal use).
void	_markDirty ()
	Mark state as dirty, and to be recompiled next frame.
void	_queuedOperation (CompositorInstance::RenderSystemOperation *op)
	Internal method for registering a queued operation for deletion later.
void	_removeInstance (CompositorInstance *i)
	Remove a compositor by pointer.
CompositorInstance *	addCompositor (CompositorPtr filter, size_t addPosition=LAST, const String &scheme=StringUtil::BLANK)
	Apply a compositor.
CompositorInstance *	getCompositor (size_t index)
	Get compositor instance by position.
CompositorInstance *	getCompositor (const String &name)
	Get compositor instance by name.
InstanceIterator	getCompositors ()
	Get an iterator over the compositor instances.
CompositorInstance *	getNextInstance (CompositorInstance *curr, bool activeOnly=true)
	Get the next instance in this chain to the one specified.
size_t	getNumCompositors ()
	Get the number of compositors.
CompositorInstance *	getPreviousInstance (CompositorInstance *curr, bool activeOnly=true)
	Get the previous instance in this chain to the one specified.
Viewport *	getViewport ()
	Get viewport that is the target of this chain.
void	operator delete (void *ptr)
void	operator delete (void ptr, void )
void	operator delete (void ptr, const char , int, const char *)
void	operator delete[] (void *ptr)
void	operator delete[] (void ptr, const char , int, const char *)
void *	operator new (size_t sz, const char file, int line, const char func)
	operator new, with debug line info
void *	operator new (size_t sz)
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info
void *	operator new[] (size_t sz)
virtual void	postRenderTargetUpdate (const RenderTargetEvent &evt)
virtual void	postViewportUpdate (const RenderTargetViewportEvent &evt)
virtual void	preRenderTargetUpdate (const RenderTargetEvent &evt)
virtual void	preViewportUpdate (const RenderTargetViewportEvent &evt)
void	removeAllCompositors ()
	Remove all compositors.
void	removeCompositor (size_t position=LAST)
	Remove a compositor.
void	setCompositorEnabled (size_t position, bool state)
	Enable or disable a compositor, by position.
virtual void	viewportAdded (const RenderTargetViewportEvent &evt)
	Called to notify listener that a Viewport has been added to the target in question.
virtual void	viewportCameraChanged (Viewport *viewport)
virtual void	viewportDestroyed (Viewport *viewport)
virtual void	viewportDimensionsChanged (Viewport *viewport)
virtual void	viewportRemoved (const RenderTargetViewportEvent &evt)
	Called to notify listener that a Viewport has been removed from the target in question.
Static Public Attributes
static const size_t	BEST = 0
	Identifier for best technique.
static const size_t	LAST = (size_t)-1
	Identifier for "last" compositor in chain.
Protected Types
typedef vector < CompositorInstance::RenderSystemOperation * > ::type	RenderSystemOperations
	Render System operations queued by last compile, these are created by this instance thus managed and deleted by it.
Protected Member Functions
void	clearCompiledState ()
	Clear compiled state.
void	createOriginalScene ()
void	destroyOriginalScene ()
void	destroyResources (void)
	destroy internal resources
void	postTargetOperation (CompositorInstance::TargetOperation &op, Viewport vp, Camera cam)
	Restore a viewport, the camera and the scene after a rendering operation.
void	preTargetOperation (CompositorInstance::TargetOperation &op, Viewport vp, Camera cam)
	Prepare a viewport, the camera and the scene for a rendering operation.
Protected Attributes
bool	mAnyCompositorsEnabled
	Any compositors enabled?
CompositorInstance::CompiledState	mCompiledState
	Compiled state (updated with _compile)
bool	mDirty
	State needs recompile.
Instances	mInstances
	Postfilter instances in this chain.
unsigned int	mOldClearEveryFrameBuffers
	Old viewport settings.
bool	mOldFindVisibleObjects
	Store old find visible objects.
float	mOldLodBias
	Store old camera LOD bias.
String	mOldMaterialScheme
	Store old viewport material scheme.
bool	mOldShadowsEnabled
	Store old shadows enabled flag.
uint32	mOldVisibilityMask
	Store old scene visibility mask.
CompositorInstance *	mOriginalScene
	Plainly renders the scene; implicit first compositor in the chain.
String	mOriginalSceneScheme
RQListener	mOurListener
CompositorInstance::TargetOperation	mOutputOperation
RenderSystemOperations	mRenderSystemOperations
Viewport *	mViewport
	Viewport affected by this CompositorChain.

Detailed Description

Chain of compositor effects applying to one viewport.

Definition at line 48 of file OgreCompositorChain.h.

Member Typedef Documentation

typedef VectorIterator<Instances> Ogre::CompositorChain::InstanceIterator

Definition at line 59 of file OgreCompositorChain.h.

typedef vector<CompositorInstance*>::type Ogre::CompositorChain::Instances

Data types.

Definition at line 58 of file OgreCompositorChain.h.

typedef vector<CompositorInstance::RenderSystemOperation*>::type Ogre::CompositorChain::RenderSystemOperations [protected]

Render System operations queued by last compile, these are created by this instance thus managed and deleted by it.

The list is cleared with clearCompilationState()

Definition at line 181 of file OgreCompositorChain.h.

Constructor & Destructor Documentation

Ogre::CompositorChain::CompositorChain ( Viewport * vp )

virtual Ogre::CompositorChain::~CompositorChain ( ) [virtual]

Another gcc warning here, which is no problem because RenderTargetListener is never used to delete an object.

Member Function Documentation

void Ogre::CompositorChain::_compile ( )

Compile this Composition chain into a series of RenderTarget operations.

CompositorInstance* Ogre::CompositorChain::_getOriginalSceneCompositor ( void )

Get the original scene compositor instance for this chain (internal use).

Definition at line 100 of file OgreCompositorChain.h.

void Ogre::CompositorChain::_markDirty ( )

Mark state as dirty, and to be recompiled next frame.

void Ogre::CompositorChain::_queuedOperation ( CompositorInstance::RenderSystemOperation * op )

Internal method for registering a queued operation for deletion later.

void Ogre::CompositorChain::_removeInstance ( CompositorInstance * i )

Remove a compositor by pointer.

This is internally used by CompositionTechnique to "weak" remove any instanced of a deleted technique.

CompositorInstance* Ogre::CompositorChain::addCompositor	(	CompositorPtr	filter,
		size_t	addPosition = `LAST`,
		const String &	scheme = `StringUtil::BLANK`
	)

Apply a compositor.

Initially, the filter is enabled.

Parameters:

filter	Filter to apply.
addPosition	Position in filter chain to insert this filter at; defaults to the end (last applied filter).
scheme	Scheme to use (blank means default).

void Ogre::CompositorChain::clearCompiledState ( ) [protected]

Clear compiled state.

void Ogre::CompositorChain::createOriginalScene ( ) [protected]

void Ogre::CompositorChain::destroyOriginalScene ( ) [protected]

void Ogre::CompositorChain::destroyResources ( void ) [protected]

destroy internal resources

CompositorInstance* Ogre::CompositorChain::getCompositor ( size_t index )

Get compositor instance by position.

CompositorInstance* Ogre::CompositorChain::getCompositor ( const String & name )

Get compositor instance by name.

Returns null if not found.

InstanceIterator Ogre::CompositorChain::getCompositors ( )

Get an iterator over the compositor instances.

The first compositor in this list is applied first, the last one is applied last.

CompositorInstance* Ogre::CompositorChain::getNextInstance	(	CompositorInstance *	curr,
		bool	activeOnly = `true`
	)

Get the next instance in this chain to the one specified.

size_t Ogre::CompositorChain::getNumCompositors ( )

Get the number of compositors.

CompositorInstance* Ogre::CompositorChain::getPreviousInstance	(	CompositorInstance *	curr,
		bool	activeOnly = `true`
	)

Get the previous instance in this chain to the one specified.

Viewport* Ogre::CompositorChain::getViewport ( )

Get viewport that is the target of this chain.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr ) [inherited]

Definition at line 96 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		void *
	)		`[inherited]`

Definition at line 102 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)		`[inherited]`

Definition at line 108 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr ) [inherited]

Definition at line 113 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[]	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)		`[inherited]`

Definition at line 119 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)		`[inherited]`

operator new, with debug line info

Definition at line 68 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz ) [inherited]

Definition at line 73 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		void *	ptr
	)		`[inherited]`

placement operator new

Definition at line 79 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[]	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)		`[inherited]`

array operator new, with debug line info

Definition at line 86 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz ) [inherited]

Definition at line 91 of file OgreMemoryAllocatedObject.h.

virtual void Ogre::CompositorChain::postRenderTargetUpdate ( const RenderTargetEvent & evt ) [virtual]

See also:: RenderTargetListener::postRenderTargetUpdate

Reimplemented from Ogre::RenderTargetListener.

void Ogre::CompositorChain::postTargetOperation	(	CompositorInstance::TargetOperation &	op,
		Viewport *	vp,
		Camera *	cam
	)		`[protected]`

Restore a viewport, the camera and the scene after a rendering operation.

virtual void Ogre::CompositorChain::postViewportUpdate ( const RenderTargetViewportEvent & evt ) [virtual]

See also:: RenderTargetListener::postViewportUpdate

Reimplemented from Ogre::RenderTargetListener.

virtual void Ogre::CompositorChain::preRenderTargetUpdate ( const RenderTargetEvent & evt ) [virtual]

See also:: RenderTargetListener::preRenderTargetUpdate

Reimplemented from Ogre::RenderTargetListener.

void Ogre::CompositorChain::preTargetOperation	(	CompositorInstance::TargetOperation &	op,
		Viewport *	vp,
		Camera *	cam
	)		`[protected]`

Prepare a viewport, the camera and the scene for a rendering operation.

virtual void Ogre::CompositorChain::preViewportUpdate ( const RenderTargetViewportEvent & evt ) [virtual]

See also:: RenderTargetListener::preViewportUpdate

Reimplemented from Ogre::RenderTargetListener.

void Ogre::CompositorChain::removeAllCompositors ( )

Remove all compositors.

void Ogre::CompositorChain::removeCompositor ( size_t position = LAST )

Remove a compositor.

Parameters:

position Position in filter chain of filter to remove; defaults to the end (last applied filter)

void Ogre::CompositorChain::setCompositorEnabled	(	size_t	position,
		bool	state
	)

Enable or disable a compositor, by position.

Disabling a compositor stops it from rendering but does not free any resources. This can be more efficient than using removeCompositor and addCompositor in cases the filter is switched on and off a lot.

Parameters:

position Position in filter chain of filter

virtual void Ogre::RenderTargetListener::viewportAdded ( const RenderTargetViewportEvent & evt ) [virtual, inherited]

Called to notify listener that a Viewport has been added to the target in question.

Definition at line 134 of file OgreRenderTargetListener.h.

virtual void Ogre::CompositorChain::viewportCameraChanged ( Viewport * viewport ) [virtual]