class Enlighten::IUpdateManager

    └>Geo::IGeoReleasable

This class is the base interface for the singleton object which manages all of the Enlighten updates for the systems and lights in the world, according to the current update strategy, solve type and albedo type.

Functions

virtual BaseCubeMap* Enlighten::IUpdateManager::AllocateCubeMap

public: BaseCubeMap * AllocateCubeMap
(
    const RadCubeMapCore * coreData,
    IGpuTexture * outputTexture
)

Allocate a cube map object.

Pointer parameters that are are owned by the caller may be read any time after EnqueueAddCubeMap and before the completion of the async RemoveCubeMap command.

Parameters

virtual BaseDynamicObject* Enlighten::IUpdateManager::AllocateDynamicObject

public: BaseDynamicObject * AllocateDynamicObject
(
    const Enlighten::DynamicObject & dynamicObjectDesc
)

Allocate a dynamic object.

This will add the object to the update manager's list but it must be separately added to the worker's copy via EnqueueAddDynamicObject.

Parameters

virtual BaseProbeSet* Enlighten::IUpdateManager::AllocateProbeSet

public: BaseProbeSet * AllocateProbeSet
(
    const RadProbeSetCore * coreData,
    bool useU8Output,
    Enlighten::eSHOrder shOrder,
    RawBuffer output
)

Allocate a probe set object.

Pointer parameters that are are owned by the caller may be read (and output may be written) any time after EnqueueAddProbeSet and before the completion of the async RemoveProbeSet command.

Parameters

virtual BaseProbeSet* Enlighten::IUpdateManager::AllocateStaticProbeSet

public: BaseProbeSet * AllocateStaticProbeSet
(
    const RadProbeSetCore * coreData,
    bool useU8Output,
    Enlighten::eSHOrder shOrder,
    RawBuffer output
)

Allocate a probe set object that is not solved at runtime.

Pointer parameters that are are owned by the caller may be read (and output may be written) any time after EnqueueAddProbeSet and before the completion of the async RemoveProbeSet command.

Parameters

virtual BaseSystem* Enlighten::IUpdateManager::AllocateStaticSystem

public: BaseSystem * AllocateStaticSystem
(
    Geo::GeoGuid systemId,
    InputLightingBuffer * inputLightingBuffer,
    Geo::s32 lightChannels
)

Allocate a radiosity system where the lighting does not change at runtime.

A saved InputLightingBuffer ensures that the lighting bounces into systems which depend on this system. Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command.

Parameters

BaseSystem* Enlighten::IUpdateManager::AllocateStaticSystem

public: BaseSystem * AllocateStaticSystem
(
    Geo::GeoGuid systemId,
    InputLightingBuffer * inputLightingBuffer
)

Allocate a radiosity system where the lighting does not change at runtime.

A saved InputLightingBuffer ensures that the lighting bounces into systems which depend on this system. Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command.

Parameters

virtual BaseSystem* Enlighten::IUpdateManager::AllocateSystem

public: BaseSystem * AllocateSystem
(
    const InputWorkspace * inputWorkspace,
    const PrecomputedVisibilityData * visibilityData,
    Geo::s32 lightChannels
)

Allocate a radiosity system.

Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command.

Parameters

BaseSystem* Enlighten::IUpdateManager::AllocateSystem

public: BaseSystem * AllocateSystem
(
    const InputWorkspace * inputWorkspace,
    const PrecomputedVisibilityData * visibilityData
)

Allocate a radiosity system.

Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command.

Parameters

virtual BaseSystem* Enlighten::IUpdateManager::AllocateSystem

public: BaseSystem * AllocateSystem
(
    const RadSystemCore * coreData,
    const InputWorkspace * inputWorkspace,
    const PrecomputedVisibilityData * visibilityData,
    IGpuTexture * outputTextures,
    Geo::s32 lightChannels
)

Allocate a radiosity system.

Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command. Takes ownership of the output textures.

BaseSystem* Enlighten::IUpdateManager::AllocateSystem

public: BaseSystem * AllocateSystem
(
    const RadSystemCore * coreData,
    const InputWorkspace * inputWorkspace,
    const PrecomputedVisibilityData * visibilityData,
    IGpuTexture * outputTextures
)

Allocate a radiosity system.

Pointer parameters that are are owned by the caller may be read any time after EnqueueAddSystem and before the completion of the async RemoveSystem command. Takes ownership of the output textures.

virtual ISystemSolutionSpace* Enlighten::IUpdateManager::AllocateSystemSolutionSpace

public: ISystemSolutionSpace * AllocateSystemSolutionSpace
(
    const RadSystemCore * coreData
)

Allocate the solution space, which contains the textures and memory for the output, for a system.

This version requires an IGpuTextureAllocator to have been set on the update manager properties.

ISystemSolutionSpace* Enlighten::IUpdateManager::AllocateSystemSolutionSpace

public: ISystemSolutionSpace * AllocateSystemSolutionSpace
(
    const RadSystemCore * coreData,
    IGpuTexture * outputTextures,
    eOutputFormat irradianceTextureFormat
)

Allocate the solution space, which contains the textures and memory for the output, for a system.

This version requires the customer allocated textures to be provided. Deprecated

The irradianceTextureFormat argument is deprecated.

virtual ISystemSolutionSpace* Enlighten::IUpdateManager::AllocateSystemSolutionSpace

public: ISystemSolutionSpace * AllocateSystemSolutionSpace
(
    const RadSystemCore * coreData,
    IGpuTexture * outputTextures
)

Allocate the solution space, which contains the textures and memory for the output, for a system.

This version requires the customer allocated textures to be provided.

virtual void Enlighten::IUpdateManager::Clear

public: void Clear()

Wait until asynchronous processing has finished, then remove all objects from the update manager.

virtual void Enlighten::IUpdateManager::DetachCubeMap

public: void DetachCubeMap
(
    Geo::GeoGuid cubeMapId
)

Advanced: remove a cube map from the render thread-side list, prior to its removal.

This is automatically performed by EnqueueRemoveCubeMap, so only needs to be called if you are using a custom command to perform the removal.

virtual void Enlighten::IUpdateManager::DetachDynamicObject

public: void DetachDynamicObject
(
    Geo::GeoGuid objectId
)

Advanced: remove a dynamic object from the render thread-side list, prior to its removal.

This is automatically performed by EnqueueRemoveDynamicObject, so only needs to be called if you are using a custom command to perform the removal.

virtual BaseProbeSet* Enlighten::IUpdateManager::DetachProbeSet

public: BaseProbeSet * DetachProbeSet
(
    Geo::GeoGuid probeSetId
)

Advanced: remove a probe set from the render thread-side list, prior to its removal.

This is automatically performed by EnqueueRemoveProbeSet, so only needs to be called if you are using a custom command to perform the removal.

virtual void Enlighten::IUpdateManager::DetachSystem

public: void DetachSystem
(
    Geo::GeoGuid systemId
)

Advanced: remove a system from the render thread-side system list, prior to its removal.

This is automatically performed by EnqueueRemoveSystem, so only needs to be called if you are using a custom command to perform the removal.

virtual bool Enlighten::IUpdateManager::EnqueueAddCubeMap

public: bool EnqueueAddCubeMap
(
    BaseCubeMap * cubeMap
)

Add a previously allocated cube map to the worker's list.

virtual bool Enlighten::IUpdateManager::EnqueueAddDynamicObject

public: bool EnqueueAddDynamicObject
(
    BaseDynamicObject * object
)

Add a previously allocated dynamic object to the worker's list.

virtual bool Enlighten::IUpdateManager::EnqueueAddProbeSet

public: bool EnqueueAddProbeSet
(
    BaseProbeSet * probeSet
)

Add a previously allocated probe set to the worker's list.

virtual bool Enlighten::IUpdateManager::EnqueueAddSystem

public: bool EnqueueAddSystem
(
    BaseSystem * system
)

Add a previously allocated system to the worker's list.

virtual void Enlighten::IUpdateManager::EnqueueReleaseSystemSolutionSpaces

public: void EnqueueReleaseSystemSolutionSpaces
(
    ISystemSolutionSpace *const * ,
    Geo::s32 count
)

Enqueue system solution spaces release.

This will add the solution spaces to a list of objects to destroy on next update.

virtual void Enlighten::IUpdateManager::EnqueueRemoveAllLights

public: void EnqueueRemoveAllLights()

Removes all lights.

virtual void Enlighten::IUpdateManager::EnqueueRemoveCubeMap

public: void EnqueueRemoveCubeMap
(
    Geo::GeoGuid cubeMapId,
    RemovalMode removalMode
)

Remove or disable updates for a cube map.

virtual void Enlighten::IUpdateManager::EnqueueRemoveDynamicObject

public: void EnqueueRemoveDynamicObject
(
    Geo::GeoGuid objectId
)

Removes a dynamic object.

virtual void Enlighten::IUpdateManager::EnqueueRemoveEmissiveEnvironment

public: void EnqueueRemoveEmissiveEnvironment
(
    Geo::GeoGuid environmentId
)

Removes an environment.

virtual void Enlighten::IUpdateManager::EnqueueRemoveLight

public: void EnqueueRemoveLight
(
    Geo::GeoGuid lightId
)

Removes a light.

virtual void Enlighten::IUpdateManager::EnqueueRemoveProbeSet

public: void EnqueueRemoveProbeSet
(
    Geo::GeoGuid probeSetId,
    RemovalMode removalMode
)

Remove or disable updates for a probe set.

virtual void Enlighten::IUpdateManager::EnqueueRemoveProbeSet

public: void EnqueueRemoveProbeSet
(
    BaseProbeSet * probeSet
)

Remove a probe set.

virtual void Enlighten::IUpdateManager::EnqueueRemoveSystem

public: void EnqueueRemoveSystem
(
    Geo::GeoGuid systemId,
    RemovalMode removalMode
)

Remove or disable updates for a system.

virtual void Enlighten::IUpdateManager::EnqueueRemoveSystemSolutionSpaces

public: void EnqueueRemoveSystemSolutionSpaces
(
    Geo::GeoGuid systemId
)

Enqueue system solution spaces remove.

This will remove all the solution spaces from a system.

virtual void Enlighten::IUpdateManager::EnqueueSetAllUpdateCounters

public: void EnqueueSetAllUpdateCounters
(
    Geo::s32 count
)

Set the update counters for all systems, probe sets and cube maps in the update manager.

virtual void Enlighten::IUpdateManager::EnqueueSetDoFullSolveNextFrame

public: void EnqueueSetDoFullSolveNextFrame()

Set the flag which turns off temporal coherence for the next frame and performs a full solve from scratch.

virtual void Enlighten::IUpdateManager::EnqueueSetLightBankUpdateCounter

public: void EnqueueSetLightBankUpdateCounter
(
    Geo::s32 lightBankId,
    Geo::s32 count
)

Set the light bank update counter for the given light bank.

virtual bool Enlighten::IUpdateManager::EnqueueSetProbeSetManager

public: bool EnqueueSetProbeSetManager
(
    IProbeSetManager * probeSetManager
)

Set the Probe Set Manager object.

virtual void Enlighten::IUpdateManager::EnqueueSetProbeSetTransform

public: void EnqueueSetProbeSetTransform
(
    Geo::GeoGuid probeSetId,
    const Geo::Matrix & transform
)

Set the world-to-local-space transform for the given probe set. This will trigger a global recomputation of all probe interpolants.

virtual void Enlighten::IUpdateManager::EnqueueSetVisibilityBits

public: void EnqueueSetVisibilityBits
(
    Geo::GeoGuid objectId,
    Geo::GeoGuid lightId,
    void * visibilityBits
)

Set the visibility data associated to a given (system/cube map, spotlight) pair.

Typically, this data will have been computed using the GPU (for instance, in GeoRadiosity by the GpuSpotlightVisibilityEngine).

virtual bool Enlighten::IUpdateManager::EnqueueSetWorkerProperties

public: bool EnqueueSetWorkerProperties
(
    const UpdateManagerWorkerProperties & properties
)

Enqueue a change to the worker's global state.

virtual void Enlighten::IUpdateManager::EnqueueUpdateEmissiveEnvironment

public: void EnqueueUpdateEmissiveEnvironment
(
    Geo::GeoGuid environmentId,
    Geo::s32 resolution,
    const Geo::v128 * values
)

Update the environment with the given GUID. If this environment hasn't been updated before it will be added to the update manager.

void Enlighten::IUpdateManager::EnqueueUpdateLight

public: void EnqueueUpdateLight
(
    const Geo::GeoGuid & guid,
    const LightType & light,
    UpdateLightOptions options
)

Add the light.

Parameters

virtual void Enlighten::IUpdateManager::FlushCommands

public: void FlushCommands()

Wait for all commands to be executed before proceeding. This blocks the current thread, potentially for a long time.

virtual IGpuTexture* Enlighten::IUpdateManager::GetCubeMapTexture

public: IGpuTexture * GetCubeMapTexture
(
    Geo::GeoGuid cubeMapId
) const

Get the output texture for the cube map texture.

Implemented with a binary search by GUID. To avoid calling this, keep a reference to the output texture you provide to AllocateCubeMap.

virtual bool Enlighten::IUpdateManager::GetDynamicObjectEnvironmentVisibilityShCoeff

public: bool GetDynamicObjectEnvironmentVisibilityShCoeff
(
    Geo::GeoGuid objectId,
    Geo::SHCoeff & envVisCoeff
) const

Gets the environment visibility probe output for a given dynamic object.

virtual bool Enlighten::IUpdateManager::GetDynamicObjectShCoeff

public: bool GetDynamicObjectShCoeff
(
    Geo::GeoGuid objectId,
    Geo::SHCoeff & redCoeff,
    Geo::SHCoeff & greenCoeff,
    Geo::SHCoeff & blueCoeff
) const

Gets the probe output for a given dynamic object.

virtual Geo::s32 Enlighten::IUpdateManager::GetNumCubeMaps

public: Geo::s32 GetNumCubeMaps() const

Returns number of cube maps registered with the update manager.

virtual Geo::s32 Enlighten::IUpdateManager::GetNumDynamicObjects

public: Geo::s32 GetNumDynamicObjects() const

Returns number of dynamic objects registered with the update manager.

virtual Geo::s32 Enlighten::IUpdateManager::GetNumProbeSets

public: Geo::s32 GetNumProbeSets() const

Returns number of probe sets registered with the update manager.

virtual Geo::s32 Enlighten::IUpdateManager::GetNumSystems

public: Geo::s32 GetNumSystems() const

Returns number of systems registered with the update manager.

virtual IGpuTexture* Enlighten::IUpdateManager::GetOutputTexture

public: IGpuTexture * GetOutputTexture
(
    Geo::GeoGuid systemId,
    OutputTextureType textureType
) const

Gets the output texture of the given type for the given system.

Implemented with a binary search by GUID. To avoid calling this, keep a reference to the output textures you provide to AllocateSystem or AllocateSystemSolutionSpace.

virtual PppiOutputTextureRequirements Enlighten::IUpdateManager::GetPppiRequiredOutputTextures

public: PppiOutputTextureRequirements GetPppiRequiredOutputTextures() const

Returns information about the required PPPI output textures.

virtual const float* Enlighten::IUpdateManager::GetProbeOutput

public: const float * GetProbeOutput
(
    Geo::GeoGuid probeSetId,
    Geo::s32 probeIndex
) const

Returns the probe output for the given probe set and probe index, or NULL if the probe set produces compressed output.

virtual const float* Enlighten::IUpdateManager::GetProbeOutputIfUpdated

public: const float * GetProbeOutputIfUpdated
(
    Geo::GeoGuid probeSetId,
    Geo::s32 * outStride
) const

Returns the probe output if the probeset has been updated since this function was last called on it, otherwise NULL.

/param[out] outStride If not NULL, receives the output stride in floats.

virtual Geo::s64 Enlighten::IUpdateManager::GetTextureUpdateTicks

public: Geo::s64 GetTextureUpdateTicks() const

Get the total number of ticks spent updating GPU textures.

virtual const Geo::u8* Enlighten::IUpdateManager::GetU8ProbeOutput

public: const Geo::u8 * GetU8ProbeOutput
(
    Geo::GeoGuid probeSetId,
    Geo::s32 probeIndex
) const

Returns the compressed probe output for the given probe set and probe index, or NULL if the probe set produces uncompressed output.

virtual Geo::Matrix Enlighten::IUpdateManager::GetWorldToUvwMatrix

public: Geo::Matrix GetWorldToUvwMatrix
(
    Geo::GeoGuid objectId
) const

Gets the matrix to transform world space to UVW texture space for a dynamic object.

virtual bool Enlighten::IUpdateManager::HasCubeMap

public: bool HasCubeMap
(
    Geo::GeoGuid cubeMapId
)

Returns true if the update manager has a cube map with this GUID; false if it doesn't.

virtual bool Enlighten::IUpdateManager::HasDynamicObject

public: bool HasDynamicObject
(
    Geo::GeoGuid objectId
)

Returns true if the update manager has a dynamic object with this GUID.

virtual bool Enlighten::IUpdateManager::HasProbeSet

public: bool HasProbeSet
(
    Geo::GeoGuid probeSetId
)

Returns true if the update manager has a probe set with this GUID; false if it doesn't.

virtual bool Enlighten::IUpdateManager::HasSystem

public: bool HasSystem
(
    Geo::GeoGuid systemId
)

Returns true if the update manager has a system with this GUID; false if it doesn't.

virtual bool Enlighten::IUpdateManager::IsUpdateLimited

public: bool IsUpdateLimited() const

Are we at the limit of the number of allowed enqueued updates, and therefore the update rate is throttled?

virtual void Enlighten::IUpdateManager::Release

public: void Release()

Destroys the update manager and all the resources it owns.

virtual void Geo::IGeoReleasable::Release

public: void Release()

Free this object that was created within the Enlighten libraries.

Expect this to behave in a similar way to calling 'delete(this)'

virtual bool Enlighten::IUpdateManager::RequiresVisibilityDataOnCpu

public: bool RequiresVisibilityDataOnCpu() const

Returns true for Update Managers that require spotlight visibility to be copied to the CPU before it can be used.

virtual void Enlighten::IUpdateManager::SetPppiOutputWorkspace

public: void SetPppiOutputWorkspace
(
    const PppiOutputWorkspace & outputWorkspace,
    IPppiTextureUpdateHandler * updateHandler
)

Use the provided PPPI output textures.

Call once, before AllocateProbeSet.

Parameters

virtual void Enlighten::IUpdateManager::StopWorking

public: void StopWorking()

Wait for all asynchronous processing to finish, then quit the worker thread(s), if any.

virtual void Enlighten::IUpdateManager::Update

public: void Update()

The main update function.

This should be called once per frame from the rendering thread.

virtual PppiShaderParameters Enlighten::IUpdateManager::Update

public: PppiShaderParameters Update
(
    const Geo::v128 & viewOrigin,
    float lodDistance
)

The main update function.

This should be called once per frame from the rendering thread.

Parameters

virtual PppiShaderParameters Enlighten::IUpdateManager::UpdatePppi

public: PppiShaderParameters UpdatePppi
(
    const Geo::v128 & viewOrigin,
    const IViewVolumeIntersector * viewVolume,
    float lodDistance
)

Update PPPI indirection texture based on the view origin.

Update PPPI atlas texture with output for all probe sets that changed since the last update.

Parameters

virtual void Enlighten::IUpdateManager::UpdatePppiBorder

public: void UpdatePppiBorder
(
    const PppiIrradiance & border
)

Update the lighting for parts of the PPPI volume not covered by any probe set.