Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

DOMPoint

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨janvier 2020⁩.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

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

Voir aussi