C Specification

The XrAmbientLightANDROID structure contains light estimation data about the ambient light in the scene.

// Provided by XR_ANDROID_light_estimation
typedef struct XrAmbientLightANDROID {
    XrStructureType                type;
    void*                          next;
    XrLightEstimateStateANDROID    state;
    XrVector3f                     intensity;
    XrVector3f                     colorCorrection;
} XrAmbientLightANDROID;

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 XrSphericalHarmonicsANDROID and XrDirectionalLightANDROID.

  • state is the XrLightEstimateStateANDROID representing the state of the light estimate.

  • intensity is an XrVector3f representing the intensity of the ambient light. Each component of the vector corresponds to the red, green, and blue channels respectively.

  • colorCorrection is an XrVector3f with values in gamma space. If rendering in gamma color space, multiply them component-wise against the final calculated color after rendering. If rendering in linear space, first convert the values to linear space by rising to the power 2.2, then multiply component-wise against the final calculated color after rendering.

Description

The purpose of colorCorrection is to make a scene appear natural and blend with the real world.

Valid Usage (Implicit)

See Also

XR_ANDROID_light_estimation, XrDirectionalLightANDROID, XrLightEstimateStateANDROID, XrSphericalHarmonicsANDROID, XrStructureType, XrVector3f, xrGetLightEstimateANDROID

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

Copyright 2014-2026 The Khronos Group Inc.

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