Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

DOMPoint

Эта статья нуждается в техническом обзоре. Как вы можете помочь.

Наши волонтёры ещё не перевели данную статью на Русский. Присоединяйтесь к нам и помогите закончить эту работу!

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

A DOMPoint represents a 2D or 3D point in a coordinate system.

In general, a positive x component represents a position right of the origin, a positive y component upwards from the origin, and a positive z component outwards from the screen (in other words, opposite the direction that the user is facing).

It inherits from its parent, DOMPointReadOnly.

Constructor

DOMPoint()
Creates a new DOMPoint object.

Methods

DOMPoint inherits methods from its parent, DOMPointReadOnly.

DOMPointReadOnly.fromPoint
Translates the position/perspective of a DOMPoint to a new position (doesn't appear to be supported anywhere yet.)

Properties

DOMPoint inherits properties from its parent, DOMPointReadOnly.

DOMPointReadOnly.x Read only
The x coordinate of the DOMPoint.
DOMPointReadOnly.y Read only
The y coordinate of the DOMPoint.
DOMPointReadOnly.z Read only
The z coordinate of the DOMPoint.
DOMPointReadOnly.w Read only
The perspective value of the DOMPoint.

Examples

In the WebVR API, DOMPoint values are used to represent points in the coordinate space that the user's head mounted display exists in. In the following snippet, the position of the VR HMD can be retrieved by first grabbing a reference to the position sensor's current state using PositionSensorVRDevice.getState, then accessing the resulting VRPositionState's position property, which returns a DOMPoint. Note below the usage of position.x, position.y, and position.z.

function setView() {
      var posState = gPositionSensor.getState();
      if(posState.hasPosition) {
        posPara.textContent = 'Position: x' + roundToTwo(posState.position.x) + " y"
                                    + roundToTwo(posState.position.y) + " z"
                                    + roundToTwo(posState.position.z);
        xPos = -posState.position.x * WIDTH * 2;
        yPos = posState.position.y * HEIGHT * 2;
        if(-posState.position.z > 0.01) {
          zPos = -posState.position.z;
        } else {
          zPos = 0.01;
        }
      }

  ...

}

Note: See our positionsensorvrdevice demo for the full code.

Specifications

Specification Status Comment
Geometry Interfaces Module Level 1
The definition of 'DOMPoint' in that specification.
Candidate Recommendation Latest spec version is an ED.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support Not supported

 
(Yes)
 
Not supported

Not supported

Not supported
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support Not supported (Yes) Not supported Not supported Not supported Not supported Not supported

See also

Метки документа и участники

 Внесли вклад в эту страницу: rolfedh, Calmbit, chrisdavidmills
 Обновлялась последний раз: rolfedh,