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。离线整理了版式、链接和媒体显示。
