直感的な理解
クリッピングとマスキングを、APIが違うだけの同じ操作、つまりどちらも「このコンテンツの不要な部分を切り落とす」ものとして扱いたくなります。単純なケースではそれが正しい結果になりますが、エッジが単なる直線より少し複雑になった瞬間、そのメンタルモデルは間違いになります。
- クリップはyes/noのテストです。描画呼び出しが触れようとするすべてのピクセルについて、クリップスタックは「この点はシェイプの内側か」を問い、答えは二値です。60%だけクリップされたピクセルというものは存在しません。
- マスクはアルファの乗算です。すでにレンダリングされたものを受け取り、そのアルファを別の画像のアルファでピクセルごとにスケーリングします。その2枚目の画像は0から1までの任意のアルファ値、グラデーション、ブラー、写真自体の輝度などを持つことができ、「シェイプかそうでないか」だけではありません。
- クリッピングは描画呼び出しが何かをペイントする前に解決され、どこに書き込みを許可するかの制限として機能します。マスキングはすでに完全にペイントされたコンテンツに対するブレンドとして解決されます。
これら2つの仕組みは、ある特定のケースにおいてのみ同一のピクセルを生成します。それはハードエッジを持つ不透明なシェイプの場合です。この重なりこそが、両者が互換可能なものとして扱われる理由であり、ソフトエッジが必要になり、一方が構造的にそれを提供できないと発覚するまで、その誤解は続きます。
- →BlendMode vs CompositingStrategy: It's Not a Fence, It's a Different CanvasDstIn, SrcIn, and the Offscreen layer this post's masking technique builds on, explained from the blend-formula side.
- →Modifier Order Matters: It's a Wrapper Chain, Not a Property BagWhy clip() has to sit on the outside of background() or border() to actually cut them, the wrapper-chain reasoning this post's clip stack relies on.
具体例: 写真の端をフェードさせる
「これをシェイプに切り取る」ための明白な手段として、まず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を徐々に縮めても、フェードは生まれず、より小さいハードカットオフが生まれるだけです。クリップの境界は、それが描く1本のエッジにおいてはできますが、そのエッジの手前の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.
本質
クリッピングは描画呼び出しがどこに書き込むことを許可するかを制限します。ペイントが行われる前に解決される、幾何的な境界に対する二値の内側/外側テストです。
マスキングはアルファ合成のステップで、通常はBlendMode.DstIn/SrcInを使って、すでにレンダリング済みのレイヤーに対して、既存のピクセルを別の画像のアルファチャンネルで乗算します。マスクのアルファは連続的に変化できますが、クリップの答えは常にyesかnoしかありません。
Modifier.clip(shape)は二値ケース用の組み込みショートカットです。clipPathを手動で管理する手間を省いてくれますが、それでもクリップであることに変わりはありません。ソフトエッジを求めても、求める先がないのです。そのシェイプには段階づけできるアルファチャンネルがそもそもありません。
同じ非対称性は、それぞれが入力として受け取るものにも表れます。クリップの境界は常にPath(またはShapeのアウトラインで、これも結局Pathにコンパイルされます)です。幾何的な内側/外側テストを記述する他の方法は存在しません。
マスクのソースはそうである必要がありません。そのレイヤーにレンダリングされたものであれば何でも構いません。グラデーションで塗られた矩形、ブラーのかかった円、写真自体のピクセルなど。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経由です。描画呼び出しの書き込み先を制限しているのではなく、すでにペイント済みのレイヤーの一部を、別のシェイプのアルファに基づいて消去しているからです。 - 写真を固定のアスペクト比のフレームに切り出すこと: クリップ。フレームのエッジは固定の幾何的境界であり、フェードさせるものは何もなく、その外側のピクセルはそもそも存在してはいけません。
- 写真の境界周りのソフトなビネット: マスク。アルファソースとしてラジアルグラデーションを使う、上のフェードの例と同じDstInの仕組みで、リニアではなくラジアルであるだけです。
エッジケース
-
自分自身の影を切り取ってしまう。
clip()は「はみ出すことを意図したコンテンツ」のための例外を設けません。ネストされたすべての描画呼び出しに対して同じ二値の内側/外側テストを適用します。shadow()自身のブラーも含めてです。そのため、クリップの内側にネストされた影は、それが本来はみ出すはずだった境界で、まさにそこで黙って切り取られてしまいます。// ここでは clip が shadow の外側にあるため、shadow は clip のスコープ // 内にネストされる。クリップスタックは「あの描画呼び出しは shadow // だった」ということを知らず、単にその幾何的境界の外にある描画呼び出し // として見て、破棄するだけだ。 Modifier .clip(RoundedCornerShape(16.dp)) .shadow(8.dp, RoundedCornerShape(16.dp))これは
DstInで解決するマスキングの問題ではなく、クリップが無条件であることを思い出させるものです。その境界に対してフラットに切られたくないものは、より大きな半径でクリップの内側に描くのではなく、クリップされたスコープの完全に外側に描く必要があります。 -
ネストされたクリップはするのであって、上書きするわけではない。 2つのネストされた
clipRect(またはclipPath)スコープは、内側のものが外側のものの境界を置き換えることを許しません。クリップスタックはそれらをANDで結合します。// 外側のクリップはキャンバスの左80%だけを保持する。内側のクリップは // 右80%を求める。それらは中央の60%で重なり、実際に見えるのはそれ // だけになる。内側のクリップ自体の範囲は、外側のクリップが許す範囲 // よりさらに右まで伸びているにもかかわらずだ。 clipRect(right = size.width * 0.8f) { clipRect(left = size.width * 0.2f) { drawImage(photo, dstSize = IntSize(size.width.toInt(), size.height.toInt())) } }最も内側のクリップが最終的な可視領域を単独で決めると予想していたなら、これが驚きになるでしょう。可視性は常にスタック上の現在のすべてのクリップの交差であり、最も新しいものだけでは決まりません。
実際に使うべきメンタルモデル
クリップはyes/noの問い(この点はシェイプの内側か)に答え、マスクはどれくらいかの問い(このピクセルのアルファをあれに掛ける)に答えます。エッジが本当にハードな幾何的な線であるならクリップに、そのエッジのどこかの部分が完全なin/outではなくなる必要が生じた瞬間、マスクに手を伸ばしましょう。



