The DOMMatrixReadOnly interface represents a read-only 4×4 matrix, suitable for 2D and 3D operations.

MDN Reference

interface DOMMatrixReadOnly {
    a: number;
    b: number;
    c: number;
    d: number;
    e: number;
    f: number;
    is2D: boolean;
    isIdentity: boolean;
    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(): DOMMatrix;
    flipY(): DOMMatrix;
    inverse(): DOMMatrix;
    multiply(other?: DOMMatrixInit): DOMMatrix;
    rotate(rotX?: number, rotY?: number, rotZ?: number): DOMMatrix;
    rotateAxisAngle(
        x?: number,
        y?: number,
        z?: number,
        angle?: number,
    ): DOMMatrix;
    rotateFromVector(x?: number, y?: number): DOMMatrix;
    scale(
        scaleX?: number,
        scaleY?: number,
        scaleZ?: number,
        originX?: number,
        originY?: number,
        originZ?: number,
    ): DOMMatrix;
    scale3d(
        scale?: number,
        originX?: number,
        originY?: number,
        originZ?: number,
    ): DOMMatrix;
    scaleNonUniform(scaleX?: number, scaleY?: number): DOMMatrix;
    skewX(sx?: number): DOMMatrix;
    skewY(sy?: number): DOMMatrix;
    toFloat32Array(): Float32Array<ArrayBuffer>;
    toFloat64Array(): Float64Array<ArrayBuffer>;
    toJSON(): any;
    toString(): string;
    transformPoint(point?: DOMPointInit): DOMPoint;
    translate(tx?: number, ty?: number, tz?: number): DOMMatrix;
}
Hierarchy
Index

Properties

a: number
b: number
c: number
d: number
e: number
f: number
is2D: boolean

The readonly is2D property of the DOMMatrixReadOnly interface is a Boolean flag that is true when the matrix is 2D.

MDN Reference

isIdentity: boolean

The readonly isIdentity property of the DOMMatrixReadOnly interface is a Boolean whose value is true if the matrix is the identity matrix.

MDN Reference

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

Methods

  • The flipX() method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the x-axis.

    MDN Reference

    Returns DOMMatrix

  • The flipY() method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the y-axis.

    MDN Reference

    Returns DOMMatrix

  • The inverse() method of the DOMMatrixReadOnly interface creates a new matrix which is the inverse of the original matrix.

    MDN Reference

    Returns DOMMatrix

  • The multiply() method of the DOMMatrixReadOnly interface creates and returns a new matrix which is the dot product of the matrix and the otherMatrix parameter.

    MDN Reference

    Parameters

    Returns DOMMatrix

  • The rotate() method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix around each of its axes by the specified number of degrees.

    MDN Reference

    Parameters

    • OptionalrotX: number
    • OptionalrotY: number
    • OptionalrotZ: number

    Returns DOMMatrix

  • The rotateAxisAngle() method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix by the given vector and angle.

    MDN Reference

    Parameters

    • Optionalx: number
    • Optionaly: number
    • Optionalz: number
    • Optionalangle: number

    Returns DOMMatrix

  • The rotateFromVector() method of the DOMMatrixReadOnly interface is returns a new DOMMatrix created by rotating the source matrix by the angle between the specified vector and (1, 0).

    MDN Reference

    Parameters

    • Optionalx: number
    • Optionaly: number

    Returns DOMMatrix

  • The scale() method of the original matrix with a scale transform applied.

    MDN Reference

    Parameters

    • OptionalscaleX: number
    • OptionalscaleY: number
    • OptionalscaleZ: number
    • OptionaloriginX: number
    • OptionaloriginY: number
    • OptionaloriginZ: number

    Returns DOMMatrix

  • The scale3d() method of the DOMMatrixReadOnly interface creates a new matrix which is the result of a 3D scale transform being applied to the matrix.

    MDN Reference

    Parameters

    • Optionalscale: number
    • OptionaloriginX: number
    • OptionaloriginY: number
    • OptionaloriginZ: number

    Returns DOMMatrix

  • Parameters

    • OptionalscaleX: number
    • OptionalscaleY: number

    Returns DOMMatrix

  • The skewX() method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its x-axis.

    MDN Reference

    Parameters

    • Optionalsx: number

    Returns DOMMatrix

  • The skewY() method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its y-axis.

    MDN Reference

    Parameters

    • Optionalsy: number

    Returns DOMMatrix

  • The toFloat32Array() method of the DOMMatrixReadOnly interface returns a new Float32Array containing all 16 elements (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) which comprise the matrix.

    MDN Reference

    Returns Float32Array<ArrayBuffer>

  • The toFloat64Array() method of the DOMMatrixReadOnly interface returns a new Float64Array containing all 16 elements (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) which comprise the matrix.

    MDN Reference

    Returns Float64Array<ArrayBuffer>

  • The toJSON() method of the DOMMatrixReadOnly interface creates and returns a JSON object.

    MDN Reference

    Returns any

  • Returns string

  • The transformPoint method of the You can also create a new DOMPoint by applying a matrix to a point with the DOMPointReadOnly.matrixTransform() method.

    MDN Reference

    Parameters

    Returns DOMPoint

  • The translate() method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix with a translation applied.

    MDN Reference

    Parameters

    • Optionaltx: number
    • Optionalty: number
    • Optionaltz: number

    Returns DOMMatrix