Imgix APIsレンダリング APIテキストテキストブレンドモード

テキストブレンドモード

txt-blend-mode

テキストレイヤーを画像の上に描画する代わりに、ノックアウトの形として使用します。文字を上に描くのではなく、文字の形がそのまま透明な穴になります。ページや背景レイヤーが文字から透けて見える、切り抜き見出しの典型的な表現です。

特定のテキストレイヤーにノックアウトを適用するには txt-blend-mode[N] を使用します。

有効な値

値結果
destination-outテキストのある箇所の画像が削除されます。文字が透明な穴になります。
destination-inテキストが覆っている領域のみが残ります。文字の形の外側はすべて削除されます。

ノックアウトモードのみが適用されます

txt-blend-mode はノックアウトの仕組みであり、汎用のブレンド制御ではありません。blend-mode が受け付ける CSS ブレンドモード (multiply、screen、overlay など) は、このパラメータを指定しない場合と同じ結果になります。

切り抜きの形を決めるもの

切り抜きの形は、テキストレイヤーが描画されるはずだった姿そのものです。グリフ、その輪郭 (txt-line)、影 (txt-shad)、txt-bg のボックス、回転、txt-alpha が対象です。サイズ、配置、折り返し、パディングによって、描画されるテキストと同じ位置に配置されます。

ノックアウトレイヤーは通常の描画も行われません。切り抜きの形として消費されるため、txt-color は視覚的な効果を持ちません。色が描画されることはありませんが、その透明度は反映されます。半透明の txt-bg は半分だけ切り抜きます。

destination-out は、テキストより前に描画されたものをすべて削除します。画像、そのパディングとボーダー、ウォーターマーク、インデックスの小さいテキストレイヤーが対象です。後続のテキストレイヤーと drop-shadow は穴の上に描画され、影は切り抜きの縁に沿って落ちます。destination-in はテキストの内側のみを残し、それ以外を削除します。アニメーションは全フレームで切り抜かれます。

描画するものがないレイヤー (空白のみで txt-bg もない、折り返しボックスが空、txt-alpha=0、完全に透明な色) は Porter-Duff に従います。destination-out は何も削除せず、destination-in は何も残さないため、キャンバス全体が穴になります。

透明部分を塗りつぶす

穴は、bg を指定した場合はどのフォーマットでもその色になります。指定しない場合は次のとおりです。

  • 透明度を扱えるフォーマット (PNG、WebP、AVIF) では穴は透明になります。
  • JPEG と GIF では白で塗りつぶされます。
  • auto=compress を指定し fm を指定しない場合、JPEG ソースでも穴は透明のまま保持され、PNG として配信されます。fm=jpg を指定すると常に塗りつぶされます。

transparency=grid はテキストの切り抜きの後に描画されるため、チェッカーボードが穴から透けて見えます。

デモ

穴を見やすくするため、各例には transparency=grid を付けてチェッカーボードを表示しています。txt-blend-mode の使用に必須ではありません。

txt-blend-mode なし — 基準となる表示です。テキストが画像の上に描画されます。
https://assets.imgix.net/examples/bluehat.jpg?w=400&h=250&fit=crop&fm=png&txt=HELLO&txt-size=72&txt-align=center%2Cmiddle&txt-color=ffffff&txt-font=Avenir-Black&transparency=grid
drawn normally

関連項目

幾何学的な形で画像を切り抜くには mask-invert を参照してください。画像レイヤーで切り抜くには blend-mode のノックアウトモードを参照してください。