Back to Content

XRSession: preferredReflectionFormat property

files/en-us/web/api/xrsession/preferredreflectionformat/index.md

latest1.2 KB
Original Source

{{APIRef("WebXR Device API")}}{{SeeCompatTable}}{{SecureContext_Header}}

The read-only preferredReflectionFormat property of the {{DOMxRef("XRSession")}} interface returns this session's preferred reflection format used for lighting estimation texture data.

Value

A string representing the reflection format. Possible values:

XRReflectionFormatWebGL FormatWebGL Internal FormatWebGPU FormatHDR
"srgba8"RGBASRGB8_ALPHA8"rgba8unorm-srgb"
"rgba16f"RGBARGBA16F"rgba16float"

Examples

Requesting a light probe with the system's preferred format

You can request a light probe with {{domxref("XRSession.requestLightProbe()")}} and specify the system's preferred format by setting the reflectionFormat option equal to XRSession.preferredReflectionFormat.

js
const lightProbe = await xrSession.requestLightProbe({
  reflectionFormat: xrSession.preferredReflectionFormat,
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("XRSession.requestLightProbe()")}}