PathData
PathData は、SVGのパス構文による形状の記述を表すデータ型です。
構文
文字列を指定します。
SVGの仕様に準拠したパス文字列を記述します。 パスとして解釈不能な文字列を指定した場合は、構文エラーとなります。
警告
複雑なパスを指定した場合、SVGとは描画結果に差異が生じる可能性があります。
描画に問題がある場合は、お問い合わせフォームからご連絡ください。
サポートするパスコマンド
| コマンド | 概要 |
|---|---|
M / m | 線を描かずに移動し、新しいサブパスを開始します。 |
L / l | 指定位置まで直線を描きます。 |
H / h | 水平線を描きます。 |
V / v | 垂直線を描きます。 |
C / c | 2つの制御点を指定して3次ベジェ曲線を描きます。 |
S / s | 第1制御点を自動で求めて3次ベジェ曲線を描きます。 |
Q / q | 1つの制御点を指定して2次ベジェ曲線を描きます。 |
T / t | 制御点を自動で求めて2次ベジェ曲線を描きます。 |
A / a | 楕円弧を描きます。 |
Z / z | サブパスを閉じます。 |
パスコマンドの詳細
以下では、SVGの仕様に沿って各コマンドの動作を説明します。
パス文字列には、コマンドを実行する順に並べます。 各コマンドは1文字で表し、その直後に必要な引数を書きます。
パスは M または m で描画の開始位置を決めるところから始まります。
直線や曲線を描くと、その終点が次のコマンドの現在位置になります。
例えば、次のパス文字列は、2本の直線を描いてから始点に戻り、三角形を作ります。
M 5 5 L 25 5 l -10 15 Z
M 5 5で(5, 5)へ移動します。L 25 5で(25, 5)まで直線を描きます。l -10 15で、現在位置から左へ10、下へ15進んだ(15, 20)まで直線を描きます。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はどちらも引数を取らず、動作は同じです。- 閉じた後は、その始点が現在位置になります。