Class representing a Compositor object. More...
#include <OgreCompositor.h>
Public Types | |
enum | LoadingState { LOADSTATE_UNLOADED, LOADSTATE_LOADING, LOADSTATE_LOADED, LOADSTATE_UNLOADING, LOADSTATE_PREPARED, LOADSTATE_PREPARING } |
Enum identifying the loading state of the resource. More... | |
typedef VectorIterator < Techniques > | TechniqueIterator |
typedef vector < CompositionTechnique * > ::type | Techniques |
Data types for internal lists. More... | |
Public Member Functions | |
Compositor (ResourceManager *creator, const String &name, ResourceHandle handle, const String &group, bool isManual=false, ManualResourceLoader *loader=0) | |
~Compositor () | |
virtual void | _dirtyState () |
Manually mark the state of this resource as having been changed. More... | |
virtual void | _fireLoadingComplete (bool wasBackgroundLoaded) |
Firing of loading complete event. More... | |
virtual void | _firePreparingComplete (bool wasBackgroundLoaded) |
Firing of preparing complete event. More... | |
virtual void | _fireUnloadingComplete (void) |
Firing of unloading complete event. More... | |
virtual void | _notifyOrigin (const String &origin) |
Notify this resource of it's origin. More... | |
virtual void | addListener (Listener *lis) |
Register a listener on this resource. More... | |
virtual void | changeGroupOwnership (const String &newGroup) |
Change the resource group ownership of a Resource. More... | |
virtual void | copyParametersTo (StringInterface *dest) const |
Method for copying this object's parameters to another object. More... | |
CompositionTechnique * | createTechnique () |
Create a new technique, and return a pointer to it. More... | |
virtual void | escalateLoading () |
Escalates the loading of a background loaded resource. More... | |
virtual ResourceManager * | getCreator (void) |
Gets the manager which created this resource. More... | |
virtual const String & | getGroup (void) const |
Gets the group which this resource is a member of. More... | |
virtual ResourceHandle | getHandle (void) const |
virtual LoadingState | getLoadingState () const |
Returns the current loading state. More... | |
virtual const String & | getName (void) const |
Gets resource name. More... | |
size_t | getNumSupportedTechniques () |
Get the number of supported techniques. More... | |
size_t | getNumTechniques () |
Get the number of techniques. More... | |
virtual const String & | getOrigin (void) const |
Get the origin of this resource, e.g. More... | |
ParamDictionary * | getParamDictionary (void) |
Retrieves the parameter dictionary for this class. More... | |
const ParamDictionary * | getParamDictionary (void) const |
virtual String | getParameter (const String &name) const |
Generic parameter retrieval method. More... | |
const ParameterList & | getParameters (void) const |
Retrieves a list of parameters valid for this object. More... | |
RenderTarget * | getRenderTarget (const String &name) |
Get the render target for a given render texture name. More... | |
virtual size_t | getSize (void) const |
Retrieves info about the size of the resource. More... | |
virtual size_t | getStateCount () const |
Returns the number of times this resource has changed state, which generally means the number of times it has been loaded. More... | |
CompositionTechnique * | getSupportedTechnique (size_t idx) |
Get a supported technique. More... | |
CompositionTechnique * | getSupportedTechnique (const String &schemeName=StringUtil::BLANK) |
Get a pointer to a supported technique for a given scheme. More... | |
TechniqueIterator | getSupportedTechniqueIterator (void) |
Gets an iterator over all the Techniques which are supported by the current card. More... | |
CompositionTechnique * | getTechnique (size_t idx) |
Get a technique. More... | |
TechniqueIterator | getTechniqueIterator (void) |
Get an iterator over the Techniques in this compositor. More... | |
TexturePtr | getTextureInstance (const String &name, size_t mrtIndex) |
Get the instance of a global texture. More... | |
const String & | getTextureInstanceName (const String &name, size_t mrtIndex) |
Get the instance name for a global texture. More... | |
virtual bool | isBackgroundLoaded (void) const |
Returns whether this Resource has been earmarked for background loading. More... | |
virtual bool | isLoaded (void) const |
Returns true if the Resource has been loaded, false otherwise. More... | |
virtual bool | isLoading () const |
Returns whether the resource is currently in the process of background loading. More... | |
virtual bool | isManuallyLoaded (void) const |
Is this resource manually loaded? More... | |
virtual bool | isPrepared (void) const |
Returns true if the Resource has been prepared, false otherwise. More... | |
virtual bool | isReloadable (void) const |
Returns true if the Resource is reloadable, false otherwise. More... | |
virtual void | load (bool backgroundThread=false) |
Loads the resource, if it is not already. 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) |
virtual void | prepare (bool backgroundThread=false) |
Prepares the resource for load, if it is not already. More... | |
virtual void | reload (void) |
Reloads the resource, if it is already loaded. More... | |
void | removeAllTechniques () |
Remove all techniques. More... | |
virtual void | removeListener (Listener *lis) |
Remove a listener on this resource. More... | |
void | removeTechnique (size_t idx) |
Remove a technique. More... | |
virtual void | setBackgroundLoaded (bool bl) |
Tells the resource whether it is background loaded or not. More... | |
virtual bool | setParameter (const String &name, const String &value) |
Generic parameter setting method. More... | |
virtual void | setParameterList (const NameValuePairList ¶mList) |
Generic multiple parameter setting method. More... | |
virtual void | touch (void) |
'Touches' the resource to indicate it has been used. More... | |
virtual void | unload (void) |
Unloads the resource; this is not permanent, the resource can be reloaded later if required. More... | |
Static Public Member Functions | |
static void | cleanupDictionary () |
Cleans up the static 'msDictionary' required to reset Ogre, otherwise the containers are left with invalid pointers, which will lead to a crash as soon as one of the ResourceManager implementers (e.g. More... | |
Protected Types | |
typedef set< Listener * >::type | ListenerList |
Protected Member Functions | |
size_t | calculateSize (void) const |
Calculate the size of a resource; this will only be called after 'load'. More... | |
void | compile () |
Check supportedness of techniques. More... | |
bool | createParamDictionary (const String &className) |
Internal method for creating a parameter dictionary for the class, if it does not already exist. More... | |
void | loadImpl (void) |
Internal implementation of the meat of the 'load' action, only called if this resource is not being loaded from a ManualResourceLoader. More... | |
virtual void | postLoadImpl (void) |
Internal hook to perform actions after the load process, but before the resource has been marked as fully loaded. More... | |
virtual void | postUnloadImpl (void) |
Internal hook to perform actions after the unload process, but before the resource has been marked as fully unloaded. More... | |
virtual void | preLoadImpl (void) |
Internal hook to perform actions before the load process, but after the resource has been marked as 'loading'. More... | |
virtual void | prepareImpl (void) |
Internal implementation of the meat of the 'prepare' action. More... | |
virtual void | preUnloadImpl (void) |
Internal hook to perform actions before the unload process. More... | |
void | unloadImpl (void) |
Internal implementation of the 'unload' action; called regardless of whether this resource is being loaded from a ManualResourceLoader. More... | |
virtual void | unprepareImpl (void) |
Internal function for undoing the 'prepare' action. More... | |
Protected Attributes | |
ResourceManager * | mCreator |
Creator. More... | |
String | mGroup |
The name of the resource group. More... | |
ResourceHandle | mHandle |
Numeric handle for more efficient look up than name. More... | |
volatile bool | mIsBackgroundLoaded |
Is this resource going to be background loaded? Only applicable for multithreaded. More... | |
bool | mIsManual |
Is this file manually loaded? More... | |
ListenerList | mListenerList |
ManualResourceLoader * | mLoader |
Optional manual loader; if provided, data is loaded from here instead of a file. More... | |
AtomicScalar< LoadingState > | mLoadingState |
Is the resource currently loaded? More... | |
String | mName |
Unique name of the resource. More... | |
String | mOrigin |
Origin of this resource (e.g. script name) - optional. More... | |
size_t | mSize |
The size of the resource in bytes. More... | |
size_t | mStateCount |
State count, the number of times this resource has changed state. More... | |
Private Types | |
typedef map< String, MultiRenderTarget * >::type | GlobalMRTMap |
Store a list of MRTs we've created. More... | |
typedef map< String, TexturePtr >::type | GlobalTextureMap |
Map from name->local texture. More... | |
Private Member Functions | |
void | createGlobalTextures () |
Create global rendertextures. More... | |
void | freeGlobalTextures () |
Destroy global rendertextures. More... | |
Private Attributes | |
bool | mCompilationRequired |
Compilation required This is set if the techniques change and the supportedness of techniques has to be re-evaluated. More... | |
GlobalMRTMap | mGlobalMRTs |
GlobalTextureMap | mGlobalTextures |
Techniques | mSupportedTechniques |
Techniques | mTechniques |
Class representing a Compositor object.
Compositors provide the means to flexibly "composite" the final rendering result from multiple scene renders and intermediate operations like rendering fullscreen quads. This makes it possible to apply postfilter effects, HDRI postprocessing, and shadow effects to a Viewport.
Definition at line 49 of file OgreCompositor.h.
|
private |
Store a list of MRTs we've created.
Definition at line 172 of file OgreCompositor.h.
|
private |
Map from name->local texture.
Definition at line 169 of file OgreCompositor.h.
|
protectedinherited |
Definition at line 165 of file OgreResource.h.
Definition at line 58 of file OgreCompositor.h.
typedef vector<CompositionTechnique *>::type Ogre::Compositor::Techniques |
Data types for internal lists.
Definition at line 57 of file OgreCompositor.h.
|
inherited |
Enum identifying the loading state of the resource.
Definition at line 126 of file OgreResource.h.
Ogre::Compositor::Compositor | ( | ResourceManager * | creator, |
const String & | name, | ||
ResourceHandle | handle, | ||
const String & | group, | ||
bool | isManual = false , |
||
ManualResourceLoader * | loader = 0 |
||
) |
Ogre::Compositor::~Compositor | ( | ) |
|
virtualinherited |
Manually mark the state of this resource as having been changed.
|
virtualinherited |
Firing of loading complete event.
wasBackgroundLoaded | Whether this was a background loaded event |
|
virtualinherited |
Firing of preparing complete event.
wasBackgroundLoaded | Whether this was a background loaded event |
|
virtualinherited |
Firing of unloading complete event.
|
inlinevirtualinherited |
Notify this resource of it's origin.
Definition at line 421 of file OgreResource.h.
|
virtualinherited |
Register a listener on this resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
protectedvirtual |
Calculate the size of a resource; this will only be called after 'load'.
Implements Ogre::Resource.
|
virtualinherited |
Change the resource group ownership of a Resource.
newGroup | Name of the new group |
|
staticinherited |
Cleans up the static 'msDictionary' required to reset Ogre, otherwise the containers are left with invalid pointers, which will lead to a crash as soon as one of the ResourceManager implementers (e.g.
MaterialManager) initializes.
|
protected |
Check supportedness of techniques.
|
inlinevirtualinherited |
Method for copying this object's parameters to another object.
dest | Pointer to object to have it's parameters set the same as this object. |
Definition at line 302 of file OgreStringInterface.h.
References Ogre::ParamDictionary::mParamDefs, and Ogre::StringInterface::setParameter().
|
private |
Create global rendertextures.
|
inlineprotectedinherited |
Internal method for creating a parameter dictionary for the class, if it does not already exist.
className | the name of the class using the dictionary |
Definition at line 185 of file OgreStringInterface.h.
References OGRE_LOCK_MUTEX.
CompositionTechnique* Ogre::Compositor::createTechnique | ( | ) |
Create a new technique, and return a pointer to it.
|
virtualinherited |
Escalates the loading of a background loaded resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
private |
Destroy global rendertextures.
|
inlinevirtualinherited |
Gets the manager which created this resource.
Definition at line 412 of file OgreResource.h.
|
inlinevirtualinherited |
Gets the group which this resource is a member of.
Definition at line 400 of file OgreResource.h.
|
inlinevirtualinherited |
Reimplemented in Ogre::SkeletonInstance.
Definition at line 318 of file OgreResource.h.
|
inlinevirtualinherited |
Returns the current loading state.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 349 of file OgreResource.h.
|
inlinevirtualinherited |
Gets resource name.
Reimplemented in Ogre::SkeletonInstance.
Definition at line 313 of file OgreResource.h.
size_t Ogre::Compositor::getNumSupportedTechniques | ( | ) |
Get the number of supported techniques.
size_t Ogre::Compositor::getNumTechniques | ( | ) |
Get the number of techniques.
|
inlinevirtualinherited |
Get the origin of this resource, e.g.
a script file name.
Definition at line 419 of file OgreResource.h.
|
inlineinherited |
Retrieves the parameter dictionary for this class.
Definition at line 218 of file OgreStringInterface.h.
|
inlineinherited |
Definition at line 223 of file OgreStringInterface.h.
|
inlinevirtualinherited |
Generic parameter retrieval method.
name | The name of the parameter to get |
Definition at line 271 of file OgreStringInterface.h.
References Ogre::ParamCommand::doGet(), and Ogre::ParamDictionary::getParamCommand().
|
inherited |
Retrieves a list of parameters valid for this object.
RenderTarget* Ogre::Compositor::getRenderTarget | ( | const String & | name | ) |
Get the render target for a given render texture name.
|
inlinevirtualinherited |
Retrieves info about the size of the resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 302 of file OgreResource.h.
|
inlinevirtualinherited |
Returns the number of times this resource has changed state, which generally means the number of times it has been loaded.
Objects that build derived data based on the resource can check this value against a copy they kept last time they built this derived data, in order to know whether it needs rebuilding. This is a nice way of monitoring changes without having a tightly-bound callback.
Definition at line 430 of file OgreResource.h.
CompositionTechnique* Ogre::Compositor::getSupportedTechnique | ( | size_t | idx | ) |
Get a supported technique.
CompositionTechnique* Ogre::Compositor::getSupportedTechnique | ( | const String & | schemeName = StringUtil::BLANK | ) |
Get a pointer to a supported technique for a given scheme.
schemeName | The scheme name you are looking for. Blank means to look for techniques with no scheme associated |
TechniqueIterator Ogre::Compositor::getSupportedTechniqueIterator | ( | void | ) |
Gets an iterator over all the Techniques which are supported by the current card.
CompositionTechnique* Ogre::Compositor::getTechnique | ( | size_t | idx | ) |
Get a technique.
TechniqueIterator Ogre::Compositor::getTechniqueIterator | ( | void | ) |
Get an iterator over the Techniques in this compositor.
TexturePtr Ogre::Compositor::getTextureInstance | ( | const String & | name, |
size_t | mrtIndex | ||
) |
Get the instance of a global texture.
name | The name of the texture in the original compositor definition |
mrtIndex | If name identifies a MRT, which texture attachment to retrieve |
Get the instance name for a global texture.
name | The name of the texture in the original compositor definition |
mrtIndex | If name identifies a MRT, which texture attachment to retrieve |
|
inlinevirtualinherited |
Returns whether this Resource has been earmarked for background loading.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 366 of file OgreResource.h.
|
inlinevirtualinherited |
Returns true if the Resource has been loaded, false otherwise.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 333 of file OgreResource.h.
|
inlinevirtualinherited |
Returns whether the resource is currently in the process of background loading.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 342 of file OgreResource.h.
|
inlinevirtualinherited |
Is this resource manually loaded?
Definition at line 290 of file OgreResource.h.
|
inlinevirtualinherited |
Returns true if the Resource has been prepared, false otherwise.
Definition at line 325 of file OgreResource.h.
|
inlinevirtualinherited |
Returns true if the Resource is reloadable, false otherwise.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 283 of file OgreResource.h.
|
virtualinherited |
Loads the resource, if it is not already.
backgroundThread | Indicates whether the caller of this method is the background resource loading thread. |
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
protectedvirtual |
Internal implementation of the meat of the 'load' action, only called if this resource is not being loaded from a ManualResourceLoader.
Implements Ogre::Resource.
|
inlineinherited |
Definition at line 95 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 101 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 107 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 112 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 118 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
operator new, with debug line info
Definition at line 67 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 72 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
placement operator new
Definition at line 78 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
array operator new, with debug line info
Definition at line 85 of file OgreMemoryAllocatedObject.h.
|
inlineinherited |
Definition at line 90 of file OgreMemoryAllocatedObject.h.
|
inlineprotectedvirtualinherited |
Internal hook to perform actions after the load process, but before the resource has been marked as fully loaded.
Reimplemented in Ogre::Mesh, Ogre::D3D9Texture, and Ogre::D3D11Texture.
Definition at line 190 of file OgreResource.h.
|
inlineprotectedvirtualinherited |
Internal hook to perform actions after the unload process, but before the resource has been marked as fully unloaded.
Definition at line 200 of file OgreResource.h.
|
inlineprotectedvirtualinherited |
Internal hook to perform actions before the load process, but after the resource has been marked as 'loading'.
Definition at line 183 of file OgreResource.h.
|
virtualinherited |
Prepares the resource for load, if it is not already.
One can call prepare() before load(), but this is not required as load() will call prepare() itself, if needed. When OGRE_THREAD_SUPPORT==1 both load() and prepare() are thread-safe. When OGRE_THREAD_SUPPORT==2 however, only prepare() is thread-safe. The reason for this function is to allow a background thread to do some of the loading work, without requiring the whole render system to be thread-safe. The background thread would call prepare() while the main render loop would later call load(). So long as prepare() remains thread-safe, subclasses can arbitrarily split the work of loading a resource between load() and prepare(). It is best to try and do as much work in prepare(), however, since this will leave less work for the main render thread to do and thus increase FPS.
backgroundThread | Whether this is occurring in a background thread |
|
inlineprotectedvirtualinherited |
Internal implementation of the meat of the 'prepare' action.
Reimplemented in Ogre::Mesh, Ogre::D3D9Texture, Ogre::Material, Ogre::D3D11Texture, Ogre::PatchMesh, Ogre::GLTexture, Ogre::GLESTexture, and Ogre::GLES2Texture.
Definition at line 204 of file OgreResource.h.
|
inlineprotectedvirtualinherited |
Internal hook to perform actions before the unload process.
Definition at line 195 of file OgreResource.h.
|
virtualinherited |
Reloads the resource, if it is already loaded.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
void Ogre::Compositor::removeAllTechniques | ( | ) |
Remove all techniques.
|
virtualinherited |
Remove a listener on this resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
void Ogre::Compositor::removeTechnique | ( | size_t | idx | ) |
Remove a technique.
It will also be destroyed.
|
inlinevirtualinherited |
Tells the resource whether it is background loaded or not.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
Definition at line 376 of file OgreResource.h.
|
virtualinherited |
Generic parameter setting method.
name | The name of the parameter to set |
value | String value. Must be in the right format for the type specified in the parameter definition. See the StringConverter class for more information. |
Referenced by Ogre::StringInterface::copyParametersTo().
|
virtualinherited |
Generic multiple parameter setting method.
paramList | Name/value pair list |
|
virtualinherited |
'Touches' the resource to indicate it has been used.
Reimplemented in Ogre::Material, and Ogre::UnifiedHighLevelGpuProgram.
Referenced by Ogre::Material::touch().
|
virtualinherited |
Unloads the resource; this is not permanent, the resource can be reloaded later if required.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
protectedvirtual |
Internal implementation of the 'unload' action; called regardless of whether this resource is being loaded from a ManualResourceLoader.
Implements Ogre::Resource.
|
inlineprotectedvirtualinherited |
Internal function for undoing the 'prepare' action.
Called when the load is completed, and when resources are unloaded when they are prepared but not yet loaded.
Reimplemented in Ogre::Mesh, Ogre::D3D9Texture, Ogre::Material, Ogre::D3D11Texture, Ogre::GLTexture, Ogre::GLESTexture, and Ogre::GLES2Texture.
Definition at line 209 of file OgreResource.h.
|
private |
Compilation required This is set if the techniques change and the supportedness of techniques has to be re-evaluated.
Definition at line 157 of file OgreCompositor.h.
|
protectedinherited |
Creator.
Definition at line 143 of file OgreResource.h.
|
private |
Definition at line 173 of file OgreCompositor.h.
|
private |
Definition at line 170 of file OgreCompositor.h.
|
protectedinherited |
The name of the resource group.
Definition at line 147 of file OgreResource.h.
|
protectedinherited |
Numeric handle for more efficient look up than name.
Definition at line 149 of file OgreResource.h.
|
protectedinherited |
Is this resource going to be background loaded? Only applicable for multithreaded.
Definition at line 153 of file OgreResource.h.
|
protectedinherited |
Is this file manually loaded?
Definition at line 157 of file OgreResource.h.
|
protectedinherited |
Definition at line 166 of file OgreResource.h.
|
protectedinherited |
Optional manual loader; if provided, data is loaded from here instead of a file.
Definition at line 161 of file OgreResource.h.
|
protectedinherited |
Is the resource currently loaded?
Definition at line 151 of file OgreResource.h.
|
protectedinherited |
Unique name of the resource.
Definition at line 145 of file OgreResource.h.
|
protectedinherited |
Origin of this resource (e.g. script name) - optional.
Definition at line 159 of file OgreResource.h.
|
protectedinherited |
The size of the resource in bytes.
Definition at line 155 of file OgreResource.h.
|
protectedinherited |
State count, the number of times this resource has changed state.
Definition at line 163 of file OgreResource.h.
|
private |
Definition at line 152 of file OgreCompositor.h.
|
private |
Definition at line 151 of file OgreCompositor.h.