Ogre::RTShader::SubRenderState Class Referenceabstract
Core » RTShader

This class is the base interface of sub part from a shader based rendering pipeline. More...

`#include <OgreShaderSubRenderState.h>`

Inheritance diagram for Ogre::RTShader::SubRenderState:
[legend]

## Public Member Functions

| SubRenderState ()
| Class default constructor. More...
virtual | ~SubRenderState ()
| Class destructor. More...
virtual void | copyFrom (const SubRenderState &rhs)=0
| Copy details from a given sub render state to this one. More...
virtual bool | createCpuSubPrograms (ProgramSet *programSet)
| Create sub programs that represents this sub render state as part of a program set. More...
SubRenderStateAccessorPtr | getAccessor ()
| Return the accessor object to this sub render state. More...
SubRenderStateAccessorPtr | getAccessor () const
| Return the accessor object to this sub render state. More...
virtual int | getExecutionOrder () const =0
| Get the execution order of this sub render state. More...
virtual const String & | getType () const =0
| Get the type of this sub render state. More...
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 More...
void * | operator new (size_t sz)
void * | operator new (size_t sz, void *ptr)
| placement operator new More...
void * | operator new[] (size_t sz, const char *file, int line, const char *func)
| array operator new, with debug line info More...
void * | operator new[] (size_t sz)
SubRenderState & | operator= (const SubRenderState &rhs)
| Operator = declaration. More...
virtual bool | preAddToRenderState (const RenderState *renderState, Pass *srcPass, Pass *dstPass)
| Called before adding this sub render state to the given render state. More...
virtual void | updateGpuProgramsParams (Renderable *rend, Pass *pass, const AutoParamDataSource *source, const LightList *pLightList)
| Update GPU programs parameters before a rendering operation occurs. More...

## Protected Member Functions

virtual bool | addFunctionInvocations (ProgramSet *programSet)
| Add function invocation that this sub render state requires. More...
virtual bool | resolveDependencies (ProgramSet *programSet)
| Resolve dependencies that this sub render state requires. More...
virtual bool | resolveParameters (ProgramSet *programSet)
| Resolve parameters that this sub render state requires. More...

## Private Attributes

SubRenderStateAccessorPtr | mOtherAccessor
SubRenderStateAccessorPtr | mThisAccessor

## Detailed Description

This class is the base interface of sub part from a shader based rendering pipeline.

All sub parts implementations should derive from it and implement the needed methods. A simple example of sub class of this interface will be the transform sub state of the fixed pipeline.

Definition at line 56 of file OgreShaderSubRenderState.h.

## Constructor & Destructor Documentation

## SubRenderState()

Ogre::RTShader::SubRenderState::SubRenderState | ( |  | ) |

Class default constructor.

## ~SubRenderState()

virtual Ogre::RTShader::SubRenderState::~SubRenderState | ( |  | ) |

virtual

Class destructor.

## Member Function Documentation

## addFunctionInvocations()

virtual bool Ogre::RTShader::SubRenderState::addFunctionInvocations | ( | ProgramSet * | programSet | ) |

protected virtual

Add function invocation that this sub render state requires.

Parameters

  programSet | container class of CPU and GPU programs that this sub state will affect on.

Remarks
  Internal method called in the context of SubRenderState::createCpuSubPrograms implementation.

## copyFrom()

virtual void Ogre::RTShader::SubRenderState::copyFrom | ( | const SubRenderState & | rhs | ) |

pure virtual

Copy details from a given sub render state to this one.

Parameters

  rhs | the source sub state to copy from.

## createCpuSubPrograms()

virtual bool Ogre::RTShader::SubRenderState::createCpuSubPrograms | ( | ProgramSet * | programSet | ) |

virtual

Create sub programs that represents this sub render state as part of a program set.

The given program set contains CPU programs that represents a vertex shader and pixel shader. One should use these program class API to create a representation of the sub state he wished to implement.

Parameters

  programSet | container class of CPU and GPU programs that this sub state will affect on.

## getAccessor() [1/2]

SubRenderStateAccessorPtr Ogre::RTShader::SubRenderState::getAccessor | ( |  | ) |

Return the accessor object to this sub render state.

See also
  SubRenderStateAccessor.

## getAccessor() [2/2]

SubRenderStateAccessorPtr Ogre::RTShader::SubRenderState::getAccessor | ( |  | ) | const

Return the accessor object to this sub render state.

See also
  SubRenderStateAccessor.

## getExecutionOrder()

virtual int Ogre::RTShader::SubRenderState::getExecutionOrder | ( |  | ) | const

pure virtual

Get the execution order of this sub render state.

Remarks
  The return value should be synchronized with the predefined values of the FFPShaderStage enum.

## getType()

virtual const String& Ogre::RTShader::SubRenderState::getType | ( |  | ) | const

pure virtual

Get the type of this sub render state.

Remarks
  The type string should be unique among all registered sub render states.

## operator delete() [1/3]

template<class Alloc >

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

inherited

Definition at line 96 of file OgreMemoryAllocatedObject.h.

## operator delete() [2/3]

template<class Alloc >

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

inherited

Definition at line 102 of file OgreMemoryAllocatedObject.h.

## operator delete() [3/3]

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.

## operator delete[]() [1/2]

template<class Alloc >

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

inherited

Definition at line 113 of file OgreMemoryAllocatedObject.h.

## operator delete[]() [2/2]

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.

## operator new() [1/3]

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.

## operator new() [2/3]

template<class Alloc >

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

inherited

Definition at line 73 of file OgreMemoryAllocatedObject.h.

## operator new() [3/3]

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.

## operator new[]() [1/2]

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.

## operator new[]() [2/2]

template<class Alloc >

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

inherited

Definition at line 91 of file OgreMemoryAllocatedObject.h.

## operator=()

SubRenderState& Ogre::RTShader::SubRenderState::operator= | ( | const SubRenderState & | rhs | ) |

Operator = declaration.

Assign the given source sub state to this sub state.

Parameters

  rhs | the source sub state to copy from.

## preAddToRenderState()

virtual bool Ogre::RTShader::SubRenderState::preAddToRenderState | ( | const RenderState * | renderState,
|  | Pass * | srcPass,
|  | Pass * | dstPass
| ) |  |

virtual

Called before adding this sub render state to the given render state.

Allows this sub render state class to configure specific parameters depending on source pass or parent render state. Return of false value will cause canceling the add operation.

Parameters

  renderState | The target render state container this sub render state is about to be added.
  srcPass | The source pass.
  dstPass | The destination pass.

Definition at line 120 of file OgreShaderSubRenderState.h.

## resolveDependencies()

virtual bool Ogre::RTShader::SubRenderState::resolveDependencies | ( | ProgramSet * | programSet | ) |

protected virtual

Resolve dependencies that this sub render state requires.

Parameters

  programSet | container class of CPU and GPU programs that this sub state will affect on.

Remarks
  Internal method called in the context of SubRenderState::createCpuSubPrograms implementation.

## resolveParameters()

virtual bool Ogre::RTShader::SubRenderState::resolveParameters | ( | ProgramSet * | programSet | ) |

protected virtual

Resolve parameters that this sub render state requires.

Parameters

  programSet | container class of CPU and GPU programs that this sub state will affect on.

Remarks
  Internal method called in the context of SubRenderState::createCpuSubPrograms implementation.

## updateGpuProgramsParams()

virtual void Ogre::RTShader::SubRenderState::updateGpuProgramsParams | ( | Renderable * | rend,
|  | Pass * | pass,
|  | const AutoParamDataSource * | source,
|  | const LightList * | pLightList
| ) |  |

virtual

Update GPU programs parameters before a rendering operation occurs.

This method is called in the context of SceneManager::renderSingle object via the RenderObjectListener interface and lets this sub render state instance opportunity to update custom GPU program parameters before the rendering action occurs.

See also
  RenderObjectListener::notifyRenderSingleObject.

Parameters

  rend | The renderable that is about to be rendered.
  pass | The pass that used for this rendering.
  source | The auto parameter source.
  pLightList | The light list used in the current rendering context.

Definition at line 111 of file OgreShaderSubRenderState.h.

## Member Data Documentation

## mOtherAccessor

SubRenderStateAccessorPtr Ogre::RTShader::SubRenderState::mOtherAccessor

private

Definition at line 158 of file OgreShaderSubRenderState.h.

## mThisAccessor

SubRenderStateAccessorPtr Ogre::RTShader::SubRenderState::mThisAccessor

mutable private

Definition at line 156 of file OgreShaderSubRenderState.h.

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

- OgreShaderSubRenderState.h

Copyright © 2012 Torus Knot Software Ltd
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.