DOMPoint

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Un DOMPoint représente un point 2D ou 3D dans le système de coordonnées.

En général, un x positif représente une position à droite de l'origine ; un y positif est une position au-dessus de l'origine ; et un z positif est une position vers l'extérieur de l'écran (autrement dit, opposée à la direction de l'utilisateur).

Il hérite de son parent DOMPointReadOnly.

Constructeur

DOMPoint()

Crée un nouvel objet DOMPoint.

Méthodes

DOMPoint hérite des méthodes de son parent DOMPointReadOnly.

DOMPointReadOnly.fromPoint

Traduit la position/perspective d'un DOMPoint à une nouvelle position (ne semble pas encore être pris en charge).

Propriétés

DOMPoint hérite des propriétés de son parent DOMPointReadOnly.

DOMPointReadOnly.x

La coordonnée x du DOMPoint.

DOMPointReadOnly.y

La coordonnée y du DOMPoint.

DOMPointReadOnly.z

La coordonnée z du DOMPoint.

DOMPointReadOnly.w

La valeur de perspective du DOMPoint.

Exemples

Dans l' API WebVR (VR = réalité virtuelle), les valeurs DOMPoint sont utilisées pour représenter les points dans l'espace de coordonnées dans lequel l'affichage monté sur la tête de l'utilisateur existe. Dans l'extrait suivant, la position du VR HMD peut être récupérée en saisissant d'abord une référence à l'état actuel du capteur de position avec PositionSensorVRDevice.getState, puis en accédant au résultat de la position de la propriété VRPositionState, qui renvoie un DOMPoint. Notez ci-dessous l'utilisation de position.x, position.y et position.z.

js
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 : Voir notre positionsensorvrdevice demo pour le code complet.

Spécifications

Specification
Geometry Interfaces Module Level 1
# DOMPoint

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi