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.

AddInstanceParameters(const PipelineInstanceParameters &)

Add a named set of instance parameters to the scene.

AddProbeOctreeBoxes(Geo::GeoFileString, ProbeOctreeResolution, const Geo::GeoBoundingBox *, Geo::s32)

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

AddProbeOctreePoints(Geo::GeoFileString, ProbeOctreeResolution, const Geo::v128 *, Geo::s32)

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

AddProbeOctreeVolume(Geo::GeoFileString, ProbeOctreeResolution, const IPrecompVolumeQuery &)

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

AddProbeVolume(const PipelineProbeVolume &)

Adds a probe volume to the scene.

AddRadiosityDependencies(PipelineRadiosityGroupType, Geo::GeoFileString, const Dependencies &, const Dependencies &)

Adds a dependency set.

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.

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.

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.

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.

GetSystemDusterFilename(const Geo::GeoFileString &)

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

LoadClusterAlbedoWorkspaceMaterialData(const Geo::GeoFileString &)

Load a precompute object from file.

LoadGeneratedSystems(const Geo::GeoFileString &)

Load a precompute object from file.

LoadInputWorkspace(const Geo::GeoFileString &)

Load a precompute object from file.

LoadOctreeProbeSetCore(const Geo::GeoFileString &, Geo::s32)

Load a precompute object from file.

LoadOctreeProbeSetCore(const PrecompOctreeCode)

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.

LoadRadCubeMapCore(const Geo::GeoFileString &)

Load a precompute object from file.

LoadRadiosityNormalTexture(const Geo::GeoFileString &, Geo::s32)

Load a precompute object from file.

LoadRadProbeSetCore(const Geo::GeoFileString &)

Load a precompute object from file.

LoadRadSystemCore(const Geo::GeoFileString &, Geo::s32)

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.

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 &)

Constructor.

PrecomputeParameters(PrecomputeDistribute, Geo::u32, bool, bool)

Constructor.

PrecomputePipeline(PipelinePaths, PrecomputeParameters, const PipelineGlobalParameters &, const Geo::GeoFileString &)

Constructor.

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.

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.

bool m_Unattended

If true, the precompute does not wait for user input when an error occurs.



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



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.