This is the documentation for Enlighten.
└>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.
| 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. |
| Name | Description |
|---|---|
| State | The set of states that an instance may transition between. |
| Name | Description |
|---|---|
| Geo::GeoArray< Geo::GeoFileString > Dependencies | Array of dependencies. |
| Geo::GeoArray< Geo::GeoFileString > InstanceNames | An array of instance names. |
| 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. |
public: void AddCubemap
(
const PipelineCubemap & cubemap
)
Add a cubemap to the scene.
public: void AddGeom
(
const PipelineGeom & geom
)
Add the geom to the scene.
public: void AddInstance
(
const PipelineRadiosityInstance & instance
)
Add a radiosity instance to the scene.
public: void AddInstance
(
const PipelineExcludedInstance & instance
)
Add an excluded instance to the scene.
public: void AddInstance
(
const PipelineUnlitInstance & instance
)
Add an unlit instance to the scene.
public: void AddInstanceParameters
(
const PipelineInstanceParameters & parameters
)
Add a named set of instance parameters to the scene.
public: void AddProbeRegion
(
const PipelineBoxSetProbeRegion & region
)
Add a region defined by a set of boxes to the specified probe octree.
public: void AddProbeRegion
(
const PipelinePointSetProbeRegion & region
)
Add a region defined by a set of points to the specified probe octree.
public: void AddProbeRegion
(
const PipelineVolumeProbeRegion & region
)
Add a probe region defined by a volume to the specified zone.
public: void AddProbeVolume
(
const PipelineProbeVolume & probeVolume
)
Adds a probe volume to the scene.
public: void AddRadiosityDependencies
(
PipelineRadiosityGroupType type,
Geo::GeoFileString groupName,
const Dependencies & dependencies,
const Dependencies & explicitDependencies
)
Adds a dependency set.
public: void AddRadiosityDependencies
(
Geo::GeoFileString zone,
const Dependencies & dependencies
)
Limit the radiosity dependencies of the specified zone to the specified set of zone dependencies.
public: void CancelPrecompute()
Cancel the currently running precompute.
public: AlbedoBufferPtr CreateAlbedoBuffer
(
InputWorkspace * inputWorkspace
)
Create a runtime object.
Return a unique pointer which owns the object.
public: DynamicMaterialWorkspacePtr CreateDynamicMaterialWorkspace
(
ClusterAlbedoWorkspaceMaterialData * cawMaterialData
)
Create a runtime object.
Return a unique pointer which owns the object.
public: EmissiveBufferPtr CreateEmissiveBuffer
(
InputWorkspace * inputWorkspace
)
Create a runtime object.
Return a unique pointer which owns the object.
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!
public: bool GeomExists
(
const Geo::GeoFileString & name
) const
Returns true if there is a geometry object associated with the specified name. O(1) complexity.
public: Geo::GeoFileString GetClusterAlbedoMaterialDataFilename
(
const Geo::GeoFileString & SystemName
) const
Returns the full path to the cluster albedo material data file for the specified system.
public: Geo::GeoFileString GetCubemapCoreFilename
(
const Geo::GeoFileString & cubemapName
) const
Returns the full path to the rad cubemap core output file for the specified cubemap.
public: Geo::GeoFileString GetCubemapDependenciesFilename
(
const Geo::GeoFileString & cubemapName
) const
Returns the full path to the system dependencies output file for the specified cubemap.
public: const char * GetDefaultSceneName()
Returns the default name of the scene.
public: Geo::GeoFileString GetDepsFilename() const
Returns the full path to the .deps file.
public: Geo::GeoFileString GetDirectionalVisibilityFilename
(
const Geo::GeoFileString & SystemName
) const
Returns the full path to the directional visibility file for the specified system.
public: const Geo::GeoFileString & GetExportPath() const
Returns the export path that was supplied to the constructor.
public: Geo::GeoFileString GetGeneratedSystemsFilename
(
const Geo::GeoFileString & zoneName
) const
Returns the full path to the generated systems file for the specified zone.
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.
public: Geo::GeoFileString GetInputProbeSetFilename
(
const Geo::GeoFileString & name
) const
Returns the full path to the input probeset file for the specified system.
public: Geo::GeoFileString GetInputSystemFilename
(
const Geo::GeoFileString & systemName
) const
Returns the full path to the input system output file for the specified system.
public: Geo::GeoFileString GetInputWorkspaceFilename
(
const Geo::GeoFileString & SystemName
) const
Returns the full path to the input workspace file for the specified system.
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.
public: Geo::GeoFileString GetLightsFilename() const
Returns the full path to the.lights file.
public: Geo::GeoFileString GetLightTransportOutputFilename
(
const Geo::GeoFileString & SystemName
) const
Returns the full path to the light transport output file for the specified system.
public: Geo::GeoFileString GetOutputProbeOctreeFilename
(
const Geo::GeoFileString & name
) const
Returns the full path to the output probe octree file for the specified input octree.
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.
public: Geo::GeoFileString GetPackedSystemFilename
(
const Geo::GeoFileString & systemName
) const
Returns the full path to the packed system output file for the specified system.
public: Geo::GeoFileString GetParamsetFilename() const
Returns the full path to the paramset file.
public: Geo::GeoFileString GetPrecomputeLogFilename() const
Returns the full path to the precompute log file.
public: Geo::GeoFileString GetProbeAtlasMaximaFilename
(
const Geo::GeoFileString & paramsetName
) const
Returns the full path to the probe atlas maxima file.
public: Geo::GeoFileString GetProbeDependenciesFilename
(
const Geo::GeoFileString & probeSetName
) const
Returns the full path to the system dependencies output file for the specified probe-set.
public: Geo::GeoFileString GetProbeRegionFilename
(
const Geo::GeoFileString & name
) const
Returns the full path to the probe region file with the specified name.
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.
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.
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.
public: Geo::GeoFileString GetRefInputWorkspaceFilename
(
const Geo::GeoFileString & SystemName
) const
Returns the full path to the reference input workspace file for the specified system.
public: Geo::GeoFileString GetSceneFilename() const
Returns the full path to the .scene file.
public: const Geo::GeoFileString & GetSceneName() const
Returns the name of the scene.
public: Geo::GeoFileString GetSceneOutputPath() const
Returns the full path to the directory containing the build results.
public: Geo::GeoFileString GetSystemDependenciesFilename
(
const Geo::GeoFileString & systemName
) const
Returns the full path to the system dependencies output file for the specified system.
public: Geo::GeoFileString GetSystemDusterFilename
(
const Geo::GeoFileString & systemName
) const
Returns the full path to the system duster output file for the specified system.
public: CAWMaterialDataPtr LoadClusterAlbedoWorkspaceMaterialData
(
const Geo::GeoFileString & systemName,
Geo::u32 sections
) 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.
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.
public: InputProbeSetPtr LoadInputProbeSet
(
const PrecompOctreeCode octreeCode,
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.
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.
public: InputWorkspacePtr LoadInputWorkspace
(
const Geo::GeoFileString & systemName,
Geo::u32 sections
) 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.
public: RadProbeSetCorePtr LoadOctreeProbeSetCore
(
const PrecompOctreeCode octreeCode,
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.
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.
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.
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.
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.
public: ProbeAtlasMaximaPtr LoadProbeAtlasMaxima
(
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.
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.
public: RGBXTexturePtr LoadRadiosityNormalTexture
(
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.
public: RadProbeSetCorePtr LoadRadProbeSetCore
(
const Geo::GeoFileString & probeSetName,
Geo::u32 sections
) 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.
public: RadSystemCorePtr LoadRadSystemCore
(
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.
public: RadSystemCorePtr LoadRadSystemCoreEx
(
const Geo::GeoFileString & systemName,
Geo::u32 sections
) 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.
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.
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.
public: Geo::GeoFileString MakeProbeOctreeName
(
const char * paramsetName
)
Returns the name of the probe octree associated with the optional parameter set.
public: PipelinePaths
(
const Geo::GeoFileString & exportPath,
const Geo::GeoFileString & sceneName
)
Provide an export path to which the current process can write files.
public: PipelinePaths
(
const Geo::GeoFileString & exportPath
)
Provide an export path to which the current process can write files.
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.
public: PrecomputeParameters
(
PrecomputeDistribute distribute,
Geo::u32 memoryLimit,
bool sampleFramework,
bool unattended
)
Constructor.
public: PrecomputePipeline
(
PipelinePaths paths,
PrecomputeParameters parameters,
const PipelineGlobalParameters & global,
const Geo::GeoFileString & toolsPath
)
Constructor.
public: void SetSceneComment
(
Geo::GeoFileStringView comment
)
Add a comment to include in the scene file.
public: void StartPrecompute
(
bool parameterize
)
Launches the High Level Build System to run the build.
public: PrecomputeResult TryGetPrecomputeResult()
If the precompute is still running, return Running, else return the precompute result.
public: bool WaitForPrecompute()
Wait for the precompute to complete.
Return true if the precompute succeeded.
public: void WriteScene
(
Geo::IGeoProgressProxy & progressProxy
) const
Write the Enlighten scene to disk.
public: void WriteScene
(
Geo::IGeoProgressProxy & progressProxy
)
Write the scene to the export path.
protected: enum State{}
The set of states that an instance may transition between.