DOMMatrixReadOnly: DOMMatrixReadOnly() コンストラクター
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.
メモ: この機能はウェブワーカー内で利用可能です。
DOMMatrixReadOnly コンストラクターは新しい DOMMatrixReadOnly オブジェクトを作成します。このオブジェクトは 4x4 の行列を表し、 2D および 3D の演算に適しています。
構文
new DOMMatrixReadOnly()
new DOMMatrixReadOnly(initString)
new DOMMatrixReadOnly(initArray)
引数
initString省略可-
CSS の
matrix()またはmatrix3d()の形式で 2D または 3D の行列を表す文字列です。 initArray省略可-
列優先順で 6 または 16 個の数値を含む配列。それ以外の長さの配列では
TypeErrorが発生します。- 6 個の要素の配列の場合は、行列成分
[m11, m12, m21, m22, m41, m42]と解釈され、2D 行列を作成します。 - 16 個の要素の配列の場合は、行列成分
[m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44]と解釈され、3D 行列を作成します。
この引数が省略された場合、恒等行列が作成されます。すなわち、
[1, 0, 0, 1, 0, 0]と同等です。この引数が
Float32ArrayまたはFloat64Arrayで提供される場合は、より高性能な静的メソッドであるDOMMatrixReadOnly.fromFloat32Array()またはDOMMatrixReadOnly.fromFloat64Array()を代わりに使用することを検討してください。 - 6 個の要素の配列の場合は、行列成分
返値
新しい DOMMatrixReadOnly オブジェクトです。
例外
TypeError-
引数が文字列でない場合、または長さが 6 または 16 以外の配列である場合に発生します。
SyntaxError-
文字列引数が有効な CSS の
matrix()またはmatrix3d()形式でない場合に発生します。
例
DOMMatrixReadOnly を文字列から作成
const matrixFromString = new DOMMatrixReadOnly("matrix(1, 0, 0, 1, 10, 20)");
console.log(matrixFromString.toJSON());
// 出力: {a: 1, b: 0, c: 0, d: 1, e: 10, f: 20}
DOMMatrixReadOnly を配列から作成
const matrixFromArray = new DOMMatrixReadOnly([1, 0, 0, 1, 10, 20]);
console.log(matrixFromArray.toJSON());
// 出力: {a: 1, b: 0, c: 0, d: 1, e: 10, f: 20}
仕様書
| Specification |
|---|
| Geometry Interfaces Module Level 1 # dom-dommatrixreadonly-dommatrixreadonly |