Geometry Interfaces
The DOMPointReadOnly()
constructor returns a new DOMPointReadOnly object representing a point
in 2D or 3D space, optionally with perspective, whose values cannot be altered by
script code.
Syntax
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)
Parameters
x- : The value of the horizontal coordinate, x, as a floating point number. The default value is 0.
y- : The value of the vertical coordinate, y, as a floating point number. The default value is 0.
z- : The value of the depth coordinate, z, as a floating point number. The default value is 0.
w- : The value of the perspective, w, as a floating point number. The default is 1.
[!NOTE] Each of these values is what's called an unrestricted number. In addition to any finite floating-point value, you may use special values such as ±Infinity and NaN.
Return value
A new DOMPointReadOnly object representing the specified location in space.
Examples
The following code demonstrates creating both 2D and 3D points.
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
