大网数据广告活动
Web 标准与前端开发

DOMPoint

· 52CE 我爱测

`DOMPoint`** 对象表示坐标系统中的一个二维或三维点;它包含最多三个维度的坐标值以及一个可选的透视值。`DOMPoint` 基于 DOMPointReadOnly,但允许修改其属性的值。

Geometry Interfaces

DOMPoint 对象表示坐标系统中的一个二维或三维点;它包含最多三个维度的坐标值以及一个可选的透视值。DOMPoint 基于 DOMPointReadOnly,但允许修改其属性的值。

一般而言,x 的正值表示位于原点右侧的位置,y 的正值表示位于原点下方,而 z 的正值表示从屏幕向外(即朝向用户)的方向。

构造函数

  • DOMPoint.DOMPoint
    • : 根据零个或多个坐标分量值(以及可选的透视值 w)创建并返回一个新的 DOMPoint 对象。你也可以通过调用 DOMPoint.fromPoint_static 静态方法,使用现有的 DOMPoint、DOMPointReadOnly 或具有相同属性的对象来创建一个新的点。

实例属性

DOMPoint 还继承父接口 DOMPointReadOnly 的属性。

  • DOMPoint.x
    • : DOMPoint 的 x 坐标。
  • DOMPoint.y
    • : DOMPoint 的 y 坐标。
  • DOMPoint.z
    • : DOMPoint 的 z 坐标。
  • DOMPoint.w
    • : DOMPoint 的透视值。

实例方法

DOMPoint 继承父接口 DOMPointReadOnly 的实例方法。

静态方法

DOMPoint 还可能继承父接口 DOMPointReadOnly 的静态方法。

  • DOMPoint/fromPoint_static
    • : 根据一个已有的点(或包含相应属性的对象)创建一个新的可变 DOMPoint 对象,并使用该点的属性值进行初始化。

示例

在 WebXR 设备 API 中,DOMPointReadOnly 值用于表示位置和方向。在以下代码片段中,可以在 XRSession 的动画帧回调中,通过调用 XRFrame.getViewerPose() 来获取 XR 设备(例如 VR 头显或具备 AR 功能的手机)的姿态。返回的 XRPose 对象的 XRPose.transform 属性包含两个 DOMPointReadOnly 类型的属性:XRRigidTransform.position(表示位置向量)和 XRRigidTransform.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 视图位置:{x: ${roundToTwo(position.x)}, y: ${roundToTwo(
        position.y,
      )}, z: ${roundToTwo(position.z)}}`,
    );

    console.log(
      `XR 视图方向:{x: ${roundToTwo(orientation.x)}, y: ${roundToTwo(
        orientation.y,
      )}, z: ${roundToTwo(orientation.z)}, w: ${roundToTwo(orientation.w)}}`,
    );
  }
}

规范

浏览器兼容性

参见

  • DOMRect
  • DOMMatrix

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。