自動
auto
auto=compress：35kB
autoパラメーターは、画像カタログ全体にわたるベースラインレベルの最適化を自動化するのに役立ちます。現在、次の四つの異なる方法があります：
- 圧縮
- 視覚的な向上
- ファイル形式の変換
- 赤目除去
必要に応じて、autoが表す設定を画像ごとに上書きするか、コード内で上書きすることができます。たとえば、auto=compressはカラープロファイルのメタデータを削除しますが、サイトに必要な場合は、画像URLにcs=originやcs=srgbなどの異なる値を追加することができます。
autoの値は、コンマ区切りで組み合わせることができます。また、再反復によって組み合わせる唯一のパラメーターです。たとえば、auto=compress,enhanceのように組み合わせることができます。さらに、auto=compress&auto=enhance&auto=formatのように再反復で組み合わせることもできます。
auto=compress
auto=compressが設定されている場合、imgixは画像のサイズを削減するための最善の努力をします。これには、通常の処理アルゴリズムを変更してより積極的な画像圧縮を適用することが含まれます。
クエリにauto=formatが含まれている場合、それは尊重されます。この場合、画像はできる限りAVIF形式で提供され、圧縮が適用されます。AVIFがサポートされていない場合、画像はWebPとして提供されます。WebP形式がサポートされていない場合、透過を含む画像はPNG8形式で提供され（サポートされている場合）、それ以外の画像はJPEGで提供されます。品質基準（q）は45に設定されています。
注意： 可視情報をできるだけ維持しながらファイルサイズを削減するよう努めていますので、適用される操作は変更される可能性があります。これは、以下の例で見られるように、高い色域範囲を使用する画像で見えます。cs=originを追加することで、色の問題を解決し、元のカラースペースを追加することができます。また、デフォルトの品質基準は、qパラメーターを使用して上書きすることができます。
注意：
アニメーションのないアセットにfmと併用した場合、auto=compressはfmパラメーターをオーバーライドし、アルファチャネルが存在するかどうかに応じてJPEGまたはPNGファイルを使用します。
auto=compress：35kBauto=enhance
auto=enhanceが設定されている場合、画像はハイライト、ミドルトーン、およびシャドウの分布を使用して、赤、緑、青（RGB）のすべてのチャネルにわたって調整されます。全体的に、この調整により、画像はより鮮やかな外観になります。
調整は、個々の画像に異なる影響を与え、編集写真、ストック写真、およびソーシャルメディアアプリケーション向けのユーザー生成コンテンツとよく機能します。
auto=enhance
auto=enhance
auto=true
auto=trueが設定されている場合、imgixは追加のパラメーターを適用して自動的にアセットを調整します。まず、imgixはアセットにauto=enhanceを適用します。
さらに、crop=facesが設定されており、auto=trueを適用する場合、imgixは自動的にauto=redeyeを適用します。
auto=format
auto=formatが設定されている場合、imgixは自動コンテンツネゴシエーションと呼ばれるプロセスによって、画像をより良い形式で提供できるかどうかを判断します。これには、ヘッダー、ユーザーエージェント、画像アナリティクスなど、利用可能なさまざまなシグナルが含まれます。この形式が提供され、画像が正しくキャッシュされます。
auto=formatロジックは、可能な限りAVIF形式で画像を提供しようとします。AVIFがサポートされていない場合、画像はWebPとして提供されます。WebP形式がサポートされていない場合、ファイルはJPGまたはPNGとして提供されます。
フォールバックロジックは、auto=compressを追加することや、fmでフォールバック形式を指定することで変更できます。これらを併用する場合、fmがauto=compressよりも優先されます。たとえば、auto=format&fm=jpgを指定すると、auto=formatがフォールバックパラメーターとしてのみ機能しますが、auto=compress&fm=jpgはauto=formatで設定されたファイルタイプをオーバーライドします。
auto=formatおよび自動コンテンツネゴシエーションについて詳しくは、チュートリアルを読んでください。
フォーマット優先順位の更新
以下の fm 値は、auto=format と両方が指定された場合に優先されます：
- fm=mp4:
auto=formatよりも優先されます。これにより、ビデオがMP4形式で配信されることが保証されます。 - fm=pdf: PDFファイルに使用すると、fm=pdf は元のPDFファイルを配信し、auto=format を含むすべての他のパラメーターを無視します。
Firefor 66+ 警告
Firefoxバージョン66以降では、画像がウェブページ上でレンダリングされている場合にのみ、自動コンテンツネゴシエーションが行われます。ブラウザで単一の画像を開く場合は行われません。
Safari WebP レンダリングの警告
iOS 14およびSafari >= 14では、システムフレームワークの問題により、一部のWebP画像が正しくレンダリングされない場合があります。
このため、影響を受けるSafariバージョンでは、auto=formatはJPEGまたはPNGのいずれかを返します。
Safari >=16.4 AVIFサポート
2024年9月以前、安定性の問題により、imgixはSafariブラウザに対してauto=formatを使用した際にWebP画像を提供していました。2024年9月以降、imgixはauto=formatを使用した際に、Safariバージョン16.4以降のブラウザにAVIF画像を提供するようになりました。
auto=redeye
auto=redeyeが設定されている場合、赤目除去が検出された顔に適用されます。
auto=redeye
Base64非対応
このパラメーターは、ベース64でエンコードされた値を受け付けません。すべての値は、標準のUTF8、URLエンコードされた文字列として提供する必要があります。