Cogs.Core
Public Member Functions | Public Attributes | Private Member Functions | Private Attributes | List of all members
Cogs::EffectsGLES30 Struct Reference
Inheritance diagram for Cogs::EffectsGLES30:
Cogs::EffectsCommon Cogs::IEffects

Public Member Functions

void initialize (ContextGLES30 *context)
 
EffectHandle load (const ProcessedContent &vsSource, const ProcessedContent &hsSource, const ProcessedContent &dsSource, const ProcessedContent &gsSource, const ProcessedContent &psSource, const StringView &vsEntryPoint, const StringView &hsEntryPoint, const StringView &dsEntryPoint, const StringView &gsEntryPoint, const StringView &psEntryPoint, const EffectDescription &desc) override
 
void releaseEffect (EffectHandle handle)
 Release the effect with the given handle, freeing all resources generated during program loading.
 
EffectVariableHandle getEffectVariable (EffectHandle effectHandle, const StringView &name) override
 Get a handle to the variable with the given name in the effect with the given effectHandle.
 
ConstantBufferBindingHandle getConstantBufferBinding (EffectHandle effectHandle, const StringView &name) override
 Get a handle to a constant buffer binding, mapping how to bind a constant buffer to the given effect.
 
TextureBindingHandle getTextureBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot) override
 Get a handle to a texture object binding, mapping how to bind textures to the given effect.
 
SamplerStateBindingHandle getSamplerStateBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot) override
 Get a handle to a sampler state object binding, mapping how to bind the sampler state to the given effect.
 
void releaseResources ()
 Release all allocated effect resources.
 
virtual EffectHandle loadComputeEffect (const StringView &fileName, EffectFlags::EEffectFlags effectFlags) override
 Load the compute shader with the given file name and create an effect.
 
virtual EffectHandle loadComputeEffect (const StringView &fileName, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags) override
 Load the compute shader with the given file name and create an effect.
 
- Public Member Functions inherited from Cogs::EffectsCommon
EffectHandle loadEffect (const EffectDescription &description) final
 Load an effect from the given description.
 
EffectHandle loadEffectSource (const EffectDescription &description)
 
EffectHandle loadEffectContents (const EffectDescription &description, const EffectContents &contents)
 
EffectHandle loadEffect (const StringView &fileName, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load the given single file effect.
 
EffectHandle loadEffect (const StringView &fileName, const PreprocessorDefinitions &defines, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)
 
EffectHandle loadEffect (const StringView &vsFileName, const StringView &psFileName, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex and pixel shader files given.
 
EffectHandle loadEffect (const StringView &vsFileName, const StringView &psFileName, const PreprocessorDefinitions &defines, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex and pixel shader files given, applying the given preprocessor definitions to the shaders.
 
EffectHandle loadEffectSource (const StringView &vsSource, const StringView &psSource, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex and pixel shader sources given.
 
EffectHandle loadEffectSource (const StringView &vsSource, const StringView &psSource, const PreprocessorDefinitions &defines, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex and pixel shader sources given, applying the given preprocessor definitions to the shaders.
 
EffectHandle loadEffectSource (const StringView &vsSource, const StringView &gsSource, const StringView &psSource, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex, geometry, and pixel shader sources given.
 
EffectHandle loadEffectSource (const StringView &vsSource, const StringView &gsSource, const StringView &psSource, const PreprocessorDefinitions &defines, EffectFlags::EEffectFlags effectFlags=EffectFlags::None) final
 Load an effect created from the vertex, geometry, and pixel shader sources given, applying the given preprocessor definitions to the shaders.
 
EffectVariableHandle getEffectVariable (EffectHandle effectHandle, const StringView &name) override
 Get a handle to the variable with the given name in the effect with the given effectHandle.
 
ConstantBufferBindingHandle getConstantBufferBinding (EffectHandle effectHandle, const StringView &name) override
 Get a handle to a constant buffer binding, mapping how to bind a constant buffer to the given effect.
 
TextureBindingHandle getTextureBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot) override
 Get a handle to a texture object binding, mapping how to bind textures to the given effect.
 
SamplerStateBindingHandle getSamplerStateBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot) override
 Get a handle to a sampler state object binding, mapping how to bind the sampler state to the given effect.
 
BufferBindingHandle getBufferBinding (EffectHandle effectHandle, const StringView &name) override
 Get a handle to a buffer binding.
 
void releaseBufferBinding (BufferBindingHandle bufferBindingHandle) override
 Release a handle to a buffer binding.
 
void setIOHandler (IIOHandler *handler) override
 Sets an external I/O handler to use for I/O operations.
 
IIOHandlergetIOHandler () override
 Gets the external I/O handler.
 
EffectHandle load (const ProcessedContent &vsSource, const ProcessedContent &psSource, const StringView &vsEntryPoint, const StringView &psEntryPoint, const EffectDescription &desc)
 
EffectHandle load (const ProcessedContent &vsSource, const ProcessedContent &gsSource, const ProcessedContent &psSource, const StringView &vsEntryPoint, const StringView &gsEntryPoint, const StringView &psEntryPoint, const EffectDescription &desc)
 
virtual EffectHandle load (const ProcessedContent &vsSource, const ProcessedContent &hsSource, const ProcessedContent &dsSource, const ProcessedContent &gsSource, const ProcessedContent &psSource, const StringView &vsEntryPoint, const StringView &hsEntryPoint, const StringView &dsEntryPoint, const StringView &gsEntryPoint, const StringView &psEntryPoint, const EffectDescription &desc)=0
 
void initialize (struct IBuffers *buffers)
 
- Public Member Functions inherited from Cogs::IEffects
virtual EffectHandle loadEffect (const EffectDescription &description)=0
 Load an effect from the given description.
 
virtual EffectHandle loadEffect (const StringView &fileName, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load the given single file effect.
 
virtual EffectHandle loadComputeEffect (const StringView &fileName, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load the compute shader with the given file name and create an effect.
 
virtual EffectHandle loadComputeEffect (const StringView &fileName, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load the compute shader with the given file name and create an effect.
 
virtual EffectHandle loadEffect (const StringView &vsFileName, const StringView &psFileName, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex and pixel shader files given.
 
virtual EffectHandle loadEffect (const StringView &vsFileName, const StringView &psFileName, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex and pixel shader files given, applying the given preprocessor definitions to the shaders.
 
virtual EffectHandle loadEffectSource (const StringView &vsSource, const StringView &psSource, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex and pixel shader sources given.
 
virtual EffectHandle loadEffectSource (const StringView &vsSource, const StringView &gsSource, const StringView &psSource, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex, geometry, and pixel shader sources given.
 
virtual EffectHandle loadEffectSource (const StringView &vsSource, const StringView &psSource, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex and pixel shader sources given, applying the given preprocessor definitions to the shaders.
 
virtual EffectHandle loadEffectSource (const StringView &vsSource, const StringView &gsSource, const StringView &psSource, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags=EffectFlags::None)=0
 Load an effect created from the vertex, geometry, and pixel shader sources given, applying the given preprocessor definitions to the shaders.
 
virtual void releaseEffect (EffectHandle effectHandle)=0
 Release the effect with the given handle, freeing all resources generated during program loading.
 
virtual EffectVariableHandle getEffectVariable (EffectHandle effectHandle, const StringView &name)=0
 Get a handle to the variable with the given name in the effect with the given effectHandle.
 
virtual ConstantBufferBindingHandle getConstantBufferBinding (EffectHandle effectHandle, const StringView &name)=0
 Get a handle to a constant buffer binding, mapping how to bind a constant buffer to the given effect.
 
virtual TextureBindingHandle getTextureBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot)=0
 Get a handle to a texture object binding, mapping how to bind textures to the given effect.
 
virtual BufferBindingHandle getBufferBinding (EffectHandle effectHandle, const StringView &name)=0
 Get a handle to a buffer binding.
 
virtual void releaseBufferBinding (BufferBindingHandle bufferBindingHandle)=0
 Release a handle to a buffer binding.
 
virtual SamplerStateBindingHandle getSamplerStateBinding (EffectHandle effectHandle, const StringView &name, const unsigned int slot)=0
 Get a handle to a sampler state object binding, mapping how to bind the sampler state to the given effect.
 
virtual void releaseResources ()=0
 Release all allocated effect resources.
 
virtual void annotate (EffectHandle handle, const StringView &name)
 Associate a name with an object for use in graphics debugging.
 
virtual void annotateVS (EffectHandle handle, const StringView &name)
 Associate a name with an object for use in graphics debugging.
 
virtual void annotateGS (EffectHandle handle, const StringView &name)
 Associate a name with an object for use in graphics debugging.
 
virtual void annotatePS (EffectHandle handle, const StringView &name)
 Associate a name with an object for use in graphics debugging.
 
virtual void annotateCS (EffectHandle handle, const StringView &name)
 Associate a name with an object for use in graphics debugging.
 
virtual void setIOHandler (IIOHandler *handler)=0
 Sets an external I/O handler to use for I/O operations.
 
virtual IIOHandlergetIOHandler ()
 Gets the external I/O handler.
 

Public Attributes

ResourceMap< EffectHandle, EffectGLES30effects
 
- Public Attributes inherited from Cogs::EffectsCommon
SafeResourceMap< EffectHandle, Effecteffects
 
ResourceMap< BufferBindingHandle, BufferBindingbufferBindings
 
IIOHandlerhandler = nullptr
 
std::unique_ptr< IIOHandlerdefaultHandler
 
struct IBuffersbuffers = nullptr
 

Private Member Functions

EffectHandle loadEffect (const char *pVertexSource, const char *pFragmentSource, const PreprocessorDefinitions &definitions, EffectFlags::EEffectFlags effectFlags)
 
GLint loadShader (GLenum shaderType, const char *pSource, PreprocessorDefinitions definitions)
 

Private Attributes

ContextGLES30context = nullptr
 

Detailed Description

Definition at line 13 of file EffectsGLES30.h.

Member Function Documentation

◆ getConstantBufferBinding()

Cogs::ConstantBufferBindingHandle Cogs::EffectsGLES30::getConstantBufferBinding ( EffectHandle  effectHandle,
const StringView name 
)
overridevirtual

Get a handle to a constant buffer binding, mapping how to bind a constant buffer to the given effect.

The binding object can then be used to effectively bind the constant buffer before drawing, and avoid having to do name based lookups at runtime.

Parameters
effectHandleValid handle to an effect.
nameName of the constant buffer as used in shaders.
Returns
Handle to the constant buffer binding, InvalidHandle if the operation failed.

Reimplemented from Cogs::EffectsCommon.

Definition at line 522 of file EffectsGLES30.cpp.

References Cogs::StringView::empty(), Cogs::hash(), and Cogs::Handle_t< ConstantBufferBindingTag >::InvalidHandle.

◆ getEffectVariable()

Cogs::EffectVariableHandle Cogs::EffectsGLES30::getEffectVariable ( EffectHandle  effectHandle,
const StringView name 
)
overridevirtual

Get a handle to the variable with the given name in the effect with the given effectHandle.

Parameters
effectHandleValid handle to an effect.
nameName of the variable get a handle to.
Returns
Handle to the effect variable, InvalidHandle if the operation failed.

Reimplemented from Cogs::EffectsCommon.

Definition at line 510 of file EffectsGLES30.cpp.

References Cogs::StringView::data(), and Cogs::Handle_t< VariableBindingTag >::NoHandle.

◆ getSamplerStateBinding()

Cogs::SamplerStateBindingHandle Cogs::EffectsGLES30::getSamplerStateBinding ( EffectHandle  effectHandle,
const StringView name,
const unsigned int  slot 
)
overridevirtual

Get a handle to a sampler state object binding, mapping how to bind the sampler state to the given effect.

The name is used to lookup a shader-defined sampler state object if supported. If named sampler states are not supported, the given slot is used to bind the sampler state.

In scenarios where no sampler state usage is defined in the shader, the sampler state object should be bound to a slot with the same number as the texture slot the sampler should be applied to.

Parameters
effectHandleValid handle to an effect.
nameName of the sampler state object as used in shaders in the effect. If not supported by the graphics device, this field is ignored.
slotSlot number to bind the sampler state object to. The slot number is by default used to apply the sampler state when sampling from textures bound with the same slot index. On supported systems this may be remapped in the shaders.
Returns
Handle to the sampler state object binding, InvalidHandle if the operation failed.s

Reimplemented from Cogs::EffectsCommon.

Definition at line 481 of file EffectsGLES30.cpp.

References Cogs::StringView::data(), Cogs::hash(), Cogs::StringView::length(), Cogs::Handle_t< SamplerStateBindingTag >::NoHandle, Cogs::StringView::size(), and Cogs::StringView::substr().

◆ getTextureBinding()

Cogs::TextureBindingHandle Cogs::EffectsGLES30::getTextureBinding ( EffectHandle  effectHandle,
const StringView name,
const unsigned int  slot 
)
overridevirtual

Get a handle to a texture object binding, mapping how to bind textures to the given effect.

The name is used to lookup how to make textures set using this binding be bound to the shader variable of the same name. The slot number is used to bind the texture if no direct slot is given by the shader.

Parameters
effectHandleValid handle to an effect.
nameName of the texture object as used in shaders in the effect.
slotSlot number to bind the texture object to. If multiple textures are bound to the same effect, the slot numbers must be unique and ranging from zero to the maximum number of texture slots for the graphics device.
Returns
Handle to the texture object binding, InvalidHandle if the operation failed.

Reimplemented from Cogs::EffectsCommon.

Definition at line 465 of file EffectsGLES30.cpp.

References Cogs::StringView::empty(), Cogs::hash(), and Cogs::Handle_t< TextureBindingTag >::NoHandle.

◆ initialize()

void Cogs::EffectsGLES30::initialize ( ContextGLES30 context)

Definition at line 504 of file EffectsGLES30.cpp.

◆ load()

EffectHandle Cogs::EffectsGLES30::load ( const ProcessedContent vsSource,
const ProcessedContent hsSource,
const ProcessedContent dsSource,
const ProcessedContent gsSource,
const ProcessedContent psSource,
const StringView vsEntryPoint,
const StringView hsEntryPoint,
const StringView dsEntryPoint,
const StringView gsEntryPoint,
const StringView psEntryPoint,
const EffectDescription desc 
)
overridevirtual

Implements Cogs::EffectsCommon.

Definition at line 543 of file EffectsGLES30.cpp.

◆ loadComputeEffect() [1/2]

EffectHandle Cogs::EffectsGLES30::loadComputeEffect ( const StringView fileName,
const PreprocessorDefinitions definitions,
EffectFlags::EEffectFlags  effectFlags 
)
overridevirtual

Load the compute shader with the given file name and create an effect.

Parameters
fileNameFile name of a compute shader.
definitionsA set of preprocessor definitions to apply to the shader source.
Returns
Handle to the loaded effect, InvalidHandle if the operation failed.

Implements Cogs::IEffects.

Definition at line 459 of file EffectsGLES30.cpp.

References Cogs::Handle_t< EffectTag >::InvalidHandle.

◆ loadComputeEffect() [2/2]

EffectHandle Cogs::EffectsGLES30::loadComputeEffect ( const StringView fileName,
EffectFlags::EEffectFlags  effectFlags 
)
overridevirtual

Load the compute shader with the given file name and create an effect.

Parameters
fileNameFile name of a compute shader.
Returns
Handle to the loaded effect, InvalidHandle if the operation failed.

Implements Cogs::IEffects.

Definition at line 453 of file EffectsGLES30.cpp.

References Cogs::Handle_t< EffectTag >::InvalidHandle.

◆ loadEffect()

EffectHandle Cogs::EffectsGLES30::loadEffect ( const char *  pVertexSource,
const char *  pFragmentSource,
const PreprocessorDefinitions definitions,
EffectFlags::EEffectFlags  effectFlags 
)
private

Definition at line 208 of file EffectsGLES30.cpp.

◆ loadShader()

GLint Cogs::EffectsGLES30::loadShader ( GLenum  shaderType,
const char *  pSource,
PreprocessorDefinitions  definitions 
)
private

Definition at line 150 of file EffectsGLES30.cpp.

◆ releaseEffect()

void Cogs::EffectsGLES30::releaseEffect ( EffectHandle  effectHandle)
virtual

Release the effect with the given handle, freeing all resources generated during program loading.

Parameters
effectHandleValid handle to a previously created effect.

Implements Cogs::IEffects.

Definition at line 124 of file EffectsGLES30.cpp.

References Cogs::Handle_t< EffectTag >::NoHandle, and Cogs::ContextGLES30::setEffect().

◆ releaseResources()

void Cogs::EffectsGLES30::releaseResources ( )
virtual

Release all allocated effect resources.

Implements Cogs::IEffects.

Definition at line 139 of file EffectsGLES30.cpp.

Member Data Documentation

◆ context

ContextGLES30* Cogs::EffectsGLES30::context = nullptr
private

Definition at line 45 of file EffectsGLES30.h.

◆ effects

ResourceMap<EffectHandle, EffectGLES30> Cogs::EffectsGLES30::effects

Definition at line 39 of file EffectsGLES30.h.


The documentation for this struct was generated from the following files: