画像変換
Fóirは画像のリサイズと変換を行います。画像フィールドは、指定した形式で、名前付きのサイズごとにURLを返し、URLの背後にある画像は、最初にリクエストされたときに生成されます。
名前付きの8つのサイズ
サイズはプリセットで、名前は画像の長辺の幅（ピクセル）に対応します。thumbnail（160）、small（640）、medium（1024）、large（1280）、xlarge（1920）、そして2560、3840、5120のさらに大きな3つの階層です。階層より小さいソースは、その階層に合わせて拡大されません。各バリアントはレンダリングされた幅と高さを報告します。
4つの形式
既定はWebPで、AVIF、JPEG、PNGも使えます。形式はクエリでvariants(format:)を使って選びます。形式はURLの一部で、ブラウザのAcceptヘッダーからは決まらないため、各URLの表現は1つです。データクライアントは、画像の値にWebPとAVIFのセットも載せるため、1回の読み取りでpicture要素を満たせます。
最初のリクエストで生成
APIはサイズと形式ごとにURLを返します。画像はそのURLが最初にリクエストされたときに生成され、以後はCDNのキャッシュから配信されます。指示はFóirが発行するトークンに含まれるため、URLに手で追加した幅や形式のパラメーターは反映されず、Fóirが認識しないクエリには元の画像が返ります。
クロップと焦点
クロップは、パーセンテージで表す長方形で、任意で焦点を指定でき、使われる場所の画像とともに保存されます。アセットライブラリの1つのファイルは、表示される場所ごとに異なるクロップにできます。
プレースホルダー
アップロード時に、Fóirは各画像のblurhashと代表色を計算します。画像フィールドは、URL、寸法、altテキストとともにその両方を返します。
詳細を読む
メディアAPIのリファレンスで、プリセット、形式のオプション、クロップのフィールド、画像フィールドが返す形を一覧しています。