Imgix APIsレンダリング APIフォーマットアイコンのサイズ

アイコンのサイズ

ico-sizes

ico-sizes パラメーターは、1つの fm=ico ファイルに複数のサイズを格納します。ICOは複数の画像を保持できる唯一の出力形式であり、これにより1つの favicon.ico で、ブラウザのタブ、ブックマークバー、デスクトップのショートカットのそれぞれに、拡大縮小されていない最適なサイズを提供できます。

最大8つのサイズをカンマ区切りで指定します。各サイズは1〜256の範囲で、値はアイコンの長辺の目標サイズ(ピクセル)です。

https://assets.imgix.net/examples/blue-pineapple-no-background.png?fit=crop&ar=1:1&fm=ico&ico-sizes=16,32,48

このリクエストでは、以下の3つの画像をすべて含む1つのファイルが生成されます。それぞれ実際のサイズで表示しています。

ico-sizes=16
sandbox-demo
ico-sizes=32
sandbox-demo
ico-sizes=48
sandbox-demo

指定できる値

不正な入力がエラーになることはありません。使用できない値は破棄され、リクエストの残りの部分はそのまま処理されます。

入力結果
ico-sizes=4848pxのエントリーが1つ
ico-sizes=16,32,481つのファイルに3つのエントリー
ico-sizes=16,16,32重複が統合され、3つではなく2つのエントリー
ico-sizes=16,300,321〜256の範囲外の値が破棄され、2つのエントリー
8つを超えるサイズ先頭の8つのみが使用されます
ico-sizes=abc解釈できないため、出力サイズのアイコンが1つ
ico-sizes を指定しない場合出力サイズのアイコンが1つ

アスペクト比

アスペクト比は正方形に強制されるのではなく保持されるため、横長のロゴを 48 で格納すると長辺が48pxになります。3:2のソースに ico-sizes=16,32,48 を指定すると、エントリーは16x11、32x21、48x32になります。正方形のアイコンが必要な場合は、上記の例のように fit=crop と正方形の ar で先にクロップしてください。

ico-sizes は X-Imgix-Params レスポンスヘッダーには表示されません。