Imgix APIsレンダリング APIウォーターマーク(透かし)ウォーターマークのリサイズフィルタ

ウォーターマークのリサイズフィルタ

mark-resize-filter

mark 画像のリサイズに使用するリサンプリングカーネルを設定します。mark-scale によるリサイズも対象です。デフォルトは lanczos2 です。

特定のウォーターマークレイヤーにカーネルを設定するには mark-resize-filter[N] を使用します。

有効な値

値エイリアス適した用途
lanczos2—**デフォルト。**写真のレイヤー向け。シャープさとアーティファクトの少なさのバランスが取れています。
lanczos3lanczos、photo、sharplanczos2 よりシャープですが、高コントラストなエッジの周囲にリンギングが出やすくなります。
bicubiccubic、catmull-rom滑らかなグラデーションと適度なシャープさ。
mitchellgraphic、soft柔らかくリンギングの少ない出力。グラフィックやフラットな色面に適しています。
bilinearlinear高速で滑らかですが、cubic 系や lanczos 系より明らかに柔らかくなります。
nearestpixel補間なしの硬いエッジ。ピクセルアートのバッジ、QR コード、UI のスクリーンショットに適しています。

値は完全一致でマッチし、大文字と小文字を区別します。どれにも一致しない値(NEAREST のように綴りは正しくても大文字小文字が異なるものを含む)は無視され、エラーにはならずデフォルトの lanczos2 でリサイズされます。有効な値は、ベース画像に対する resize-filter と同じです。

小さなウォーターマークを拡大する

カーネルの影響がもっとも大きいのはウォーターマークを拡大するときです。わずかな元ピクセルから出力ピクセルを作り出す必要があるためです。以下のデモでは、幅 40 ピクセルのパイナップルを 240 ピクセルで配置しています。lanczos2 は元のピクセル間を補間して滑らかにし、nearest は 1 ピクセルをそのままブロックとして繰り返します。1 つ目は参考として、同じレイヤーをフルサイズで読み込んだものです。他のカーネルも下の行から選べます。

さまざまなリサンプリングカーネルで 40 ピクセルの元画像から拡大したパイナップルのウォーターマークさまざまなリサンプリングカーネルで 40 ピクセルの元画像から拡大したパイナップルのウォーターマーク
◂▸
lanczos2nearest
左
右

どちらが正しいというものではありません。写真のバッジであれば補間が望ましく、ピクセルアートのバッジであれば望ましくないだけです。

すべてのカーネルを切り替えられますが、拡大時には 4 つの滑らかなカーネルの結果はほぼ一致します。lanczos3、bicubic、mitchell、bilinear は同じわずかな元ピクセルの間を補間するため、lanczos2 との差は 1〜2 階調に収まります。これらが分かれるのは縮小時で、その比較は resize-filter にあります。カーネルの挙動は、ウォーターマークでもベース画像でも同じです。

レイヤーはカーネルを継承しません

ウォーターマークは、そのレイヤーに mark-resize-filter が設定されていない限り lanczos2 でリサイズされます。ベース画像に対する resize-filter の指定は影響しません。この 2 つが独立しているため、背景の写真は通常どおりリサイズしつつ、ピクセルアートのバッジだけを鮮明に保つことができます。

?w=800&mark=badge.png&mark-w=96&mark-resize-filter=nearest