W3cubDocs

/Web APIs

DOMPointReadOnly

The DOMPointReadOnly interface specifies the coordinate and perspective fields used by DOMPoint to define a 2D or 3D point in a coordinate system.

Note: This feature is available in Web Workers

There are two ways to create a new DOMPointReadOnly instance. First, you can use its constructor, passing in the values of the parameters for each dimension and, optionally, the perspective:

js

/* 2D */
const point2D = new DOMPointReadOnly(50, 50);

/* 3D */
const point3D = new DOMPointReadOnly(50, 50, 25);

/* 3D with perspective */
const point3DPerspective = new DOMPointReadOnly(100, 100, 100, 1.0);

The other option is to use the static DOMPointReadOnly.fromPoint() method:

js

const point = DOMPointReadOnly.fromPoint({ x: 100, y: 100, z: 50, w: 1.0 });

Constructor

DOMPointReadOnly()

Creates a new DOMPointReadOnly object given the values of its coordinates and perspective. To create a point using an object, you can instead use DOMPointReadOnly.fromPoint().

Instance properties

DOMPointReadOnly.x Read only

The point's horizontal coordinate, x.

DOMPointReadOnly.y Read only

The point's vertical coordinate, y.

DOMPointReadOnly.z Read only

The point's depth coordinate, z.

DOMPointReadOnly.w Read only

The point's perspective value, w.

Static methods

DOMPointReadOnly.fromPoint()

A static method that creates a new DOMPointReadOnly object given the coordinates provided in the specified object.

Instance methods

matrixTransform()

Applies a matrix transform specified as an object to the DOMPointReadOnly object.

toJSON()

Returns a JSON representation of the DOMPointReadOnly object.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
DOMPointReadOnly 61 79 62 No 48 10.1 61 61 62 45 10.3 8.0
DOMPointReadOnly 61 79 31 No 48 10.1 61 61 31 45 10.3 8.0
fromPoint_static 61 79 62 No 48 10.1 61 61 62 45 10.3 8.0
matrixTransform 61 79 69 No 48 11 61 61 79 45 11 8.0
toJSON 61 79 62 No 48 10.1 61 61 62 45 10.3 8.0
w 61 79 31 No 48 10.1 61 61 31 45 10.3 8.0
worker_support 61 79 69 No 48 10.1 61 61 79 45 10.3 8.0
x 61 79 31 No 48 10.1 61 61 31 45 10.3 8.0
y 61 79 31 No 48 10.1 61 61 31 45 10.3 8.0
z 61 79 31 No 48 10.1 61 61 31 45 10.3 8.0

See also

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