VRDisplayCapabilities.maxLayers

The maxLayers read-only property of the VRDisplayCapabilities interface returns a number indicating the maximum number of VRLayers that the VR display can present at once (e.g. the maximum length of the array that Display.requestPresent() can accept.)

Syntax

var maximumLayers = vrDisplayCapabilitiesInstance.maxLayers;

Value

A number, which must be 1 if VRDisplayCapabilities.canPresent is true, or 0 otherwise.

Examples

function reportDisplays() {
  navigator.getVRDisplays().then(function(displays) {
    for(var i = 0; i < displays.length; i++) {
      var cap = displays[i].capabilities;
      // cap is a VRDisplayCapabilities object
      var listItem = document.createElement('li');
      listItem.innerHTML = '<strong>Display ' + (i+1) + '</strong>'
                   + '<br>VR Display ID: ' + displays[i].displayId
                   + '<br>VR Display Name: ' + displays[i].displayName
                   + '<br>Display can present content: ' + cap.canPresent
                   + '<br>Display is separate from the computer\'s main display: ' + cap.hasExternalDisplay
                   + '<br>Display can return position info: ' + cap.hasPosition
                   + '<br>Display can return orientation info: ' + cap.hasOrientation
                   + '<br>Display max layers: ' + cap.maxLayers;
      list.appendChild(listItem);
    }
  });
}

Specifications

Browser compatibility

See also

• WebVR API homepage
• MozVr.com — demos, downloads, and other resources from the Mozilla VR team.