大网数据广告活动
Web 标准与前端开发

DOMPointReadOnly: matrixTransform() method

· 52CE 我爱测

The **`matrixTransform()`** method of the DOMPointReadOnly interface applies a matrix transform specified as an object to the DOMPointReadOnly object, creating and returning a new `DOMPointReadOnly` object. Neither the matrix nor the point are altered.

Geometry Interfaces

The matrixTransform() method of the DOMPointReadOnly interface applies a matrix transform specified as an object to the DOMPointReadOnly object, creating and returning a new DOMPointReadOnly object. Neither the matrix nor the point are altered.

If the matrix passed as a parameter is 2D (the DOMMatrixReadOnly.is2D is true) then this is a 2D transformation and the point's z coordinate will be 0 and point's w perspective will be 1. Otherwise this is a 3D transformation.

You can also create a new DOMPoint with a point and matrix with the DOMMatrixReadOnly.transformPoint() method.

Syntax

matrixTransform()
matrixTransform(matrix)

Parameters

  • matrix
    • : A DOMMatrix or DOMMatrixReadOnly object.

Return value

A new DOMPoint object.

Examples

2D transform

In this example, we apply a 2D matrix transform to a DOMPointReadOnly, creating a new DOMPoint:

const originalPoint = new DOMPointReadOnly(10, 20); // DOMPointReadOnly {x: 10, y: 20, z: 0, w: 1}
const matrix = new DOMMatrix([1, 0, 0, 1, 15, 30]);

const transformedPoint = originalPoint.matrixTransform(matrix); // DOMPoint {x: 25, y: 50, z: 0, w: 1}

console.log(transformedPoint.toJSON()); // output: {x: 25, y: 50, z: 0, w: 1}

3D transform

In this example, we apply a 3D matrix transform to a DOMPointReadOnly:

const point = new DOMPointReadOnly(5, 10); // DOMPointReadOnly {x: 5, y: 10, z: 0, w: 1}
const matrix3D = new DOMMatrix().translate(0, 0, 10);
const transformedPoint = point.matrixTransform(matrix3D); // DOMPoint {x: 5, y: 10, z: 10, w: 1}

Specifications

Browser compatibility

See also

  • DOMPoint
  • DOMMatrix
  • DOMMatrixReadOnly.transformPoint()
  • CSS transform-function/matrix and transform-function/matrix3d functions

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。