DOMPoint: fromPoint() 静态方法

DOMPoint 接口的 fromPoint() 静态方法根据源点创建一个新的可变 DOMPoint 对象并返回该对象。

你也可以使用 DOMPoint() 构造函数创建新的 DOMPoint 对象。

尽管此接口基于 DOMPointReadOnly,但它并非只读;其中的属性可以随时更改。

语法

js
DOMPoint.fromPoint(sourcePoint)

参数

sourcePoint

一个 DOMPointDOMPointReadOnly 实例,或包含以下属性的对象,从中获取新点的属性值

x

一个无限制的浮点值,指示空间中点的 x 坐标。这通常是水平坐标,正值表示向右,负值表示向左。默认值为 0

y

一个无限制的浮点数,提供点的 y 坐标。这是垂直坐标,在没有对坐标系应用任何转换的情况下,正值表示向下,负值表示向上,朝向屏幕顶部。默认值为 0

z

一个无限制的浮点值,提供点的 z 坐标,它(假设没有改变这种情况的转换)是深度坐标;正值表示更靠近用户,负值表示向后缩回屏幕。默认值为 0

w

点的 w 透视值,以无限制的浮点数给出。默认值为 1

返回值

一个新的 DOMPoint 对象,其坐标和透视值与源点中的值相同。点的属性是可变的,可以在任何时间更改。

示例

从只读点创建可变点

如果你有一个 DOMPointReadOnly 对象,你可以轻松地创建一个该点的可变副本

js
const mutablePoint = DOMPoint.fromPoint(readOnlyPoint);

创建二维点

此示例创建一个二维点,指定一个内联对象,其中包括用于 xy 的值。zw 属性可以保留其默认值(分别为 0 和 1)。

js
const center = DOMPoint.fromPoint({ x: 75, y: -50, z: -55, w: 0.25 });

规范

规范
几何接口模块级别 1
# dom-dompoint-frompoint

浏览器兼容性

BCD 表格仅在浏览器中加载