Spec-Zone.ru › Web APIs

DOMPoint

Базовая поддержка Широко распространена

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках выполнения Web Workers.

Объект DOMPoint представляет собой 2D или 3D точку в системе координат; он включает значения координат вплоть до трёх измерений, а также необязательное значение перспективы. DOMPoint основан на DOMPointReadOnly, но позволяет изменять значения его свойств.

В общем случае положительное значение x компоненты означает позицию справа от начала координат, положительное значение y компоненты означает позицию ниже начала координат, а положительное значение z компоненты означает позицию, направленную наружу от экрана (другими словами, в сторону пользователя).

DOMPointReadOnly DOMPoint

Конструктор

DOMPoint()

Создаёт и возвращает новый объект DOMPoint с заданными значениями нуля или более координатных компонентов и, необязательно, значением перспективы w. Также можно использовать существующий объект DOMPoint или DOMPointReadOnly, чтобы создать новую точку, вызвав статический метод DOMPoint.fromPoint().

Свойства экземпляра

DOMPoint может также унаследовать свойства от своего родителя, DOMPointReadOnly.

DOMPoint.x

Координата x точки DOMPoint.

DOMPoint.y

Координата y точки DOMPoint.

DOMPoint.z

Координата z точки DOMPoint.

DOMPoint.w

Значение перспективы для точки DOMPoint.

Методы экземпляра

DOMPoint наследует методы экземпляра от своего родителя, DOMPointReadOnly.

Статические методы

DOMPoint может также унаследовать статические методы от своего родителя, DOMPointReadOnly.

DOMPoint.fromPoint()

Создаёт новый изменяемый объект DOMPoint на основе существующей точки (или объекта, содержащего соответствующие свойства), предоставляя значения для его свойств.

Примеры

В API устройств WebXR значения DOMPointReadOnly представляют собой координаты и ориентации. В следующем фрагменте положение устройства XR (например, VR-шлема или телефона с AR-возможностями) можно получить, вызвав XRFrame.getViewerPose() во время кадра анимации XRSession, а затем обратившись к свойству XRPose's transform, которое содержит два атрибута DOMPointReadOnly: position в качестве вектора и orientation в качестве кватерниона.

function onXRFrame(time, xrFrame) {
  let viewerPose = xrFrame.getViewerPose(xrReferenceSpace);

  if (viewerPose) {
    let position = viewerPose.transform.position;
    let orientation = viewerPose.transform.orientation;

    console.log(
      `XR Viewer Position: {x: ${roundToTwo(position.x)}, y: ${roundToTwo(
        position.y,
      )}, z: ${roundToTwo(position.z)}`,
    );

    console.log(
      `XR Viewer Orientation: {x: ${roundToTwo(orientation.x)}, y: ${roundToTwo(
        orientation.y,
      )}, z: ${roundToTwo(orientation.z)}, w: ${roundToTwo(orientation.w)}`,
    );
  }
}

Спецификации

Спецификация
Модуль интерфейсов Geometry Уровень 1
# DOMPoint

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
DOMPoint 61 79 31 48 10.1 61 31 45 10.3 8.0 61
DOMPoint 61 79 31 48 10.1 61 31 45 10.3 8.0 61
fromPoint_static 61 79 62 48 10.1 61 62 45 10.3 8.0 61
w 61 79 31 48 10.1 61 31 45 10.3 8.0 61
worker_support 61 79 69 48 10.1 61 79 45 10.3 8.0 61
x 61 79 31 48 10.1 61 31 45 10.3 8.0 61
y 61 79 31 48 10.1 61 31 45 10.3 8.0 61
z 61 79 31 48 10.1 61 31 45 10.3 8.0 61

См. также

  • DOMRect
  • DOMMatrix

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMPoint

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API