DOMMatrixReadOnly: метод rotateAxisAngle()

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

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

Примечание: Эта функция доступна в Веб-воркерах.

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

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

Синтаксис

DOMMatrixReadOnly.rotateAxisAngle()
DOMMatrixReadOnly.rotateAxisAngle(rotX)
DOMMatrixReadOnly.rotateAxisAngle(rotX, rotY)
DOMMatrixReadOnly.rotateAxisAngle(rotX, rotY, rotZ)
DOMMatrixReadOnly.rotateAxisAngle(rotX, rotY, rotZ, angle)

Параметры

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

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

Объект DOMMatrix.

Примеры

const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.rotateAxisAngle().toString()); // matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.rotateAxisAngle(10, 20, 30).toString()); // matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.rotateAxisAngle(10, 20, 30, 45).toString());
/* matrix3d(
    0.728, 0.609, -0.315, 0, 
    -0.525, 0.791, 0.315, 0, 
    0.441, -0.063, 0.895, 
    0, 0, 0, 0, 1) */
console.log(matrix.rotateAxisAngle(5, 5, 5, -45).toString());
/* matrix3d(
    0.805, -0.311, 0.506, 0, 
    0.506, 0.805, -0.311, 0, 
    -0.311, 0.506, 0.805, 0, 
    0, 0, 0, 1) */
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)" (unchanged)

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

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

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

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

См. также

DOMMatrix.rotateAxisAngleSelf()
DOMMatrixReadOnly.rotate()
DOMMatrixReadOnly.rotateFromVector()
Свойство CSS transform и функция rotate3d()
Свойство CSS rotate
Модуль CSS-преобразований
Атрибут 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/rotateAxisAngle