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

static IPrecompInputProbeSet* Enlighten::IPrecompInputProbeSet::Create

---

public: IPrecompInputProbeSet * Create()

---

Create a new empty IPrecompInputProbeSet.

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

---

public: bool SetOctreeProbePositions
(
    const IPrecompOutputProbeOctree & tree,
    Geo::s32 subset
)

---

Create light probes based on an octree.

Previous positions are deleted. The octree may be obtained by running the CreateOutputProbeOctree task.

Parameters

Returns

True if the operation succeeded, false if there was not enough memory to satisfy the request or if the specified subset index was not valid.

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

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

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

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.