CanvasPattern: setTransform() メソッド

CanvasPattern.setTransform() メソッドは、パターンの変換行列として DOMMatrix オブジェクトを使用し、パターンにこれを実行します。

構文

js
setTransform(matrix)

引数

matrix

パターンの変換行列として使用する DOMMatrix です。

返値

なし (undefined)。

setTransform メソッドの使用

これは setTransform メソッドを使用して DOMMatrix によるパターンの座標変換を指定して CanvasPattern を生成する簡単なコードスニペットです。たとえば、パターンが現在の fillStyle として適用され、fillRect() メソッドを使用すると、キャンバスに描画されます。

HTML

html
<canvas id="canvas"></canvas>

JavaScript

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

const matrix = new DOMMatrix([1, 0.2, 0.8, 1, 0, 0]);

const img = new Image();
img.src =
  "/en-US/docs/Web/API/CanvasPattern/setTransform/canvas_createpattern.png";

img.onload = () => {
  const pattern = ctx.createPattern(img, "repeat");
  pattern.setTransform(matrix.rotate(-45).scale(1.5));
  ctx.fillStyle = pattern;
  ctx.fillRect(0, 0, 400, 400);
};

編集可能なデモ

上のコードスニペットの編集可能なデモです。 SetTransform() の引数を変更して、その効果を確認してみてください。

仕様書

Specification
HTML Standard
# dom-canvaspattern-settransform-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報