自動
auto
auto
パラメーターは、画像カタログ全体にわたるベースラインレベルの最適化を自動化するのに役立ちます。現在、次の四つの異なる方法があります:
- 圧縮
- 視覚的な向上
- ファイル形式の変換
- 赤目除去
必要に応じて、auto
が表す設定を画像ごとに上書きするか、コード内で上書きすることができます。たとえば、auto=compress
はカラープロファイルのメタデータを削除しますが、サイトに必要な場合は、画像URLにcs=origin
やcs=srgb
などの異なる値を追加することができます。
注意: auto=format
は、有料プランのお客様向けのデフォルトパラメータとして利用できます。無料プランのお客様は、auto=format
をデフォルトパラメーターとして追加しようとすると、アカウントのアップグレードを促されます。
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=enhance
auto=enhance
が設定されている場合、画像はハイライト、ミドルトーン、およびシャドウの分布を使用して、赤、緑、青(RGB)のすべてのチャネルにわたって調整されます。全体的に、この調整により、画像はより鮮やかな外観になります。
調整は、個々の画像に異なる影響を与え、編集写真、ストック写真、およびソーシャルメディアアプリケーション向けのユーザー生成コンテンツとよく機能します。
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=mp4
が auto=format
よりも優先されるようになりました。これにより、ビデオがMP4形式で確実に配信されます。
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
が設定されている場合、赤目除去が検出された顔に適用されます。
Base64非対応
このパラメーターは、ベース64でエンコードされた値を受け付けません。すべての値は、標準のUTF8、URLエンコードされた文字列として提供する必要があります。