module Albedo Handling

In order to bounce light from geometry, Enlighten needs some description of the surface colour - the "albedo" of the surface.

Enlighten will use the albedo colour to modulate the input lighting to compute the colour of the bounce light.

Classes

Name	Description
Enlighten::ClusterAlbedoWorkspaceMaterialData	Constitutes the precomputed material data for a system.
Enlighten::SurfaceColourDynamicity	A set of initialisers for the dynamicity of surface colours.
Enlighten::TextureResolutionScale	Specify the albedo/emissive texture resolution relative to the light map resolution.

Typedefs

Name	Description
Geo::GeoRGBXTextureElement CpuTextureElement	Structure defining the memory layout of CPU texture data used by Enlighten for texture albedo and emissive.
Geo::u64 SurfaceSelection	Selects a set of surfaces within a system.

Functions

Name	Description
CalcAlbedoBufferSize(const Enlighten::InputWorkspace *)	Calculate the size of the AlbedoBuffer for a system.
CalcDynamicMaterialWorkspaceSize(const ClusterAlbedoWorkspaceMaterialData *)	Calculate the size of the DynamicMaterialWorkspace.
CalcEmissiveBufferSize(const Enlighten::InputWorkspace *)	Calculate the size of the EmissiveBuffer for a system.
CalcTransparencyBufferSize(const Enlighten::InputWorkspace *)	Calculate the size of the TransparencyBuffer for a system.
CreateAlbedoBuffer(const Enlighten::InputWorkspace , void )	Create an AlbedoBuffer for a system.
CreateCompositeMaterialId(Geo::u16, Geo::u16, Geo::u32)	Determine the specific material ID for a given instance, mesh and 32-bit material ID.
CreateDynamicMaterialWorkspace(const ClusterAlbedoWorkspaceMaterialData , void )	Create a DynamicMaterialWorkspace which is used for dynamic updates of material colours at runtime.
CreateEmissiveBuffer(const Enlighten::InputWorkspace , void )	Create an EmissiveBuffer for a system.
CreateTransparencyBuffer(const Enlighten::InputWorkspace , void )	Create a TransparencyBuffer for a system.
EncodeRGBM(float *, float)	Utility function for converting floating point values to the RGBM format.
GetClusterAlbedoWorkspaceMaterialDataSize(const Enlighten::ClusterAlbedoWorkspaceMaterialData *)	Returns the size of the specified ClusterAlbedoWorkspaceMaterialData object.
GetClusterAlbedoWorkspaceMaterialIds(const Enlighten::ClusterAlbedoWorkspaceMaterialData *)	Returns a list of all material Ids referenced by this albedo workspace.
GetClusterAlbedoWorkspaceNumMaterials(const Enlighten::ClusterAlbedoWorkspaceMaterialData *)	Returns the number of material Ids referenced by this albedo workspace.
GetDebugAlbedoValue(const Geo::u32, const AlbedoBuffer *, Geo::v128 &)	Get the cluster albedo value of a debug point from an AlbedoBuffer.
GetDebugEmissiveValue(const Geo::u32, const EmissiveBuffer *, Geo::v128 &)	Get the cluster emissive value of a debug point from an EmissiveBuffer.
GetDebugTransparencyValue(const Geo::u32, const TransparencyBuffer *, float &)	Get the cluster transparency value of a debug point from an TransparencyBuffer.
GetTextureSize(const Enlighten::RadSystemCore *, const TextureResolutionScale::Value, Geo::s32 &, Geo::s32 &)	Returns the required dimensions of the albedo and emissive textures for a given radiosity core.
GetTextureSize(const TextureResolutionScale::Value, Geo::s32, Geo::s32, Geo::s32 &, Geo::s32 &)	Inline function that returns the required dimensions of the albedo and emissive textures for a given a texture width and height.
InitialiseAlbedoBufferFromColoursPerPoint(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const InputWorkspace , const Geo::v128 , const Geo::s32, AlbedoBuffer *)	Sets the albedo colours for an AlbedoBuffer based on the individual sample points.
InitialiseAlbedoBufferFromMaterialWorkspace(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , AlbedoBuffer *)	Sets the albedo colours for an AlbedoBuffer from a materialWorkspace.
InitialiseAlbedoBufferFromTexture(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Enlighten::InputTextureSamplerParameters , const TextureResolutionScale::Value, AlbedoBuffer )	Sets the albedo colours for an AlbedoBuffer from an albedo texture expected in RGBA format in gamma-2 colour space.
InitialiseEmissiveBufferFromColoursPerPoint(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const InputWorkspace , const Geo::v128 , const Geo::s32, EmissiveBuffer *)	Sets the emissive colours for an EmissiveBuffer based on the individual sample points.
InitialiseEmissiveBufferFromMaterialWorkspace(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , EmissiveBuffer *)	Sets the emissive colours for an EmissiveBuffer from a materialWorkspace.
InitialiseEmissiveBufferFromTexture(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Enlighten::InputTextureSamplerParameters , float, const TextureResolutionScale::Value, EmissiveBuffer )	Sets the emissive colours for an EmissiveBuffer from an emissive texture expected in RGBM format in linear colour space.
InitialiseEmissiveBufferFromTextureFp16(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Enlighten::InputTextureSamplerParameters , const TextureResolutionScale::Value, EmissiveBuffer )	Sets the emissive colours for an EmissiveBuffer from an emissive texture expected in FP16 format in linear colour space.
InitialiseInstanceEmissiveAsDynamic(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Geo::u16)	Initialise all the materials of an instance in the DynamicMaterialWorkspace as dynamic.
InitialiseMaterialDynamicity(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const SurfaceSelection &, SurfaceColourDynamicity)	Initialise a material component in the DynamicMaterialWorkspace as static or dynamic.
InitialiseMaterialEmissiveAsDynamic(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Geo::u64 &)	Initialise a material emissive component in the DynamicMaterialWorkspace as dynamic.
InitialiseSystemEmissiveAsDynamic(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData )	Initialise all the materials in the DynamicMaterialWorkspace as dynamic.
InitialiseTransparencyBufferFromColoursPerPoint(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const InputWorkspace , const float , const Geo::s32, TransparencyBuffer *)	Sets the transparency for a TransparencyBuffer based on the individual sample points.
InitialiseTransparencyBufferFromMaterialWorkspace(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , TransparencyBuffer *)	Sets the values for a TransparencyBuffer from a materialWorkspace.
InitialiseTransparencyBufferFromTexture(DynamicMaterialWorkspace , const Enlighten::ClusterAlbedoWorkspaceMaterialData , const Enlighten::InputTextureSamplerParameters , const Geo::s32, const Geo::s32, const TextureResolutionScale::Value, TransparencyBuffer )	Sets the values for a TransparencyBuffer from a the alpha channel in the albedo texture in RGBA format.
IsAlbedoBufferInitialiseRequired(const DynamicMaterialWorkspace *)	Determine if the buffer needs to be initialised.
IsEmissiveBufferInitialiseRequired(const DynamicMaterialWorkspace *)	Determine if the buffer needs to be initialised.