マスクの反転
mask-invert
mask を反転させ、形を削除してその周囲を残します。結果はマスクを 1 から引いたものに正確に一致するため、mask が残していた形が透明な穴になります。切り抜き (クロップ) ではなくステンシルです。
mask-invert はすべてのマスクタイプで機能します。ellipse、corners、poly3 から poly32、および画像 URL が対象です。
有効な値
| 値 | 結果 |
|---|---|
false | デフォルト。マスクは形を残し、その周囲を破棄します。 |
true | マスクが反転します。形が透明な穴になり、その周囲が残ります。 |
何が残るか
ノックアウトはマスクの正反対です。マスクがピクセルを残す箇所ではノックアウトがそれを削除し、その逆も同様です。
| 反転時の動作 | |
|---|---|
ellipse、corners、poly3–poly32 | 画像と同じ大きさで描画されるため、反転するとその外側だけが残ります。楕円であれば周囲の角、角丸矩形であれば丸められる断片です。画像の中央により小さな形の穴をあけるには、画像マスクを使用してください。 |
| 画像マスク | 明度が反転します。白い領域が削除され、黒い領域が残ります。 |
fade | ぼかした縁も同じように、反転した形でフェードします。 |
pad | パディングは形の外側にあるため、マスクはこれに影響しません。 |
border | 形の縁に沿って描画され、ノックアウトの輪郭を縁取ります。 |
| ウォーターマークとテキスト | マスクの後に描画されるため、マスクに削除されることはありません。 |
透明部分を塗りつぶす
穴は、mask-bg を指定した場合はどのフォーマットでもその色になります。指定しない場合は次のとおりです。
- 透明度を扱えるフォーマット (PNG、WebP、AVIF) では穴は透明になります。
- JPEG と GIF では白で塗りつぶされます。
auto=compressを指定しfmを指定しない場合、JPEG ソースでも穴は透明のまま保持され、PNG として配信されます。fm=jpgを指定すると常に塗りつぶされます。
drop-shadow を併用する場合、穴はデフォルトの白では塗りつぶされません。代わりに bg が形の背景となり、影はノックアウトの縁に沿って落ちます。
デモ
穴を見やすくするため、各例には transparency=grid を付けてチェッカーボードを表示しています。mask-invert の使用に必須ではありません。
mask=ellipse — 基準となる表示です。楕円が残り、4 つの角が破棄されます。https://static-a.imgix.net/espresso.jpg?w=300&h=300&fit=crop&fm=png&mask=ellipse&transparency=grid

関連項目
幾何学的な形ではなくブレンドレイヤーやテキストで画像を切り抜くには、ノックアウト用のブレンドモードを使用します。blend-mode と txt-blend-mode を参照してください。