module Interpolation

Classes and functions for interpolating light probe data.

Classes

Functions

bool GEO_CALL Enlighten::DoProbeInterpolationTask

---

public: bool GEO_CALL DoProbeInterpolationTask
(
    const Enlighten::ProbeInterpolationTask * task,
    Geo::u32 & timeUs
)

---

Performs an interpolation of SH coefficients for a given set of points in space and probe sets.

All parameters must point to valid non-null objects.

Parameters

Returns

TRUE if the interpolation is successful.

bool GEO_CALL Enlighten::GetProbeInterpolants

---

public: bool GEO_CALL GetProbeInterpolants
(
    Geo::v128 point,
    const InterpolationInputSet * inputSet,
    ProbeInterpolant * interpolants,
    Geo::s32 numMaxInterpolants,
    Geo::s32 & numUsedInterpolants,
    Geo::u32 lod
)

---

Retrieves the probes interpolants for a given point for a single probe set.

The output of this function is provided in an array of interpolants and by the number of valid entries in this arrays. The pointers to the output array has to be provided as input as well as its allocated size. The recommended number of interpolants is eight. If you experience discontinuities in the interpolation you can increase this size. However, eight is completely sufficient for the majority of cases. For regular grids, eight is also the minimum size.

For probe sets that are regular grids this function performs a fast trilinear interpolation. The order of probes as they get referenced by the indices in the output for regular grids is implicitly defined by the resolution in each dimension. The algorithm assumes an order similar to [x=3 y=2 z=2] -> {000,100,200,010,110,210,001,101,201,011,111,211}. The array with probe positions is ignored entirely in this case, and its input can be a NULL pointer.

For probe sets that are not

---

regular grids this function computes the distance to all probes in the probe set and picks the closest ones combined with a smooth interpolation kernel to generate the output weights. This can be a costly operation especially for large probe sets. The order of probes is explicitly given by the array of positions which has to be specified in this case. The length of this array has to not be smaller than the number of probes in the probe set.

The output interpolants are sorted by their weight from highest to lowest.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.

bool GEO_CALL Enlighten::GetProbeInterpolants

---

public: bool GEO_CALL GetProbeInterpolants
(
    Geo::v128 point,
    const InterpolationInputSet * inputSets,
    Geo::s32 numInputSets,
    ProbeInterpolant * interpolants,
    Geo::s32 numMaxInterpolants,
    Geo::s32 & numUsedInterpolants,
    Geo::u32 lod
)

---

Retrieves the probes interpolants for a given point for multiple probe set.

This function has the same properties as its variant for a single input probe set. The only addition is that the computation only uses the up to eight best probe sets, and then within each probe set up to eight probes as interpolants.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.

bool GEO_CALL Enlighten::GetProbeInterpolantsUnchecked

---

public: bool GEO_CALL GetProbeInterpolantsUnchecked
(
    Geo::v128 point,
    const InterpolationInputSet * inputSets,
    Geo::s32 numInputSets,
    ProbeInterpolant * interpolants,
    Geo::s32 numMaxInterpolants,
    Geo::s32 & numUsedInterpolants,
    Geo::u32 lod
)

---

Retrieves the probes interpolants for a given point for multiple probe set, without performing any kind of validation on the input arguments.

This function has the same properties as its checked variant, noting no validation on the inputs is performed.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.

bool GEO_CALL Enlighten::GetProbeSetInterpolants

---

public: bool GEO_CALL GetProbeSetInterpolants
(
    Geo::v128 point,
    const InterpolationInputSet * inputSets,
    Geo::s32 numInputSets,
    ProbeInterpolant * interpolants,
    Geo::s32 numMaxInterpolants,
    Geo::s32 & numUsedInterpolants
)

---

Retrieves the probe set interpolants for a given point.

Note that this function creates an interpolant for a probe set and not for an individual probe.

This function has the same properties as its variant for probes with a single input probe set.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.

bool GEO_CALL Enlighten::GetProbeShCoefficients

---

public: bool GEO_CALL GetProbeShCoefficients
(
    Geo::v128 point,
    const InterpolationInputSet * inputSet,
    float * r,
    float * g,
    float * b,
    eSHOrder shOrder
)

---

Retrieves the interpolated light probe spherical harmonics coefficients for a point based on a single input probe set.

The interpolated coefficients get stored independently for each RGB channel in buffers that have to be provided to this function and which must be large enough to accommodate the coefficients that get generated. The number of generated coefficients depends on the requested SH order (L0, L1, L2), but also on the SH order of the probe set retrieved from the probe set metadata.

A fixed maximum of eight probes as interpolants is used in the computation.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.

bool GEO_CALL Enlighten::GetProbeShCoefficients

---

public: bool GEO_CALL GetProbeShCoefficients
(
    Geo::v128 point,
    const InterpolationInputSet * inputSets,
    Geo::s32 numInputSets,
    float * r,
    float * g,
    float * b,
    eSHOrder shOrder
)

---

Retrieves the interpolated light probe spherical harmonics coefficients for a point based on multiple input probe sets.

This function has the same properties as its variant for a single input probe set. The only addition is that the computation only uses the up to eight best probe sets, and then within each probe set up to eight probes as interpolants.

Parameters

Returns

TRUE if the input to this function is valid and the interpolation is successful, otherwise FALSE.