OGRE-Next  2.3
Object-Oriented Graphics Rendering Engine
Ogre::ForwardClustered Class Reference

Implementation of Clustered Forward Shading. More...

#include <OgreForwardClustered.h>

+ Inheritance diagram for Ogre::ForwardClustered:

Public Types

typedef vector< CachedGridBuffer >::type CachedGridBufferVec
 
enum  ForwardPlusMethods { MethodForward3D , MethodForwardClustered , NumForwardPlusMethods }
 

Public Member Functions

 ForwardClustered (uint32 width, uint32 height, uint32 numSlices, uint32 lightsPerCell, uint32 decalsPerCell, uint32 cubemapProbesPerCell, float minDistance, float maxDistance, SceneManager *sceneManager)
 
virtual ~ForwardClustered ()
 
void _changeRenderSystem (RenderSystem *newRs)
 
void _releaseManualHardwareResources ()
 
void collectLights (Camera *camera) override
 
void execute (size_t threadId, size_t numThreads) override
 Overload this function to perform whatever you want. More...
 
void fillConstBufferData (Viewport *viewport, bool bRequiresTextureFlipping, uint32 renderTargetHeight, IdString shaderSyntax, bool instancedStereo, float *RESTRICT_ALIAS passBufferPtr) const override
 Fills 'passBufferPtr' with the necessary data for ForwardClustered rendering. More...
 
size_t getConstBufferSize () const override
 Returns the amount of bytes that fillConstBufferData is going to fill. More...
 
bool getDebugFrustum () const
 
bool getDebugMode () const
 
bool getDecalsEnabled () const
 
uint32 getDecalsPerCell () const
 
bool getEnableVpls () const
 
bool getFadeAttenuationRange () const
 
bool getFineLightMaskGranularity () const
 
ForwardPlusMethods getForwardPlusMethod () const override
 
bool getFreezeDebugFrustum () const
 
ReadOnlyBufferPackedgetGlobalLightListBuffer (const Camera *camera) const
 Cache the return value as internally we perform an O(N) search. More...
 
TexBufferPackedgetGridBuffer (const Camera *camera) const
 Cache the return value as internally we perform an O(N) search. More...
 
uint32 getHeight () const
 
uint32 getLightsPerCell () const
 
float getMaxDistance () const
 
float getMinDistance () const
 
uint32 getNumSlices () const
 
uint32 getWidth () const
 
bool isCacheDirty (const Camera *camera) const
 
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 More...
 
void * operator new (size_t sz, void *ptr)
 placement operator new More...
 
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 More...
 
void setDebugFrustum (bool bEnableDebugFrustumWireAabb)
 
void setDebugMode (bool debugMode)
 Turns on visualization of light cell occupancy. More...
 
void setEnableVpls (bool enable)
 
void setFadeAttenuationRange (bool fade)
 Attenuates the light by the attenuation range, causing smooth endings when at the end of the light range instead of a sudden sharp termination. More...
 
void setFineLightMaskGranularity (bool useFineGranularity)
 Toggles whether light masks will be obeyed per object & per light by doing: if( movableObject->getLightMask() & light->getLightMask() ) doLighting( movableObject light ); Note this toggle only affects Forward+ lights. More...
 
void setFreezeDebugFrustum (bool freezeDebugFrustum)
 
void setHlmsPassProperties (Hlms *hlms) override
 

Static Public Attributes

static const size_t MaxCubemapProbeRq
 
static const size_t MaxDecalRq
 
static const size_t MinCubemapProbeRq
 
static const size_t MinDecalRq
 

Detailed Description

Implementation of Clustered Forward Shading.

Member Typedef Documentation

◆ CachedGridBufferVec

Member Enumeration Documentation

◆ ForwardPlusMethods

Enumerator
MethodForward3D 
MethodForwardClustered 
NumForwardPlusMethods 

Constructor & Destructor Documentation

◆ ForwardClustered()

Ogre::ForwardClustered::ForwardClustered ( uint32  width,
uint32  height,
uint32  numSlices,
uint32  lightsPerCell,
uint32  decalsPerCell,
uint32  cubemapProbesPerCell,
float  minDistance,
float  maxDistance,
SceneManager sceneManager 
)

◆ ~ForwardClustered()

virtual Ogre::ForwardClustered::~ForwardClustered ( )
virtual

Member Function Documentation

◆ _changeRenderSystem()

void Ogre::ForwardPlusBase::_changeRenderSystem ( RenderSystem newRs)
inherited

◆ _releaseManualHardwareResources()

void Ogre::ForwardPlusBase::_releaseManualHardwareResources ( )
inherited

◆ collectLights()

void Ogre::ForwardClustered::collectLights ( Camera camera)
overridevirtual

Implements Ogre::ForwardPlusBase.

◆ execute()

void Ogre::ForwardClustered::execute ( size_t  threadId,
size_t  numThreads 
)
overridevirtual

Overload this function to perform whatever you want.

It will be called from all worker threads at the same time.

Parameters
threadIdThe index of the thread it is being called from. An index is guaranteed to be in range [0; numThreads)
numThreadsNumber of total threads

Implements Ogre::UniformScalableTask.

◆ fillConstBufferData()

void Ogre::ForwardClustered::fillConstBufferData ( Viewport viewport,
bool  bRequiresTextureFlipping,
uint32  renderTargetHeight,
IdString  shaderSyntax,
bool  instancedStereo,
float *RESTRICT_ALIAS  passBufferPtr 
) const
overridevirtual

Fills 'passBufferPtr' with the necessary data for ForwardClustered rendering.

See also
getConstBufferSize
Remarks
Assumes 'passBufferPtr' is aligned to a vec4/float4 boundary.

Implements Ogre::ForwardPlusBase.

◆ getConstBufferSize()

size_t Ogre::ForwardClustered::getConstBufferSize ( ) const
overridevirtual

Returns the amount of bytes that fillConstBufferData is going to fill.

Implements Ogre::ForwardPlusBase.

◆ getDebugFrustum()

bool Ogre::ForwardClustered::getDebugFrustum ( ) const

◆ getDebugMode()

bool Ogre::ForwardPlusBase::getDebugMode ( ) const
inlineinherited

◆ getDecalsEnabled()

bool Ogre::ForwardPlusBase::getDecalsEnabled ( ) const
inlineinherited

◆ getDecalsPerCell()

uint32 Ogre::ForwardClustered::getDecalsPerCell ( ) const
inline

◆ getEnableVpls()

bool Ogre::ForwardPlusBase::getEnableVpls ( ) const
inlineinherited

◆ getFadeAttenuationRange()

bool Ogre::ForwardPlusBase::getFadeAttenuationRange ( ) const
inlineinherited

◆ getFineLightMaskGranularity()

bool Ogre::ForwardPlusBase::getFineLightMaskGranularity ( ) const
inlineinherited

◆ getForwardPlusMethod()

ForwardPlusMethods Ogre::ForwardClustered::getForwardPlusMethod ( ) const
inlineoverridevirtual

Implements Ogre::ForwardPlusBase.

◆ getFreezeDebugFrustum()

bool Ogre::ForwardClustered::getFreezeDebugFrustum ( ) const

◆ getGlobalLightListBuffer()

ReadOnlyBufferPacked* Ogre::ForwardPlusBase::getGlobalLightListBuffer ( const Camera camera) const
inherited

Cache the return value as internally we perform an O(N) search.

◆ getGridBuffer()

TexBufferPacked* Ogre::ForwardPlusBase::getGridBuffer ( const Camera camera) const
inherited

Cache the return value as internally we perform an O(N) search.

◆ getHeight()

uint32 Ogre::ForwardClustered::getHeight ( ) const
inline

◆ getLightsPerCell()

uint32 Ogre::ForwardClustered::getLightsPerCell ( ) const
inline

◆ getMaxDistance()

float Ogre::ForwardClustered::getMaxDistance ( ) const
inline

◆ getMinDistance()

float Ogre::ForwardClustered::getMinDistance ( ) const
inline

◆ getNumSlices()

uint32 Ogre::ForwardClustered::getNumSlices ( ) const
inline

◆ getWidth()

uint32 Ogre::ForwardClustered::getWidth ( ) const
inline

◆ isCacheDirty()

bool Ogre::ForwardPlusBase::isCacheDirty ( const Camera camera) const
inherited

◆ 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

◆ setDebugFrustum()

void Ogre::ForwardClustered::setDebugFrustum ( bool  bEnableDebugFrustumWireAabb)

◆ setDebugMode()

void Ogre::ForwardPlusBase::setDebugMode ( bool  debugMode)
inlineinherited

Turns on visualization of light cell occupancy.

◆ setEnableVpls()

void Ogre::ForwardPlusBase::setEnableVpls ( bool  enable)
inlineinherited

◆ setFadeAttenuationRange()

void Ogre::ForwardPlusBase::setFadeAttenuationRange ( bool  fade)
inlineinherited

Attenuates the light by the attenuation range, causing smooth endings when at the end of the light range instead of a sudden sharp termination.

This isn't physically based (light's range is infinite), but looks very well, and makes more intuitive to manipulate a light by controlling its range instead of controlling its radius.

See also
Light::setAttenuationBasedOnRadius and
setAttenuation. And even when controlling the light by its radius, you don't have to worry so much about the threshold's value being accurate. It has a tendency to make lights dimmer though. That's the price to pay for this optimization and having more intuitive controls. Enabled by default.

In math: atten *= max( (attenRange - fDistance) / attenRange, 0.0f );

◆ setFineLightMaskGranularity()

void Ogre::ForwardPlusBase::setFineLightMaskGranularity ( bool  useFineGranularity)
inlineinherited

Toggles whether light masks will be obeyed per object & per light by doing: if( movableObject->getLightMask() & light->getLightMask() ) doLighting( movableObject light ); Note this toggle only affects Forward+ lights.

You may want to see HlmsPbs::setFineLightMaskGranularity for control over Forward lights. If you only need coarse granularity control over Forward+ lights, you may get higher performance via CompositorPassSceneDef::mLightVisibilityMask (light_visibility_mask keyword in scripts).

◆ setFreezeDebugFrustum()

void Ogre::ForwardClustered::setFreezeDebugFrustum ( bool  freezeDebugFrustum)

◆ setHlmsPassProperties()

void Ogre::ForwardClustered::setHlmsPassProperties ( Hlms hlms)
overridevirtual

Reimplemented from Ogre::ForwardPlusBase.

Member Data Documentation

◆ MaxCubemapProbeRq

const size_t Ogre::ForwardPlusBase::MaxCubemapProbeRq
staticinherited

◆ MaxDecalRq

const size_t Ogre::ForwardPlusBase::MaxDecalRq
staticinherited

◆ MinCubemapProbeRq

const size_t Ogre::ForwardPlusBase::MinCubemapProbeRq
staticinherited

◆ MinDecalRq

const size_t Ogre::ForwardPlusBase::MinDecalRq
staticinherited

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