|
virtual uint16 | getNumExtraPassTextures (const HlmsPropertyVec &properties, bool casterPass) const |
| If hlmsTypeChanged is going to be binding extra textures, override this function to tell us how many textures you will use, so that we don't use those slots.
|
|
virtual uint32 | getPassBufferSize (const CompositorShadowNode *shadowNode, bool casterPass, bool dualParaboloid, SceneManager *sceneManager) const |
| Listeners should return the extra bytes they wish to allocate for storing additional data in the pass buffer.
|
|
virtual void | hlmsTypeChanged (bool casterPass, CommandBuffer *commandBuffer, const HlmsDatablock *datablock, size_t texUnit) |
| Called when the last Renderable processed was of a different Hlms type, thus we need to rebind certain buffers (like the pass buffer).
|
|
virtual float * | preparePassBuffer (const CompositorShadowNode *shadowNode, bool casterPass, bool dualParaboloid, SceneManager *sceneManager, float *passBufferPtr) |
| Users can write to passBufferPtr.
|
|
virtual void | preparePassHash (const CompositorShadowNode *shadowNode, bool casterPass, bool dualParaboloid, SceneManager *sceneManager, Hlms *hlms) |
| Called right before creating the pass cache, to allow the listener to add/remove properties.
|
|
virtual void | propertiesMergedPreGenerationStep (Hlms *hlms, const HlmsCache &passCache, const HlmsPropertyVec &renderableCacheProperties, const PiecesMap renderableCachePieces[NumShaderTypes], const HlmsPropertyVec &properties, const QueuedRenderable &queuedRenderable) |
| Similar to HlmsListener::shaderCacheEntryCreated, but it gets called before creating any shader.
|
|
virtual void | setupRootLayout (RootLayout &rootLayout, const HlmsPropertyVec &properties) const |
| Called right before compiling.
|
|
virtual void | shaderCacheEntryCreated (const String &shaderProfile, const HlmsCache *hlmsCacheEntry, const HlmsCache &passCache, const HlmsPropertyVec &properties, const QueuedRenderable &queuedRenderable) |
| Called after the shader was created/compiled, and right before bindGpuProgramParameters (relevant information for OpenGL programs).
|
|
Listener that can be hooked to an Hlms implementation for extending it with custom code.
See "8.6.5 Customizing an existing implementation" of the 2.x manual on the different approaches to customizing Hlms implementations.
Similar to HlmsListener::shaderCacheEntryCreated, but it gets called before creating any shader.
The main difference is that there is no hlmsCacheEntry (because it hasn't been generated yet) and the properties are before they are transformed by the templates
propertiesMergedPreGenerationStep
- Parameters
-
hlms | Pointer to caller. WARNING: Note that any modified property WON'T BE CACHED. If you set a property based on external information, it will break caches. |
You can only set new properties that are derived from existing properties e.g. c = a + b, which means caching a and b will always result in c being the same value
- Parameters
-
passCache | Properties used by this pass |
renderableCacheProperties | Properties assigned to the renderable |
renderableCachePieces | Pieces that can be inserted, belonging to the renderable. The PiecesMap pointer cannot be null |
properties | Combined properties of both renderableCacheProperties & passCache.setProperties |
queuedRenderable | |
Called right before compiling.
If customizations require additional resources slots (e.g. more textures) then this function should modify the root layout accordingly
To allow caches to work, the rootLayout must only be generated from values in 'properties' (or via constant modifications) otherwise there is no guarantee a cached version can recreate the same state.
This is why the function is marked const.
- Parameters
-
rootLayout | An already-filled rootLayout derived classes can modify |
properties | The current contents of Hlms::mSetProperties |