Override an existing resolution function for a given known Shader Attribute name
the name of the Attribute to override
the replacement resolution function
Override an existing resolution function for a given known Shader Uniform name, where that Uniform varies per Entity
the name of the Uniform to override
the replacement resolution function
Override an existing resolution function for a given known Shader Uniform name, where that Uniform is unassocated with any given Entity
the name of the Uniform to override
the replacement resolution function
Register a new resolution function for a given unknown Shader Attribute name
the name of the Attribute to register
the resolution function to register
Register a new resolution function for a given unknown Shader Uniform name, where that Uniform varies per Entity
the name of the Uniform to register
the resolution function to register
Register a new resolution function for a given unknown Shader Uniform name, where that Uniform is unassocated with any given Entity
the name of the Uniform to register
the resolution function to register
Resolve an Attribute value, given its name, from an Entity
the name of the attribute to resolve a value for
the Entity to retrieve the value from
the resolved Attribute value
Resolve a Uniform value, given its name, from an Entity
the name of the uniform to resolve a value for
the Entity to retrieve the value from
the resolved Uniform value
Resolve a Uniform value, given its name, from the Game
the name of the uniform to resolve a value for
the Game instance to retrieve the value from
the resolved Uniform value
Utility class for automatically retrieving attribute and uniform shader values from Entities, Components and other Game constructs
Forms a critical component of the system's rendering approach, where Entities are able to specify their own Shaders. Utilised by the EntityManager in the construction of Vertex Buffers, and by the WebGLRenderer in the upload of Uniforms
Works in conjunction with VertexShader + FragmentShader configuration objects, which specify the names, sizes, types, and variation patterns of their attributes and uniforms
Mappings of <shaderVariableName => ResolutionFunction> are broken into three categories - Attribute, EntityUniform and StaticUniform:
Attribute - attributes, varying per vertex, to be retrieved from Entities in the construction of Vertex Buffers by the EntityManager
attribute vec2 a_Position;- a vertex position, retrieved from an Entity's Model ComponentEntityUniform - uniforms, varying per Entity, to be retrieved from Entities and uploaded once per draw call by the WebGLRenderer
uniform mat3 u_Transform2D;- an Entity's Transformation Matrix, retrieved from its Transform ComponentStaticUniform - uniforms, unrelated to Entities, to be retrieved from the Game and uploaded once per render call by the WebGLRenderer
uniform mat3 u_View2D;- the 2D View Matrix, retrieved from the Game's World/CameraThe mappings built into the class represent the supported set of built-in Attribute/Uniform names which, when used in Shaders, will automatically be retrieved; thereby also setting out the relationship between a variable name and the Entity/engine data it reflects
Allows for the registration of new mappings at application initialisation, facilitating the extension of the system's built-in Shader and Component library
Allows for the overriding of built-in mappings as an explicit choice separate from registration; supporting the augmentation of default engine functionality but avoiding user error
Handles errors in the absence of Resulution Functions for given names, preventing invalid WebGL draws
EntityShaderVariableResolver
StaticShaderVariableResolver
VertexShader
FragmentShader
EntityManager
WebGLRenderer