DOMMatrix: метод scale3dSelf()

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

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

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

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

Для 3D-масштабирования матрицы без её изменения используйте DOMMatrixReadOnly.scale3d(), который создаёт новую масштабированную матрицу, не изменяя исходную.

Синтаксис

Метод scale3dSelf() задаётся нулём до четырёх значений.

DOMMatrix.scale3dSelf();
DOMMatrix.scale3dSelf(scale);
DOMMatrix.scale3dSelf(scale, originX);
DOMMatrix.scale3dSelf(scale, originX, originY);
DOMMatrix.scale3dSelf(scale, originX, originY, originZ);

Параметры

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

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

Возвращает себя; объект DOMMatrix.

Примеры

const matrix = new DOMMatrix();
console.log(matrix.scale3dSelf(2).toString());
/* matrix3d(
    2, 0, 0, 0, 
    0, 2, 0, 0, 
    0, 0, 2, 0, 
    0, 0, 0, 1) */
console.log(matrix.scale3dSelf(3.1, 25, 25, 1.25).toString());
/* matrix3d(
    6.2, 0, 0, 0,
    0, 6.2, 0, 0, 
    0, 0, 6.2, 0, 
    -105, -105, -5.25, 1) */
console.log(matrix.toString());
/* matrix3d(
    6.2, 0, 0, 0, 
    0, 6.2, 0, 0, 
    0, 0, 6.2, 0, 
    -105, -105, -5.25, 1) (same as above) */

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

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

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

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

См. также

DOMMatrixReadOnly.scale3d()
DOMMatrix.scaleSelf()
Свойство CSS transform и функции scale3d() и matrix3d()
Модуль CSS-преобразований
Атрибут SVG transform
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/DOMMatrix/scale3dSelf