class Enlighten::PrecomputePipeline

└>Enlighten::PipelinePaths └>Enlighten::PipelineScene └>Enlighten::PrecomputeParameters

Exports the scene and runs the precompute process.

Member functions may assert or throw a PipelineError exception to indicate a violation of the API contract. If you handle the exception, destroy the PrecomputePipeline instance to prevent unexpected behaviour.

Functions

Name	Description
AddCubemap(const PipelineCubemap &)	Add a cubemap to the scene.
AddGeom(const PipelineGeom &)	Add the geom to the scene.
AddInstance(const PipelineRadiosityInstance &)	Add a radiosity instance to the scene.
AddInstance(const PipelineExcludedInstance &)	Add an excluded instance to the scene.
AddInstanceParameters(const PipelineInstanceParameters &)	Add a named set of instance parameters to the scene.
AddProbeRegion(const PipelineBoxSetProbeRegion &)	Add a region defined by a set of boxes to the specified probe octree.
AddProbeRegion(const PipelinePointSetProbeRegion &)	Add a region defined by a set of points to the specified probe octree.
AddProbeRegion(const PipelineVolumeProbeRegion &)	Add a probe region defined by a volume to the specified zone.
AddProbeVolume(const PipelineProbeVolume &)	Adds a probe volume to the scene.
AddRadiosityDependencies(PipelineRadiosityGroupType, Geo::GeoFileString, const Dependencies &, const Dependencies &)	Adds a dependency set.
AddRadiosityDependencies(Geo::GeoFileString, const Dependencies &)	Limit the radiosity dependencies of the specified zone to the specified set of zone dependencies.
CancelPrecompute()	Cancel the currently running precompute.
CreateAlbedoBuffer(InputWorkspace *)	Create a runtime object.
CreateDynamicMaterialWorkspace(ClusterAlbedoWorkspaceMaterialData *)	Create a runtime object.
CreateEmissiveBuffer(InputWorkspace *)	Create a runtime object.
DumpDebugScene(const Geo::GeoFileString &)	Dump the entire scene to a single text file for debug and test purposes.
GeomExists(const Geo::GeoFileString &)	Returns true if there is a geometry object associated with the specified name. O(1) complexity.
GetClusterAlbedoMaterialDataFilename(const Geo::GeoFileString &)	Returns the full path to the cluster albedo material data file for the specified system.
GetCubemapCoreFilename(const Geo::GeoFileString &)	Returns the full path to the rad cubemap core output file for the specified cubemap.
GetCubemapDependenciesFilename(const Geo::GeoFileString &)	Returns the full path to the system dependencies output file for the specified cubemap.
GetDefaultSceneName()	Returns the default name of the scene.
GetDepsFilename()	Returns the full path to the .deps file.
GetDirectionalVisibilityFilename(const Geo::GeoFileString &)	Returns the full path to the directional visibility file for the specified system.
GetExportPath()	Returns the export path that was supplied to the constructor.
GetGeneratedSystemsFilename(const Geo::GeoFileString &)	Returns the full path to the generated systems file for the specified zone.
GetInputGeometryFilename(const Geo::GeoFileString &, const Geo::GeoFileString &)	Returns the full path to the input geometry output file for a the specified geom/paramSet combination.
GetInputProbeSetFilename(const Geo::GeoFileString &)	Returns the full path to the input probeset file for the specified system.
GetInputSystemFilename(const Geo::GeoFileString &)	Returns the full path to the input system output file for the specified system.
GetInputWorkspaceFilename(const Geo::GeoFileString &)	Returns the full path to the input workspace file for the specified system.
GetInstanceNames(const Geo::GeoFileString &)	Return the names of the instances within the specified group.
GetLightsFilename()	Returns the full path to the.lights file.
GetLightTransportOutputFilename(const Geo::GeoFileString &)	Returns the full path to the light transport output file for the specified system.
GetOutputProbeOctreeFilename(const Geo::GeoFileString &)	Returns the full path to the output probe octree file for the specified input octree.
GetPackedGeometryFilename(const Geo::GeoFileString &, const Geo::GeoFileString &)	Returns the full path to the packed geometry output file for a the specified geom/paramSet combination.
GetPackedSystemFilename(const Geo::GeoFileString &)	Returns the full path to the packed system output file for the specified system.
GetParamsetFilename()	Returns the full path to the paramset file.
GetPrecomputeLogFilename()	Returns the full path to the precompute log file.
GetProbeAtlasMaximaFilename(const Geo::GeoFileString &)	Returns the full path to the probe atlas maxima file.
GetProbeDependenciesFilename(const Geo::GeoFileString &)	Returns the full path to the system dependencies output file for the specified probe-set.
GetProbeRegionFilename(const Geo::GeoFileString &)	Returns the full path to the probe region file with the specified name.
GetProbeSetCoreFilename(const Geo::GeoFileString &)	Returns the full path to the rad probe set core output file for the specified probe set.
GetRadCoreFilename(const Geo::GeoFileString &, const Geo::s32)	Returns the full path to the rad lightmap core file for the specified system and lod.
GetRadiosityNormalTextureFilename(const Geo::GeoFileString &, const Geo::s32)	Returns the full path to the radiosity normal texture file for the specified system and lod.
GetRefInputWorkspaceFilename(const Geo::GeoFileString &)	Returns the full path to the reference input workspace file for the specified system.
GetSceneFilename()	Returns the full path to the .scene file.
GetSceneName()	Returns the name of the scene.
GetSceneOutputPath()	Returns the full path to the directory containing the build results.
GetSystemDependenciesFilename(const Geo::GeoFileString &)	Returns the full path to the system dependencies output file for the specified system.
GetSystemDusterFilename(const Geo::GeoFileString &)	Returns the full path to the system duster output file for the specified system.
LoadClusterAlbedoWorkspaceMaterialData(const Geo::GeoFileString &, Geo::u32)	Load a precompute object from file.
LoadGeneratedSystems(const Geo::GeoFileString &)	Load a precompute object from file.
LoadInputProbeSet(const PrecompOctreeCode, const Geo::GeoFileString &)	Load a precompute object from file.
LoadInputProbeSet(const Geo::GeoFileString &)	Load a precompute object from file.
LoadInputWorkspace(const Geo::GeoFileString &, Geo::u32)	Load a precompute object from file.
LoadOctreeProbeSetCore(const PrecompOctreeCode, const Geo::GeoFileString &)	Load a precompute object from file.
LoadOutputProbeOctree(const Geo::GeoFileString &)	Load a precompute object from file.
LoadPackedGeometry(const Geo::GeoFileString &, const Geo::GeoFileString &)	Load a precompute object from file.
LoadPackedSystem(const Geo::GeoFileString &)	Load a precompute object from file.
LoadPrecomputedVisibilityData(const Geo::GeoFileString &)	Load a precompute object from file.
LoadProbeAtlasMaxima(const Geo::GeoFileString &)	Load a precompute object from file.
LoadRadCubeMapCore(const Geo::GeoFileString &)	Load a precompute object from file.
LoadRadiosityNormalTexture(const Geo::GeoFileString &)	Load a precompute object from file.
LoadRadProbeSetCore(const Geo::GeoFileString &, Geo::u32)	Load a precompute object from file.
LoadRadSystemCore(const Geo::GeoFileString &)	Load a precompute object from file.
LoadRadSystemCoreEx(const Geo::GeoFileString &, Geo::u32)	Load a precompute object from file.
LoadSystemDuster(const Geo::GeoFileString &)	Load a precompute object from file.
MakeOctreeProbeSetName(const PrecompOctreeCode, const char *)	Returns the name of the octree probe set for the specified octree code and optional parameter set.
MakeProbeOctreeName(const char *)	Returns the name of the probe octree associated with the optional parameter set.
PipelinePaths(const Geo::GeoFileString &, const Geo::GeoFileString &)	Provide an export path to which the current process can write files.
PipelinePaths(const Geo::GeoFileString &)	Provide an export path to which the current process can write files.
PipelineScene(PipelinePaths, const PipelineGlobalParameters &)	To use this class, construct an instance of the PrecomputePipeline class.
PrecomputeParameters(PrecomputeDistribute, Geo::u32, bool, bool)	Constructor.
PrecomputePipeline(PipelinePaths, PrecomputeParameters, const PipelineGlobalParameters &, const Geo::GeoFileString &)	Constructor.
SetSceneComment(Geo::GeoFileStringView)	Add a comment to include in the scene file.
StartPrecompute(bool)	Launches the High Level Build System to run the build.
TryGetPrecomputeResult()	If the precompute is still running, return Running, else return the precompute result.
WaitForPrecompute()	Wait for the precompute to complete.
WriteScene(Geo::IGeoProgressProxy &)	Write the Enlighten scene to disk.
WriteScene(Geo::IGeoProgressProxy &)	Write the scene to the export path.

Enums

Name	Description
State	The set of states that an instance may transition between.

Typedefs

Name	Description
Geo::GeoArray< Geo::GeoFileString > Dependencies	Array of dependencies.
Geo::GeoArray< Geo::GeoFileString > InstanceNames	An array of instance names.

Variables

Name	Description
bool m_DebugTool	If true, the precompute uses the debug configuration of the build tools.
PrecomputeDistribute m_Distribute	The way the precompute process should be distributed.
bool m_DumpInputs	If true, the precompute dumps additional data for debugging and testing.
Geo::u32 m_MemoryLimit	Limit the percentage of the total system memory available to the precompute.
bool m_SampleFramework	Advanced.
State m_State	The current state of this instance.
bool m_Unattended	If true, the precompute does not wait for user input when an error occurs.
bool m_ValidateXML	If true, do xml validation.

void Enlighten::PipelineScene::AddCubemap

public: void AddCubemap
(
const PipelineCubemap & cubemap
)

Add a cubemap to the scene.

void Enlighten::PipelineScene::AddGeom

public: void AddGeom
(
const PipelineGeom & geom
)

Add the geom to the scene.

void Enlighten::PipelineScene::AddInstance

public: void AddInstance
(
const PipelineRadiosityInstance & instance
)

Add a radiosity instance to the scene.

void Enlighten::PipelineScene::AddInstance

public: void AddInstance
(
const PipelineExcludedInstance & instance
)

Add an excluded instance to the scene.

void Enlighten::PipelineScene::AddInstanceParameters

public: void AddInstanceParameters
(
const PipelineInstanceParameters & parameters
)

Add a named set of instance parameters to the scene.

void Enlighten::PipelineScene::AddProbeRegion

public: void AddProbeRegion
(
const PipelineBoxSetProbeRegion & region
)

Add a region defined by a set of boxes to the specified probe octree.

void Enlighten::PipelineScene::AddProbeRegion

public: void AddProbeRegion
(
const PipelinePointSetProbeRegion & region
)

Add a region defined by a set of points to the specified probe octree.

void Enlighten::PipelineScene::AddProbeRegion

public: void AddProbeRegion
(
const PipelineVolumeProbeRegion & region
)

Add a probe region defined by a volume to the specified zone.

void Enlighten::PipelineScene::AddProbeVolume

public: void AddProbeVolume
(
const PipelineProbeVolume & probeVolume
)

Adds a probe volume to the scene.

void Enlighten::PipelineScene::AddRadiosityDependencies

public: void AddRadiosityDependencies
(
PipelineRadiosityGroupType type,
Geo::GeoFileString groupName,
const Dependencies & dependencies,
const Dependencies & explicitDependencies
)

Adds a dependency set.

void Enlighten::PipelineScene::AddRadiosityDependencies

public: void AddRadiosityDependencies
(
Geo::GeoFileString zone,
const Dependencies & dependencies
)

Limit the radiosity dependencies of the specified zone to the specified set of zone dependencies.

void Enlighten::PrecomputePipeline::CancelPrecompute

public: void CancelPrecompute()

Cancel the currently running precompute.

static AlbedoBufferPtr Enlighten::PipelineScene::CreateAlbedoBuffer

public: AlbedoBufferPtr CreateAlbedoBuffer
(
InputWorkspace * inputWorkspace
)

Create a runtime object.

Return a unique pointer which owns the object.

static DynamicMaterialWorkspacePtr Enlighten::PipelineScene::CreateDynamicMaterialWorkspace

public: DynamicMaterialWorkspacePtr CreateDynamicMaterialWorkspace
(
ClusterAlbedoWorkspaceMaterialData * cawMaterialData
)

Create a runtime object.

Return a unique pointer which owns the object.

static EmissiveBufferPtr Enlighten::PipelineScene::CreateEmissiveBuffer

public: EmissiveBufferPtr CreateEmissiveBuffer
(
InputWorkspace * inputWorkspace
)

Create a runtime object.

Return a unique pointer which owns the object.

void Enlighten::PipelineScene::DumpDebugScene

public: void DumpDebugScene
(
const Geo::GeoFileString & filename
) const

Dump the entire scene to a single text file for debug and test purposes.

Note: For use only in Enlighten internal testing, may be removed in a future release!

bool Enlighten::PipelineScene::GeomExists

public: bool GeomExists
(
const Geo::GeoFileString & name
) const

Returns true if there is a geometry object associated with the specified name. O(1) complexity.

Geo::GeoFileString Enlighten::PipelinePaths::GetClusterAlbedoMaterialDataFilename

public: Geo::GeoFileString GetClusterAlbedoMaterialDataFilename
(
const Geo::GeoFileString & SystemName
) const

Returns the full path to the cluster albedo material data file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetCubemapCoreFilename

public: Geo::GeoFileString GetCubemapCoreFilename
(
const Geo::GeoFileString & cubemapName
) const

Returns the full path to the rad cubemap core output file for the specified cubemap.

Geo::GeoFileString Enlighten::PipelinePaths::GetCubemapDependenciesFilename

public: Geo::GeoFileString GetCubemapDependenciesFilename
(
const Geo::GeoFileString & cubemapName
) const

Returns the full path to the system dependencies output file for the specified cubemap.

static const char* Enlighten::PipelinePaths::GetDefaultSceneName

public: const char * GetDefaultSceneName()

Returns the default name of the scene.

Geo::GeoFileString Enlighten::PipelinePaths::GetDepsFilename

public: Geo::GeoFileString GetDepsFilename() const

Returns the full path to the .deps file.

Geo::GeoFileString Enlighten::PipelinePaths::GetDirectionalVisibilityFilename

public: Geo::GeoFileString GetDirectionalVisibilityFilename
(
const Geo::GeoFileString & SystemName
) const

Returns the full path to the directional visibility file for the specified system.

const Geo::GeoFileString& Enlighten::PipelinePaths::GetExportPath

public: const Geo::GeoFileString & GetExportPath() const

Returns the export path that was supplied to the constructor.

Geo::GeoFileString Enlighten::PipelinePaths::GetGeneratedSystemsFilename

public: Geo::GeoFileString GetGeneratedSystemsFilename
(
const Geo::GeoFileString & zoneName
) const

Returns the full path to the generated systems file for the specified zone.

Geo::GeoFileString Enlighten::PipelinePaths::GetInputGeometryFilename

public: Geo::GeoFileString GetInputGeometryFilename
(
const Geo::GeoFileString & geomName,
const Geo::GeoFileString & paramsetName
) const

Returns the full path to the input geometry output file for a the specified geom/paramSet combination.

Geo::GeoFileString Enlighten::PipelinePaths::GetInputProbeSetFilename

public: Geo::GeoFileString GetInputProbeSetFilename
(
const Geo::GeoFileString & name
) const

Returns the full path to the input probeset file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetInputSystemFilename

public: Geo::GeoFileString GetInputSystemFilename
(
const Geo::GeoFileString & systemName
) const

Returns the full path to the input system output file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetInputWorkspaceFilename

public: Geo::GeoFileString GetInputWorkspaceFilename
(
const Geo::GeoFileString & SystemName
) const

Returns the full path to the input workspace file for the specified system.

const InstanceNames& Enlighten::PipelineScene::GetInstanceNames

public: const InstanceNames & GetInstanceNames
(
const Geo::GeoFileString & group
) const

Return the names of the instances within the specified group.

The instances are listed in the order that they were added to the scene. Use IPrecompPackedInstance::GetInstanceId to index this array.

Geo::GeoFileString Enlighten::PipelinePaths::GetLightsFilename

public: Geo::GeoFileString GetLightsFilename() const

Returns the full path to the.lights file.

Geo::GeoFileString Enlighten::PipelinePaths::GetLightTransportOutputFilename

public: Geo::GeoFileString GetLightTransportOutputFilename
(
const Geo::GeoFileString & SystemName
) const

Returns the full path to the light transport output file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetOutputProbeOctreeFilename

public: Geo::GeoFileString GetOutputProbeOctreeFilename
(
const Geo::GeoFileString & name
) const

Returns the full path to the output probe octree file for the specified input octree.

Geo::GeoFileString Enlighten::PipelinePaths::GetPackedGeometryFilename

public: Geo::GeoFileString GetPackedGeometryFilename
(
const Geo::GeoFileString & geomName,
const Geo::GeoFileString & paramsetName
) const

Returns the full path to the packed geometry output file for a the specified geom/paramSet combination.

Geo::GeoFileString Enlighten::PipelinePaths::GetPackedSystemFilename

public: Geo::GeoFileString GetPackedSystemFilename
(
const Geo::GeoFileString & systemName
) const

Returns the full path to the packed system output file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetParamsetFilename

public: Geo::GeoFileString GetParamsetFilename() const

Returns the full path to the paramset file.

Geo::GeoFileString Enlighten::PipelinePaths::GetPrecomputeLogFilename

public: Geo::GeoFileString GetPrecomputeLogFilename() const

Returns the full path to the precompute log file.

Geo::GeoFileString Enlighten::PipelinePaths::GetProbeAtlasMaximaFilename

public: Geo::GeoFileString GetProbeAtlasMaximaFilename
(
const Geo::GeoFileString & paramsetName
) const

Returns the full path to the probe atlas maxima file.

Geo::GeoFileString Enlighten::PipelinePaths::GetProbeDependenciesFilename

public: Geo::GeoFileString GetProbeDependenciesFilename
(
const Geo::GeoFileString & probeSetName
) const

Returns the full path to the system dependencies output file for the specified probe-set.

Geo::GeoFileString Enlighten::PipelinePaths::GetProbeRegionFilename

public: Geo::GeoFileString GetProbeRegionFilename
(
const Geo::GeoFileString & name
) const

Returns the full path to the probe region file with the specified name.

Geo::GeoFileString Enlighten::PipelinePaths::GetProbeSetCoreFilename

public: Geo::GeoFileString GetProbeSetCoreFilename
(
const Geo::GeoFileString & probeSetName
) const

Returns the full path to the rad probe set core output file for the specified probe set.

Geo::GeoFileString Enlighten::PipelinePaths::GetRadCoreFilename

public: Geo::GeoFileString GetRadCoreFilename
(
const Geo::GeoFileString & SystemName,
const Geo::s32 LodIndex
) const

Returns the full path to the rad lightmap core file for the specified system and lod.

Geo::GeoFileString Enlighten::PipelinePaths::GetRadiosityNormalTextureFilename

public: Geo::GeoFileString GetRadiosityNormalTextureFilename
(
const Geo::GeoFileString & SystemName,
const Geo::s32 LodIndex
) const

Returns the full path to the radiosity normal texture file for the specified system and lod.

Geo::GeoFileString Enlighten::PipelinePaths::GetRefInputWorkspaceFilename

public: Geo::GeoFileString GetRefInputWorkspaceFilename
(
const Geo::GeoFileString & SystemName
) const

Returns the full path to the reference input workspace file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetSceneFilename

public: Geo::GeoFileString GetSceneFilename() const

Returns the full path to the .scene file.

const Geo::GeoFileString& Enlighten::PipelinePaths::GetSceneName

public: const Geo::GeoFileString & GetSceneName() const

Returns the name of the scene.

Geo::GeoFileString Enlighten::PipelinePaths::GetSceneOutputPath

public: Geo::GeoFileString GetSceneOutputPath() const

Returns the full path to the directory containing the build results.

Geo::GeoFileString Enlighten::PipelinePaths::GetSystemDependenciesFilename

public: Geo::GeoFileString GetSystemDependenciesFilename
(
const Geo::GeoFileString & systemName
) const

Returns the full path to the system dependencies output file for the specified system.

Geo::GeoFileString Enlighten::PipelinePaths::GetSystemDusterFilename

public: Geo::GeoFileString GetSystemDusterFilename
(
const Geo::GeoFileString & systemName
) const

Returns the full path to the system duster output file for the specified system.