module Utilities

Defines file formats for saving run-time data structures to file and provides helper classes to drive the run-time radiosity system.

The code for Enlighten Utilities is included in the SDK distribution so that you can:

Modify the way in which EnlightenPrecompute saves data to file.
See how to drive the radiosity run-time on different platforms and different threading models.

Functions

Name	Description

Name	Description
CopyAlbedoBufferBuffer(const Enlighten::InputWorkspace , const Enlighten::AlbedoBuffer )	Copy an InputLightingBuffer object.
CopyDynamicMaterialWorkspaceBuffer(const Enlighten::InputWorkspace , const Enlighten::DynamicMaterialWorkspace )	Copy an DynamicMaterialWorkspace object.
CopyEmissiveBuffer(const Enlighten::InputWorkspace , const Enlighten::EmissiveBuffer )	Copy an InputLightingBuffer object.
CopyIncidentLightingBuffer(const Enlighten::InputWorkspace , const Enlighten::IncidentLightingBuffer )	Copy an IncidentLightingBuffer object.
CopyInputLightingBuffer(const Enlighten::InputWorkspace , const Enlighten::InputLightingBuffer )	Copy an InputLightingBuffer object.
CopyRadCubeMapCore(const Enlighten::RadCubeMapCore , Enlighten::RadCubeMapCore )	Copies a RadCubeMapCore.
CopyRadSystemCore(const Enlighten::RadSystemCore , Enlighten::RadSystemCore )	Copies a RadSystemCore.
DeleteAlbedoBuffer(Enlighten::AlbedoBuffer *&)	Free an AlbedoBuffer object, and all the memory it owns.
DeleteClusterAlbedoWorkspaceMaterialData(Enlighten::ClusterAlbedoWorkspaceMaterialData *&)	Free an ClusterAlbedoWorkspaceMaterialData object, and all the memory (RadDataBlocks) it owns.
DeleteDynamicMaterialWorkspace(Enlighten::DynamicMaterialWorkspace *&)	Free an DynamicMaterialWorkspace object, and all the memory it owns.
DeleteEmissiveBuffer(Enlighten::EmissiveBuffer *&)	Free an EmissiveBuffer object, and all the memory it owns.
DeleteIncidentLightingBuffer(Enlighten::IncidentLightingBuffer *&)	Free an IncidentLightingBuffer object, and all the memory it owns.
DeleteInputLightingBuffer(Enlighten::InputLightingBuffer *&)	Free an InputLightingBuffer object, and all the memory it owns.
DeleteInputWorkspace(Enlighten::InputWorkspace *&)	Free an InputWorkspace object, and all the memory (RadDataBlocks) it owns.
DeletePrecomputedVisibilityData(Enlighten::PrecomputedVisibilityData *&)	Free a PrecomputedVisibilityData object, and all the memory (RadDataBlocks) it owns.
DeleteRadCubeMapCore(Enlighten::RadCubeMapCore *&)	Free a RadCubeMapCore object, and all the memory (RadDataBlocks) it owns.
DeleteRadProbeSetCore(Enlighten::RadProbeSetCore *&)	Free a RadProbeSetCore object, and all the memory (RadDataBlocks) it owns.
DeleteRadSystemCore(Enlighten::RadSystemCore *&)	Free a RadSystemCore object, and all the memory (RadDataBlocks) it owns.
DeleteTransparencyBuffer(Enlighten::TransparencyBuffer *&)	Free a TransparencyBuffer object, and all the memory it owns.
FreeDataBlockContents(RadDataBlock *)	Free a RadDataBlock object, and all the memory it owns.
GetSolverSuffix(eSolverType)	Defines a platform specific extension for some files, such as the InputWorkspace, that differ in content between platforms.
ReadAlbedoBuffer(Geo::IGeoInputStream &)	Read an AlbedoBuffer from a stream.
ReadAlbedoBufferInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadClusterAlbedoWorkspaceMaterialData(Geo::IGeoInputStream &, Geo::u32)	Read an ClusterAlbedoWorkspaceMaterialData from a stream.
ReadClusterAlbedoWorkspaceMaterialDataFromFile(const char *, Geo::u32)	Read an ClusterAlbedoWorkspaceMaterialData from file.
ReadClusterAlbedoWorkspaceMaterialDataInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadDataBlock(RadDataBlock *, Geo::IGeoInputStream &)	Read a RadDataBlock from a Geo::IGeoInputStream. Will return an object that should be released with FreeDataBlockContents().
ReadDataBlockInPlace(RadDataBlock &, char *&)	These utilities perform in-place fixup of the various enlighten data structures.
ReadDynamicMaterialWorkspace(Geo::IGeoInputStream &)	Read an DynamicMaterialWorkspace from a stream.
ReadDynamicMaterialWorkspaceInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadEmissiveBuffer(Geo::IGeoInputStream &)	Read an EmissiveBuffer from a stream.
ReadEmissiveBufferInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadIncidentLightingBuffer(Geo::IGeoInputStream &)	Read an IncidentLightingBuffer from a stream.
ReadIncidentLightingBufferInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadInputLightingBuffer(Geo::IGeoInputStream &)	Read an InputLightingBuffer from a stream.
ReadInputLightingBufferInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadInputWorkspace(Geo::IGeoInputStream &, Geo::u32)	Read an InputWorkspace from a stream.
ReadInputWorkspaceFromFile(const char *, Geo::u32)	Read an InputWorkspace from file.
ReadInputWorkspaceInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadOptionalDataBlock(RadDataBlock *, Geo::IGeoInputStream &, Geo::u32, Geo::u32)	Read or skip a RadDataBlock in a Geo::IGeoInputStream, depending on the sections requested and the id of the block.
ReadPrecomputedVisibilityData(Geo::IGeoInputStream &)	Read a PrecomputedVisibilityData struct from a stream.
ReadPrecomputedVisibilityDataFromFile(const char *)	Read a PrecomputedVisibilityData struct from a file.
ReadPrecomputedVisibilityDataInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadProbeTaskOutput(Enlighten::RadProbeTask *, Geo::IGeoInputStream &)	Read the RadProbeTask results data from a file/stream.
ReadProbeTaskOutputFromFile(Enlighten::RadProbeTask , const char )	Read the RadProbeTask results data from a file/stream.
ReadRadCubeMapCore(Geo::IGeoInputStream &)	Read a RadCubeMapCore from a stream.
ReadRadCubeMapCoreFromFile(const char *)	Read a RadCubeMapCore from file.
ReadRadCubeMapCoreInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadRadProbeSetCore(Geo::IGeoInputStream &, Geo::u32)	Read run-time probeset data from a file.
ReadRadProbeSetCoreFromFile(const char *, Geo::u32)	Read run-time probe set data from a file.
ReadRadProbeSetCoreInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadRadSystemCore(Geo::IGeoInputStream &, Geo::u32)	Read a RadSystemCore from a stream.
ReadRadSystemCoreFromFile(const char *, Geo::u32)	Read a RadSystemCore from file.
ReadRadSystemCoreInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
ReadRadTaskOutput(Geo::s32 &, Geo::s32 &, eOutputFormat &, eOutputFormatByteOrder &, void , void , void *, Geo::IGeoInputStream &)	Read the RadIrradianceTask results data from a file/stream.
ReadRadTaskOutputFromFile(Geo::s32 &, Geo::s32 &, eOutputFormat &, eOutputFormatByteOrder &, void , void , void , const char )	Read the RadIrradianceTask results data from a file.
ReadTransparencyBufferInPlace(char *, size_t)	These utilities perform in-place fixup of the various enlighten data structures.
SkipDataBlock(Geo::IGeoInputStream &)	Skip a RadDataBlock in a Geo::IGeoStream. Will advance the stream past a RadDataBlock without reading the contents.
WriteAlbedoBuffer(const Enlighten::AlbedoBuffer *, Geo::IGeoStream &)	Write an AlbedoBuffer to a stream.
WriteAlbedoBufferForInPlace(const AlbedoBuffer *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteClusterAlbedoWorkspaceMaterialData(const Enlighten::ClusterAlbedoWorkspaceMaterialData *, Geo::IGeoStream &)	Write an ClusterAlbedoWorkspaceMaterialData to a stream, ready to be loaded on the target platform.
WriteClusterAlbedoWorkspaceMaterialDataForInPlace(const ClusterAlbedoWorkspaceMaterialData *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteClusterAlbedoWorkspaceMaterialDataToFile(const Enlighten::ClusterAlbedoWorkspaceMaterialData , const char )	Write an ClusterAlbedoWorkspaceMaterialData to file, ready to be loaded on the target platform.
WriteDataBlock(const RadDataBlock &, Geo::IGeoStream &)	Write a RadDataBlock to a Geo::IGeoStream.
WriteDataBlockForInPlace(const RadDataBlock &, char *&)	These utilities perform in-place fixup of the various enlighten data structures.
WriteDynamicMaterialWorkspace(const Enlighten::DynamicMaterialWorkspace *, Geo::IGeoStream &)	Write an DynamicMaterialWorkspace to a stream.
WriteDynamicMaterialWorkspaceForInPlace(const DynamicMaterialWorkspace *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteEmissiveBuffer(const Enlighten::EmissiveBuffer *, Geo::IGeoStream &)	Write an EmissiveBuffer to a stream.
WriteEmissiveBufferForInPlace(const EmissiveBuffer *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteIncidentLightingBuffer(const Enlighten::IncidentLightingBuffer *, Geo::IGeoStream &)	Write an IncidentLightingBuffer to a stream.
WriteIncidentLightingBufferForInPlace(const IncidentLightingBuffer *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteInputLightingBuffer(const Enlighten::InputLightingBuffer *, Geo::IGeoStream &)	Write an InputLightingBuffer to a stream.
WriteInputLightingBufferForInPlace(const InputLightingBuffer *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteInputLightingBufferToFile(const Enlighten::InputLightingBuffer , const char )	Write an InputLightingBuffer to file.
WriteInputWorkspace(const Enlighten::InputWorkspace *, Geo::IGeoStream &)	Write an InputWorkspace to a stream, ready to be loaded on the target platform.
WriteInputWorkspaceForInPlace(const InputWorkspace *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteInputWorkspaceToFile(const Enlighten::InputWorkspace , const char )	Write an InputWorkspace to file, ready to be loaded on the target platform.
WritePrecomputedVisibilityData(const Enlighten::PrecomputedVisibilityData *, Geo::IGeoStream &)	Write a PrecomputedVisibilityData structure to a stream.
WritePrecomputedVisibilityDataForInPlace(const PrecomputedVisibilityData *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WritePrecomputedVisibilityDataToFile(const Enlighten::PrecomputedVisibilityData , const char )	Write a PrecomputedVisibilityData structure to a file.
WriteProbeTaskOutput(const Enlighten::RadProbeTask *, Geo::IGeoStream &)	Write the RadProbeTask results data to a file/stream.
WriteProbeTaskOutputToFile(const Enlighten::RadProbeTask , const char )	Write the RadProbeTask results data to a file/stream.
WriteRadCubeMapCore(const Enlighten::RadCubeMapCore *, Geo::IGeoStream &)	Write a RadCubeMapCore to a stream, ready to be loaded on the target platform.
WriteRadCubeMapCoreForInPlace(const RadCubeMapCore *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteRadCubeMapCoreToFile(const Enlighten::RadCubeMapCore , const char )	Write a RadCubeMapCore to file, ready to be loaded on the target platform.
WriteRadIrradianceTaskOutput(const RadIrradianceTask *, Geo::IGeoStream &)	Write the RadIrradianceTask results data to a file/stream.
WriteRadIrradianceTaskOutputToFile(const RadIrradianceTask , const char )	Write the RadIrradianceTask results data to a file/stream.
WriteRadProbeSetCore(const Enlighten::RadProbeSetCore *, Geo::IGeoStream &)	Write run-time probeset data to a stream, ready to be loaded on the target platform.
WriteRadProbeSetCoreForInPlace(const RadProbeSetCore *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteRadProbeSetCoreToFile(const Enlighten::RadProbeSetCore , const char )	Write run-time probeset data to file, ready to be loaded on the target platform.
WriteRadSystemCore(const Enlighten::RadSystemCore *, Geo::IGeoStream &)	Write a RadSystemCore to a stream, ready to be loaded on the target platform.
WriteRadSystemCoreForInPlace(const RadSystemCore *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.
WriteRadSystemCoreToFile(const Enlighten::RadSystemCore , const char )	Write a RadSystemCore to file, ready to be loaded on the target platform.
WriteTransparencyBufferForInPlace(const TransparencyBuffer *, Geo::IGeoStream &, Geo::EConvertEndianMode)	These utilities perform in-place fixup of the various enlighten data structures.

Enlighten::AlbedoBuffer *GEO_CALL Enlighten::CopyAlbedoBufferBuffer

public: Enlighten::AlbedoBuffer *GEO_CALL CopyAlbedoBufferBuffer
(
const Enlighten::InputWorkspace * inputWorkspace,
const Enlighten::AlbedoBuffer * sourceAlbedoBuffer
)

Copy an InputLightingBuffer object.

Parameters

[in]	inputWorkspace	- The Inputworkspace to use to create the input lighting buffer.
[in]	sourceAlbedoBuffer	- The AlbedoBuffer to copy from.

Enlighten::DynamicMaterialWorkspace *GEO_CALL Enlighten::CopyDynamicMaterialWorkspaceBuffer

public: Enlighten::DynamicMaterialWorkspace *GEO_CALL CopyDynamicMaterialWorkspaceBuffer
(
const Enlighten::InputWorkspace * inputWorkspace,
const Enlighten::DynamicMaterialWorkspace * materialWorkspace
)

Copy an DynamicMaterialWorkspace object.

Parameters

[in]	inputWorkspace	- The Inputworkspace to use to create the input lighting buffer.
[in]	materialWorkspace	- The DynamicMaterialWorkspace to copy from.

Enlighten::EmissiveBuffer *GEO_CALL Enlighten::CopyEmissiveBuffer

public: Enlighten::EmissiveBuffer *GEO_CALL CopyEmissiveBuffer
(
const Enlighten::InputWorkspace * inputWorkspace,
const Enlighten::EmissiveBuffer * sourceEmissiveBuffer
)

Copy an InputLightingBuffer object.

Parameters

[in]	inputWorkspace	- The InputWorkspace to use to create the input lighting buffer.
[in]	sourceEmissiveBuffer	- The EmissiveBuffer to copy from.

Enlighten::IncidentLightingBuffer *GEO_CALL Enlighten::CopyIncidentLightingBuffer

public: Enlighten::IncidentLightingBuffer *GEO_CALL CopyIncidentLightingBuffer
(
const Enlighten::InputWorkspace * inputWorkspace,
const Enlighten::IncidentLightingBuffer * sourceIncidentLightingBuffer
)

Copy an IncidentLightingBuffer object.