XRQuadLayer
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The XRQuadLayer
interface of the WebXR Device API is a layer that takes up a flat rectangular space in the virtual environment. An XRQuadLayer
has no thickness. It is a two-dimensional object positioned and oriented in 3D space. The position of a quad refers to the center of the quad. Only the front of the layer is visible.
XRQuadLayer
requires the layers
feature to be enabled for the XRSession
. You can request it in XRSystem.requestSession()
.
To create a new XRQuadLayer
, call either:
XRWebGLBinding.createQuadLayer()
for a WebGL opaque texture quad layer, orXRMediaBinding.createQuadLayer()
for an HTML<video>
playback quad layer.
To present layers to the XR device, add them to the layers
render state using XRSession.updateRenderState()
.
Properties
Inherits properties from its parent, XRCompositionLayer
.
XRQuadLayer.height
-
Represents the height of the layer in meters.
XRQuadLayer.space
-
An
XRSpace
representing the layer's spatial relationship with the user's physical environment. XRQuadLayer.transform
-
An
XRRigidTransform
representing the offset and orientation relative tospace
. XRQuadLayer.width
-
Represents the width of the layer in meters.
Methods
Inherits methods from its parents, XRCompositionLayer
and EventTarget
.
Events
redraw
-
Sent to the
XRQuadLayer
object when the underlying resources of the layer are lost or when the XR Compositor can no longer reproject the layer. If this event is sent, authors should redraw the content of the layer in the next XR animation frame.
Specifications
No specification found
No specification data found for api.XRQuadLayer
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Browser compatibility
No compatibility data found for api.XRQuadLayer
.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.