パス
<path> 要素は、 SVG の基本図形ライブラリーの中でもっとも強力な要素です。これは、直線、曲線、弧などを作成するために用いることができます。
パスは、複数の直線や曲線を組み合わせて複雑な形状を作ります。直線だけで構成された複雑な形状は、 <polyline> 要素として作成することができます。 <polyline> および <path> 要素は似たような形状を作ることができますが、 <polyline> 要素は曲線を表現するのに大量の小さな直線を必要とするため、大きなサイズにはうまく拡大することができません。
SVG を描画する際には、パスをよく理解しておくことが重要です。XML エディターやテキストエディターを使用して複雑なパスを作成するのはお勧めできませんが、それらがどのように機能するかを理解しておけば、 SVG の表示問題を特定して修復することができます。
<path> 要素の形状は、1 つの引数である d によって定義されます (詳細は基本図形を参照してください)。 d 属性はこれらのコマンドで使用される一連のコマンドと引数を含みます。
各コマンドは特定の文字で呼び出されます。たとえば、"Move to" コマンドは M で表されます。座標 (10, 10) に移動するには、コマンドを M 10 10 で開始します。パーサーはこの文字に遭遇すると、まず接続線を描かずにその点へ移動する必要があると認識します。
すべてのコマンドは 2 つの種類があります。大文字はページ上の絶対座標を指定し、小文字は相対座標 (例えば、 直前の点から上に 10px、左に 7px 移動) を指定します。
d 属性の座標は 常に単位なし で指定するので、ユーザー座標システムになります。後のチュートリアルで、どのようにパスを他のニーズに合わせて変形できるかを学びます。
直線コマンド
<path> ノードには、直線のコマンドが 5 つあります。1 つ目のコマンドは "Move To" すなわち M で、前述したものです。これは少なくとも 2 つの引数を取り、最初の 2 つは移動先の x 座標と y 座標です。カーソルがすでにページ上のどこかにあった場合は、2 つの位置を結ぶ線は描画されません。 "Move To" コマンドは、どこから描画を始めるかを指定するパスの始点に見られます。
M x y (または) m dx dy
"Move To" コマンドの後には、複数の座標ペアを続けることができます。カーソルを移動するのは最初のペアだけで、それ以降の各ペアは "Line To" コマンドを使用した場合と同じように線を描画します。たとえば、M 10 10 90 10 90 90 は M 10 10 L 90 10 L 90 90 と同じです。m の後に続くペアも同様に線を描画しますが、現在の位置からの相対座標になります。
たとえば、次のパスは 1 つの M コマンドと 3 つの座標ペアを使って、つながった 2 本の線分を描画します。
<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
<path d="M10 10 90 10 90 90" stroke="black" fill="none" />
</svg>
以下の例では点 (10, 10) だけがある状態になります。ただし、パスだけを描画してもこれらの点が表示されないことに注意してください。
<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
<path d="M10 10" />
</svg>
線を描画するコマンドは 3 種類あります。もっとも一般的なものは、 "Line To" コマンド、すなわち L です。 L は 2 つの引数—x および y 座標—を持ち、現在の位置から新しい位置に向けて直線を描画します。
L x y (または) l dx dy
水平または垂直の線を描画するための短縮された形式があります。 H は水平線を描画、V は垂直線を描画します。どちらのコマンドも一方向にしか移動しないので、引数は 1 つだけです。
H x (または) h dx V y (または) v dy
始めやすいところは実際に図形を描いてみることです。手始めに矩形 (<rect> 要素を使うとより簡単に描けるものと同じです) を描いてみましょう。これは水平線と垂直線だけで構成されています。
<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
<path d="M 10 10 H 90 V 90 H 10 L 10 10" />
</svg>
上記のパス宣言は、Z で呼び出される「パスを閉じる」コマンドを使用することで、少し短縮することができます。このコマンドは、現在の位置から最初の未閉鎖の点(最後の Z コマンドの後にある最初の点、またはそれがない場合はパスの最初の点)まで直線を描き、線の接合でパスを閉じます。このコマンドは、多くの場合、パスノードの末尾に置かれますが、常にそうとは限りません。大文字と小文字のコマンドに違いはありません。
Z (または) z
したがって、上記のパスは次のように簡単に書くことができます。
<path d="M 10 10 H 90 V 90 H 10 Z" fill="none" stroke="black" />
同じ画像を描画するために、これらコマンドの相対形式を用いることもできます。前に述べたとおり相対形式のコマンドは小文字を用いて表記され、厳密な座標でカーソルを移動するのではなく直前の位置から相対的に移動します。例えば、ここで描いた四角形のサイズは 80x80 であるので、 <path> 要素は以下のように書くことができます:
<path d="M 10 10 h 80 v 80 h -80 Z" fill="none" stroke="black" />
パスは点 (10, 10) に移動した後、右へ水平に点 80 個分、下に点 80 個分、左に点 80 個分、そして始点へ戻るように移動します。
これらの例では、おそらく <polygon> や <polyline> 要素を使用すると、より直感的に書くことができます。しかし、パスは SVG で描画する際に頻繁に使用されるので、開発者はこれらの代わりにパスを使用した方が快適かもしれません。どちらを使用しても、性能上の利点や欠点はありません。
曲線コマンド
なめらかな曲線を作成するために使うコマンドは 3 種類あります。 2 つはベジェ曲線、3 つめは「円弧」すなわち円の一部です。すでに Inkscape, Illustrator, Photoshop などのパスツールを使用して、ベジェ曲線の実体験をしているかもしれません。ベジェ曲線には無数の種類がありますが、 <path> 要素では 2 種類だけが使用可能です。三次ベジェ曲線の C と、二次ベジェ曲線の Q です。
ベジェ曲線
三次ベジェ曲線 C は、やや複雑な曲線です。三次ベジェ曲線は、各々の点に対する 2 つの制御点をとります。従って、三次ベジェ曲線を作成したいときは 3 組の座標を指定しなければなりません。
C x1 y1, x2 y2, x y (または) c dx1 dy1, dx2 dy2, dx dy
ここで最後にある座標 (x, y) は、線の終点にしたい場所です。他の 2 組は制御点です。 (x1, y1) は曲線の始点向けの制御点、 (x2, y2) は曲線の終点向けの制御点です。制御点は各々の点から始まる線の傾斜を本質的に説明するものです。このときベジェ関数は、線の始めで確立した傾斜からもう一方の側の傾斜へ至るなめらかな曲線を作成します。
<svg width="190" height="160" xmlns="http://www.w3.org/2000/svg">
<path d="M 10 10 C 20 20, 40 20, 50 10" stroke="black" fill="transparent" />
<path d="M 70 10 C 70 20, 110 20, 110 10" stroke="black" fill="transparent" />
<path
d="M 130 10 C 120 20, 180 20, 170 10"
stroke="black"
fill="transparent" />
<path d="M 10 60 C 20 80, 40 80, 50 60" stroke="black" fill="transparent" />
<path d="M 70 60 C 70 80, 110 80, 110 60" stroke="black" fill="transparent" />
<path
d="M 130 60 C 120 80, 180 80, 170 60"
stroke="black"
fill="transparent" />
<path
d="M 10 110 C 20 140, 40 140, 50 110"
stroke="black"
fill="transparent" />
<path
d="M 70 110 C 70 140, 110 140, 110 110"
stroke="black"
fill="transparent" />
<path
d="M 130 110 C 120 140, 180 140, 170 110"
stroke="black"
fill="transparent" />
</svg>
上の例では 9 つのベジェ曲線を作成しています。曲線が右へ進むにつれて、制御点は水平方向に離れていきます。また曲線が下へ進むにつれて、制御点は終点から遠く離れていきます。ここで特筆することは、曲線は 1 番目の制御点の方向へ出発し、2 番目の制御点の方向に沿って到着するということです。
長いなめらかな図形を描くために、複数のベジェ曲線をつなぐことができます。この場合はたいてい、ある点の片方の制御点はもう一方で使われる制御点の対向になるでしょう (傾斜を一定に保つ場合)。この場合はコマンド S (または s) で示される、三次ベジェ曲線の短縮版を用いることができます。
S x2 y2, x y (または) s dx2 dy2, dx dy
S は前に示したものと同種の曲線を生成しますが、これが別の S コマンドや C コマンドの後に続く場合は、1 番目の制御点が前を曲線で用いられた制御点の対向にするものとみなします。S コマンドが別の S または C コマンドの後にない場合は、その曲線の 2 つの制御点は同じ場所であるとみなします。この場合は、 Q コマンドに同じ引数を与えて出力する結果と同じ結果になります。
この構文の例を以下に示しますが、左の図では、指定された制御点が赤、推定された制御点が青で示されています。
<svg width="190" height="160" xmlns="http://www.w3.org/2000/svg">
<path
d="M 10 80 C 40 10, 65 10, 95 80 S 150 150, 180 80"
stroke="black"
fill="transparent" />
</svg>
もう一つの種類のベジェ曲線は二次ベジェ曲線 Q であり、こちらは三次ベジェ曲線よりシンプルな曲線です。基本的に制御点を 1 つだけ必要とし、それは始点側と終点側両方の曲線の傾斜を定義します。このコマンドは制御点と曲線の終点を示す 2 つの引数を持ちます。
メモ:
q コマンドにおける座標の差分は、どちらも前回の点からの相対座標です (すなわち dx と dy は dx1 と dy1 に対する相対座標ではありません)。
Q x1 y1, x y (または) q dx1 dy1, dx dy
<svg width="190" height="160" xmlns="http://www.w3.org/2000/svg">
<path d="M 10 80 Q 95 10 180 80" stroke="black" fill="transparent" />
</svg>
三次ベジェ曲線の場合と同様に、二次ベジェ曲線のセットをつなぎ合わせるためのショートカットである T があります。
T x y (または) t dx dy
このショートカットは前に用いた制御点を参照して、そこから新しい制御点を推測します。これは、最初の制御点を指定した後は終点を指定するだけで、ある程度複雑な図形を作成できることを意味します。
このコマンドは前のコマンドが Q または T コマンドである場合のみ動作します。そうではない場合、制御点は前の点と同じであるとみなして直線が描画されるだけになります。
<svg width="190" height="160" xmlns="http://www.w3.org/2000/svg">
<path
d="M 10 80 Q 52.5 10, 95 80 T 180 80"
stroke="black"
fill="transparent" />
</svg>
三次ベジェ曲線は描きたい曲線の形状をより自由に指定できますが、どちらの曲線もかなり似た結果になります。どちらの曲線を用いるかはたいてい、そのときの状況や曲線の対称度に依存します。
円弧
SVG を用いて作成できる別のタイプの曲線が円弧 A コマンドです。円弧の本質は円または楕円の一部分です。
与えられた X 軸と Y 軸の半径について、2 つの点に接する楕円は (それらが円の半径の範囲内にある限り) 2 つあります。どちらにも 2 点を結ぶパスが 2 つずつあるため、どのような場合でも考えられる円弧は 4 つあります。
このため、円弧はかなり多くの引数をとります。
A rx ry x-axis-rotation large-arc-flag sweep-flag x y a rx ry x-axis-rotation large-arc-flag sweep-flag dx dy
始めに arc 要素は、円弧の X 軸方向の半径と Y 軸方向の半径を示す 2 つの引数を持ちます。必要に応じて <ellipse> で同動作するかを確認してください。後の 2 つの引数は、描画が終了する X および Y 座標を示します。
3 番目の引数は、円弧の回転度を示します。これは次の説明が最適です。
<svg width="320" height="320" xmlns="http://www.w3.org/2000/svg">
<path
d="M 10 315
L 110 215
A 30 50 0 0 1 162.55 162.45
L 172.55 152.45
A 30 50 -45 0 1 215.1 109.9
L 315 10"
stroke="black"
fill="green"
stroke-width="2"
fill-opacity="0.5" />
</svg>
この例では、ページを斜めに横切る <path> 要素を示しています。その中央では、2 つの楕円弧(X 軸方向の半径 = 30、Y 軸方向の半径 = 50)が切り抜かれています。1 つ目の円弧では x-axis-rotation が 0 なので、円弧が通る楕円(赤色で表示)は垂直になっています。一方、2 つ目の円弧では x-axis-rotation が -45 度です。これにより楕円が回転し、例の図にあるとおり、短半径がパスの方向に沿うように並びます。
上の図の回転していない楕円については、円弧の始点と終点から引かれた線が楕円の中心を通るので、選べる円弧は 4 つではなく 2 つだけです。少し修正した例では、4 つの異なる円弧を形成する 2 つの楕円を見ることができます。
<svg xmlns="http://www.w3.org/2000/svg" width="320" height="320">
<path
d="M 10 315
L 110 215
A 36 60 0 0 1 150.71 170.29
L 172.55 152.45
A 30 50 -45 0 1 215.1 109.9
L 315 10"
stroke="black"
fill="green"
stroke-width="2"
fill-opacity="0.5" />
</svg>
それぞれの楕円は、時計回りまたは反時計回りに進む 2 つの円弧で構成されていることに注意してください。各楕円には短い円弧と長い円弧があります。2 つの楕円は互いに鏡像で、始点から終点へ引いた線を軸に反転しています。
始点と終点の間隔が楕円の x 半径と y 半径で届く距離を超えると、楕円の半径は始点と終点に届くように必要最小限だけ拡大されます。このページ下部の対話型デモで、この動作を確認できます。楕円の半径を拡大する必要があるかどうかを判断するには、このような方程式系を解く必要があります。この計算は、始点 (110, 215) と終点 (150.71, 170.29) の非回転楕円についてのものです。解 (x, y) は楕円の中心です。楕円の半径が小さすぎると、解は虚数になります。この 2 番目の計算は、始点 (110, 215) と終点 (162.55, 162.45) の非回転楕円についてのものです。楕円はわずかに拡大されただけなので、この解には小さな虚数成分が含まれています。
前述した 4 つの異なるパスは、次の 2 つの引数フラグによって決まります。パスが通る楕円には 2 つの候補があり、それぞれの楕円上にも 2 つのパスの候補があるため、合計 4 つのパスが考えられます。最初の引数は large-arc-flag です。円弧が 180 度より大きいか小さいかを決め、最終的には指定した円の周りを円弧がどちら向きに進むかを決定します。2 番目の引数は sweep-flag です。円弧が正または負の角度で描き始めるかを決め、基本的にはどちらの円に沿って進むかを選びます。以下の例では、4 つの組み合わせと、それぞれに対応する 2 つの円を示しています。
<svg width="360" height="360" xmlns="http://www.w3.org/2000/svg">
<path
d="M 100 100
A 45 45, 0, 0, 0, 145 145
L 145 100 Z"
fill="#00FF00A0"
stroke="black"
stroke-width="2" />
<path
d="M 250 100
A 45 45, 0, 1, 0, 295 145
L 295 100 Z"
fill="#FF0000A0"
stroke="black"
stroke-width="2" />
<path
d="M 100 250
A 45 45, 0, 0, 1, 145 295
L 145 250 Z"
fill="#FF00FFA0"
stroke="black"
stroke-width="2" />
<path
d="M 250 250
A 45 45, 0, 1, 1, 295 295
L 295 250 Z"
fill="#0000FFA0"
stroke="black"
stroke-width="2" />
<path
d="M 45 45 L 345 45 L 345 345 L 45 345 Z M 195 45 L 195 345 M 45 195 L 345 195"
fill="none"
stroke="black" />
<text x="140" y="20" font-size="20" fill="black">large-arc-flag</text>
<text
x="-15"
y="195"
font-size="20"
fill="black"
transform="rotate(-90)"
transform-origin="20 195">
sweep-flag
</text>
<text x="120" y="40" font-size="20" fill="black">0</text>
<text x="270" y="40" font-size="20" fill="black">1</text>
<text x="30" y="120" font-size="20" fill="black">0</text>
<text x="30" y="270" font-size="20" fill="black">1</text>
</svg>
円弧は、図面の中で円や楕円のピースを簡単に作成する方法です。例えば、円グラフでは、各ピースごとに異なる円弧が必要になります。
<canvas> から SVG に移行する場合、弧は学ぶのが最も難しいことかもしれませんが、その一方で、より強力な機能でもあります。SVG の弧が描画できない唯一の図形は、完全な円と楕円です。円を囲むパスは、その開始点と終了点が同じ点であるため、選択できる円の数は無限であり、実際のパスは未定義になります。パスの開始点と終了点をわずかにずらし、別のパス区間でつなぐことで、円に近づけることができます。例えば、半円ごとに弧を描いて円を作成することができます。この点では、実際の <circle> や <ellipse> ノードを使用するほうが簡単な場合が多いでしょう。この対話型デモは、SVG の弧の概念を理解するのに役立つかもしれません。