Physically based shading implementation specfically designed for OpenGL 3+, D3D11 and other RenderSystems which support uniform buffers. More...

#include <OgreHlmsPbs.h>

Inheritance diagram for Ogre::HlmsPbs:

Public Types
enum	AmbientLightMode { AmbientAuto , AmbientFixed , AmbientHemisphere , AmbientNone }

typedef std::map< IdString, DatablockEntry >	HlmsDatablockMap

typedef vector< Library >::type	LibraryVec

enum	LightGatheringMode { LightGatherForward , LightGatherForwardPlus , LightGatherDeferred , LightGatherNone }

enum	OptimizationStrategy { LowerCpuOverhead , LowerGpuOverhead }

enum	ShadowFilter { PCF_2x2 , PCF_3x3 , PCF_4x4 , ExponentialShadowMaps , NumShadowFilter }

Public Member Functions
	HlmsPbs (Archive dataFolder, ArchiveVec libraryFolders)

virtual	~HlmsPbs ()

virtual void	_changeRenderSystem (RenderSystem *newRs)

void	_clearShaderCache (void)

virtual void	_collectSamplerblocks (set< const HlmsSamplerblock * >::type &outSamplerblocks, const HlmsDatablock *datablock) const

void	_compileShaderFromPreprocessedSource (const RenderableCache &mergedCache, const String source[NumShaderTypes])

int32	_getProperty (IdString key, int32 defaultVal=0) const

virtual void	_loadJson (const rapidjson::Value &jsonValue, const HlmsJson::NamedBlocks &blocks, HlmsDatablock datablock, HlmsJsonListener listener, const String &additionalTextureExtension) const
	Loads datablock values from a JSON value.

void	_notifyManager (HlmsManager *manager)

void	_notifyShadowMappingBackFaceSetting (void)
	Internal use.

virtual void	_saveJson (const HlmsDatablock datablock, String &outString, HlmsJsonListener listener, const String &additionalTextureExtension) const

void	_setProperty (IdString key, int32 value)
	For debugging stuff. I.e. the Command line uses it for testing manually set properties.

virtual void	calculateHashFor (Renderable *renderable, uint32 &outHash, uint32 &outCasterHash)
	Called by the renderable when either it changes the material, or its properties change (e.g.

void	compileShaderCode (ShaderCodeCache &codeCache)
	Compiles input properties and adds it to the shader code cache.

HlmsDatablock *	createDatablock (IdString name, const String &refName, const HlmsMacroblock &macroblockRef, const HlmsBlendblock &blendblockRef, const HlmsParamVec &paramVec, bool visibleToManager=true, const String &filename=BLANKSTRING, const String &resourceGroup=BLANKSTRING)
	Creates a unique datablock that can be shared by multiple renderables.

void	destroyAllDatablocks (void)
	Destroys all datablocks created with @createDatablock.

void	destroyDatablock (IdString name)
	Destroys a datablocks given its name.

virtual uint32	fillBuffersFor (const HlmsCache *cache, const QueuedRenderable &queuedRenderable, bool casterPass, uint32 lastCacheHash, uint32 lastTextureHash)
	Fills the constant buffers.

virtual uint32	fillBuffersForV1 (const HlmsCache cache, const QueuedRenderable &queuedRenderable, bool casterPass, uint32 lastCacheHash, CommandBuffer commandBuffer)

virtual uint32	fillBuffersForV2 (const HlmsCache cache, const QueuedRenderable &queuedRenderable, bool casterPass, uint32 lastCacheHash, CommandBuffer commandBuffer)

virtual void	frameEnded (void)
	Called when the frame has fully ended (ALL passes have been executed to all RTTs)

AmbientLightMode	getAmbientLightMode (void) const

const TexturePtr &	getAreaLightMasks (void) const

uint16	getAreaLightsLimit (void) const

uint8	getAreaLightsRoundMultiple (void) const

HlmsDatablock *	getDatablock (IdString name) const
	Finds an existing datablock based on its name (.

const HlmsDatablockMap &	getDatablockMap (void) const
	Returns all datablocks owned by this Hlms, including the default one.

Archive *	getDataFolder (void)

bool	getDebugPssmSplits (void) const

HlmsDatablock *	getDefaultDatablock (void) const
	Datablock to use when another datablock failed or none was specified.

uint16	getEsmK (void) const

void	getFilenameAndResourceGroup (IdString name, String const outFilename, String const outResourceGroup) const
	Returns the filaname & resource group a datablock was created from, and is associated with its hashed name (this was passed as in @createDatablock).

bool	getFineLightMaskGranularity (void) const

bool	getHighQuality (void) const

HlmsManager *	getHlmsManager (void) const

IrradianceVolume *	getIrradianceVolume (void) const

HlmsListener *	getListener (void) const
	Returns the current listener.

const HlmsCache *	getMaterial (HlmsCache const *lastReturnedValue, const HlmsCache &passCache, const QueuedRenderable &queuedRenderable, bool casterPass)
	Retrieves an HlmsCache filled with the GPU programs to be used by the given renderable.

const String *	getNameStr (IdString name) const
	Returns the string name associated with its hashed name (this was passed as refName in @createDatablock).

OptimizationStrategy	getOptimizationStrategy () const

ParallaxCorrectedCubemap *	getParallaxCorrectedCubemap (void) const

const LibraryVec &	getPiecesLibrary (void) const

ArchiveVec	getPiecesLibraryAsArchiveVec (void) const

size_t	getPoolIndex (ConstBufferPoolUser *user) const
	Gets an ID corresponding to the pool this user was assigned to, unique per hash.

RenderSystem *	getRenderSystem (void) const

const ShaderCodeCacheVec &	getShaderCodeCache (void) const

const String &	getShaderProfile (void) const

ShadowFilter	getShadowFilter (void) const

bool	getShadowReceiversInPixelShader (void) const

void	getTemplateChecksum (uint64 outHash[2]) const

HlmsTypes	getType (void) const

IdString	getTypeName (void) const

const String &	getTypeNameStr (void) const

void	loadLtcMatrix (void)

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	postCommandBufferExecution (CommandBuffer *commandBuffer)
	This gets called after executing the command buffer.

virtual void	preCommandBufferExecution (CommandBuffer *commandBuffer)
	This gets called right before executing the command buffer.

virtual HlmsCache	preparePassHash (const Ogre::CompositorShadowNode shadowNode, bool casterPass, bool dualParaboloid, SceneManager sceneManager)
	Called every frame by the Render Queue to cache the properties needed by this pass.

void	releaseSlot (ConstBufferPoolUser *user)
	Releases a slot requested with requestSlot.

virtual void	reloadFrom (Archive newDataFolder, ArchiveVec libraryFolders=0)
	Destroys all the cached shaders and in the next opportunity will recreate them from the new location.

void	requestSlot (uint32 hash, ConstBufferPoolUser *user, bool wantsExtraBuffer)
	Requests a slot and fills 'user'. Automatically schedules for update.

void	saveAllTexturesFromDatablocks (const String &folderPath, set< String >::type &savedTextures, bool saveOitd, bool saveOriginal, HlmsTextureExportListener *listener)

void	scheduleForUpdate (ConstBufferPoolUser *dirtyUser)

void	setAmbientLightMode (AmbientLightMode mode)

void	setAreaLightForwardSettings (uint16 areaLightsLimit, uint8 areaLightsRoundMultiple)
	Area lights use regular Forward.

void	setAreaLightMasks (const TexturePtr &areaLightMask)

void	setDebugOutputPath (bool enableDebugOutput, bool outputProperties, const String &path=BLANKSTRING)
	Call to output the automatically generated shaders (which are usually made from templates) on the given folder for inspection, analyzing, debugging, etc.

void	setDebugPssmSplits (bool bDebug)

void	setEsmK (uint16 K)
	Sets the 'K' parameter of ESM filter.

void	setFineLightMaskGranularity (bool useFineGranularity)
	Toggles whether light masks will be obeyed per object by doing: if( movableObject->getLightMask() & light->getLightMask() ) doLighting( movableObject light ); Note this toggle only affects forward lights (i.e.

void	setHighQuality (bool highQuality)
	Sets the quality of the Hlms.

void	setIrradianceVolume (IrradianceVolume *irradianceVolume)

void	setListener (HlmsListener *listener)
	Sets a listener to extend an existing Hlms implementation's with custom code, without having to rewrite it or modify the source code directly.

virtual void	setOptimizationStrategy (OptimizationStrategy optimizationStrategy)
	Sets the optimization strategy.

void	setParallaxCorrectedCubemap (ParallaxCorrectedCubemap *pcc)

void	setShadowReceiversInPixelShader (bool bInPixelShader)
	Toggles whether light-space position is calculated in vertex or pixel shader.

void	setShadowSettings (ShadowFilter filter)

void	setTextureBufferDefaultSize (size_t defaultSize)
	Changes the default suggested size for the texture buffer.

Static Public Member Functions
static bool	findParamInVec (const HlmsParamVec &paramVec, IdString key, String &inOut)
	Finds the parameter with key 'key' in the given 'paramVec'.

static void	getDefaultPaths (String &outDataFolderPath, StringVector &outLibraryFoldersPaths)
	Fill the provided string and string vector with all the sub-folder needed to instantiate an HlmsPbs object with the default distribution of the HlmsResources.

static int32	getProperty (const HlmsPropertyVec &properties, IdString key, int32 defaultVal=0)
	Utility helper, mostly useful to HlmsListener implementations.

static void	setProperty (HlmsPropertyVec &properties, IdString key, int32 value)
	Utility helper, mostly useful to HlmsListener implementations.

Detailed Description

Physically based shading implementation specfically designed for OpenGL 3+, D3D11 and other RenderSystems which support uniform buffers.

Member Typedef Documentation

◆ HlmsDatablockMap

typedef std::map<IdString, DatablockEntry> Ogre::Hlms::HlmsDatablockMap

inherited

◆ LibraryVec

typedef vector<Library>::type Ogre::Hlms::LibraryVec

inherited

Member Enumeration Documentation

◆ AmbientLightMode

enum Ogre::HlmsPbs::AmbientLightMode

Enumerator
AmbientAuto	Use fixed-colour ambient lighting when upper hemisphere = lower hemisphere, use hemisphere lighting when they don't match. Disables ambient lighting if the colours are black.
AmbientFixed	Force fixed-colour ambient light. Only uses the upper hemisphere paramter.
AmbientHemisphere	Force hemisphere ambient light. Useful if you plan on adjusting the colours dynamically very often and this might cause swapping shaders.
AmbientNone	Disable ambient lighting.

◆ LightGatheringMode

enum Ogre::Hlms::LightGatheringMode

inherited

Enumerator
LightGatherForward
LightGatherForwardPlus
LightGatherDeferred
LightGatherNone

◆ OptimizationStrategy

enum Ogre::ConstBufferPool::OptimizationStrategy

inherited

Enumerator

LowerCpuOverhead

Optimize for low CPU overhead.

Use this on slow CPUs (i.e. older AMD CPU models) or if CPU is the bottleneck. This strategy is optimized for having a lot of different materials. Default on Desktop.

LowerGpuOverhead

Optimize for low GPU overhead.

Use this if GPU is the bottleneck. This strategy performs best when you have few materials. Do not enable this mode blindly unless you've profiled and it gives you important benefits. Default on mobile.

◆ ShadowFilter

enum Ogre::HlmsPbs::ShadowFilter

Enumerator
PCF_2x2	Standard quality. Very fast.
PCF_3x3	Good quality. Still quite fast on most modern hardware.
PCF_4x4	High quality. Very slow in old hardware (i.e. DX10 level hw and below) Use RSC_TEXTURE_GATHER to check whether it will be slow or not.
ExponentialShadowMaps	High quality. Produces soft shadows. It's much more expensive but given its blurry results, you can reduce resolution and/or use less PSSM splits which gives you very competing performance with great results. ESM stands for Exponential Shadow Maps.
NumShadowFilter

Constructor & Destructor Documentation

◆ HlmsPbs()

Ogre::HlmsPbs::HlmsPbs	(	Archive *	dataFolder,
		ArchiveVec *	libraryFolders
	)

◆ ~HlmsPbs()

virtual Ogre::HlmsPbs::~HlmsPbs ( )

virtual

Member Function Documentation

◆ _changeRenderSystem()

virtual void Ogre::HlmsPbs::_changeRenderSystem ( RenderSystem * newRs )

virtual

Reimplemented from Ogre::HlmsBufferManager.

◆ _clearShaderCache()

void Ogre::Hlms::_clearShaderCache ( void )

inherited

◆ _collectSamplerblocks()

virtual void Ogre::HlmsPbs::_collectSamplerblocks	(	set< const HlmsSamplerblock * >::type &	outSamplerblocks,
		const HlmsDatablock *	datablock
	)		const

virtual

Reimplemented from Ogre::Hlms.

◆ _compileShaderFromPreprocessedSource()

void Ogre::Hlms::_compileShaderFromPreprocessedSource	(	const RenderableCache &	mergedCache,
		const String	source[NumShaderTypes]
	)

inherited

◆ _getProperty()

int32 Ogre::Hlms::_getProperty	(	IdString	key,
		int32	defaultVal = `0`
	)		const

inlineinherited

◆ _loadJson()

virtual void Ogre::HlmsPbs::_loadJson	(	const rapidjson::Value &	jsonValue,
		const HlmsJson::NamedBlocks &	blocks,
		HlmsDatablock *	datablock,
		HlmsJsonListener *	listener,
		const String &	additionalTextureExtension
	)		const

virtual

Loads datablock values from a JSON value.

See also: HlmsJson.

Parameters

jsonValue	JSON Object containing the definition of this datablock.
blocks	All the loaded Macro-, Blend- & Samplerblocks the JSON has defined and may be referenced by the datablock declaration.
datablock	Datablock to fill the values.

Reimplemented from Ogre::Hlms.

◆ _notifyManager()

void Ogre::Hlms::_notifyManager ( HlmsManager * manager )

inlineinherited

◆ _notifyShadowMappingBackFaceSetting()

void Ogre::Hlms::_notifyShadowMappingBackFaceSetting ( void )

inherited

Internal use.

See also: HlmsManager::setShadowMappingUseBackFaces

◆ _saveJson()

virtual void Ogre::HlmsPbs::_saveJson	(	const HlmsDatablock *	datablock,
		String &	outString,
		HlmsJsonListener *	listener,
		const String &	additionalTextureExtension
	)		const

virtual

Reimplemented from Ogre::Hlms.

◆ _setProperty()

void Ogre::Hlms::_setProperty	(	IdString	key,
		int32	value
	)

inlineinherited

For debugging stuff. I.e. the Command line uses it for testing manually set properties.

◆ calculateHashFor()

virtual void Ogre::Hlms::calculateHashFor	(	Renderable *	renderable,
		uint32 &	outHash,
		uint32 &	outCasterHash
	)

virtualinherited

Called by the renderable when either it changes the material, or its properties change (e.g.

the mesh' uvs are stripped)

Parameters

renderable	The renderable the material will be used on.
movableObject	The MovableObject the material will be used on (usually the parent of renderable)

Returns: A hash. This hash references property parameters that are already cached.

Reimplemented in Ogre::HlmsUnlitMobile, and Ogre::HlmsLowLevel.

◆ compileShaderCode()

void Ogre::Hlms::compileShaderCode ( ShaderCodeCache & codeCache )

inherited

Compiles input properties and adds it to the shader code cache.

Parameters

codeCache [in/out] All variables must be filled except for ShaderCodeCache::shaders which is the output

◆ createDatablock()

HlmsDatablock * Ogre::Hlms::createDatablock	(	IdString	name,
		const String &	refName,
		const HlmsMacroblock &	macroblockRef,
		const HlmsBlendblock &	blendblockRef,
		const HlmsParamVec &	paramVec,
		bool	visibleToManager = `true`,
		const String &	filename = `BLANKSTRING`,
		const String &	resourceGroup = `BLANKSTRING`
	)

inherited

Creates a unique datablock that can be shared by multiple renderables.

Remarks: The name of the datablock must be in paramVec["name"] and must be unique Throws if a datablock with the same name paramVec["name"] already exists

Parameters

name	Name of the Datablock, must be unique within all Hlms types, not just this one. 99% you want this to be IdString( refName ); however this is not enforced.
refName	Name of the Datablock. The engine doesn't use this value at all. It is only useful for UI editors which want to enumerate all existing datablocks and display its name to the user.
macroblockRef	@See HlmsManager::getMacroblock
blendblockRef	@See HlmsManager::getBlendblock
paramVec	Key - String Value list of paramters. MUST BE SORTED.
visibleToManager	When false, HlmsManager::getDatablock won't find this datablock. True by default
filename	Filename in which it was defined, so that this information can be retrieved later by the user if needed. This is only for informational purposes.
resourceGroup	ResourceGroup. See filename param.

Returns: Pointer to created Datablock

◆ destroyAllDatablocks()

void Ogre::Hlms::destroyAllDatablocks ( void )

inherited

Destroys all datablocks created with @createDatablock.

Caller is responsible for ensuring those pointers aren't still in use (i.e. dangling pointers) The default datablock will be recreated.

◆ destroyDatablock()

void Ogre::Hlms::destroyDatablock ( IdString name )

inherited

Destroys a datablocks given its name.

Caller is responsible for ensuring those pointers aren't still in use (i.e. dangling pointers)

Remarks: Throws if no datablock with the given name exists.

◆ fillBuffersFor()

virtual uint32 Ogre::HlmsPbs::fillBuffersFor	(	const HlmsCache *	cache,
		const QueuedRenderable &	queuedRenderable,
		bool	casterPass,
		uint32	lastCacheHash,
		uint32	lastTextureHash
	)

virtual

Fills the constant buffers.

Gets executed right before drawing the mesh.

Parameters

cache	Current cache of Shaders to be used.
queuedRenderable	The Renderable-MovableObject pair about to be rendered.
casterPass	Whether this is a shadow mapping caster pass.
lastCacheHash	The hash of the cache of shaders that was the used by the previous renderable.
lastTextureHash	Last Texture Hash, used to let the Hlms know whether the textures should be changed again

Returns: New Texture hash (may be equal or different to lastTextureHash).

Implements Ogre::Hlms.

◆ fillBuffersForV1()

virtual uint32 Ogre::HlmsPbs::fillBuffersForV1	(	const HlmsCache *	cache,
		const QueuedRenderable &	queuedRenderable,
		bool	casterPass,
		uint32	lastCacheHash,
		CommandBuffer *	commandBuffer
	)

virtual

Implements Ogre::Hlms.

◆ fillBuffersForV2()

virtual uint32 Ogre::HlmsPbs::fillBuffersForV2	(	const HlmsCache *	cache,
		const QueuedRenderable &	queuedRenderable,
		bool	casterPass,
		uint32	lastCacheHash,
		CommandBuffer *	commandBuffer
	)

virtual

Implements Ogre::Hlms.

◆ findParamInVec()

static bool Ogre::Hlms::findParamInVec	(	const HlmsParamVec &	paramVec,
		IdString	key,
		String &	inOut
	)

staticinherited

Finds the parameter with key 'key' in the given 'paramVec'.

If found, outputs the value to 'inOut', otherwise leaves 'inOut' as is.

Returns: True if the key was found (inOut was modified), false otherwise

Remarks: Assumes paramVec is sorted by key.

◆ frameEnded()

virtual void Ogre::HlmsPbs::frameEnded ( void )

virtual

Called when the frame has fully ended (ALL passes have been executed to all RTTs)

Reimplemented from Ogre::HlmsBufferManager.

◆ getAmbientLightMode()

AmbientLightMode Ogre::HlmsPbs::getAmbientLightMode ( void ) const

inline

◆ getAreaLightMasks()

const TexturePtr & Ogre::HlmsPbs::getAreaLightMasks ( void ) const

inline

◆ getAreaLightsLimit()

uint16 Ogre::Hlms::getAreaLightsLimit ( void ) const

inlineinherited

◆ getAreaLightsRoundMultiple()

uint8 Ogre::Hlms::getAreaLightsRoundMultiple ( void ) const

inlineinherited

◆ getDatablock()

HlmsDatablock * Ogre::Hlms::getDatablock ( IdString name ) const

inherited

Finds an existing datablock based on its name (.

See also: createDatablock)

Returns: The datablock associated with that name. Null pointer if not found. Doesn't throw.

◆ getDatablockMap()

const HlmsDatablockMap & Ogre::Hlms::getDatablockMap ( void ) const

inlineinherited

Returns all datablocks owned by this Hlms, including the default one.

◆ getDataFolder()

Archive * Ogre::Hlms::getDataFolder ( void )

inlineinherited

◆ getDebugPssmSplits()

bool Ogre::HlmsPbs::getDebugPssmSplits ( void ) const

inline

◆ getDefaultDatablock()

HlmsDatablock * Ogre::Hlms::getDefaultDatablock ( void ) const

inherited

Datablock to use when another datablock failed or none was specified.

◆ getDefaultPaths()

static void Ogre::HlmsPbs::getDefaultPaths	(	String &	outDataFolderPath,
		StringVector &	outLibraryFoldersPaths
	)

static

Fill the provided string and string vector with all the sub-folder needed to instantiate an HlmsPbs object with the default distribution of the HlmsResources.

These paths are dependent of the current RenderSystem.

This method can only be called after a valid RenderSysttem has been chosen.

All output parameter's content will be replaced with the new set of paths.

Parameters

outDataFolderPath	Path (as a String) used for creating the "dataFolder" Archive the constructor will need
outLibraryFoldersPaths	Vector of String used for creating the ArchiveVector "libraryFolders" the constructor will need

◆ getEsmK()

uint16 Ogre::HlmsPbs::getEsmK ( void ) const

inline

◆ getFilenameAndResourceGroup()

void Ogre::Hlms::getFilenameAndResourceGroup	(	IdString	name,
		String const **	outFilename,
		String const **	outResourceGroup
	)		const

inherited

Returns the filaname & resource group a datablock was created from, and is associated with its hashed name (this was passed as in @createDatablock).

Returns null ptr if not found. Note that it may also be a valid pointer but contain an empty string. The reason this String doesn't live in HlmsDatablock is to prevent cache trashing (datablocks are hot iterated every frame, and the filename & resource groups are rarely ever used) Usage: String const *filename; String const *resourceGroup; datablock->getFilenameAndResourceGroup( &filename, &resourceGroup ); if( filename && resourceGroup && !filename->empty() && !resourceGroup->empty() ) { //Valid filename & resource group. }

◆ getFineLightMaskGranularity()

bool Ogre::HlmsPbs::getFineLightMaskGranularity ( void ) const

inline

◆ getHighQuality()

bool Ogre::Hlms::getHighQuality ( void ) const

inlineinherited

◆ getHlmsManager()

HlmsManager * Ogre::Hlms::getHlmsManager ( void ) const

inlineinherited

◆ getIrradianceVolume()

IrradianceVolume * Ogre::HlmsPbs::getIrradianceVolume ( void ) const

inline

◆ getListener()

HlmsListener * Ogre::Hlms::getListener ( void ) const

inherited

Returns the current listener.

See also: setListener();

Remarks: If the default listener is being used (that does nothing) then null is returned.

◆ getMaterial()

const HlmsCache * Ogre::Hlms::getMaterial	(	HlmsCache const *	lastReturnedValue,
		const HlmsCache &	passCache,
		const QueuedRenderable &	queuedRenderable,
		bool	casterPass
	)

inherited

Retrieves an HlmsCache filled with the GPU programs to be used by the given renderable.

If the shaders have already been created (i.e. whether for this renderable, or another one) it gets them from a cache. Otherwise we create it. It assumes that renderable->setHlms( this, parameters ) has already called.

Parameters

lastReturnedValue	The last value returned by getMaterial.
passCache	The cache returned by @preparePassHash.
renderable	The renderable the caller wants us to give the shaders.
movableObject	The MovableObject owner of the renderable (we need it to know if renderable should cast shadows)
casterPass	True if this pass is the shadow mapping caster pass, false otherwise

Returns: Structure containing all necessary shaders

◆ getNameStr()

const String * Ogre::Hlms::getNameStr ( IdString name ) const

inherited

◆ getProperty()

static int32 Ogre::Hlms::getProperty	(	const HlmsPropertyVec &	properties,
		IdString	key,
		int32	defaultVal = `0`
	)

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

◆ postCommandBufferExecution()

virtual void Ogre::HlmsPbs::postCommandBufferExecution ( CommandBuffer * commandBuffer )

virtual

This gets called after executing the command buffer.

Reimplemented from Ogre::HlmsBufferManager.

◆ preCommandBufferExecution()

virtual void Ogre::HlmsBufferManager::preCommandBufferExecution ( CommandBuffer * commandBuffer )

virtualinherited

This gets called right before executing the command buffer.

Reimplemented from Ogre::Hlms.

◆ preparePassHash()

virtual HlmsCache Ogre::HlmsPbs::preparePassHash	(	const Ogre::CompositorShadowNode *	shadowNode,
		bool	casterPass,
		bool	dualParaboloid,
		SceneManager *	sceneManager
	)

virtual

Called every frame by the Render Queue to cache the properties needed by this pass.

i.e. Number of PSSM splits, number of shadow casting lights, etc

Parameters

shadowNode The shadow node currently in effect. Can be null.

Returns: A hash and cached property parameters. Unlike @calculateHashFor, the cache must be kept by the caller and not by us (because it may change every frame and is one for the whole pass, but Mesh' properties usually stay consistent through its lifetime but may differ per mesh)

Reimplemented from Ogre::HlmsBufferManager.

◆ releaseSlot()

void Ogre::ConstBufferPool::releaseSlot ( ConstBufferPoolUser * user )

inherited

Releases a slot requested with requestSlot.

◆ reloadFrom()

virtual void Ogre::Hlms::reloadFrom	(	Archive *	newDataFolder,
		ArchiveVec *	libraryFolders = `0`
	)

virtualinherited

Destroys all the cached shaders and in the next opportunity will recreate them from the new location.

This is very useful for fast iteration and real-time editing of Hlms shader templates.

Remarks: Calling with null pointer is possible and will only invalidate existing shaders but you should provide a valid pointer before we start generating the first shader (or else crash).

: Existing datablock materials won't be reloaded from files, so their properties won't change (i.e. changed from blue to red), but the shaders will.

Parameters

libraryFolders When null pointer, the library folders paths won't be changed at all (but still will be reloaded). When non-null pointer, the library folders will be overwriten. Pass an empty container if you want to stop using libraries.

Reimplemented in Ogre::HlmsCompute.

◆ requestSlot()

void Ogre::ConstBufferPool::requestSlot	(	uint32	hash,
		ConstBufferPoolUser *	user,
		bool	wantsExtraBuffer
	)

inherited

Requests a slot and fills 'user'. Automatically schedules for update.

◆ saveAllTexturesFromDatablocks()

void Ogre::Hlms::saveAllTexturesFromDatablocks	(	const String &	folderPath,
		set< String >::type &	savedTextures,
		bool	saveOitd,
		bool	saveOriginal,
		HlmsTextureExportListener *	listener
	)

inherited

◆ scheduleForUpdate()

void Ogre::ConstBufferPool::scheduleForUpdate ( ConstBufferPoolUser * dirtyUser )

inherited

◆ setAmbientLightMode()

void Ogre::HlmsPbs::setAmbientLightMode ( AmbientLightMode mode )

◆ setAreaLightForwardSettings()

void Ogre::Hlms::setAreaLightForwardSettings	(	uint16	areaLightsLimit,
		uint8	areaLightsRoundMultiple
	)

inherited

Area lights use regular Forward.

Parameters

areaLightsLimit	Maximum number of area lights that will be considered by the shader. Default value is 1. Use 0 to disable area lights.
areaLightsRoundMultiple	To prevent frequent shader recompiles, you can round the number of area lights to the next multiple.

For example when areaLightsRoundMultiple = 1, if there are two area lights in the frustum, shader 'A' will be used. If the camera moves and now only one are light is in the frustum, shader 'B' will be used.

This maximizes GPU performance, but if the number of area lights is constantly jumping, you may see a lot of recompiles until all variations are cached, which can be very slow.

By setting for example, areaLightsRoundMultiple = 2, we will always generate shader variations that use 2 area lights, even if there's only 1 area light in the camera (if there's none, we use a different variation). The unused slot will just output black. If there's 3 area lights, the shader variation will be compiled to use 4. This sacrifices some pixel shader GPU performance, but prevents permutation explosion.

By setting areaLightsLimit = areaLightsRoundMultiple, you will minimize the number of permutations and stabilize frame rates; but average framerate may be lower if there are less area lights.

Default value is 1. This value cannot be 0. This value must be <= areaLightsLimit, unless areaLightsLimit is 0.

◆ setAreaLightMasks()

void Ogre::HlmsPbs::setAreaLightMasks ( const TexturePtr & areaLightMask )

◆ setDebugOutputPath()

void Ogre::Hlms::setDebugOutputPath	(	bool	enableDebugOutput,
		bool	outputProperties,
		const String &	path = `BLANKSTRING`
	)

inherited

Call to output the automatically generated shaders (which are usually made from templates) on the given folder for inspection, analyzing, debugging, etc.

Remarks: The shader will be dumped when it is generated, not when this function gets called. You should call this function at start up

Parameters

enableDebugOutput	Whether to enable or disable dumping the shaders into a folder
outputProperties	Whether to dump properties and pieces at the beginning of the shader file. This is very useful for determining what caused Ogre to compile a new variation. Note that this setting may not always produce valid shader code in the dumped files (but it we'll still produce valid shader code while at runtime) If you want to compile the dumped file and it is invalid, just strip this info.
path	Path location on where to dump it. Should end with slash for proper concatenation (i.e. C:/path/ instead of C:/path; or /home/user/ instead of /home/user)

◆ setDebugPssmSplits()

void Ogre::HlmsPbs::setDebugPssmSplits ( bool bDebug )

◆ setEsmK()

void Ogre::HlmsPbs::setEsmK ( uint16 K )

Sets the 'K' parameter of ESM filter.

Defaults to 600. Small values will give weak shadows, and light bleeding (specially if the caster is close to the receiver; particularly noticeable at contact points). It also gives the chance of over darkening to appear (the shadow of a small caster in front of a large caster looks darker; thus the large caster appers like if it were made of glass instead of being solid).

Large values give strong, dark shadows; but the higher the value, the more you push floating point limits. This value is related to K in MiscUtils::setGaussianLogFilterParams. You don't have to set them to the same value; but you'll notice that if you change this value here, you'll likely have to change the log filter's too.

Parameters

K	In range (0; infinite).

◆ setFineLightMaskGranularity()

void Ogre::HlmsPbs::setFineLightMaskGranularity ( bool useFineGranularity )

inline

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

Directional lights + shadow casting lights). You may want to see ForwardPlusBase::setFineLightMaskGranularity for control over Forward+ lights.

◆ setHighQuality()

void Ogre::Hlms::setHighQuality ( bool highQuality )

inherited

Sets the quality of the Hlms.

This function is most relevant for mobile and almost or completely ignored by Desktop. The default value is false.

: On mobile, high quality will use "highp" quality precision qualifier for all its variables and functions. When not in HQ, mobile users may see aliasing artifacts, gradients; but the performance impact can be quite high. Some GPU drivers might even refuse to execute the shader as they cannot handle it.

: Unless you absolutely require high quality rendering on Mobile devices and/or to get it to look as closely as possible as it looks in a Desktop device, the recommended option is to have this off.

◆ setIrradianceVolume()

void Ogre::HlmsPbs::setIrradianceVolume ( IrradianceVolume * irradianceVolume )

inline

◆ setListener()

void Ogre::Hlms::setListener ( HlmsListener * listener )

inherited

Sets a listener to extend an existing Hlms implementation's with custom code, without having to rewrite it or modify the source code directly.

Remarks: Other alternatives for extending an existing implementation is to derive from the class and override particular virtual functions. For performance reasons, listeners are never called on a per-object basis. Consult the section "Customizing an existing implementation" from the manual in the Docs/2.0 folder.

Parameters

listener Listener pointer. Use null to disable.

◆ setOptimizationStrategy()

virtual void Ogre::ConstBufferPool::setOptimizationStrategy ( OptimizationStrategy optimizationStrategy )

virtualinherited

Sets the optimization strategy.

See OptimizationStrategy.

Remarks: Changing the optimization strategy on the fly will trigger a massive shader recompilation.

: Implementations that don't support different strategies can overload this function.

Reimplemented in Ogre::HlmsUnlit.

◆ setParallaxCorrectedCubemap()

void Ogre::HlmsPbs::setParallaxCorrectedCubemap ( ParallaxCorrectedCubemap * pcc )

inline

◆ setProperty()

static void Ogre::Hlms::setProperty	(	HlmsPropertyVec &	properties,
		IdString	key,
		int32	value
	)

staticinherited

Utility helper, mostly useful to HlmsListener implementations.

◆ setShadowReceiversInPixelShader()

void Ogre::HlmsPbs::setShadowReceiversInPixelShader ( bool bInPixelShader )

Toggles whether light-space position is calculated in vertex or pixel shader.

This position is used for evaluating shadow mapping

Remarks: Set this setting to true if you need to support a very large number of shadow mapped lights (e.g. > 30) because otherwise you will hit HW limits on how much data we can send from Vertex to Pixel shader.

Performance: Whether this setting results in higher or lower performance depends on:

1. Vertex count of the scene (high vertex count benefit from bInPixelShader = true)
2. Screen resolution (large resolutions benefit from bInPixelShader = false)
3. Number of shadow mapping lights (large numbers benefit from bInPixelShader = true)

You will have to profile which setting gives you better performance, although generally speaking for low number of lights (e.g. < 5) bInPixelShader = false is more likely to win.

◆ setShadowSettings()

void Ogre::HlmsPbs::setShadowSettings ( ShadowFilter filter )

◆ setTextureBufferDefaultSize()

void Ogre::HlmsBufferManager::setTextureBufferDefaultSize ( size_t defaultSize )

inherited

Changes the default suggested size for the texture buffer.

Actual size may be lower if the GPU can't honour the request.

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

OgreHlmsPbs.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ HlmsDatablockMap

◆ LibraryVec

Member Enumeration Documentation

◆ AmbientLightMode

◆ LightGatheringMode

◆ OptimizationStrategy

◆ ShadowFilter

Constructor & Destructor Documentation

◆ HlmsPbs()

◆ ~HlmsPbs()

Member Function Documentation

◆ _changeRenderSystem()

◆ _clearShaderCache()

◆ _collectSamplerblocks()

◆ _compileShaderFromPreprocessedSource()

◆ _getProperty()

◆ _loadJson()

◆ _notifyManager()

◆ _notifyShadowMappingBackFaceSetting()

◆ _saveJson()

◆ _setProperty()

◆ calculateHashFor()

◆ compileShaderCode()

◆ createDatablock()

◆ destroyAllDatablocks()

◆ destroyDatablock()

◆ fillBuffersFor()

◆ fillBuffersForV1()

◆ fillBuffersForV2()

◆ findParamInVec()

◆ frameEnded()

◆ getAmbientLightMode()

◆ getAreaLightMasks()

◆ getAreaLightsLimit()

◆ getAreaLightsRoundMultiple()

◆ getDatablock()

◆ getDatablockMap()

◆ getDataFolder()

◆ getDebugPssmSplits()

◆ getDefaultDatablock()

◆ getDefaultPaths()

◆ getEsmK()

◆ getFilenameAndResourceGroup()

◆ getFineLightMaskGranularity()

◆ getHighQuality()

◆ getHlmsManager()

◆ getIrradianceVolume()

◆ getListener()

◆ getMaterial()

◆ getNameStr()

◆ getOptimizationStrategy()

◆ getParallaxCorrectedCubemap()

◆ getPiecesLibrary()

◆ getPiecesLibraryAsArchiveVec()

◆ getPoolIndex()

◆ getProperty()

◆ getRenderSystem()

◆ getShaderCodeCache()

◆ getShaderProfile()

◆ getShadowFilter()

◆ getShadowReceiversInPixelShader()

◆ getTemplateChecksum()

◆ getType()

◆ getTypeName()

◆ getTypeNameStr()

◆ loadLtcMatrix()

◆ operator delete() [1/3]

◆ operator delete() [2/3]

◆ operator delete() [3/3]

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

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

◆ operator new() [1/3]

◆ operator new() [2/3]

◆ operator new() [3/3]

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