DOMPointReadOnly: метод fromPoint() статический

Статический метод DOMPointReadOnly fromPoint() создает и возвращает новый объект DOMPointReadOnly на основе исходной точки.

Вы также можете создать новый объект DOMPointReadOnly с помощью конструктора DOMPointReadOnly().

sourcePoint

Экземпляр DOMPoint или DOMPointReadOnly, или объект, содержащий следующие свойства, из которых будут взяты значения свойств новой точки:

x

Значение с плавающей точкой без ограничений, обозначающее координату x точки в пространстве. Обычно это горизонтальная координата, положительные значения — справа, отрицательные — слева. Значение по умолчанию — 0.

y

Число с плавающей точкой без ограничений, определяющее координату y точки. Это вертикальная координата, и, за исключением преобразований, примененных к системе координат, положительные значения направлены вниз, отрицательные — вверх к верху экрана. Значение по умолчанию — 0.

z

Значение с плавающей точкой без ограничений, которое задает координату z точки, которая (при отсутствии преобразований, изменяющих ситуацию) является координатой глубины; положительные значения ближе к пользователю, а отрицательные удаляются от экрана. Значение по умолчанию — 0.

w

Значение перспективы точки, заданное как число с плавающей точкой без ограничений. Значение по умолчанию — 1.

Новый объект DOMPointReadOnly (который идентичен исходной точке).

В этом примере создается 2D точка, задавая встроенный объект, включающий значения для x и y. Свойства z и w могут сохранить свои значения по умолчанию (0 и 1 соответственно).

const point2D = DOMPointReadOnly.fromPoint({ x: 25, y: 25 });

В этом примере создается точка, origPoint, типа DOMPoint, с использованием DOMPoint(). Затем эта точка используется в качестве входных данных для fromPoint() для создания новой точки, newPoint.

const origPoint = new DOMPoint(25, 25, 100, 0.5);

const newPoint = DOMPointReadOnly.fromPoint(origPoint);