直感的な理解
カードに切り込みを入れたい、あるいは重なり合った2つのブロブを1つの輪郭にまとめたい——そんなとき clip() が適したツールに思えるが、実際はこの用途向けには作られていない。
clip()はあくまで、すでに描かれているものを 形状に制限するだけだ。2つの図形を1つの新しい輪郭に合成することはできないし、「重なり部分だけ」や「AからBを引いたもの」を実体のある再利用可能なパスとして生成することもできない。- よくある回避策は見せかけだけで済ませることだ。カードを描いてから、背景色の円をその上に重ねて、縁が欠けたように見せる。これは
border()を追加するまではうまく見えるが、border()は円を完全に無視して、角丸矩形全体の輪郭をそのままトレースしてしまう。なぜなら、元のパスそのものは何も変わっていないからだ。ヒットテストやPathMeasureも同じ理由で同じように誤った結果になる。 Path.op()は、2つの元パスとブール規則から、幾何学的に実際の新しいPathを計算する。切り込み(あるいは合成、あるいは重なり部分)は、見た目だけの近似ではなく、本物の輪郭データになる。
- →Clipping Fundamentals: Canvas Clip Stack vs. Layer + Outline MaskWhat clip() actually is, a stencil in front of paint operations, which is exactly the tool this post shows the limits of.
- →PathMeasure: Position and Direction at Any Distance Along a PathPath.op() hands back a real Path, and a real Path is exactly what PathMeasure needs to walk, stroke-reveal, or sample by distance.
切り込みを入れる:clip() は引けないが、Path.op() はできる
val card = Path().apply {
addRoundRect(RoundRect(0f, 0f, 300f, 160f, cornerRadius = CornerRadius(16f)))
}
val notch = Path().apply {
addOval(Rect(center = Offset(150f, 0f), radius = 24f))
}
// Faking it: paint a background-colored circle over the edge.
// Looks right with no border. Add one, and it still traces the
// untouched rounded rect, because `card` itself never changed.
drawPath(card, color = Color.White)
drawCircle(color = pageBackground, radius = 24f, center = Offset(150f, 0f))
drawPath(card, color = Color.Black, style = Stroke(width = 2f)) // ignores the notch
// Path.op(): the notch is cut from the actual outline.
val cut = Path()
cut.op(card, notch, PathOperation.Difference)
drawPath(cut, color = Color.White)
drawPath(cut, color = Color.Black, style = Stroke(width = 2f)) // follows the notchcut は本物のパスだ。これにストロークをかけても、これでクリップしても、これに対してヒットテストをしても、あるいは PathMeasure に渡しても、どれもみな切り込みを認識する。なぜなら、それはパス自身の点データの中に存在しており、上に描かれただけのものではないからだ。
4つの操作、1組の図形
同じ仕組みは「切り込みを入れる」以上のことに答えてくれる。重なり合った2つの円から、選ぶ PathOperation だけによって4通りの異なる結果が得られる。
val a = Path().apply { addOval(Rect(0f, 0f, 200f, 200f)) }
val b = Path().apply { addOval(Rect(100f, 0f, 300f, 200f)) }
val result = Path().apply { op(a, b, operation) }同じ2つの円、同じ呼び出しの形、変わるのは operation だけだ。
operation | result が保持するもの |
|---|---|
PathOperation.Union | どちらかの円に覆われている部分すべて |
PathOperation.Intersect | レンズ状に重なった部分のみ |
PathOperation.Difference | 円 a から重なり部分を取り除いたもの |
PathOperation.Xor | ちょうど片方の円だけに覆われている部分、両方ではない |
Drag circle B left or right. The filled shape is op(a, b, PathOperation.Union): everything covered by either circle. Union: everything covered by either circle.
Union と Intersect は対称だ。a と b を入れ替えても結果は同じになる。Difference はそうではない。常に「最初の引数から2番目の引数を引く」ことを意味する。PathOperation.ReverseDifference が存在するのはまさに、引数の順序を入れ替えずにどちらの図形を減算するかを切り替えられるようにするためで、a と b が名前付きの変数で、コードベース中でその並びを入れ替えたくない場合に便利だ。
根底にある考え方
これがブールパス合成だ。すなわち、2つの図形を覆われた点の集合として扱い、それらを集合演算で組み合わせることだ。union はいずれかの図形に含まれる点を保持し、intersect は両方に含まれる点を保持し、difference は最初の図形に含まれるが2番目には含まれない点を保持し、xor はちょうど1つの図形にだけ含まれる点を保持する。結果は実際のジオメトリとして——元の図形の上に重ねた視覚効果ではなく、点と曲線の新しい並びとして——計算される。
他のツールでは:根底にある考え方は同じ、フレームワークが違うだけ
- Figma / Illustrator の Pathfinder:同じ4つの操作が、Union、Subtract、Intersect、Exclude という名前で用意されている。Subtract が
Difference、Exclude がXorに当たり、デザイナーはまさにこのパネルを使って、本記事が扱っているのと同じ切り込みや図形合成を行う。 - SwiftUI / Core Graphics:著しく欠けている。
CGPath、UIBezierPath、SwiftUI のPathには union、subtract、intersect、xor に相当する組み込み機能がない。iOS 開発者は VectorBoolean のようなサードパーティライブラリに頼るか、あるいは本記事の冒頭で否定したまさにあの「上に図形を描いて見せかける」という手法に逆に頼ることになる。プラットフォームが本物の機能を一度も提供していないからだ。 - Blender のブーリアンモディファイア、OpenSCAD の
union()/difference()/intersection():同一の数学が2Dパスから3Dボリュームへと昇格したもので、その正式名称は**コンストラクティブ・ソリッド・ジオメトリ(CSG)**だ。カードに切り込みを入れることと、3Dプリントされたブラケットに穴を開けることは、次元が1つ違うだけの同じ集合演算なのだ。 - Shapely(Python):ポリゴンオブジェクトに対する
.union()、.difference()、.intersection()、.symmetric_difference()。UIではなく GIS や空間重なりクエリのために使われるが、集合論そのものの名前を使った同じ4つの操作だ。
エッジケース
Boolean の戻り値は計算の失敗を示すものであり、結果が空であることを示すものではない。 op() は計算そのものが不可能なときに false を返す。これは典型的には入力パスのどちらかが非有限な点を含んでいる場合であって、結果の図形がたまたま空になったからではない。重なっていない2つの円の intersect を取ることは完全に正当な呼び出しであり、true を返して空のパスを残す。これは他の離れた図形同士の intersect を取る場合と同じだ。
受け取り側のそれまでの内容は合成されるのではなく置き換えられる。 result.op(a, b, operation) は result を a と b を合成した結果に設定する。呼び出し前に result が保持していたものは、計算に組み込まれるのではなく破棄される。長く使い続ける Path を出力先として再利用する場合、事前に reset() を呼ぶ必要はないが、同時に、以前の内容が残っていることをあてにもできない。複数の操作をまたいで結果を積み上げたい場合は、同じオブジェクトに対して op() を繰り返し呼んで蓄積されることを期待するのではなく、前回の呼び出しの出力を次の呼び出しの2つの入力パスのどちらかに戻してやる必要がある。
フィルルールは最初に各元の図形を個別に支配する。 ブール演算の計算が走る前に、「この点はパス a の内側にあるか」という問いに、a と b それぞれについて個別に答えなければならない。これは、どのフィルルールも答える、自己交差するパスに関する同じ問いだ。自己交差する元のパスは、op() がそれをもう一方の図形と合成する前に、そのフィルルールによって解決される。
実際に使うためのメンタルモデル
Path.op() は描画を重ねて切り込みや合成を見せかけるのではなく、本物の新しい輪郭を計算する。 欲しい図形が直接描けるものではなく、「AとBを、ある集合演算で組み合わせたもの」として記述できる図形であるときは、いつでもこれに頼ればいい。ストローク、クリップ、ヒットテスト、PathMeasure のすべてが、あなたが見ているのと同じ図形を見ることになる。



