DOMMatrixReadOnly: метод scale3d()

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

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

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

Метод scale3d() интерфейса DOMMatrixReadOnly создаёт новую матрицу, являющуюся результатом применения 3D-масштабирования к исходной матрице. Он возвращает новую матрицу DOMMatrix, созданную путём масштабирования исходной 3D-матрицы заданным коэффициентом масштабирования, сосредоточенного в точке начала координат, указанной параметрами origin, по умолчанию (0, 0, 0). Исходная матрица не изменяется.

Чтобы изменить матрицу во время 3D-масштабирования, см. DOMMatrix.scale3dSelf().

Синтаксис

DOMMatrixReadOnly.scale3d();
DOMMatrixReadOnly.scale3d(scale);
DOMMatrixReadOnly.scale3d(scale, originX);
DOMMatrixReadOnly.scale3d(scale, originX, originY);
DOMMatrixReadOnly.scale3d(scale, originX, originY, originZ);

Параметры

scale: Множитель; значение масштабирования. Если масштаб не указан, по умолчанию используется 1.
originX Необязательно: Координата x начала преобразования. Если начало координат не указано, по умолчанию используется 0.
originY Необязательно: Координата y начала преобразования. Если начало координат не указано, по умолчанию используется 0.
originZ Необязательно: Координата z начала преобразования. Если это значение 0, по умолчанию, при отсутствии, полученная матрица может не быть 3D.

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

Матрица DOMMatrix.

Примеры

const matrix = new DOMMatrix();
console.log(matrix.toString()); // no transforms applied
// matrix(1, 0, 0, 1, 0, 0)

console.log(matrix.scale3d(2).toString());
/* matrix3d(
    2, 0, 0, 0, 
    0, 2, 0, 0, 
    0, 0, 2, 0, 
    0, 0, 0, 1) */
console.log(matrix.scale3d(0.5, 25, 25, 1.25).toString());
/* matrix3d(
    0.5, 0, 0, 0, 
    0, 0.5, 0, 0, 
    0, 0, 0.5, 0, 1
    2.5, 12.5, 0.625, 1) */
console.log(matrix.toString()); // original matrix is unchanged
// matrix(1, 0, 0, 1, 0, 0)

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в IOS	Samsung Internet	WebView Android
`scale3d`	61	79	33 Начиная с Firefox 69, первый параметр (`scale`) теперь необязателен со значением по умолчанию 1, в соответствии со спецификацией. Ранее он был обязательным.	48	11	61	33 Начиная с Firefox для Android 79, первый параметр (`scale`) теперь необязателен со значением по умолчанию 1, в соответствии со спецификацией. Ранее он был обязательным.	45	11	8.0	61

См. также

DOMMatrix.scale3dSelf()
DOMMatrixReadOnly.scale()
Свойство CSS transform и функции scale3d() и matrix3d()
Модуль CSS-преобразований
Атрибут SVG transform
CanvasRenderingContext2D интерфейса CanvasRenderingContext2D.transform() метода

© 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/scale3d