Recomposed
Canvas

Path.op(): 클립 체조 없이 모양 합성하기

Oct 19, 2026 · 1 min read

Path.op(): 클립 체조 없이 모양 합성하기

직관적으로 이해하기

카드에서 홈을 하나 파내거나, 겹쳐진 두 블롭을 하나의 윤곽선으로 합쳐야 한다면 어떨까요? clip()이 딱 맞는 도구처럼 보이지만, 사실 이런 작업을 위해 만들어진 게 아닙니다:

  • clip()은 이미 그려진 것을 모양으로 제한하는 역할만 합니다. 두 모양을 하나의 새로운 윤곽선으로 합칠 수도 없고, "겹치는 부분만" 또는 "A에서 B를 뺀 부분"을 실제로 재사용 가능한 path로 만들어낼 수도 없습니다.
  • 흔히 쓰는 우회 방법은 가짜로 흉내 내는 것입니다: 카드를 그린 다음, 배경색과 같은 원을 그 위에 그려서 가장자리를 베어낸 것처럼 시뮬레이션하는 방식입니다. border()를 추가하기 전까지는 멀쩍이 보이지만, border를 추가하면 원을 완전히 무시하고 여전히 둥근 사각형 전체 윤곽선을 그립니다. 바탕이 되는 path 자체는 한 번도 바뀐 적이 없기 때문입니다. hit-testing과 PathMeasure 역시 같은 이유로 똑같이 틀리게 동작합니다.
  • Path.op()는 두 개의 소스 path와 boolean 규칙으로부터 실제 새로운 Path를 geometry 차원에서 계산해 냅니다. 홈(또는 합치기, 또는 겹치는 부분)이 시각적 근사치가 아니라 실제 윤곽선 데이터가 되는 것입니다.

홈 파내기: 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 notch
FIG. 01
Faked notch (left): border ignores it. Path.op() Difference (right): border follows the real cut.

cut은 실제 path입니다: stroke를 입히든, 여기에 clip을 걸든, hit-test를 하든, PathMeasure에 넘기든, 어떤 경우에도 홈이 반영됩니다. 그 위에 덧칠된 게 아니라 path 자체의 point 데이터 안에 들어 있기 때문입니다.

네 가지 연산, 하나의 모양 쌍

같은 메커니즘이 "홈 파내기"보다 더 많은 것에 답을 줍니다. 겹치는 두 개의 원으로 어떤 PathOperation을 고르느냐에 따라 네 가지 다른 결과를 만들 수 있습니다:

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) }

같은 두 원, 같은 호출 형태, 오직 operation만 바뀝니다:

operationresult가 유지하는 것
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는 그렇지 않습니다: 항상 "첫 번째 인자에서 두 번째 인자를 뺀 것"을 의미합니다. PathOperation.ReverseDifference가 존재하는 이유는 바로, 인자의 순서를 바꾸지 않고도 어느 쪽 모양을 뺄지 뒤집을 수 있게 하기 위해서입니다. a와 b가 코드베이스 곳곳에서 바꿔 쓰고 싶지 않은 이름 붙은 변수일 때 유용합니다.

핵심 개념

이것이 바로 boolean path 합성입니다: 두 모양을 점들의 집합으로 취급하고, 집합 연산으로 이들을 결합하는 것입니다. Union은 어느 한쪽이라도 포함된 모양의 점을 유지하고, intersect는 양쪽 모두에 포함된 점을 유지하며, difference는 첫 번째 모양에는 있지만 두 번째 모양에는 없는 점을 유지하고, xor는 정확히 한쪽에만 포함된 점을 유지합니다. 결과는 원본 위에 덧씌운 시각 효과가 아니라, 점과 곡선으로 이루어진 새로운 시퀀스, 즉 실제 geometry로 계산됩니다.

다른 곳에서는: 같은 핵심 개념, 다른 프레임워크

  • Figma / Illustrator Pathfinder: 같은 네 가지 연산을 Union, Subtract, Intersect, Exclude라는 이름으로 제공합니다. Subtract가 Difference에, Exclude가 Xor에 해당하며, 디자이너들은 이 글에서 다루는 것과 똑같은 홈 파내기와 모양 합치기를 하기 위해 바로 이 패널을 사용합니다.
  • SwiftUI / Core Graphics: 눈에 띄게 빠져 있습니다. CGPath, UIBezierPath, 그리고 SwiftUI의 Path에는 union, subtract, intersect, xor에 해당하는 기능이 내장되어 있지 않습니다. iOS 개발자들은 VectorBoolean 같은 서드파티 라이브러리를 사용하거나, 이 글의 서두에서 반박했던 "위에 모양을 덧그리는" 가짜 방법으로 되돌아갑니다. 플랫폼이 실제 기능을 한 번도 제공한 적이 없기 때문입니다.
  • Blender의 Boolean modifier, OpenSCAD의 union()/difference()/ intersection(): 동일한 수학을 2D path에서 3D volume으로 확장한 것으로, 정식 명칭인 **constructive solid geometry(CSG)**로 불립니다. 카드에 홈을 파내는 것과 3D 프린팅된 브래킷에 구멍을 뚫는 것은 차원이 하나 다를 뿐, 같은 집합 연산입니다.
  • Shapely(Python): polygon 객체에 대한 .union(), .difference(), .intersection(), .symmetric_difference()로, UI가 아니라 GIS와 공간 중첩 쿼리에 쓰이지만, 이것 역시 집합론적 이름 그대로의 동일한 네 가지 연산입니다.

예외 상황

Boolean 반환값은 계산 실패를 알리는 신호이지, 결과가 비어 있다는 뜻이 아닙니다. op()는 계산 자체를 할 수 없을 때, 보통 입력 path 중 하나에 non-finite한 point가 포함되어 있을 때 false를 반환합니다. 결과로 나온 모양이 비어 있어서가 아닙니다. 서로 겹치지 않는 두 원을 intersect하는 것은 완전히 유효한 호출이며, true를 반환하고 빈 path를 남깁니다. 다른 어떤 서로 떨어진 모양을 intersect할 때와 마찬가지입니다.

receiver가 이전에 갖고 있던 내용은 합쳐지는 게 아니라 교체됩니다. result.op(a, b, operation)은 result를 a와 b를 합친 결과로 설정하는 것이며, 호출 이전에 result가 갖고 있던 내용은 계산에 반영되지 않고 버려집니다. 오래 유지되는 Path를 destination으로 재사용할 때 먼저 reset()을 호출할 필요는 없지만, 동시에 이전 내용이 그대로 남아 있을 거라고 기대할 수도 없다는 뜻입니다. 여러 연산에 걸쳐 결과를 쌓아 올리려면, 같은 객체에 대해 op()를 반복 호출해서 누적되기를 기대하는 대신, 이전 호출의 출력을 다음 호출의 두 입력 path 중 하나로 다시 넘겨주어야 합니다.

fill rule은 여전히 각 소스 모양에 먼저 적용됩니다. boolean 연산이 실행되기 전에, "이 point가 path a 안에 있는가"라는 질문은 a와 b 각각에 대해 개별적으로 답을 구해야 합니다. 이는 어떤 fill rule이든 답해야 하는, 스스로 교차하는 path에 대한 동일한 질문입니다. 스스로 교차하는 소스 path는 op()가 다른 모양과 합치기 전에 자신의 fill rule에 따라 먼저 해석됩니다.

실제로 써먹을 사고 모델

Path.op()는 레이어로 그림을 겹쳐서 자르거나 합친 것처럼 흉내 내는 것이 아니라, 실제로 새로운 윤곽선을 계산해 냅니다. 원하는 모양을 직접 그릴 수는 없지만 "A와 B를 집합 연산으로 합친 것"으로 설명할 수 있다면, 언제든 이를 사용하세요: stroke, clip, hit-test, PathMeasure 모두 여러분이 보는 것과 똑같은 모양을 보게 됩니다.

Keep reading

Related reads

새 글을 이메일로 받아보세요