XrSphericalHarmonicsANDROID(3)

C Specification

The XrSphericalHarmonicsANDROID structure contains spherical harmonics representing the lighting of the scene.

// Provided by XR_ANDROID_light_estimation
typedef struct XrSphericalHarmonicsANDROID {
    XrStructureType                    type;
    void*                              next;
    XrLightEstimateStateANDROID        state;
    XrSphericalHarmonicsKindANDROID    kind;
    float                              coefficients[9][3];
} XrSphericalHarmonicsANDROID;

Members

Member Descriptions

type is the XrStructureType of this structure.
next is NULL or a pointer to the next structure in a structure chain. Valid structures include XrAmbientLightANDROID and XrDirectionalLightANDROID.
state is the XrLightEstimateStateANDROID representing the state of the light estimate.
kind is the XrSphericalHarmonicsKindANDROID requested by the application.
coefficients is a two-dimensional float array with dimensions 9 rows and 3 columns. The 3 columns corresponding to color channels red, green and blue respectively. Each channel has 9 spherical harmonic coefficients.

Description

The coefficients are to be used in a special function which takes a direction as an input and outputs the light color coming from that direction. More detail available in R. Ramamoorthi and P. Hanrahan, "An efficient representation for irradiance environment maps," in SIGGRAPH '01: Proceedings of the 28th annual conference on Computer graphics and interactive techniques, ACM, Aug. 2001, pp. 497-500. doi:10.1145/383259.383317.

Valid Usage (Implicit)

The XR_ANDROID_light_estimation extension must be enabled prior to using XrSphericalHarmonicsANDROID
type must be XR_TYPE_SPHERICAL_HARMONICS_ANDROID
next must be NULL or a valid pointer to the next structure in a structure chain
state must be a valid XrLightEstimateStateANDROID value
kind must be a valid XrSphericalHarmonicsKindANDROID value

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

This work is licensed under a Creative Commons Attribution 4.0 International License.

XrSphericalHarmonicsANDROID(3) Manual Page

Name

C Specification

Members

Description

See Also

Document Notes

Copyright