WebXR Device API
The XRVisibilityMaskChangeEvent of the WebXR Device API describes the portion of an XRView visible to the user after the view has changed, for example by specifying the eye that the view is relevant to, and the vertices of a visibility mask that defines the visible part of the view. This enables performance improvements by allowing the browser to draw only the visible part of the updated view.
An XRVisibilityMaskChangeEvent object is made available as the event object of a XRSession.visibilitymaskchange_event event, fired each time the portion of the view displayed to the user changes to provide new information to update the view.
Constructor
- XRVisibilityMaskChangeEvent.XRVisibilityMaskChangeEvent
- : Creates and returns a new
XRVisibilityMaskChangeEventobject.
- : Creates and returns a new
Instance properties
In addition to properties inherited from its parent interface, Event, XRVisibilityMaskChangeEvent provides the following:
- XRVisibilityMaskChangeEvent.eye
- : The eye the mask applies to.
- XRVisibilityMaskChangeEvent.index
- : The index of the current XRView in the XRViewerPose.views array.
- XRVisibilityMaskChangeEvent.indices
- : Specifies the index position of each coordinate pair (not individual array index) inside the
verticesarray that define the triangles used to draw the currently visible part of the scene displayed in the XRView.
- : Specifies the index position of each coordinate pair (not individual array index) inside the
- XRVisibilityMaskChangeEvent.session
- : The XRSession to which the event belongs.
- XRVisibilityMaskChangeEvent.vertices
- : An array representing the set of possible coordinate values that may be used in a visibility mask. If this array is empty, the whole region of the
XRViewwill be drawn.
- : An array representing the set of possible coordinate values that may be used in a visibility mask. If this array is empty, the whole region of the
Instance methods
While XRSessionEvent defines no methods, it inherits methods from its parent interface, Event.
Examples
Three.js example
This snippet shows how visibilitymaskchange might be used to draw only the visible portion of the XRView in a Three.js application. The new view must be drawn using the XRView.projectionMatrix of the relevant XRView and a default XRRigidTransform.
session.addEventListener("visibilitymaskchange", onVisibilityMaskChange);
function onVisibilityMaskChange(event) {
const geometry = new BufferGeometry();
geometry.setIndex(new BufferAttribute(event.indices, 1));
const vertices = new Float32Array((event.vertices.length / 2) * 3);
let x = 0,
y = 0;
while (x < event.vertices.length) {
vertices[y++] = event.vertices[x++];
vertices[y++] = event.vertices[x++];
vertices[y++] = -1;
}
geometry.setAttribute("position", new BufferAttribute(vertices, 3));
const mask = event.eye === "left" ? leftEyeMask : rightEyeMask;
const matrix = cameras[event.eye === "left" ? 0 : 1].projectionMatrix;
mask.geometry = geometry;
mask.material = new ShaderMaterial({
vertexShader: _visibility_mask_vertex,
fragmentShader: _visibility_mask_fragment,
uniforms: {
clipMatrix: { value: matrix },
},
});
maskScene = new Scene();
maskScene.add(leftEyeMask);
maskScene.add(rightEyeMask);
}
The code snippet is taken from this fork of WebXRManager.js.
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
