DOMMatrixReadOnly: метод rotate()

Базовая Широко поддерживается

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с января 2020 года.

Примечание: Эта функция доступна в Web Workers.

Метод rotate() интерфейса DOMMatrixReadOnly возвращает новый объект DOMMatrix, созданный путем поворота исходной матрицы вокруг каждой из ее осей на указанное количество градусов. Исходная матрица не изменяется.

Чтобы изменять матрицу во время поворота, см. DOMMatrix.rotateSelf().

Синтаксис

DOMMatrixReadOnly.rotate()
DOMMatrixReadOnly.rotate(rotX)
DOMMatrixReadOnly.rotate(rotX, rotY)
DOMMatrixReadOnly.rotate(rotX, rotY, rotZ)

Параметры

rotX: Число; координата x вектора, обозначающего ось поворота. Если не равно нулю, is2D имеет значение false.
rotY Необязательно: Число; координата y вектора, обозначающего ось поворота. Если не равно нулю, is2D имеет значение false.
rotZ Необязательно: Число; координата z вектора, обозначающего ось поворота.

Если передан только rotX, то rotX используется как значение для координаты z, а координаты x и y устанавливаются в ноль.

Возвращаемое значение

Объект DOMMatrix.

Примеры

const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString());
// output: "matrix(1, 0, 0, 1, 0, 0)"

const rotated = matrix.rotate(30); // rotation and assignment
console.log(matrix.toString()); // original matrix is unchanged
// output: "matrix(1, 0, 0, 1, 0, 0)"
console.log(rotated.toString());
// output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"

Спецификации

Спецификация
Модуль уровня 1 интерфейсов геометрии # dom-dommatrixreadonly-rotate

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в IOS	Samsung Internet	WebView Android
`rotate`	61	79	33	48	11	61	33	45	11	8.0	61

См. также

DOMMatrix.rotateSelf()
DOMMatrixReadOnly.rotateAxisAngle()
DOMMatrixReadOnly.rotateFromVector()
Свойство CSS transform и функция rotate3d()
Свойство CSS rotate
Модуль CSS transforms
Атрибут SVG transform
CanvasRenderingContext2D интерфейс и метод rotate()

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