CanvasRenderingContext2D: beginPath() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
CanvasRenderingContext2D.beginPath() はキャンバス 2D API のメソッドで、サブパスのリストを空にすることにより新しいパスを開始します。新しいパスを作成したい場合は、このメソッドを呼び出してください。
メモ:
新しいサブパス（つまり、現在のキャンバスの状態に一致するサブパス）を作成する場合、 CanvasRenderingContext2D.moveTo() が使用できます。
構文
js
beginPath()
引数
なし。
返値
なし (undefined)。
例
独立したパスの作成
この例では、それぞれが 1 本の直線を含む 2 つのパスを作成します。
HTML
html
<canvas id="canvas"></canvas>
JavaScript
beginPath() メソッドがそれぞれの線を引く前に呼び出されるため、それぞれの線は別々な色で描かれます。
js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// 第 1 のパス
ctx.beginPath();
ctx.strokeStyle = "blue";
ctx.moveTo(20, 20);
ctx.lineTo(200, 20);
ctx.stroke();
// 第 2 のパス
ctx.beginPath();
ctx.strokeStyle = "green";
ctx.moveTo(20, 20);
ctx.lineTo(120, 120);
ctx.stroke();
結果
仕様書
| 仕様書 |
|---|
| HTML # dom-context-2d-beginpath-dev |
ブラウザーの互換性
関連情報
- このメソッドを定義しているインターフェイス:
CanvasRenderingContext2D CanvasRenderingContext2D.closePath()