メインコンテンツまでスキップ
version: v3.0

PathData

PathData は、SVGのパス構文による形状の記述を表すデータ型です。

構文​

文字列を指定します。

SVGの仕様に準拠したパス文字列を記述します。 パスとして解釈不能な文字列を指定した場合は、構文エラーとなります。

警告

複雑なパスを指定した場合、SVGとは描画結果に差異が生じる可能性があります。

描画に問題がある場合は、お問い合わせフォームからご連絡ください。

サポートするパスコマンド​

コマンド概要
M / m線を描かずに移動し、新しいサブパスを開始します。
L / l指定位置まで直線を描きます。
H / h水平線を描きます。
V / v垂直線を描きます。
C / c2つの制御点を指定して3次ベジェ曲線を描きます。
S / s第1制御点を自動で求めて3次ベジェ曲線を描きます。
Q / q1つの制御点を指定して2次ベジェ曲線を描きます。
T / t制御点を自動で求めて2次ベジェ曲線を描きます。
A / a楕円弧を描きます。
Z / zサブパスを閉じます。

パスコマンドの詳細​

以下では、SVGの仕様に沿って各コマンドの動作を説明します。

パス文字列には、コマンドを実行する順に並べます。 各コマンドは1文字で表し、その直後に必要な引数を書きます。

パスは M または m で描画の開始位置を決めるところから始まります。 直線や曲線を描くと、その終点が次のコマンドの現在位置になります。

例えば、次のパス文字列は、2本の直線を描いてから始点に戻り、三角形を作ります。

M 5 5 L 25 5 l -10 15 Z
  1. M 5 5 で (5, 5) へ移動します。
  2. L 25 5 で (25, 5) まで直線を描きます。
  3. l -10 15 で、現在位置から左へ10、下へ15進んだ (15, 20) まで直線を描きます。
  4. Z で始点 (5, 5) へ直線を引いて閉じます。

座標と引数の書き方​

座標はX軸、Y軸の順に数値で記述します。右がX軸、下がY軸の正の方向です。 座標や移動量の単位はミリメートル(mm)です。パス文字列では数値に mm を付けずに記述します。

  • 大文字では原点を基準に位置を指定し、小文字では現在位置からの移動量を指定します。上の例の l -10 15 は L 15 20 と同じ終点を指します。
  • 引数は空白またはカンマで区切ります。例えば L 25 5 と L 25,5 は同一です。
  • 同じコマンドを続けるときは、引数を必要な個数ずつ並べて2回目以降のコマンド文字を省略できます。例えば L 25 5 15 20 は L 25 5 L 15 20 と同一です(ただし、M と m は例外です)。

移動 : M / m​

線を描かずに移動し、新しいサブパスを開始します。

  • M x y の x と y は、新しいサブパスの始点を指定します。
  • パスの先頭には M または m を指定します。先頭の m の最初の座標は原点からの位置として扱われます。
  • 座標の組を続けて指定すると、2組目以降は L または l と同じように直線を描きます。

直線 : L / l, H / h, V / v​

現在位置から終点まで直線を描きます。水平線と垂直線には、片方の座標だけを指定できます。

  • L x y は、現在位置から (x, y) まで直線を描きます。
  • H x は、Y座標を保ったまま、指定したX座標まで水平線を描きます。
  • V y は、X座標を保ったまま、指定したY座標まで垂直線を描きます。

3次ベジェ曲線 : C / c, S / s​

2つの制御点で3次ベジェ曲線の形を決めます。S と s では第1制御点が自動で決まります。

  • C x1 y1 x2 y2 x y は、現在位置から終点 (x, y) まで、制御点 (x1, y1) と (x2, y2) を使って曲線を描きます。
  • S x2 y2 x y は、第2制御点 (x2, y2) と終点 (x, y) を指定します。直前のコマンドも C / c または S / s なら、その第2制御点を現在位置に対して点対称に移した点が第1制御点になります。それ以外の場合は現在位置が第1制御点になります。

2次ベジェ曲線 : Q / q, T / t​

1つの制御点で2次ベジェ曲線の形を決めます。T と t では制御点が自動で決まります。

  • Q x1 y1 x y は、現在位置から終点 (x, y) まで、制御点 (x1, y1) を使って曲線を描きます。
  • T x y は、終点 (x, y) を指定します。直前のコマンドも Q / q または T / t なら、その制御点を現在位置に対して点対称に移した点を使います。それ以外の場合は現在位置を制御点にします。

楕円弧 : A / a​

現在位置から終点まで楕円弧を描きます。楕円の形と傾きに加え、描く弧の長さと向きを指定できます。

  • A rx ry rotation largeArc sweep x y と書き、末尾の x と y で終点を指定します。
  • rx と ry は楕円の半径です。rotation は楕円の回転角を度で指定します。
  • largeArc は短い弧なら 0、長い弧なら 1 を指定します。
  • sweep は反時計回りなら 0、時計回りなら 1 を指定します。

クローズパス : Z / z​

現在位置とサブパスの始点を直線で結び、サブパスを閉じます。

  • Z と z はどちらも引数を取らず、動作は同じです。
  • 閉じた後は、その始点が現在位置になります。

関連情報​