XRCylinderLayer

Secure contextLimited availability

The XRCylinderLayer interface of the WebXR Device API is a layer that takes up a curved rectangular space in the virtual environment. Only the front of the layer is visible.

XRCylinderLayer requires the layers feature to be enabled for the XRSession. You can request it in requestSession().

To create a new XRCylinderLayer, call either:

• createCylinderLayer() for a WebGL opaque texture layer, or
• createCylinderLayer() for an HTML <video> playback layer.

To present layers to the XR device, add them to the layers render state using updateRenderState().

Instance properties

Inherits properties from its parent, XRCompositionLayer.

• aspectRatio Experimental
  • : A number indicating the ratio of the visible cylinder section. It is the ratio of the width of the visible section of the cylinder divided by its height. The width is calculated by multiplying the radius with the centralAngle.
• centralAngle Experimental
  • : A number indicating the angle in radians of the visible section of the cylinder.
• radius Experimental
  • : A number indicating the radius of the cylinder.
• space Experimental
  • : An XRSpace representing the layer’s spatial relationship with the user’s physical environment.
• transform Experimental
  • : An XRRigidTransform representing the offset and orientation relative to space.

Instance methods

Inherits methods from its parents, XRCompositionLayer and EventTarget.

Events

• redraw Experimental
  • : Sent to the XRCylinderLayer 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

Browser compatibility

See also

• XRLayer
• EventTarget
• XRCompositionLayer
• XREquirectLayer
• XRCubeLayer
• XRQuadLayer
• XRProjectionLayer