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

Enums

Typedefs

Variables

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::AddProbeOctreeBoxes

public: void AddProbeOctreeBoxes
(
    Geo::GeoFileString octreeName,
    ProbeOctreeResolution resolution,
    const Geo::GeoBoundingBox * boxes,
    Geo::s32 count
)

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

void Enlighten::PipelineScene::AddProbeOctreePoints

public: void AddProbeOctreePoints
(
    Geo::GeoFileString octreeName,
    ProbeOctreeResolution resolution,
    const Geo::v128 * points,
    Geo::s32 count
)

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

void Enlighten::PipelineScene::AddProbeOctreeVolume

public: void AddProbeOctreeVolume
(
    Geo::GeoFileString octreeName,
    ProbeOctreeResolution resolution,
    const IPrecompVolumeQuery & query
)

Add a region defined by a volume 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::AddProbeRegion

public: void AddProbeRegion
(
    const PipelineBoxSetProbeRegion & region
)

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

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::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::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.

CAWMaterialDataPtr Enlighten::PipelineScene::LoadClusterAlbedoWorkspaceMaterialData

public: CAWMaterialDataPtr LoadClusterAlbedoWorkspaceMaterialData
(
    const Geo::GeoFileString & systemName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

GeneratedSystemsPtr Enlighten::PipelineScene::LoadGeneratedSystems

public: GeneratedSystemsPtr LoadGeneratedSystems
(
    const Geo::GeoFileString & zoneName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

InputProbeSetPtr Enlighten::PipelineScene::LoadInputProbeSet

public: InputProbeSetPtr LoadInputProbeSet
(
    const Geo::GeoFileString & octreeName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

InputProbeSetPtr Enlighten::PipelineScene::LoadInputProbeSet

public: InputProbeSetPtr LoadInputProbeSet
(
    const PrecompOctreeCode octreeCode
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

InputWorkspacePtr Enlighten::PipelineScene::LoadInputWorkspace

public: InputWorkspacePtr LoadInputWorkspace
(
    const Geo::GeoFileString & systemName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RadProbeSetCorePtr Enlighten::PipelineScene::LoadOctreeProbeSetCore

public: RadProbeSetCorePtr LoadOctreeProbeSetCore
(
    const Geo::GeoFileString & probeSetName,
    Geo::s32 probeSetIndex
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RadProbeSetCorePtr Enlighten::PipelineScene::LoadOctreeProbeSetCore

public: RadProbeSetCorePtr LoadOctreeProbeSetCore
(
    const PrecompOctreeCode octreeCode
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

OutputProbeOctreePtr Enlighten::PipelineScene::LoadOutputProbeOctree

public: OutputProbeOctreePtr LoadOutputProbeOctree
(
    const Geo::GeoFileString & octreeName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

PackedGeometryPtr Enlighten::PipelineScene::LoadPackedGeometry

public: PackedGeometryPtr LoadPackedGeometry
(
    const Geo::GeoFileString & geomName,
    const Geo::GeoFileString & paramSetName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

PackedSystemPtr Enlighten::PipelineScene::LoadPackedSystem

public: PackedSystemPtr LoadPackedSystem
(
    const Geo::GeoFileString & systemName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

PrecompVisDataPtr Enlighten::PipelineScene::LoadPrecomputedVisibilityData

public: PrecompVisDataPtr LoadPrecomputedVisibilityData
(
    const Geo::GeoFileString & systemName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RadCubeMapCorePtr Enlighten::PipelineScene::LoadRadCubeMapCore

public: RadCubeMapCorePtr LoadRadCubeMapCore
(
    const Geo::GeoFileString & cubeMapName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RGBXTexturePtr Enlighten::PipelineScene::LoadRadiosityNormalTexture

public: RGBXTexturePtr LoadRadiosityNormalTexture
(
    const Geo::GeoFileString & systemName,
    Geo::s32 lodIndex
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RadProbeSetCorePtr Enlighten::PipelineScene::LoadRadProbeSetCore

public: RadProbeSetCorePtr LoadRadProbeSetCore
(
    const Geo::GeoFileString & probeSetName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

RadSystemCorePtr Enlighten::PipelineScene::LoadRadSystemCore

public: RadSystemCorePtr LoadRadSystemCore
(
    const Geo::GeoFileString & systemName,
    Geo::s32 lodIndex
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

SystemDusterPtr Enlighten::PipelineScene::LoadSystemDuster

public: SystemDusterPtr LoadSystemDuster
(
    const Geo::GeoFileString & systemName
) const

Load a precompute object from file.

Return a unique pointer which owns the object. The unique pointer is compatible with either std::move or GeoStd::Move.

static Geo::GeoFileString Enlighten::PipelinePaths::MakeOctreeProbeSetName

public: Geo::GeoFileString MakeOctreeProbeSetName
(
    const PrecompOctreeCode octreeCode,
    const char * paramSetName
)

Returns the name of the octree probe set for the specified octree code and optional parameter set.

Enlighten::PipelinePaths::PipelinePaths

public: PipelinePaths
(
    const Geo::GeoFileString & exportPath,
    const Geo::GeoFileString & sceneName
)

Provide an export path to which the current process can write files.

Enlighten::PipelinePaths::PipelinePaths

public: PipelinePaths
(
    const Geo::GeoFileString & exportPath
)

Provide an export path to which the current process can write files.

Enlighten::PipelineScene::PipelineScene

protected: PipelineScene
(
    PipelinePaths paths,
    const PipelineGlobalParameters & global
)

To use this class, construct an instance of the PrecomputePipeline class.

Do not directly construct an instance of PipelineScene.

Enlighten::PrecomputeParameters::PrecomputeParameters

public: PrecomputeParameters
(
    PrecomputeDistribute distribute,
    Geo::u32 memoryLimit,
    bool sampleFramework,
    bool unattended
)

Constructor.

Enlighten::PrecomputePipeline::PrecomputePipeline

public: PrecomputePipeline
(
    PipelinePaths paths,
    PrecomputeParameters parameters,
    const PipelineGlobalParameters & global,
    const Geo::GeoFileString & toolsPath
)

Constructor.

void Enlighten::PrecomputePipeline::StartPrecompute

public: void StartPrecompute
(
    bool parameterize
)

Launches the High Level Build System to run the build.

PrecomputeResult Enlighten::PrecomputePipeline::TryGetPrecomputeResult

public: PrecomputeResult TryGetPrecomputeResult()

If the precompute is still running, return Running, else return the precompute result.

bool Enlighten::PrecomputePipeline::WaitForPrecompute

public: bool WaitForPrecompute()

Wait for the precompute to complete.

Return true if the precompute succeeded.

void Enlighten::PipelineScene::WriteScene

public: void WriteScene
(
    Geo::IGeoProgressProxy & progressProxy
) const

Write the Enlighten scene to disk.

void Enlighten::PrecomputePipeline::WriteScene

public: void WriteScene
(
    Geo::IGeoProgressProxy & progressProxy
)

Write the scene to the export path.

State

protected: enum State{}

The set of states that an instance may transition between.