DOMMatrixReadOnly: fromMatrix() 静的メソッド
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年7月.
メモ: この機能はウェブワーカー内で利用可能です。
fromMatrix() は DOMMatrixReadOnly インターフェイスの静的メソッドで、新しい DOMMatrixReadOnly オブジェクトを、与えられた既存の行列またはそのプロパティの値を提供するオブジェクトから作成します。
構文
DOMMatrixReadOnly.fromMatrix()
DOMMatrixReadOnly.fromMatrix(other)
引数
other省略可-
DOMMatrixかDOMMatrixReadOnlyか、同じプロパティを持つオブジェクトです。すべてのプロパティのデフォルトは0です。プロパティは次の通りです。is2D-
論理値。行列を二次元行列として作成する場合に
trueを指定します。m13、m14、m23、m24、m31、m32、m34、m43のいずれかがゼロでない場合、またはm33もしくはm44のどちらかが 1 でない場合、デフォルトはfalseとなります。それ以外の場合はデフォルトでtrueとなります。 m11,m12,m13,m14,m21,m22,m23,m24,m31,m32,m33,m34,m41,m42,m43,m44-
4 × 4 行列のそれぞれの要素を表す数値。
m11からm14は第 1 列、m21からm24は第 2 列、以下同様となります。m11、m22、m33、m44はデフォルトで1、その他の要素はすべてデフォルトで0となります。is2Dが明示的にtrueに設定されている場合、m13、m14、m23、m24、m31、m32、m34、m43は省略するか0に設定しなければならないし、m33とm44は省略するか1に設定しなければなりません。 a,b,c,d,e,f-
二次元行列の初期化時に便利なように、それぞれ
m11、m12、m21、m22、m41、m42の別名です。これらの別名をmの対応する変数につけて指定する場合、その値は等しくなければなりません。
返値
DOMMatrixReadOnly オブジェクトです。
例外
TypeError-
指定されたオブジェクトのプロパティに矛盾がある場合（例えば、
aとm11の両方が指定されているが値が異なる場合）に発生する。
例
オブジェクトから行列を作成
この例では、オブジェクト内で行列値を指定することで DOMMatrixReadOnly を作成します。
const matrix = DOMMatrixReadOnly.fromMatrix({
a: 1,
b: 0,
c: 0,
d: 1,
e: 50,
f: 50,
is2D: true,
});
console.log(matrix.toString());
// 出力: matrix(1, 0, 0, 1, 50, 50)
console.log(matrix.is2D);
// 出力: true
既存の行列から行列を作成
この例では、新しい DOMMatrixReadOnly を既存の DOMMatrixReadOnly から作成します。
const matrix1 = new DOMMatrixReadOnly([1, 0, 0, 1, 100, 100]);
const matrix2 = DOMMatrixReadOnly.fromMatrix(matrix1);
console.log(matrix2.toString());
// 出力: matrix(1, 0, 0, 1, 100, 100)
デフォルトの恒等行列を作成
この例は、引数なしで fromMatrix() を呼び出すと恒等行列が作成されることを示しています。
const identityMatrix = DOMMatrixReadOnly.fromMatrix();
console.log(identityMatrix.toString());
// 出力: matrix(1, 0, 0, 1, 0, 0)
console.log(identityMatrix.isIdentity);
// 出力: true
仕様書
| Specification |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-frommatrix |