IPTC パススルー
iptc
iptc パラメータを使用すると、出力画像のIPTC/XMPメタデータを保持するかどうかを制御します。メタデータのパススルーはJPEG、PNG、WebP、AVIFの出力フォーマットでサポートされており、異なるフォーマット間の変換(例:JPEG入力をWebP出力に変換)も含まれます。
有効な値は iptc=allow と iptc=block です。
使用方法
iptc=allow を設定すると、サポートされている出力フォーマット(JPEG、PNG、WebP、AVIF)のIPTC/XMPデータが伝達されます。一方、iptc=block を設定すると、メタデータの伝達が防止されます。デフォルトでは、パラメータが指定されていない場合は iptc=block が有効になっています。
このパラメータは、以下のデフォルト動作のいずれかを使用するように Imgix サポートチームによって構成できます。
- IPTC データを常にブロックする
- IPTC データを常にパススルーする
- URL パラメータの値に基づいてパス/ブロックを行う(デフォルトオプション)
Always blockまたはAlways passthroughの動作は、両方とも画像の URL にiptc=allowまたはiptc=blockを含めることで上書きできます。
デフォルトのIPTC/Exifデータの設定
Imgixサポートチームは、レンダリングされたすべての画像に対してデフォルトのIPTC/Exifフィールド値を設定することができます。これは、メタデータをRendering API経由で提供するために強制的に設定する場合に役立ちます。
- IPTC特別指示: 指示には、ライセンスに関する追加情報や、画像の使用目的に必要な技術情報が含まれる場合があります。最大256文字まで対応。
- 著作権: 画像の著作権者に関する情報。最大128文字まで対応。
制限事項
デフォルトのIPTC/Exifデータは、Rendering API経由でレンダリングされたファイルにのみ表示されます。パススルーとして提供される画像には、デフォルトのIPTC/Exifデータが適用されません。
これを有効にしたい場合は、アカウントマネージャーまたは サポート に連絡してください。
既知の制限事項
サードパーティ製リーダーの文字数制限
Imgixは、特別指示に最大256文字、著作権に最大128文字という最大フィールド長を適用しますが、Adobe Photoshop、Lightroom、DAMプラットフォームやCMSプラットフォームなどのIPTCリーダーは、独自のより厳しい文字数制限を設けている場合があります。Imgixは許可された最大長でデータを渡しますが、下流のアプリケーションでは切り捨てられて表示される場合があります。サードパーティツールでメタデータが切り捨てられて表示される場合は、そのアプリケーションのIPTCフィールド長の制限を確認し、対象リーダーが期待する最も保守的な制限内にフィールドの値を収めるようにしてください。
キーワードのグループ化
IPTCキーワードフィールドは繰り返し可能なフィールドであり、一部のオーサリングツールは | や / などの区切り文字を使って階層的なキーワードグループをエンコードします。Imgixはキーワードデータをそのまま渡します。宛先アプリケーションで表示されるグループ化や階層は、元の画像のIPTCがどのように構造化されていたか、および宛先リーダーがこれらの区切り文字をどのように解釈するかによって異なります。