class Enlighten PrecomputePipeline

This is the documentation for Enlighten.

class Enlighten PrecomputePipeline

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

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.

AddInstance(const PipelineUnlitInstance &)

Add an unlit 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

Name

Description

State

The set of states that an instance may transition between.

Typedefs

Name

Description

Name

Description

Geo::GeoArray< Geo::GeoFileString > Dependencies

Array of dependencies.

Geo::GeoArray< Geo::GeoFileString > InstanceNames

An array of instance names.

Variables

Name

Description

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


public: void AddInstance
(
    const PipelineUnlitInstance & instance
)


Add an unlit 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)