XRCylinderLayer: redraw event

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

The redraw event is 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.

See also the {{domxref("XRCompositionLayer.needsRedraw")}} property which is also available to XRCylinderLayer objects through inheritance from {{domxref("XRCompositionLayer")}}.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

addEventListener("redraw", (event) => { })

onredraw = (event) => { }

Event type

An {{domxref("XRLayerEvent")}}. Inherits from {{domxref("Event")}}.

Event properties

In addition to the properties listed below, properties from the parent interface, {{domxref("Event")}}, are available.

• {{domxref("XRLayerEvent.layer", "layer")}} {{ReadOnlyInline}}
  • : The {{domxref("XRLayer")}} which generated the event.

Examples

Using the redraw event

You can pass redraw to {{domxref("EventTarget.addEventListener()", "addEventListener()")}}:

cylinderLayer.addEventListener("redraw", (event) => {
  // redraw the layer
});

Alternatively, you can use the onredraw event handler property to establish a handler for the redraw event:

cylinderLayer.onredraw = (event) => {
  // redraw the layer
};

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("XRCompositionLayer.needsRedraw")}}