This is the documentation for Enlighten.

class Enlighten CpuDynamicObject

class Enlighten::CpuDynamicObject

    └>Enlighten::BaseDynamicObject
        └>Geo::IGeoReleasable

Implementation of BaseDynamicObject for Cpu Solving.

Variables

Name Description
bool m_AddedToManager

false when the object is allocated; true when it is added to the working set

IGpuTexture * m_GpuTexture[ENLIGHTEN_PROBE_VOLUME_NUM_TYPES]

GPU output volume textures for R/G/B/Env.

InterpolatedPoint * m_InterpolationPoints

Set of points where we require interpolated probe output.

eSHOrder m_MaximumEnvVisShOrder

The amount of storage allocated for environment SH results.

eSHOrder m_MaximumShOrder

Whether this dynamic object has L1 or L2 storage allocated.

bool m_NewSolverOutputToCopy

Flag set when there is fresh output to copy to the GPU.

const DynamicObject m_Object

Fixed description of the object.

Geo::s32 m_RowPitch[ENLIGHTEN_PROBE_VOLUME_NUM_TYPES]

The row pitch of the CPU output, in bytes.

Geo::s32 m_SlicePitch[ENLIGHTEN_PROBE_VOLUME_NUM_TYPES]

The slice pitch of the CPU output, in bytes.

void * m_SolverOutput[ENLIGHTEN_PROBE_VOLUME_NUM_TYPES]

CPU output for R/G/B/Env.

Geo::Matrix m_Transform

Current local-to-world-space transform of the object.

bool m_UseVolumeTextures

Whether this dynamic object has volume textures.

Geo::Matrix m_WorldToUvw

Current world-space-to-uvw-coordinate transform of the object.

Functions

Name Description
AllocateSolutionSpace(IGpuTextureAllocator *, Enlighten::eSHOrder, Enlighten::eSHOrder, bool)

Allocates space for probe output - CPU buffer if useVolumeTextures is false; GPU textures if true.

AllocateSolutionSpace(IGpuTextureAllocator *, Enlighten::eSHOrder, Enlighten::eSHOrder, bool)

Allocates space to hold the interpolated probe coefficients for the object.

BaseDynamicObject(const DynamicObject &)

Constructor, taking a DynamicObject description. Called during IUpdateManager::AllocateDynamicObject.

CpuDynamicObject(const DynamicObject &)

Constructor, taking a DynamicObject description.

GetNumInterpolationPoints()

Helper function to return the resolution of the output volume textures.

GetOutputPointer(Geo::s32, Geo::s32, Geo::s32, Geo::s32)

Returns the CPU pointer to write interpolated data for the given channel and grid coordinates.

GetOutputPointer(Geo::s32, Geo::s32, Geo::s32, Geo::s32)

Returns the CPU pointer to write interpolated data for the given channel and grid coordinates.

GetWorldToUvwMatrix()

Returns a matrix which transforms from world space to UVW volume texture coordinates to look up light probe data.

IsUpdatePending()

Are any irradiance buffers marked for an update?

IsUpdatePending()

Are any irradiance buffers marked for an update?

MarkUpdate(bool)

Mark solution buffer as requiring update in next call to UpdateGpuTexture.

MarkUpdate(bool)

Mark solution buffer as requiring update in next call to UpdateGpuTexture.

Release()

Free this object that was created within the Enlighten libraries.

Release()

Free this object that was created within the Enlighten libraries.

RequestInterpolationOnAllPoints()

will setInterpolatedPoint:: m_RecomputeInterpolants to true on all the interpolated points.

SetGpuTexture(ProbeVolumeOutputTextureType, IGpuTexture *)

Sets an output texture for the dynamic object.

SetGpuTexture(ProbeVolumeOutputTextureType, IGpuTexture *)

Sets an output texture for the dynamic object.

SetTransform(const Geo::Matrix &)

Sets the world transform for the object, and updates the world-to-uvw transform.

UpdateGpuTexture()

Update textures using the marked solution buffers.

UpdateGpuTexture()

Update the GPU volume textures.


virtual void Enlighten::CpuDynamicObject::AllocateSolutionSpace


public: virtual void AllocateSolutionSpace
(
    IGpuTextureAllocator * textureAllocator,
    Enlighten::eSHOrder maximumShOrder,
    Enlighten::eSHOrder maximumEnvVisShOrder,
    bool useVolumeTextures
)


Allocates space for probe output - CPU buffer if useVolumeTextures is false; GPU textures if true.


virtual void Enlighten::BaseDynamicObject::AllocateSolutionSpace


protected: void AllocateSolutionSpace
(
    IGpuTextureAllocator * textureAllocator,
    Enlighten::eSHOrder maximumShOrder,
    Enlighten::eSHOrder maximumEnvVisShOrder,
    bool useVolumeTextures
)


Allocates space to hold the interpolated probe coefficients for the object.

If useVolumeTextures is false this will be a CPU buffer. If useVolumeTextures is true it will be GPU textures, along with whatever other resources are required to update the textures.


Enlighten::BaseDynamicObject::BaseDynamicObject


protected: BaseDynamicObject
(
    const DynamicObject & object
)


Constructor, taking a DynamicObject description. Called during IUpdateManager::AllocateDynamicObject.


Enlighten::CpuDynamicObject::CpuDynamicObject


public: CpuDynamicObject
(
    const DynamicObject & object
)


Constructor, taking a DynamicObject description.


Geo::s32 Enlighten::BaseDynamicObject::GetNumInterpolationPoints


protected: Geo::s32 GetNumInterpolationPoints()


Helper function to return the resolution of the output volume textures.


virtual void* Enlighten::CpuDynamicObject::GetOutputPointer


public: virtual void * GetOutputPointer
(
    Geo::s32 channel,
    Geo::s32 x,
    Geo::s32 y,
    Geo::s32 z
)


Returns the CPU pointer to write interpolated data for the given channel and grid coordinates.


virtual void* Enlighten::BaseDynamicObject::GetOutputPointer


protected: virtual void * GetOutputPointer
(
    Geo::s32 channel,
    Geo::s32 x,
    Geo::s32 y,
    Geo::s32 z
)


Returns the CPU pointer to write interpolated data for the given channel and grid coordinates.


Geo::Matrix Enlighten::BaseDynamicObject::GetWorldToUvwMatrix


protected: Geo::Matrix GetWorldToUvwMatrix() const


Returns a matrix which transforms from world space to UVW volume texture coordinates to look up light probe data.


virtual bool Enlighten::CpuDynamicObject::IsUpdatePending


public: virtual bool IsUpdatePending() const


Are any irradiance buffers marked for an update?


virtual bool Enlighten::BaseDynamicObject::IsUpdatePending


protected: virtual bool IsUpdatePending() const


Are any irradiance buffers marked for an update?


virtual void Enlighten::BaseDynamicObject::MarkUpdate


protected: virtual void MarkUpdate
(
    bool value
)


Mark solution buffer as requiring update in next call to UpdateGpuTexture.


virtual void Enlighten::CpuDynamicObject::MarkUpdate


public: virtual void MarkUpdate
(
    bool value
)


Mark solution buffer as requiring update in next call to UpdateGpuTexture.


virtual void Enlighten::BaseDynamicObject::Release


protected: virtual 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 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)'


void Enlighten::BaseDynamicObject::RequestInterpolationOnAllPoints


public: void RequestInterpolationOnAllPoints()


will setInterpolatedPoint:: m_RecomputeInterpolants to true on all the interpolated points.


virtual void Enlighten::CpuDynamicObject::SetGpuTexture


public: virtual void SetGpuTexture
(
    ProbeVolumeOutputTextureType textureType,
    IGpuTexture * gpuTexture
)


Sets an output texture for the dynamic object.


virtual void Enlighten::BaseDynamicObject::SetGpuTexture


public: virtual void SetGpuTexture
(
    ProbeVolumeOutputTextureType textureType,
    IGpuTexture * gpuTexture
)


Sets an output texture for the dynamic object.


void Enlighten::BaseDynamicObject::SetTransform


public: void SetTransform
(
    const Geo::Matrix & transform
)


Sets the world transform for the object, and updates the world-to-uvw transform.


virtual void Enlighten::CpuDynamicObject::UpdateGpuTexture


public: virtual void UpdateGpuTexture()


Update textures using the marked solution buffers.


virtual void Enlighten::BaseDynamicObject::UpdateGpuTexture


protected: virtual void UpdateGpuTexture()


Update the GPU volume textures.