Recomposed
Canvas

클리핑의 기초: 캔버스 클립 스택 대 레이어 + 아웃라인 마스크

Oct 18, 2026 · 2 min read

클리핑의 기초: 캔버스 클립 스택 대 레이어 + 아웃라인 마스크

직관적으로 이해하기

클리핑과 마스킹을 API만 다른 동일한 동작, 즉 둘 다 "이 콘텐츠에서 원치 않는 부분을 잘라낸다"라고 취급하고 싶은 유혹이 있다. 단순한 경우에는 그 결과가 맞지만, 경계가 단순한 직선보다 조금이라도 흥미로워지는 순간 그 사고 모델은 틀린 것이 된다.

  • 클립은 예/아니오 테스트다: 어떤 draw 호출이 건드리려는 모든 픽셀에 대해, 클립 스택은 "이 점이 도형 내부에 있는가"를 묻고, 그 답은 이항적이다. 60%만 클리핑된 픽셀 같은 건 존재하지 않는다.
  • 마스크는 알파 곱셈이다: 이미 렌더링된 결과를 가져와서 그 알파값을 두 번째 이미지의 알파값으로 픽셀 단위로 스케일링한다. 그 두 번째 이미지는 0에서 1 사이의 어떤 알파값이든, 그레이디언트든, 블러든, 사진 자체의 휘도든 가질 수 있다. "도형이냐 아니냐"에 국한되지 않는다.
  • 클리핑은 draw 호출이 무엇을 그리기 전에 어디에 쓸 수 있는지에 대한 제약으로 해석된다. 마스킹은 이미 완전히 그려진 콘텐츠에 대한 블렌드로서 해석된다.

이 두 메커니즘은 단 한 가지 특수한 경우에만 동일한 픽셀을 만들어낸다: 경계가 뚜렷한 불투명 도형. 바로 그 겹치는 부분 때문에 둘을 서로 바꿔 써도 되는 것처럼 취급되다가, 부드러운 경계가 필요한 순간 둘 중 하나가 구조적으로 그걸 제공할 수 없다는 사실을 발견하게 된다.

구체적인 예: 사진 가장자리를 페이드하기

"이걸 어떤 모양으로 잘라내라"는 요구에는 당연히 clipPath가 먼저 떠오른다:

// Canvas clip stack: clipPath pushes a binary stencil onto the canvas.
// Every pixel inside the path is fully visible, every pixel outside it
// is fully gone. There is no third option, so the bottom edge of the
// photo just stops, hard, at whatever line you draw.
Canvas(Modifier.size(240.dp)) {
    val fadeLine = size.height * 0.7f
    clipRect(bottom = fadeLine) {
        drawImage(photo, dstSize = IntSize(size.width.toInt(), size.height.toInt()))
    }
}

fadeLine을 점점 줄여도 페이드가 생기지 않고, 더 작은 위치에서 생기는 또 다른 하드 컷오프만 생길 뿐이다. 클립 경계는 그것이 그려지는 바로 그 한 경계선에서는 될 수 있지만, 그 경계선 앞 40px 구간을 점점 투명하게 만들 수는 없다. "점점 투명해짐"이라는 것 자체가 클립 스택의 개념에 전혀 존재하지 않기 때문이다. 마스킹은 그렇지 않다:

// Layer + mask: draw the photo into its own layer, then composite a
// gradient on top with DstIn. DstIn keeps dst (the photo, already
// rendered) scaled by src's alpha (the gradient), and the gradient's
// alpha runs continuously from 1 to 0, so the photo fades instead of
// cutting off.
Box(
    Modifier
        .size(240.dp)
        .graphicsLayer { compositingStrategy = CompositingStrategy.Offscreen }
        .drawWithContent {
            drawContent()
            drawRect(
                brush = Brush.verticalGradient(
                    0.6f to Color.Black,
                    1f to Color.Transparent,
                ),
                blendMode = BlendMode.DstIn,
            )
        },
) {
    Image(photo, contentDescription = null, modifier = Modifier.fillMaxSize())
}

시각적 목표는 동일하다, 즉 사진의 아래쪽을 잘라내는 것인데, 마스크 버전은 클립 버전이 구조적으로 표현할 수 없는 것, 즉 부분적으로만 보이는 영역을 표현할 수 있다.

Drag the line. Everything past it is just gone, no partial values. Clip mode: the boundary is a hard yes or no test, nothing past the line is visible, with no gradual fade.

핵심 원리

클리핑은 draw 호출이 어디에 쓸 수 있는지를 제한한다: 기하학적 경계에 대한 이항적인 내부/외부 테스트이며, 어떤 페인팅이 일어나기 전에 해석된다.

마스킹은 알파 합성 단계다. 보통 BlendMode.DstIn/SrcIn을 이미 렌더링된 레이어에 적용하여 기존 픽셀을 두 번째 이미지의 알파 채널로 곱한다. 마스크의 알파값은 연속적으로 변할 수 있지만, 클립의 답은 언제나 예 또는 아니오뿐이다.

Modifier.clip(shape)은 이항적인 경우를 위한 내장 단축 수단이다. clipPath를 직접 다루는 수고를 덜어주지만, 여전히 클립이다: 부드러운 경계를 요청해도 물어볼 것이 없다, 그 도형에는 농도를 조절할 알파 채널 자체가 없기 때문이다.

같은 비대칭성이 각각이 입력으로 받는 것에서도 드러난다. 클립의 경계는 항상 Path(또는 그것으로 컴파일되는 Shape의 외곽선)다; 기하학적 내부/외부 테스트를 설명할 다른 방법이 없기 때문이다.

마스크의 소스는 그럴 필요가 없다. 그저 그 레이어에 렌더링된 무엇이든 될 수 있다: 그레이디언트로 채워진 사각형, 블러 처리된 원, 사진 자체의 픽셀. Path는 거기에 그릴 수 있었던 수많은 것들 중 하나일 뿐이다.

다른 곳에서는: 같은 원리, 다른 프레임워크

  • CSS: clip-path는 이항적인 내부/외부를 가르는 단단한 기하학적 경계이지만, mask-image는 그레이디언트나 부분 알파를 가진 PNG를 받아들여 그에 따라 페이드한다, 왜냐하면 이것은 도형 소속 여부를 테스트하는 것이 아니라 알파값을 읽는 것이기 때문이다.
  • SVG: <clipPath>는 자식 도형들을 합쳐 하나의 이항적인 내부/외부 테스트로 만든다. <mask>는 설계상 명시적으로 단계적이다: 마스크 콘텐츠의 흰색 픽셀은 완전히 보임을, 검은색은 완전히 숨김을, 회색은 부분적으로 보임을 의미하며, 이는 <clipPath>가 표현할 방법이 없는 연속체다.
  • CoreAnimation (iOS): cornerRadius와 함께 쓰인 layer.masksToBounds는 레이어 자신의 기하학적 경계에 클리핑한다, 이항적이고 도형만으로 결정된다. 대신 layer.mask를 CAGradientLayer로 설정하면 진짜 알파 페이드가 만들어진다, 왜냐하면 mask는 경계를 테스트하는 대신 마스크 레이어의 알파 채널을 읽기 때문이다.
  • SwiftUI: .clipShape(RoundedRectangle(cornerRadius: 16))은 다른 곳과 마찬가지로 이항적인 기하학적 컷이다. .mask(LinearGradient(colors: [.black, .clear], startPoint: .top, endPoint: .bottom))은 대신 그레이디언트 뷰의 알파를 읽는다, 스크롤 뷰 가장자리를 페이드할 때 쓰이는 SwiftUI의 표준적인 트릭이며, 위 Compose 예제와 동일한 DstIn 방식의 메커니즘이고, 그저 뷰 모디파이어로 표현된 것일 뿐이다.
  • Flutter: ClipRRect/ClipPath/ClipOval은 자식을 그리기 전에 캔버스에 이항적인 클립을 적용한다. ShaderMask는 대신 Shader(예: LinearGradient)를 BlendMode를 통해 이미 그려진 자식 위에 알파 마스크로 적용한다, 동일한 DstIn 방식의 연속적인 페이드다.

사용 사례: 실제로 무엇을 선택해야 하는가

  • 둥근 아바타나 썸네일: 클립. 경계는 페이드할 것이 전혀 없는 고정된 기하학적 도형이며, 클립이 만들어진 바로 그 이항적인 경우에 정확히 들어맞는다. Modifier.clip(CircleShape).
  • 스크롤 가능한 리스트의 위/아래 가장자리를 페이드하여 행이 중간에서 잘린 것처럼 보이지 않게 하기: 마스크. 가장자리는 몇 픽셀의 구간을 거쳐 완전히 불투명에서 완전히 투명으로 바뀌어야 하며, 이는 경계 테스트가 아니라 오직 연속적인 알파 그레이디언트만이 표현할 수 있다.
  • 사진에 파낸 듯이 보이는 텍스트(텍스트 모양으로 구멍이 난 느낌): BlendMode.DstOut을 통한 마스크. 왜냐하면 draw 호출이 어디에 놓일 수 있는지를 제한하는 것이 아니라, 다른 도형의 알파값을 기준으로 이미 그려진 레이어의 일부를 지우는 것이기 때문이다.
  • 사진을 고정된 종횡비 프레임에 맞춰 크롭하기: 클립. 프레임의 경계는 고정된 기하학적 경계이며, 페이드할 것이 전혀 없다, 그 바깥의 픽셀은 그냥 존재하지 않아야 한다.
  • 사진 테두리 주변의 부드러운 비네트: 라디얼 그레이디언트를 알파 소스로 쓰는 마스크, 위 페이드 예제와 동일한 DstIn 메커니즘이지만 선형이 아니라 방사형일 뿐이다.

엣지 케이스

  • 자신의 그림자를 클리핑으로 잘라내는 경우. clip()은 "흘러넘쳐야 하는 콘텐츠"에 대한 예외를 두지 않는다. 그 안에 중첩된 모든 draw 호출에 동일한 이항적 내부/외부 테스트를 적용하며, 이는 shadow() 자체의 블러에도 마찬가지다. 그래서 클립 안에 중첩된 그림자는 원래 그 경계를 넘어 흘러나가야 했는데도 바로 그 경계에서 조용히 잘려나간다:

    // clip is outside shadow here, so shadow is nested inside the clip
    // scope. The clip stack doesn't know "that draw call was a shadow,"
    // it just sees a draw call outside its geometric bounds and discards it.
    Modifier
        .clip(RoundedCornerShape(16.dp))
        .shadow(8.dp, RoundedCornerShape(16.dp))

    이것은 DstIn으로 고칠 마스킹 문제가 아니라, 클립이 무조건적이라는 사실을 보여주는 사례다: 그 경계에 짓눌리지 않길 원하는 것은 더 큰 반경을 준다고 되는 게 아니라, 클리핑된 범위 바깥에서 완전히 따로 그려야 한다.

  • 중첩된 클립은 서로 한다, 덮어쓰지 않는다. 중첩된 두 개의 clipRect(또는 clipPath) 범위는 안쪽 범위가 바깥쪽 범위의 경계를 대체하도록 허용하지 않는다, 클립 스택은 둘을 AND 연산으로 합친다:

    // Outer clip keeps only the left 80% of the canvas. Inner clip asks
    // for the right 80%. They overlap in the middle 60%, and that's all
    // that's actually visible, even though the inner clip's own bounds
    // reach further right than the outer clip allows.
    clipRect(right = size.width * 0.8f) {
        clipRect(left = size.width * 0.2f) {
            drawImage(photo, dstSize = IntSize(size.width.toInt(), size.height.toInt()))
        }
    }

    가장 안쪽 클립이 최종적으로 보이는 영역을 단독으로 결정하리라 예상했다면, 바로 여기서 뜻밖의 결과를 보게 된다: 보이는 영역은 언제나 현재 스택에 올라와 있는 모든 클립의 교집합이며, 결코 가장 최근에 적용된 클립만으로 결정되지 않는다.

실제로 써야 할 사고 모델

클립은 예/아니오 질문(이 점이 도형 내부에 있는가)에 답하고, 마스크는 얼마나(how much) 질문(이 픽셀의 알파값을 저것으로 곱하라)에 답한다. 경계가 정말로 단단한 기하학적 직선일 때는 클립을 쓰고, 그 경계의 일부라도 완전히 안이거나 완전히 밖인 것 이상이 되어야 하는 순간에는 마스크를 써라.

Keep reading

Related reads

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