Imgix APIsレンダリング APIサイズリサイズフィルタ

リサイズフィルタ

resize-filter

画像をスケーリングする際に使用するリサンプリングカーネルを選択します。リサイズでは、出力の各ピクセルが周囲の入力ピクセルからどの色を取るかを決定する必要があり、カーネルはその決定方法そのものです。デフォルトは写真コンテンツに適した lanczos2 です。シャープさ、滑らかさ、エッジの忠実度のトレードオフを変えたい場合に resize-filter で上書きできます。

カーネルは拡大と縮小の両方に適用されます。

有効な値

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

値は完全一致でマッチし、大文字と小文字を区別します。どれにも一致しない値は — NEAREST のように綴りは正しくても大文字小文字が異なる場合を含め — 無視され、エラーを返すのではなくデフォルトの lanczos2 でレンダリングされます。

ハードエッジを保持する

違いが最も明確に現れるのは拡大時です。nearest は各ソースピクセルを単色のブロックとして繰り返すためエッジが鮮明に保たれますが、デフォルトはピクセル間を補間して滑らかなグラデーションを生成します。ピクセルアート、QR コード、バーコード、UI のスクリーンショットでは、この補間は通常望ましくありません。

デフォルト (lanczos2) — 補間あり
sandbox-demo
resize-filter=nearest — ブロック状
sandbox-demo

縮小時のシャープさ

縮小では元のピクセルの大半が捨てられ、残ったピクセルにどう重み付けするかをカーネルが決めます。違いがもっともはっきり出るのは、細く高コントラストなディテールです。以下の写真は幅を約 3 分の 1 に縮小しており、橋のハンガーロープは出力でおよそ 1 ピクセル幅になります。

仕切りをドラッグすると 2 つのレンダリングを重ねて比較できます。下の 2 行で、左右それぞれに表示する値を切り替えられます。lanczos2 がデフォルトのカーネルで、original は縮小をまったく行っていないフル解像度の元画像です。

さまざまなリサンプリングカーネルで幅 700 ピクセルに縮小したゴールデンゲートブリッジさまざまなリサンプリングカーネルで幅 700 ピクセルに縮小したゴールデンゲートブリッジ
◂▸
lanczos2nearest
左
右

nearest は出力ピクセルごとに元のピクセルを 1 つだけ取り、残りを無視します。そのためサンプル位置から外れたロープは消え、残ったロープはギザギザになります。拡大では有効でも、写真の縮小には向きません。bilinear は最も近い 4 ピクセルだけを平均するため、ロープが空に溶けてぼやけます。cubic 系と lanczos 系のカーネルはより広い範囲を重み付けするので、ロープが保たれます。

original と比較すると、縮小そのもので何が失われるかが分かります。このサイズではロープや対岸の街並みはわずかなピクセルで表されており、カーネルが決められるのは、それをどれだけ滑らかに手放すかだけです。

滑らかなカーネル同士の比較

lanczos2、lanczos3、bicubic、mitchell の差はエッジのコントラスト 1〜2 ピクセル分でしかなく、等倍では見分けられません。以下の各デモは、同じ切り抜きを指定したカーネルで幅 100px まで縮小し、その結果を nearest で 5 倍に拡大しています。出力ピクセルそのものを比較できます。

lanczos3 — エッジが硬い
sandbox-demo
デフォルト (lanczos2)
sandbox-demo
mitchell — もっとも柔らかく、リンギングが少ない
sandbox-demo

シャープなカーネルほどエッジのコントラストを保ちますが、その代わりエッジの脇に明暗のふち(リンギング)が出ます。柔らかいカーネルはそのコントラストを手放す代わりに、より滑らかな遷移になります。

用途名は再調整される可能性があります

pixel、graphic、soft、photo、sharp は、カーネル名そのものではなく、そのカーネルが何のためのものかを表します。どのカーネルに対応するかは将来再調整される可能性があるため、出力が変化しては困る場合は nearest、mitchell、lanczos3 などのカーネル名を使用してください。

レイヤーのリサイズ

ウォーターマークとブレンドレイヤーは独自のカーネルを持ち、このパラメータを継承しません。レイヤーに mark-resize-filter または blend-resize-filter を設定しない限り、ベース画像に対する resize-filter の指定にかかわらず lanczos2 でリサイズされます。blend-size=inherit でブレンドレイヤーがベース画像のサイズ指定を引き継ぐ場合も同様です。

この独立性は有用で、背景の写真は通常どおりリサイズしつつ、ピクセルアートのバッジだけを鮮明に保つことができます。

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

カーネルが影響しない処理

resize-filter はリクエストされた画像の出力リサイズに適用されます。以下は独自のリサンプリングを使用するため、この設定が影響することはありません。

  • スマートクロップ (crop=faces、crop=entropy、crop=edges、crop=auto) の解析処理とオブジェクト検出。
  • fit=fill と fill=blur によるぼかし背景。
  • mask と append の画像。
  • 影やリフレクションなどのエフェクトの内部処理。
  • fm=ico と fm=pdf。

アニメーション画像では全フレームにカーネルが適用されます。動画には影響しません。

注意事項

resize-filter が効果を持つのは、画像が実際にスケーリングされる場合のみです。ネイティブサイズのまま返されるリクエストにはリサンプリングする対象がないため、このパラメータは影響しません。

ハードなピクセルを保持するのではなく写真を拡大したい場合は、既存のピクセル間を補間するのではなくディテールを再構成する super-resolution を検討してください。