XRSession.preferredReflectionFormat

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:

XRReflectionFormat	WebGL Format	WebGL Internal Format	WebGPU Format	HDR
"srgba8"	RGBA	SRGB8_ALPHA8	"rgba8unorm-srgb"
"rgba16f"	RGBA	RGBA16F	"rgba16float"	✓

Examples

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.

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

Specifications

Specification
WebXR Lighting Estimation API Level 1 (WebXR Lighting Estimation API 1) # dom-xrsession-preferredreflectionformat

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`preferredReflectionFormat`	90	90	No	No	No	No	No	90	No	No	No	No