This is the documentation for Enlighten.

class Enlighten IPrecompInputProbeSet

class Enlighten::IPrecompInputProbeSet

    └>Geo::IGeoSerialisable
        └>Geo::IGeoReleasable

A class representing a set of sample points for which the run-time can generate spherical harmonic representations of the diffuse light incident on each sample point.

Functions

Name Description
Create()

Create a new empty IPrecompInputProbeSet.

Create(const IPrecompInputProbeSet *const *, Geo::s32)

Create a new octree IPrecompInputProbeSet as a union of the specified octree probe set objects.

GetBoundingBoxBasisX()

Get the first basis vector of the non-axis aligned bounding box.

GetBoundingBoxBasisY()

Get the second basis vector of the non-axis aligned bounding box.

GetBoundingBoxBasisZ()

Get the third basis vector of the non-axis aligned bounding box.

GetBoundingBoxOrigin()

Get the origin of the non-axis aligned bounding box.

GetBuildParameters()

Edit the build parameters for this probe set.

GetBuildParameters()

Read only access to the build parameters for this probe set.

GetId()

Return the unique ID of this light probe set.

GetName()

Get the full name.

GetNumProbes()

Return the number of probes contained in this probe set.

GetProbePositions()

Access the light probe positions.

GetRegularGridResolutionX()

Get the resolution of the regular grid in the direction of the first bounding box basis vector.

GetRegularGridResolutionY()

Get the resolution of the regular grid in the direction of the second bounding box basis vector.

GetRegularGridResolutionZ()

Get the resolution of the regular grid in the direction of the third bounding box basis vector.

IsOctree()

Returns true if this probe set was generated for a probe octree.

IsRegularGrid()

Returns if this probe set is a probe grid.

Load(IGeoInputStream &, Geo::u32)

Load an instance of this class from an IGeoInputStream.

Release()

Free this object that was created within the Enlighten libraries.

Save(IGeoStream &, Geo::u32)

Save an instance of this class to an IGeoStream.

SetId(Geo::GeoGuid)

Set the unique ID of this light probe set.

SetName(const char *)

Set a globally unique name.

SetProbePositions(const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::v128 *, const Geo::v128 *)

Copy light probe position values between [begin, end) into this object.

SetRandomProbePositions(const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::s32, const Geo::s32 &)

Create an random set of light probes within a non axis aligned bounding box.

SetRegularGridProbePositions(const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::v128 &, const Geo::s32, const Geo::s32, const Geo::s32)

Create light probes based on a regular grid.


static IPrecompInputProbeSet* Enlighten::IPrecompInputProbeSet::Create


public: IPrecompInputProbeSet * Create()


Create a new empty IPrecompInputProbeSet.


static IPrecompInputProbeSet* Enlighten::IPrecompInputProbeSet::Create


public: IPrecompInputProbeSet * Create
(
    const IPrecompInputProbeSet *const * others,
    Geo::s32 count
)


Create a new octree IPrecompInputProbeSet as a union of the specified octree probe set objects.

All probe sets must be coincident.


virtual const Geo::v128& Enlighten::IPrecompInputProbeSet::GetBoundingBoxBasisX


public: const Geo::v128 & GetBoundingBoxBasisX() const


Get the first basis vector of the non-axis aligned bounding box.


virtual const Geo::v128& Enlighten::IPrecompInputProbeSet::GetBoundingBoxBasisY


public: const Geo::v128 & GetBoundingBoxBasisY() const


Get the second basis vector of the non-axis aligned bounding box.


virtual const Geo::v128& Enlighten::IPrecompInputProbeSet::GetBoundingBoxBasisZ


public: const Geo::v128 & GetBoundingBoxBasisZ() const


Get the third basis vector of the non-axis aligned bounding box.


virtual const Geo::v128& Enlighten::IPrecompInputProbeSet::GetBoundingBoxOrigin


public: const Geo::v128 & GetBoundingBoxOrigin() const


Get the origin of the non-axis aligned bounding box.


virtual IPrecompProbeSetBuildParameters* Enlighten::IPrecompInputProbeSet::GetBuildParameters


public: IPrecompProbeSetBuildParameters * GetBuildParameters()


Edit the build parameters for this probe set.


virtual const IPrecompProbeSetBuildParameters* Enlighten::IPrecompInputProbeSet::GetBuildParameters


public: const IPrecompProbeSetBuildParameters * GetBuildParameters() const


Read only access to the build parameters for this probe set.


virtual Geo::GeoGuid Enlighten::IPrecompInputProbeSet::GetId


public: Geo::GeoGuid GetId() const


Return the unique ID of this light probe set.


virtual const char* Enlighten::IPrecompInputProbeSet::GetName


public: const char * GetName() const


Get the full name.


virtual Geo::s32 Enlighten::IPrecompInputProbeSet::GetNumProbes


public: Geo::s32 GetNumProbes() const


Return the number of probes contained in this probe set.


virtual const Geo::v128* Enlighten::IPrecompInputProbeSet::GetProbePositions


public: const Geo::v128 * GetProbePositions() const


Access the light probe positions.


virtual Geo::s32 Enlighten::IPrecompInputProbeSet::GetRegularGridResolutionX


public: Geo::s32 GetRegularGridResolutionX() const


Get the resolution of the regular grid in the direction of the first bounding box basis vector.


virtual Geo::s32 Enlighten::IPrecompInputProbeSet::GetRegularGridResolutionY


public: Geo::s32 GetRegularGridResolutionY() const


Get the resolution of the regular grid in the direction of the second bounding box basis vector.


virtual Geo::s32 Enlighten::IPrecompInputProbeSet::GetRegularGridResolutionZ


public: Geo::s32 GetRegularGridResolutionZ() const


Get the resolution of the regular grid in the direction of the third bounding box basis vector.


virtual bool Enlighten::IPrecompInputProbeSet::IsOctree


public: bool IsOctree() const


Returns true if this probe set was generated for a probe octree.


virtual bool Enlighten::IPrecompInputProbeSet::IsRegularGrid


public: bool IsRegularGrid() const


Returns if this probe set is a probe grid.

This is only true if the probe positions form a single fully occupied regular grid and there are no duplicates or probe positions outside of the grid.


virtual bool Geo::IGeoSerialisable::Load


public: bool Load
(
    IGeoInputStream & stream,
    Geo::u32 section
)


Load an instance of this class from an IGeoInputStream.

The stream must be ready to read from. You can load sections of an object by passing a bitmask representing the desired sections rather than Iff::AllSectionsMask, which will load all sections. It is also safe to call this method on an object multiple times with different section arguments to load multiple parts.


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 Geo::IGeoSerialisable::Save


public: bool Save
(
    IGeoStream & stream,
    Geo::u32 section
) const


Save an instance of this class to an IGeoStream.

The stream must be ready to write to. You can save sections of an object by passing a bitmask representing the desired sections rather than Iff::AllSectionsMask, which will save all sections that are available.


virtual void Enlighten::IPrecompInputProbeSet::SetId


public: void SetId
(
    Geo::GeoGuid id
)


Set the unique ID of this light probe set.


virtual void Enlighten::IPrecompInputProbeSet::SetName


public: void SetName
(
    const char * name
)


Set a globally unique name.


virtual bool Enlighten::IPrecompInputProbeSet::SetProbePositions


public: bool SetProbePositions
(
    const Geo::v128 & origin,
    const Geo::v128 & basisX,
    const Geo::v128 & basisY,
    const Geo::v128 & basisZ,
    const Geo::v128 * begin,
    const Geo::v128 * end
)


Copy light probe position values between [begin, end) into this object.

Previous positions are deleted. The bounding box is defined by a set of orthogonal basis vectors and their origin. The basis vectors are required to be orthogonal. The lengths of the basis vectors define the size of the bounding box.

Parameters
[in] origin

Origin of the basis vectors.

[in] basisX

First basis vector.

[in] basisY

Second basis vector.

[in] basisZ

third basis vector.

[in] begin

A pointer to the first element to be added

[in] end

A pointer to an element one past the last entity (as standard STL syntax)

Returns

True if the operation succeeded, false if there was not enough memory to satisfy the request or if the bounding box either has zero volume or its basis vectors are not orthogonal.


virtual bool Enlighten::IPrecompInputProbeSet::SetRandomProbePositions


public: bool SetRandomProbePositions
(
    const Geo::v128 & origin,
    const Geo::v128 & basisX,
    const Geo::v128 & basisY,
    const Geo::v128 & basisZ,
    const Geo::s32 numProbes,
    const Geo::s32 & seed
)


Create an random set of light probes within a non axis aligned bounding box.

Previous positions are deleted. The bounding box is defined by a set of orthogonal basis vectors and their origin. The basis vectors are required to be orthogonal. The lengths of the basis vectors define the size of the bounding box. A defined number of probes in the range [1..65536] are placed randomly within the bounding box.

Parameters
[in] origin

Origin of the basis vectors.

[in] basisX

First basis vector.

[in] basisY

Second basis vector.

[in] basisZ

Third basis vector.

[in] numProbes

Number of probes placed in the bounding box.

[in] seed

A seed value to ensure consistency between invocations.

Returns

True if the operation succeeded, false if there was not enough memory to satisfy the request or if the bounding box either has zero volume or its basis vectors are not orthogonal.


virtual bool Enlighten::IPrecompInputProbeSet::SetRegularGridProbePositions


public: bool SetRegularGridProbePositions
(
    const Geo::v128 & origin,
    const Geo::v128 & basisX,
    const Geo::v128 & basisY,
    const Geo::v128 & basisZ,
    const Geo::s32 resolutionX,
    const Geo::s32 resolutionY,
    const Geo::s32 resolutionZ
)


Create light probes based on a regular grid.

Previous positions are deleted. The regular grid is defined by a set of orthogonal basis vectors and their origin as well as the resolution in each basis vector direction. The basis vectors are required to be orthogonal and the resolution must be in the range [1..65536] otherwise this function will return false. The lengths of the basis vectors define the size of the regular grid. Based on the resolutions, the regular grid is split up into cells, and at the center of each cell a probe gets placed. This means that a regular grid with a resolution of 1 in each basis vector direction will have its single probe placed in the center of the grid and not


at the basis vector origin.

Parameters
[in] origin

Origin of the basis vectors.

[in] basisX

First basis vector.

[in] basisY

Second basis vector.

[in] basisZ

third basis vector.

[in] resolutionX

Number of probes in the direction of the first basis vector.

[in] resolutionY

Number of probes in the direction of the second basis vector.

[in] resolutionZ

Number of probes in the direction of the third basis vector.

Returns

True if the operation succeeded, false if there was not enough memory to satisfy the request or if the bounding box either has zero volume or its basis vectors are not orthogonal.