W3cubDocs

VRFieldOfView

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Avoid using it and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The VRFieldOfView interface of the WebVR API represents a field of view defined by 4 different degree values describing the view from a center point.

Properties

VRFieldOfView.upDegrees Read only: The number of degrees upwards that the field of view extends in.
VRFieldOfView.rightDegrees Read only: The number of degrees to the right that the field of view extends in.
VRFieldOfView.downDegrees Read only: The number of degrees downwards that the field of view extends in.
VRFieldOfView.leftDegrees Read only: The number of degrees to the left that the field of view extends in.

Examples

var info = document.querySelector('p');
var list = document.querySelector('ul');
var vrDisplay;

if(navigator.getVRDisplays) {
    reportFieldOfView();
} else {
  info.textContent = 'WebVR API not supported by this browser.'
}

function reportFieldOfView() {
  navigator.getVRDisplays().then(function(displays) {
    vrDisplay = displays[0];
    var lEye = vrDisplay.getEyeParameters('left');
    var rEye = vrDisplay.getEyeParameters('right');
    // lEye and rEye are VREyeParameters objects

    var lFOV = lEye.fieldOfView;
    var rFOV = rEye.fieldOfView;
    // lFOV and rFOV are VRFieldOfView objects

    var listitem1 = document.createElement('li');
    var listitem2 = document.createElement('li');

    listitem1.innerHTML = '<strong>Left eye parameters</strong>'
                 + '<br>Offset: ' + lEye.offset
                 + '<br>Render width: ' + lEye.renderWidth
                 + '<br>Render height: ' + lEye.renderHeight
                 + '<br>Up degrees: ' + lFOV.upDegrees
                 + '<br>Right degrees: ' + lFOV.rightDegrees
                 + '<br>Down degrees: ' + lFOV.downDegrees
                 + '<br>Left degrees: ' + lFOV.leftDegrees

   listitem2.innerHTML = '<strong>Right eye parameters</strong>'
                + '<br>Offset: ' + rEye.offset
                + '<br>Render width: ' + rEye.renderWidth
                + '<br>Render height: ' + rEye.renderHeight
                + '<br>Up degrees: ' + rFOV.upDegrees
                + '<br>Right degrees: ' + rFOV.rightDegrees
                + '<br>Down degrees: ' + rFOV.downDegrees
                + '<br>Left degrees: ' + rFOV.leftDegrees

    list.appendChild(listitem1);
    list.appendChild(listitem2);
  });
}

Specifications

Specification	Status	Comment
WebVR 1.1 The definition of 'VRFieldOfView' in that specification.	Draft	Initial definition

Browser compatibilityUpdate compatibility data on GitHub

	Desktop
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic support	No	Yes	55 55 Windows support was enabled in Firefox 55. 63 macOS support was enabled in Firefox 63.	No	?	?
`VRFieldOfView()` constructor	No	No	No	No	?	?
`downDegrees`	No	15	55 55 Windows support was enabled in Firefox 55. 63 macOS support was enabled in Firefox 63.	No	?	?
`leftDegrees`	No	15	55 55 Windows support was enabled in Firefox 55. 63 macOS support was enabled in Firefox 63.	No	?	?
`rightDegrees`	No	15	55 55 Windows support was enabled in Firefox 55. 63 macOS support was enabled in Firefox 63.	No	?	?
`upDegrees`	No	15	55 55 Windows support was enabled in Firefox 55. 63 macOS support was enabled in Firefox 63.	No	?	?

	Mobile
	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	iOS Safari	Samsung Internet
Basic support	No	56 Disabled 56 Disabled Only works in an experimental version of Chrome. (Other builds won't return any devices when `Navigator.getVRDisplays()` is invoked.) Daydream View supported in Chrome 56. Google Cardboard supported in Chrome 57. Disabled From version 56: this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	?	?	?	?	6.0
`VRFieldOfView()` constructor	No	No	No	?	?	?	No
`downDegrees`	No	56 Disabled 56 Disabled Only works in an experimental version of Chrome. (Other builds won't return any devices when `Navigator.getVRDisplays()` is invoked.) Daydream View supported in Chrome 56. Google Cardboard supported in Chrome 57. Disabled From version 56: this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	?	?	?	?	6.0
`leftDegrees`	No	56 Disabled 56 Disabled Only works in an experimental version of Chrome. (Other builds won't return any devices when `Navigator.getVRDisplays()` is invoked.) Daydream View supported in Chrome 56. Google Cardboard supported in Chrome 57. Disabled From version 56: this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	?	?	?	?	6.0
`rightDegrees`	No	56 Disabled 56 Disabled Only works in an experimental version of Chrome. (Other builds won't return any devices when `Navigator.getVRDisplays()` is invoked.) Daydream View supported in Chrome 56. Google Cardboard supported in Chrome 57. Disabled From version 56: this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	?	?	?	?	6.0
`upDegrees`	No	56 Disabled 56 Disabled Only works in an experimental version of Chrome. (Other builds won't return any devices when `Navigator.getVRDisplays()` is invoked.) Daydream View supported in Chrome 56. Google Cardboard supported in Chrome 57. Disabled From version 56: this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	?	?	?	?	6.0

VRFieldOfView

Properties

Examples

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also