Ogre::CompositorNodeDef Class Reference

Compositor nodes are the core subject of compositing. More...

#include <OgreCompositorNodeDef.h>

Inheritance diagram for Ogre::CompositorNodeDef:

Public Types
enum	BoolSetting { BoolFalse , BoolTrue , BoolUndefined }
typedef vector< BufferDefinition >::type	BufferDefinitionVec
typedef vector< TextureDefinition >::type	TextureDefinitionVec
enum	TextureSource { TEXTURE_INPUT , TEXTURE_LOCAL , TEXTURE_GLOBAL , NUM_TEXTURES_SOURCES }

Public Member Functions
	CompositorNodeDef (const String &name, CompositorManager2 *compositorManager)
virtual	~CompositorNodeDef ()
void	addBufferDefinition (IdString name, size_t numElements, uint32 bytesPerElement, uint32 bindFlags, float widthFactor, float heightFactor)
	Creates an UAV buffer.
virtual void	addBufferInput (size_t inputChannel, IdString name)
	Buffers.
CompositorTargetDef *	addTargetPass (const String &renderTargetName, uint32 rtIndex=0)
	Adds a new Target pass.
TextureDefinition *	addTextureDefinition (const String &name)
	Creates a TextureDefinition with a given name, must be unique.
virtual IdString	addTextureSourceName (const String &name, size_t index, TextureSource textureSource)
	Adds a texture name, whether a real one or an alias, and where to grab it from.
CompositorManager2 *	getCompositorManager (void) const
const BufferDefinitionVec &	getLocalBufferDefinitions (void) const
BufferDefinitionVec &	getLocalBufferDefinitionsNonConst (void)
	Returns the local buffer definitions.
const TextureDefinitionVec &	getLocalTextureDefinitions (void) const
TextureDefinitionVec &	getLocalTextureDefinitionsNonConst (void)
	Returns the local texture definitions.
IdString	getName (void) const
String	getNameStr (void) const
const NameToChannelMap &	getNameToChannelMap (void) const
size_t	getNumInputBufferChannels (void) const
size_t	getNumInputChannels (void) const
	This has O(N) complexity! (not cached, we look in mNameToChannelMap)
size_t	getNumOutputChannels (void) const
	Returns the number of output channels.
size_t	getNumTargetPasses (void) const
	Gets the number of passes in this node.
size_t	getPassNumber (const CompositorPassDef *passDef) const
	Returns the pass # of the given pass definition in this node.
bool	getStartEnabled (void) const
CompositorTargetDef *	getTargetPass (size_t passIndex)
	Retrieves an existing pass by it's given index.
void	getTextureSource (IdString name, size_t &index, TextureSource &textureSource) const
	See http://www.research.att.com/~bs/bs_faq2.html#overloadderived.
void	getTextureSource (size_t outputChannel, size_t &index, TextureSource &textureSource) const
	Retrieves in which container to look for when wanting to know the output texture using the mappings from input/local texture -> output.
void	mapOutputBufferChannel (size_t outChannel, IdString bufferName)
	Maps the output channel to the given buffer name which can be either a local buffer or a reference to an input channel.
void	mapOutputChannel (size_t outChannel, IdString textureName)
	Maps the output channel to the given texture name, which can be either a local texture or a reference to an input channel.
void	operator delete (void *ptr)
void	operator delete (void *ptr, const char *, int, const char *)
void	operator delete (void *ptr, void *)
void	operator delete[] (void *ptr)
void	operator delete[] (void *ptr, const char *, int, const char *)
void *	operator new (size_t sz)
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 *ptr)
	placement operator new
void *	operator new[] (size_t sz)
void *	operator new[] (size_t sz, const char *file, int line, const char *func)
	array operator new, with debug line info
virtual void	postInitializePassDef (CompositorPassDef *passDef)
	Called right after we create a pass definition.
virtual void	removeBuffer (IdString name)
	Remove a buffer. Buffer can come from an input channel, or a locally defined one.
virtual void	removeTexture (IdString name)
	WARNING: Be very careful with this function.
void	renameBuffer (IdString oldName, const String &newName)
	Changes the name of a buffer.
void	renameTexture (IdString oldName, const String &newName)
	Changes the name of a texture.
void	setNumLocalBufferDefinitions (size_t numTDs)
	Reserves enough memory for all texture definitions.
void	setNumLocalTextureDefinitions (size_t numTDs)
	Reserves enough memory for all texture definitions.
void	setNumOutputBufferChannels (size_t numOuts)
	Reserves enough memory for all output channel mappings (efficient allocation, better than using linked lists or other containers with two level of indirections)
void	setNumOutputChannels (size_t numOuts)
	Reserves enough memory for all output channel mappings (efficient allocation, better than using linked lists or other containers with two level of indirections)
void	setNumTargetPass (size_t numPasses)
	Reserves enough memory for all passes.
void	setStartEnabled (bool enabled)
	Whether the node should be start as enabled when instantiated.

Static Public Member Functions
static UavBufferPacked *	createBuffer (const BufferDefinition &bufferDef, const RenderTarget *finalTarget, VaoManager *vaoManager)
static void	createBuffers (const BufferDefinitionVec &bufferDefs, CompositorNamedBufferVec &inOutBufContainer, const RenderTarget *finalTarget, RenderSystem *renderSys)
	Utility function to create the buffers based on a given set of buffer definitions and put them in a container.
static CompositorChannel	createTexture (const TextureDefinition &textureDef, const String &texName, const RenderTarget *finalTarget, RenderSystem *renderSys)
static void	createTextures (const TextureDefinitionVec &textureDefs, CompositorChannelVec &inOutTexContainer, IdType id, const RenderTarget *finalTarget, RenderSystem *renderSys)
	Utility function to create the textures based on a given set of texture definitions and put them in a container.
static void	destroyBuffers (const BufferDefinitionVec &bufferDefs, CompositorNamedBufferVec &inOutBufContainer, RenderSystem *renderSys)
static void	destroyTextures (CompositorChannelVec &inOutTexContainer, RenderSystem *renderSys)
	@See createTextures
static void	recreateResizableBuffers (const BufferDefinitionVec &bufferDefs, CompositorNamedBufferVec &inOutBufContainer, const RenderTarget *finalTarget, RenderSystem *renderSys, const CompositorNodeVec &connectedNodes, const CompositorPassVec *passes)
	Destroys & recreates only the buffers that depend on the main RT (i.e.
static void	recreateResizableTextures (const TextureDefinitionVec &textureDefs, CompositorChannelVec &inOutTexContainer, const RenderTarget *finalTarget, RenderSystem *renderSys, const CompositorNodeVec &connectedNodes, const CompositorPassVec *passes)
	Destroys & recreates only the textures that depend on the main RT (i.e.

Public Attributes
IdString	mCustomIdentifier

Friends
class	CompositorNode

Detailed Description

Compositor nodes are the core subject of compositing.

They can define local textures and pass them to other nodes within the same workspace through their output channels. They can also receive textures through their input channels and send them through a different output channel to the next node(s). They can access global textures defined by the Workspace they belong to, but can't pass them to the output channels.

How nodes input and output channels are wired together depends on the Workspace (See @CompositorWorkspace and @CompositorWorkspaceDef) A node cannot receive input from two nodes in the same channel, but it can send output to more than one node using the same output channel.

A node whose workspace didn't connect all of its input channels cannot be executed, and unless it is disabled, the Compositor will be unable to render.

The other core feature of nodes (besides textures and channels) is that they perform passes on RTs. A pass is the basic way to render: it can be a @PASS_SCENE, @PASS_QUAD, @PASS_CLEAR, @PASS_STENCIL, @PASS_RESOLVE

This is the definition. For the instantiation,

See also

CompositorNode

Remarks

We own the local textures, so it's our job to destroy them

Author

Matias N. Goldberg

Version

1.1

Member Typedef Documentation

BufferDefinitionVec

typedef vector<BufferDefinition>::type Ogre::TextureDefinitionBase::BufferDefinitionVec

inherited

TextureDefinitionVec

typedef vector<TextureDefinition>::type Ogre::TextureDefinitionBase::TextureDefinitionVec

inherited

Member Enumeration Documentation

BoolSetting

enum Ogre::TextureDefinitionBase::BoolSetting

inherited

Enumerator
BoolFalse
BoolTrue
BoolUndefined

TextureSource

enum Ogre::TextureDefinitionBase::TextureSource

inherited

Enumerator
TEXTURE_INPUT
TEXTURE_LOCAL	We got the texture through an input channel.
TEXTURE_GLOBAL	We own the texture.
NUM_TEXTURES_SOURCES	It's a global texture. Ask the manager for it.

Constructor & Destructor Documentation

CompositorNodeDef()

Ogre::CompositorNodeDef::CompositorNodeDef ( const String &  name, CompositorManager2 *  compositorManager  )

inline

~CompositorNodeDef()

virtual Ogre::CompositorNodeDef::~CompositorNodeDef ( )

inlinevirtual

Member Function Documentation

addBufferDefinition()

void Ogre::TextureDefinitionBase::addBufferDefinition ( IdString  name, size_t  numElements, uint32  bytesPerElement, uint32  bindFlags, float  widthFactor, float  heightFactor  )

inherited

Creates an UAV buffer.

Parameters

name	Name to give to this buffer for referencing it locally from this scope. Duplicate names (including names from addBufferInput) will raise an exception when trying to instantiate the workspace.
bindFlags	Bitmask.

See also

BufferBindFlags

Parameters

widthFactor

See also

BufferDefinition::widthFactor

Parameters

heightFactor

See also

BufferDefinition::widthFactor

addBufferInput()

virtual void Ogre::TextureDefinitionBase::addBufferInput ( size_t  inputChannel, IdString  name  )

virtualinherited

Buffers.

Specifies that buffer incoming from channel 'inputChannel' will be referenced by the name 'name'

Remarks

Don't leave gaps. (i.e. set channel 0 & 2, without setting channel 1) It's ok to map them out of order (i.e. set channel 2, then 0, then 1)

Parameters

inputChannel	Input channel # the buffer comes from.
name	Name to give to this buffer for referencing it locally from this scope. Duplicate names (including names from addBufferDefinition) will raise an exception when trying to instantiate the workspace.

Reimplemented in Ogre::CompositorShadowNodeDef.

addTargetPass()

CompositorTargetDef * Ogre::CompositorNodeDef::addTargetPass	(	const String &	renderTargetName,
		uint32	rtIndex = 0
	)

Adds a new Target pass.

Remarks

WARNING: Calling this function may invalidate all previous returned pointers unless you've properly called setNumTargetPass

Parameters

renderTargetName	We need the full name, not just the hash; so we can check whether it has the global_ prefix
rtIndex	The RT to address if it is intended to use with a 3D texture (or a cubemap or a 2D Array) @See CompositorPassDef::mRtIndex. Default: 0

addTextureDefinition()

TextureDefinition * Ogre::TextureDefinitionBase::addTextureDefinition ( const String &  name )

inherited

Creates a TextureDefinition with a given name, must be unique.

Remarks

WARNING: Calling this function may invalidate all previous returned pointers unless you've properly called setLocalTextureDefinitions

@See addTextureSourceName remarks for what it can throw

Textures are local when the derived class is a Node definition, and it's global when the derived class is a Workspace definition

Parameters

name	The name of the texture. Names are usually valid only throughout this node. We need the name, not its hash because we need to validate the global_ prefix is used correctly.

addTextureSourceName()

virtual IdString Ogre::TextureDefinitionBase::addTextureSourceName ( const String &  name, size_t  index, TextureSource  textureSource  )

virtualinherited

Adds a texture name, whether a real one or an alias, and where to grab it from.

Remarks

Throws if a texture with same name already exists, or if the name makes improper usage of the 'global' prefix.

This is a generic way to add input channels, by calling:

addTextureSourceName( "myRT", 0, TextureDefinitionBase::TEXTURE_INPUT );

You're assigning an alias named "myRT" to channel Input #0 For local or global textures, the index parameter documentation

Parameters

fullName	The name of the texture. Names are usually valid only throughout this node. We need the name, not its hash because we need to validate the global_ prefix is used correctly.
index	Index in the container where the texture is located, eg. this->mLocalTextureDefs[index] for local textures, workspace->mLocalTextureDefs[index] for global textures, and this->mInTextures[index] for input channels.
textureSource	Source where the index must be used (eg. TEXTURE_LOCAL means mLocalTextureDefs)

Returns

IdString of the fullName paremeter, for convenience

Reimplemented in Ogre::CompositorShadowNodeDef.

createBuffer()

static UavBufferPacked * Ogre::TextureDefinitionBase::createBuffer ( const BufferDefinition &  bufferDef, const RenderTarget *  finalTarget, VaoManager *  vaoManager  )

staticinherited

createBuffers()

static void Ogre::TextureDefinitionBase::createBuffers ( const BufferDefinitionVec &  bufferDefs, CompositorNamedBufferVec &  inOutBufContainer, const RenderTarget *  finalTarget, RenderSystem *  renderSys  )

staticinherited

Utility function to create the buffers based on a given set of buffer definitions and put them in a container.

Remarks

Useful because both Workspace & CompositorNode share the same functionality (create global/local buffers respectively) without having to create a whole base class just for one function. It's confusing that Nodes & Workspace would share the same base class, as if they were the same base object or share similar functionality (when in fact, workspace manages nodes)

createTexture()

static CompositorChannel Ogre::TextureDefinitionBase::createTexture ( const TextureDefinition &  textureDef, const String &  texName, const RenderTarget *  finalTarget, RenderSystem *  renderSys  )

staticinherited

createTextures()

static void Ogre::TextureDefinitionBase::createTextures ( const TextureDefinitionVec &  textureDefs, CompositorChannelVec &  inOutTexContainer, IdType  id, const RenderTarget *  finalTarget, RenderSystem *  renderSys  )

staticinherited

Utility function to create the textures based on a given set of texture definitions and put them in a container.

Remarks

Useful because both Workspace & CompositorNode share the same functionality (create global/local textures respectively) without having to create a whole base class just for one function. It's confusing that Nodes & Workspace would share the same base class, as if they were the same base object or share similar functionality (when in fact, workspace manages nodes)

Parameters

textureDefs	Array of texture definitions
inOutTexContainer	Where we'll store the newly created RTs & textures
id	Unique id in the case we want textures to have unique names (uniqueNames must be true)
uniqueNames	Set to true if each RT will have a unique name based on given Id, or we don't. The latter is useful for global textures (let them get access through materials)
finalTarget	The final render target (usually the render window) we have to clone parameters from (eg. when using auto width & height, or fsaa settings)
renderSys	The RenderSystem to use

destroyBuffers()

static void Ogre::TextureDefinitionBase::destroyBuffers ( const BufferDefinitionVec &  bufferDefs, CompositorNamedBufferVec &  inOutBufContainer, RenderSystem *  renderSys  )

staticinherited

See also

createBuffers We need the definition because, unlike textures, the container passed in may contain textures that were not created by us (i.e. global & input textures) that we shouldn't delete. It is illegal for two buffers to have the same name, so it's invalid that a e.g. an input and a local texture would share the same name.

destroyTextures()

static void Ogre::TextureDefinitionBase::destroyTextures ( CompositorChannelVec &  inOutTexContainer, RenderSystem *  renderSys  )

staticinherited

@See createTextures

getCompositorManager()

CompositorManager2 * Ogre::CompositorNodeDef::getCompositorManager ( void  ) const

inline

getLocalBufferDefinitions()

const BufferDefinitionVec & Ogre::TextureDefinitionBase::getLocalBufferDefinitions ( void  ) const

inlineinherited

getLocalBufferDefinitionsNonConst()

BufferDefinitionVec & Ogre::TextureDefinitionBase::getLocalBufferDefinitionsNonConst ( void  )

inlineinherited

Returns the local buffer definitions.

Remarks

WARNING: Use with care. You should not add/remove elements or change the name

See also

addBufferDefinition,

removeBuffer and

renameBuffer to perform these actions

getLocalTextureDefinitions()

const TextureDefinitionVec & Ogre::TextureDefinitionBase::getLocalTextureDefinitions ( void  ) const

inlineinherited

getLocalTextureDefinitionsNonConst()

TextureDefinitionVec & Ogre::TextureDefinitionBase::getLocalTextureDefinitionsNonConst ( void  )

inlineinherited

Returns the local texture definitions.

Remarks

WARNING: Use with care. You should not add/remove elements or change the name as mNameToChannelMap needs to be kept in sync.

See also

addTextureDefinition,

removeTexture and

renameTexture to perform these actions

getName()

IdString Ogre::CompositorNodeDef::getName ( void  ) const

inline

getNameStr()

String Ogre::CompositorNodeDef::getNameStr ( void  ) const

inline

getNameToChannelMap()

const NameToChannelMap & Ogre::TextureDefinitionBase::getNameToChannelMap ( void  ) const

inlineinherited

getNumInputBufferChannels()

size_t Ogre::TextureDefinitionBase::getNumInputBufferChannels ( void  ) const

inherited

getNumInputChannels()

size_t Ogre::TextureDefinitionBase::getNumInputChannels ( void  ) const

inherited

This has O(N) complexity! (not cached, we look in mNameToChannelMap)

getNumOutputChannels()

size_t Ogre::CompositorNodeDef::getNumOutputChannels ( void  ) const

inline

Returns the number of output channels.

getNumTargetPasses()

size_t Ogre::CompositorNodeDef::getNumTargetPasses ( void  ) const

inline

Gets the number of passes in this node.

getPassNumber()

size_t Ogre::CompositorNodeDef::getPassNumber

(

const CompositorPassDef *

passDef

)

const

Returns the pass # of the given pass definition in this node.

This operation is O(N). Useful for debug output.

Parameters

passDef

The pass definition to look for

Returns

Value in range [0; total_numer_of_passes_in_this_node) -1 if not found (pass doesn't belong to this node)

getStartEnabled()

bool Ogre::CompositorNodeDef::getStartEnabled ( void  ) const

inline

getTargetPass()

CompositorTargetDef * Ogre::CompositorNodeDef::getTargetPass ( size_t  passIndex )

inline

Retrieves an existing pass by it's given index.

getTextureSource() [1/2]

void Ogre::TextureDefinitionBase::getTextureSource	(	IdString	name,
		size_t &	index,
		TextureSource &	textureSource
	)		const

See http://www.research.att.com/~bs/bs_faq2.html#overloadderived.

getTextureSource() [2/2]

void Ogre::CompositorNodeDef::getTextureSource	(	size_t	outputChannel,
		size_t &	index,
		TextureSource &	textureSource
	)		const

Retrieves in which container to look for when wanting to know the output texture using the mappings from input/local texture -> output.

Parameters

outputChannel	[in] The output channel we want to know about
index	[out] The index at the container in which the texture associated with the output channel is stored
textureSource	[out] Where to get this texture from

mapOutputBufferChannel()

void Ogre::CompositorNodeDef::mapOutputBufferChannel	(	size_t	outChannel,
		IdString	bufferName
	)

Maps the output channel to the given buffer name which can be either a local buffer or a reference to an input channel.

Global buffers can't be used as output.

Remarks

Don't leave gaps. (i.e. set channel 0 & 2, without setting channel 1) It's ok to map them out of order (i.e. set channel 2, then 0, then 1) Prefer calling

See also

setNumOutputChannels beforehand Will throw if the local texture hasn't been declared yet or the input channel name hasn't been set yet (declaration order is important!).

Parameters

outChannel	Output channel # to map
textureName	Name of the buffer

mapOutputChannel()

void Ogre::CompositorNodeDef::mapOutputChannel	(	size_t	outChannel,
		IdString	textureName
	)

Maps the output channel to the given texture name, which can be either a local texture or a reference to an input channel.

Global textures can't be used as output.

Remarks

Don't leave gaps. (i.e. set channel 0 & 2, without setting channel 1) It's ok to map them out of order (i.e. set channel 2, then 0, then 1) Prefer calling

See also

setNumOutputChannels beforehand Will throw if the local texture hasn't been declared yet or the input channel name hasn't been set yet (declaration order is important!).

Parameters

outChannel	Output channel # to map
textureName	Name of the texture, which can be to a local texture, or an input channel's name. Global textures aren't supported.

operator delete() [1/3]

template<class Alloc >

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

inlineinherited

operator delete() [2/3]

template<class Alloc >

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

inlineinherited

operator delete() [3/3]

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void *  ptr, void *    )

inlineinherited

operator delete[]() [1/2]

template<class Alloc >

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

inlineinherited

operator delete[]() [2/2]

template<class Alloc >

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

inlineinherited

operator new() [1/3]

template<class Alloc >

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

inlineinherited

operator new() [2/3]

template<class Alloc >

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

inlineinherited

operator new, with debug line info

operator new() [3/3]

template<class Alloc >

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

inlineinherited

placement operator new

operator new[]() [1/2]

template<class Alloc >

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

inlineinherited

operator new[]() [2/2]

template<class Alloc >

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

inlineinherited

array operator new, with debug line info

postInitializePassDef()

virtual void Ogre::CompositorNodeDef::postInitializePassDef ( CompositorPassDef *  passDef )

inlinevirtual

Called right after we create a pass definition.

Derived classes may want to do something with it

Parameters

passDef

Newly created pass to toy with.

Reimplemented in Ogre::CompositorShadowNodeDef.

recreateResizableBuffers()

static void Ogre::TextureDefinitionBase::recreateResizableBuffers ( const BufferDefinitionVec &  bufferDefs, CompositorNamedBufferVec &  inOutBufContainer, const RenderTarget *  finalTarget, RenderSystem *  renderSys, const CompositorNodeVec &  connectedNodes, const CompositorPassVec *  passes  )

staticinherited

Destroys & recreates only the buffers that depend on the main RT (i.e.

the RenderWindow) resolution

Parameters

textureDefs	Array of texture definitions, so we know which ones depend on main RT's resolution
inOutTexContainer	Where we'll replace the RTs & textures
finalTarget	The final render target (usually the render window) we have to clone parameters from (eg. when using auto width & height, or fsaa settings)
renderSys	The RenderSystem to use
connectedNodes	Array of connected nodes that may be using our buffers and need to be notified.
passes	Array of Compositor Passes which may contain the texture being recreated When the pointer is null, we don't iterate through it.

recreateResizableTextures()

static void Ogre::TextureDefinitionBase::recreateResizableTextures ( const TextureDefinitionVec &  textureDefs, CompositorChannelVec &  inOutTexContainer, const RenderTarget *  finalTarget, RenderSystem *  renderSys, const CompositorNodeVec &  connectedNodes, const CompositorPassVec *  passes  )

staticinherited

Destroys & recreates only the textures that depend on the main RT (i.e.

the RenderWindow) resolution

Parameters

textureDefs	Array of texture definitions, so we know which ones depend on main RT's resolution
inOutTexContainer	Where we'll replace the RTs & textures
finalTarget	The final render target (usually the render window) we have to clone parameters from (eg. when using auto width & height, or fsaa settings)
renderSys	The RenderSystem to use
connectedNodes	Array of connected nodes that may be using our textures and need to be notified.
passes	Array of Compositor Passes which may contain the texture being recreated When the pointer is null, we don't iterate through it.

removeBuffer()

virtual void Ogre::TextureDefinitionBase::removeBuffer ( IdString  name )

virtualinherited

Remove a buffer. Buffer can come from an input channel, or a locally defined one.

removeTexture()

virtual void Ogre::CompositorNodeDef::removeTexture ( IdString  name )

virtual

WARNING: Be very careful with this function.

Removes a texture. If the texture is from an input channel (TEXTURE_INPUT), the input channel is removed. If the texture is a local definition (TEXTURE_LOCAL) the texture definition is removed and all the references to mLocalTextureDefs[i+1] ... mLocalTextureDefs[i+n] are updated. However, the output channels will now contain an invalid index and will only be removed if it was the last output channel (since we can't alter the order). It is your responsability to call CompositorNodeDef::mapOutputChannel again with a valid texture name to the channel it was occupying. If the texture is a global texture (TEXTURE_GLOBAL), the global texture can no longer be accessed until addTextureSourceName( name, 0, TEXTURE_GLOBAL ) is called again.

Parameters

name	Name of the texture to remove.

Reimplemented from Ogre::TextureDefinitionBase.

renameBuffer()

void Ogre::TextureDefinitionBase::renameBuffer ( IdString  oldName, const String &  newName  )

inherited

Changes the name of a buffer.

Buffer can come from an input channel, or a locally defined one.

renameTexture()

void Ogre::TextureDefinitionBase::renameTexture ( IdString  oldName, const String &  newName  )

inherited

Changes the name of a texture.

Texture can come from an input channel, be a global texture, or a locally defined one. You can't rename a global texture to avoid the "global_" prefix, or add the "global_" prefix to a texture that wasn't global.

setNumLocalBufferDefinitions()

void Ogre::TextureDefinitionBase::setNumLocalBufferDefinitions ( size_t  numTDs )

inlineinherited

Reserves enough memory for all texture definitions.

Remarks

Calling this function is not obligatory, but recommended

Parameters

numPasses

The number of texture definitions expected to contain.

setNumLocalTextureDefinitions()

void Ogre::TextureDefinitionBase::setNumLocalTextureDefinitions ( size_t  numTDs )

inlineinherited

Reserves enough memory for all texture definitions.

Remarks

Calling this function is not obligatory, but recommended

Parameters

numPasses

The number of texture definitions expected to contain.

setNumOutputBufferChannels()

void Ogre::CompositorNodeDef::setNumOutputBufferChannels ( size_t  numOuts )

inline

Reserves enough memory for all output channel mappings (efficient allocation, better than using linked lists or other containers with two level of indirections)

Remarks

Calling this function is not obligatory, but recommended

Parameters

numPasses

The number of output buffer channels expected to contain.

setNumOutputChannels()

void Ogre::CompositorNodeDef::setNumOutputChannels ( size_t  numOuts )

inline

Reserves enough memory for all output channel mappings (efficient allocation, better than using linked lists or other containers with two level of indirections)

Remarks

Calling this function is not obligatory, but recommended

Parameters

numPasses

The number of output channels expected to contain.

setNumTargetPass()

void Ogre::CompositorNodeDef::setNumTargetPass ( size_t  numPasses )

inline

Reserves enough memory for all passes.

Remarks

Calling this function is obligatory, otherwise unexpected crashes may occur. CompositorTargetDef doesn't follow the Rule of Three.

Parameters

numPasses

The number of passes expected to contain.

setStartEnabled()

void Ogre::CompositorNodeDef::setStartEnabled ( bool  enabled )

inline

Whether the node should be start as enabled when instantiated.

Friends And Related Symbol Documentation

CompositorNode

friend class CompositorNode

friend

Member Data Documentation

mCustomIdentifier

IdString Ogre::CompositorNodeDef::mCustomIdentifier

---

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

• OgreCompositorNodeDef.h