XRSession: preferredReflectionFormat property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The read-only preferredReflectionFormat property of the 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

undefined

Requesting a light probe with the system's preferred format

You can request a light probe with 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

See also