Imgix APIsレンダリング APIマスク画像マスクの反転

マスクの反転

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
ellipse (not inverted)

関連項目

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