API модуля Geometry Interfaces
интерфейс DOMMatrix
Интерфейс DOMMatrix представляет матрицы 4×4, подходящие для операций в 2D и 3D, включая вращение и перенос. Это изменяемая версия интерфейса DOMMatrixReadOnly. Интерфейс доступен в веб-воркерах.
| m11 m21 m31 m41 |
| m12 m22 m32 m42 |
| m13 m23 m33 m43 |
| m14 m24 m34 m44 |
Свойства
a: number Справочник MDN
b: number Справочник MDN
c: number Справочник MDN
d: number Справочник MDN
e: number Справочник MDN
f: number Справочник MDN
m11: number Справочник MDN
m12: number Справочник MDN
m13: number Справочник MDN
m14: number Справочник MDN
m21: number Справочник MDN
m22: number Справочник MDN
m23: number Справочник MDN
m24: number Справочник MDN
m31: number Справочник MDN
m32: number Справочник MDN
m33: number Справочник MDN
m34: number Справочник MDN
m41: number Справочник MDN
m42: number Справочник MDN
m43: number Справочник MDN
m44: number Справочник MDN
Методы
Метод invertSelf() интерфейса DOMMatrix инвертирует исходную матрицу. Если матрицу нельзя инвертировать, все компоненты новой матрицы устанавливаются в NaN, а свойству is2D присваивается значение false.
Справочник MDN
multiplySelf(other?: DOMMatrixInit): DOMMatrix Метод multiplySelf() интерфейса DOMMatrix умножает матрицу на параметр otherMatrix, вычисляя скалярное произведение исходной матрицы и указанной матрицы: A⋅B. Если матрица-множитель не указана, матрица умножается на матрицу, у которой все элементы равны 0, кроме нижнего правого угла и элемента непосредственно над ним и слева от него: m33 и m34. Для них значение по умолчанию равно 1.
Справочник MDN
preMultiplySelf(other?: DOMMatrixInit): DOMMatrix Метод preMultiplySelf() интерфейса DOMMatrix изменяет матрицу, предварительно умножая её на указанную DOMMatrix. Это эквивалентно скалярному произведению B⋅A, где матрица A — исходная матрица, а B — матрица, переданная методу. Если матрица-множитель не указана, матрица умножается на матрицу, у которой все элементы равны 0, кроме нижнего правого угла и элемента непосредственно над ним и слева от него: m33 и m34. Для них значение по умолчанию равно 1.
Справочник MDN
rotateAxisAngleSelf(
x?: number,
y?: number,
z?: number,
angle?: number,
): DOMMatrix Метод rotateAxisAngleSelf() интерфейса DOMMatrix — это метод преобразования, который поворачивает исходную матрицу на заданный вектор и угол и возвращает изменённую матрицу.
Справочник MDN
rotateFromVectorSelf(
x?: number,
y?: number,
): DOMMatrix Метод rotateFromVectorSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу, поворачивая её на угол между указанным вектором и (1, 0). Угол поворота определяется как угол по часовой стрелке между векторами (1,0)T и (x,y)T, или (+/-)arctan(y/x). Если x и y равны 0, угол считается равным 0, и матрица не изменяется.
Справочник MDN
rotateSelf(
rotX?: number,
rotY?: number,
rotZ?: number,
): DOMMatrix Метод rotateSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу. Он поворачивает исходную матрицу вокруг каждой из её осей на указанное количество градусов и возвращает повёрнутую матрицу.
Справочник MDN
scale3dSelf(
scale?: number,
originX?: number,
originY?: number,
originZ?: number,
): DOMMatrix Метод scale3dSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу, применяя указанный коэффициент масштабирования ко всем трём осям относительно заданной точки начала координат (по умолчанию (0, 0, 0)) и возвращает масштабированную в 3D матрицу.
Справочник MDN
scaleSelf(
scaleX?: number,
scaleY?: number,
scaleZ?: number,
originX?: number,
originY?: number,
originZ?: number,
): DOMMatrix Метод scaleSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу, применяя указанный коэффициент масштабирования относительно заданной точки начала координат (по умолчанию (0, 0)) и возвращает масштабированную матрицу.
Справочник MDN
setMatrixValue(transformList: string): DOMMatrix Метод setMatrixValue() интерфейса DOMMatrix заменяет содержимое матрицы матрицей, заданной указанным преобразованием или преобразованиями, и возвращает сам объект.
Справочник MDN
Метод skewXSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу. Он выполняет перекос исходной матрицы, применяя указанное преобразование перекоса вдоль оси X, и возвращает матрицу с перекосом.
Справочник MDN
Метод skewYSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу. Он выполняет перекос исходной матрицы, применяя указанное преобразование перекоса вдоль оси Y, и возвращает матрицу с перекосом.
Справочник MDN
translateSelf(
tx?: number,
ty?: number,
tz?: number,
): DOMMatrix Метод translateSelf() интерфейса DOMMatrix — это изменяемый метод преобразования, который изменяет матрицу. Он применяет указанные векторы и возвращает обновлённую матрицу. Вектор по умолчанию — [0, 0, 0].
Справочник MDN
переменная DOMMatrix
Интерфейс DOMMatrix представляет матрицы 4×4, подходящие для операций в 2D и 3D, включая вращение и перенос. Это изменяемая версия интерфейса DOMMatrixReadOnly. Интерфейс доступен в веб-воркерах.
| m11 m21 m31 m41 |
| m12 m22 m32 m42 |
| m13 m23 m33 m43 |
| m14 m24 m34 m44 |
Свойства
Методы
fromFloat32Array(array32: Float32Array<ArrayBuffer>): DOMMatrix Статический метод fromFloat32Array() интерфейса DOMMatrix создаёт новый объект DOMMatrix на основе массива значений с плавающей запятой одинарной точности (32 бита).
Справочник MDN
fromFloat64Array(array64: Float64Array<ArrayBuffer>): DOMMatrix Статический метод fromFloat64Array() интерфейса DOMMatrix создаёт новый объект DOMMatrix на основе массива значений с плавающей запятой двойной точности (64 бита).
Справочник MDN
fromMatrix(other?: DOMMatrixInit): DOMMatrix Статический метод fromMatrix() интерфейса DOMMatrix создаёт новый объект DOMMatrix на основе существующей матрицы или объекта, предоставляющего значения для её свойств.
Справочник MDN
интерфейс DOMMatrix2DInit
Свойства
a: number b: number c: number d: number e: number f: number m11: number m12: number m21: number m22: number m41: number m42: number интерфейс DOMMatrixReadOnly
Интерфейс DOMMatrixReadOnly представляет собой матрицу 4×4 только для чтения, подходящую для операций в 2D и 3D. Интерфейс DOMMatrix, основанный на DOMMatrixReadOnly, добавляет возможность изменения, позволяя изменять матрицу после её создания.
| m11 m21 m31 m41 |
| m12 m22 m32 m42 |
| m13 m23 m33 m43 |
| m14 m24 m34 m44 |
Свойства
a: number b: number c: number d: number e: number f: number is2D: boolean Свойство is2D интерфейса DOMMatrixReadOnly только для чтения — это логический флаг, равный true, когда матрица является двумерной. Значение равно true, если матрица была инициализирована как двумерная и к ней применялись только двумерные операции преобразования. В противном случае матрица является трёхмерной, а is2D равно false.
isIdentity: boolean Свойство isIdentity интерфейса DOMMatrixReadOnly только для чтения — логическое значение, равное true, если матрица является единичной.
m11: number m12: number m13: number m14: number m21: number m22: number m23: number m24: number m31: number m32: number m33: number m34: number m41: number m42: number m43: number m44: number Методы
Метод flipX() интерфейса DOMMatrixReadOnly создаёт новую матрицу, полученную отражением исходной матрицы относительно оси x. Это эквивалентно умножению матрицы на DOMMatrix(-1, 0, 0, 1, 0, 0). Исходная матрица не изменяется.
Метод flipY() интерфейса DOMMatrixReadOnly создаёт новую матрицу, полученную отражением исходной матрицы относительно оси y. Это эквивалентно умножению матрицы на DOMMatrix(1, 0, 0, -1, 0, 0). Исходная матрица не изменяется.
Метод inverse() интерфейса DOMMatrixReadOnly создаёт новую матрицу, обратную исходной. Если матрицу нельзя обратить, всем компонентам новой матрицы присваивается значение NaN, а её свойству is2D — значение false. Исходная матрица не изменяется.
multiply(other?: DOMMatrixInit): DOMMatrix Метод multiply() интерфейса DOMMatrixReadOnly создаёт и возвращает новую матрицу, являющуюся скалярным произведением матрицы и параметра otherMatrix. Если otherMatrix не указан, матрица умножается на матрицу, в которой все элементы равны 0, кроме нижнего правого угла и элемента непосредственно над ним и слева от него: m33 и m34. Их значения по умолчанию равны 1. Исходная матрица не изменяется.
Метод rotate() интерфейса DOMMatrixReadOnly возвращает новую DOMMatrix, созданную поворотом исходной матрицы вокруг каждой из её осей на указанное число градусов. Исходная матрица не изменяется.
rotateAxisAngle(
x?: number,
y?: number,
z?: number,
angle?: number,
): DOMMatrix Метод rotateAxisAngle() интерфейса DOMMatrixReadOnly возвращает новую DOMMatrix, созданную поворотом исходной матрицы на заданный вектор и угол. Исходная матрица не изменяется.
rotateFromVector(
x?: number,
y?: number,
): DOMMatrix Метод rotateFromVector() интерфейса DOMMatrixReadOnly возвращает новую DOMMatrix, созданную поворотом исходной матрицы на угол между указанным вектором и (1, 0). Угол поворота определяется как угол по часовой стрелке между векторами (1,0)T и (x,y)T, то есть (+/-)arctan(y/x). Если x и y равны 0, угол принимается равным 0. Исходная матрица не изменяется.
scale(
scaleX?: number,
scaleY?: number,
scaleZ?: number,
originX?: number,
originY?: number,
originZ?: number,
): DOMMatrix Метод scale() интерфейса DOMMatrixReadOnly создаёт новую матрицу, представляющую собой исходную матрицу с применённым масштабированием.
Метод scale3d() интерфейса DOMMatrixReadOnly создаёт новую матрицу, полученную в результате применения к матрице трёхмерного масштабирования. Он возвращает новую DOMMatrix, созданную масштабированием исходной трёхмерной матрицы с заданным коэффициентом относительно начала координат, заданного параметрами origin; по умолчанию начало координат — (0, 0, 0). Исходная матрица не изменяется.
scaleNonUniform(
scaleX?: number,
scaleY?: number,
): DOMMatrix Метод skewX() интерфейса DOMMatrixReadOnly возвращает новую DOMMatrix, созданную применением указанного преобразования сдвига к исходной матрице вдоль оси x. Исходная матрица не изменяется.
Метод skewY() интерфейса DOMMatrixReadOnly возвращает новую DOMMatrix, созданную применением указанного преобразования сдвига к исходной матрице вдоль оси y. Исходная матрица не изменяется.
toFloat32Array(): Float32Array<ArrayBuffer> Метод toFloat32Array() интерфейса DOMMatrixReadOnly возвращает новый Float32Array, содержащий все 16 элементов матрицы (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44). Элементы сохраняются в массиве как числа с плавающей запятой одинарной точности в порядке по столбцам (доступ в порядке colexographical, или «colex»). (Иными словами, сначала вниз по первому столбцу сверху вниз, затем по второму столбцу и так далее.)
toFloat64Array(): Float64Array<ArrayBuffer> Метод toFloat64Array() интерфейса DOMMatrixReadOnly возвращает новый Float64Array, содержащий все 16 элементов матрицы (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44). Элементы сохраняются в массиве как числа с плавающей запятой двойной точности в порядке по столбцам (доступ в порядке colexographical, или «colex»). (Иными словами, сначала вниз по первому столбцу сверху вниз, затем по второму столбцу и так далее.)
toJSON(): any Метод toJSON() интерфейса DOMMatrixReadOnly создаёт и возвращает объект JSON. Объект JSON включает двумерные элементы матрицы от a до f, 16 элементов трёхмерной матрицы 4×4 m[1-4][1-4], логическое свойство is2D и логическое свойство isIdentity.
transformPoint(point?: DOMPointInit): DOMPoint Метод transformPoint интерфейса DOMMatrixReadOnly создаёт новый объект DOMPoint, преобразуя указанную точку с помощью матрицы. Ни матрица, ни исходная точка не изменяются.
Метод translate() интерфейса DOMMatrixReadOnly создаёт новую матрицу, представляющую собой исходную матрицу с применённым переносом.
toString(): string переменная DOMMatrixReadOnly
Интерфейс DOMMatrixReadOnly представляет собой матрицу 4×4 только для чтения, подходящую для операций в 2D и 3D. Интерфейс DOMMatrix, основанный на DOMMatrixReadOnly, добавляет возможность изменения, позволяя изменять матрицу после её создания.
| m11 m21 m31 m41 |
| m12 m22 m32 m42 |
| m13 m23 m33 m43 |
| m14 m24 m34 m44 |
Свойства
Методы
fromFloat32Array(array32: Float32Array<ArrayBuffer>): DOMMatrixReadOnly Статический метод fromFloat32Array() интерфейса DOMMatrixReadOnly создаёт новый объект DOMMatrixReadOnly на основе массива чисел с плавающей запятой одинарной точности (32 бита).
fromFloat64Array(array64: Float64Array<ArrayBuffer>): DOMMatrixReadOnly Статический метод fromFloat64Array() интерфейса DOMMatrixReadOnly создаёт новый объект DOMMatrixReadOnly на основе массива чисел с плавающей запятой двойной точности (64 бита).
fromMatrix(other?: DOMMatrixInit): DOMMatrixReadOnly Статический метод fromMatrix() интерфейса DOMMatrixReadOnly создаёт новый объект DOMMatrixReadOnly на основе существующей матрицы или объекта, предоставляющего значения для его свойств.
интерфейс DOMPoint
Объект DOMPoint представляет собой 2D- или 3D-точку в системе координат; он содержит значения координат не более чем в трёх измерениях, а также необязательное значение перспективы. DOMPoint основан на DOMPointReadOnly, но позволяет изменять значения его свойств.
Свойства
w: number Свойство w интерфейса DOMPoint содержит значение перспективы точки в пространстве — w.
x: number Свойство x интерфейса DOMPoint содержит горизонтальную координату точки в пространстве — x.
y: number Свойство y интерфейса DOMPoint содержит вертикальную координату точки в пространстве — y.
z: number Свойство z интерфейса DOMPoint задаёт координату глубины точки в пространстве.
переменная DOMPoint
Объект DOMPoint представляет собой 2D- или 3D-точку в системе координат; он содержит значения координат не более чем в трёх измерениях, а также необязательное значение перспективы. DOMPoint основан на DOMPointReadOnly, но позволяет изменять значения его свойств.
Свойства
Методы
fromPoint(other?: DOMPointInit): DOMPoint Статический метод fromPoint() интерфейса DOMPoint создаёт и возвращает новый изменяемый объект DOMPoint на основе исходной точки.
интерфейс DOMPointInit
интерфейс DOMPointReadOnly
Интерфейс DOMPointReadOnly определяет поля координат и перспективы, используемые DOMPoint для задания 2D- или 3D-точки в системе координат.
Свойства
w: number Свойство w интерфейса DOMPointReadOnly содержит значение перспективы точки в пространстве — w — для точки, доступной только для чтения.
x: number Свойство x интерфейса DOMPointReadOnly содержит горизонтальную координату точки в пространстве — x — для точки, доступной только для чтения. В этой доступной только для чтения версии объекта DOMPoint это свойство нельзя изменить с помощью кода JavaScript.
y: number Свойство y интерфейса DOMPointReadOnl**y** содержит вертикальную координату точки в пространстве — y — для точки, доступной только для чтения.
z: number Свойство z интерфейса DOMPointReadOnly содержит координату глубины z точки в пространстве для точки, доступной только для чтения.
Методы
matrixTransform(matrix?: DOMMatrixInit): DOMPoint Метод matrixTransform() интерфейса DOMPointReadOnly применяет к объекту DOMPointReadOnly матричное преобразование, заданное в виде объекта, и создаёт и возвращает новый объект DOMPointReadOnly. Ни матрица, ни точка не изменяются.
toJSON(): any Метод DOMPointReadOnly toJSON() возвращает объект, содержащий точку в формате JSON.
переменная DOMPointReadOnly
Интерфейс DOMPointReadOnly определяет поля координат и перспективы, используемые DOMPoint для задания 2D- или 3D-точки в системе координат.
Свойства
Методы
fromPoint(other?: DOMPointInit): DOMPointReadOnly Статический метод DOMPointReadOnly fromPoint() создаёт и возвращает новый объект DOMPointReadOnly на основе исходной точки.
интерфейс DOMQuad
DOMQuad — это набор из четырёх объектов DOMPoint, определяющих углы произвольного четырёхугольника. Возвращаемые объекты DOMQuad позволяют getBoxQuads() предоставлять точные данные даже при наличии произвольных 2D- или 3D-преобразований. У DOMQuad есть удобный атрибут bounds, возвращающий DOMRectReadOnly для случаев, когда требуется ограничивающий прямоугольник, выровненный по осям.
Свойства
Свойство p1 интерфейса DOMQuad содержит объект DOMPoint, представляющий один из четырёх углов DOMQuad. При создании с помощью DOMQuad.fromRect() это точка (x, y).
Свойство p2 интерфейса DOMQuad содержит объект DOMPoint, представляющий один из четырёх углов DOMQuad. При создании с помощью DOMQuad.fromRect() это точка (x + width, y).
Свойство p3 интерфейса DOMQuad содержит объект DOMPoint, представляющий один из четырёх углов DOMQuad. При создании с помощью DOMQuad.fromRect() это точка (x + width, y + height).
Свойство p4 интерфейса DOMQuad содержит объект DOMPoint, представляющий один из четырёх углов DOMQuad. При создании с помощью DOMQuad.fromRect() это точка (x, y + height).
Методы
Метод DOMQuad getBounds() возвращает объект DOMRect, представляющий наименьший прямоугольник, полностью содержащий объект DOMQuad.
toJSON(): any Метод DOMQuad toJSON() возвращает представление объекта DOMQuad в формате JSON.
переменная DOMQuad
DOMQuad — это набор из четырёх объектов DOMPoint, определяющих углы произвольного четырёхугольника. Возвращаемые объекты DOMQuad позволяют getBoxQuads() предоставлять точные данные даже при наличии произвольных 2D- или 3D-преобразований. У DOMQuad есть удобный атрибут bounds, возвращающий DOMRectReadOnly для случаев, когда требуется ограничивающий прямоугольник, выровненный по осям.
Свойства
Методы
fromQuad(other?: DOMQuadInit): DOMQuad Статический метод fromQuad() интерфейса DOMQuad возвращает новый объект DOMQuad на основе предоставленного набора координат, заданного в форме другого объекта DOMQuad.
fromRect(other?: DOMRectInit): DOMQuad Статический метод fromRect() интерфейса DOMQuad возвращает новый объект DOMQuad на основе предоставленного набора координат, заданного в форме объекта DOMRect.
интерфейс DOMQuadInit
Свойства
p1: DOMPointInit p2: DOMPointInit p3: DOMPointInit p4: DOMPointInit интерфейс DOMRect
DOMRect описывает размер и положение прямоугольника.
Свойства
height: number Свойство height интерфейса DOMRect обозначает высоту прямоугольника. Значение может быть отрицательным.
width: number Свойство width интерфейса DOMRect обозначает ширину прямоугольника. Значение может быть отрицательным.
x: number Свойство x интерфейса DOMRect обозначает координату x прямоугольника, то есть горизонтальное расстояние между левой границей области просмотра и началом координат прямоугольника.
y: number Свойство y интерфейса DOMRect обозначает координату y прямоугольника, то есть вертикальное расстояние между верхней границей области просмотра и началом координат прямоугольника.
переменная DOMRect
DOMRect описывает размер и положение прямоугольника.
Свойства
Методы
fromRect(other?: DOMRectInit): DOMRect Статический метод fromRect() объекта DOMRect создаёт новый объект DOMRect с заданным положением и размерами.
интерфейс DOMRectInit
интерфейс DOMRectReadOnly
Интерфейс DOMRectReadOnly определяет стандартные свойства (которые также используются DOMRect) для описания прямоугольника с неизменяемыми свойствами.
Свойства
bottom: number Свойство bottom интерфейса DOMRectReadOnly, доступное только для чтения, возвращает значение нижней координаты DOMRect. (Имеет то же значение, что и y + height, или y, если height отрицательно.)
height: number Свойство height интерфейса DOMRectReadOnly, доступное только для чтения, представляет высоту DOMRect.
left: number Свойство left интерфейса DOMRectReadOnly, доступное только для чтения, возвращает значение левой координаты DOMRect. (Имеет то же значение, что и x, или x + width, если width отрицательно.)
right: number Свойство right интерфейса DOMRectReadOnly, доступное только для чтения, возвращает значение правой координаты DOMRect. (Имеет то же значение, что и x + width, или x, если width отрицательно.)
top: number Свойство top интерфейса DOMRectReadOnly, доступное только для чтения, возвращает значение верхней координаты DOMRect. (Имеет то же значение, что и y, или y + height, если height отрицательно.)
width: number Свойство width интерфейса DOMRectReadOnly, доступное только для чтения, представляет ширину DOMRect.
x: number Свойство x интерфейса DOMRectReadOnly, доступное только для чтения, представляет координату x начала координат DOMRect.
y: number Свойство y интерфейса DOMRectReadOnly, доступное только для чтения, представляет координату y начала координат DOMRect.
Методы
toJSON(): any Метод DOMRectReadOnly toJSON() возвращает представление объекта DOMRectReadOnly в формате JSON.
переменная DOMRectReadOnly
Интерфейс DOMRectReadOnly определяет стандартные свойства (которые также используются DOMRect) для описания прямоугольника с неизменяемыми свойствами.
Свойства
Методы
fromRect(other?: DOMRectInit): DOMRectReadOnly Статический метод объекта DOMRectReadOnly fromRect() создаёт новый объект DOMRectReadOnly с заданным местоположением и размерами.
© 2018–2025 the Deno authors
Licensed under the MIT License.
https://docs.deno.com/api/web/geometry-interfaces-module-api
