DOMMatrixReadOnly: метод rotateFromVector()

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

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

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

Метод rotateFromVector() интерфейса DOMMatrixReadOnly возвращает новый объект DOMMatrix, созданный путём поворота исходной матрицы на угол между указанным вектором и (1, 0). Угол поворота определяется углом между вектором (1,0)T и (x,y)T по часовой стрелке, или (+/-)arctan(y/x). Если x и y оба 0, угол задаётся как 0. Исходная матрица не изменяется.

Для изменения матрицы при повороте на угол между указанным вектором и (1, 0), см. DOMMatrix.rotateFromVectorSelf().

Синтаксис

DOMMatrixReadOnly.rotateFromVector()
DOMMatrixReadOnly.rotateFromVector(rotX)
DOMMatrixReadOnly.rotateFromVector(rotX, rotY)

Параметры

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

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

Объект DOMMatrix.

Примеры

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

console.log(matrix.rotateFromVector().toString()); // defaults to `0`
// output: matrix(1, 0, 0, 1, 0, 0)

console.log(matrix.rotateFromVector(10, 20).toString());
// matrix(0.447, 0.894, -0.894, 0.447, 0, 0)

console.log(matrix.rotateFromVector(-5, 5).toString());
// matrix(-0.707, 0.707, -0.707, -0.707, 0, 0)

console.log(matrix.toString()); // matrix remains unchanged
// output: "matrix(1, 0, 0, 1, 0, 0)"

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

Спецификация
Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-rotatefromvector

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

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

См. также

DOMMatrix.rotateFromVectorSelf()
DOMMatrixReadOnly.rotate()
DOMMatrixReadOnly.rotateAxisAngle()
Свойство 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/rotateFromVector