imgix APIsレンダリング APIブレンディングブレンドフィット

ブレンドフィット

blend-fit

オーバーレイ画像がブレンド幅(blend-w)およびブレンド高さ(blend-h)の寸法に適合する方法を制御します。

有効な値は clampclipcropmax、および scale です。デフォルト値は clip です。注意: blend-fit はカラーオーバーレイやテキストオーバーレイには適用されません。カラーオーバーレイは画像全体に適用され、テキストのフィットは txt-fit パラメータで制御されます。

blend-fit=clamp

画像を切り取ったり歪めたりせず、幅と高さの境界内に適合させます。残りのスペースは画像の端からの拡張ピクセルで埋められます。結果の画像は制約された寸法に一致します。ピクセルの拡張はアフィンクランプと呼ばれ、したがって値名が clamp です。

blend-fit=clip

デフォルト。画像を切り取ったり歪めたりせず、幅と高さの境界内に適合させます。結果の画像は、制約された寸法のいずれかに一致することが保証されます。入力画像のアスペクト比を維持するように、他の寸法が変更されます。

blend-fit=crop

画像を幅と高さの境界いっぱいにリサイズし、余分な画像データを切り取ります。結果の画像は画像を歪めることなく幅と高さの制約に一致します。ブレンド画像のクロップ方法を制御するには blend-crop パラメータを参照してください。

blend-fit=max

画像を切り取ったり歪めたりせず、幅と高さの境界内に適合させますが、画像が出力サイズよりも小さい場合は画像のサイズを拡大しません。結果の画像は入力画像のアスペクト比を維持します。

blend-fit=scale

画像を制約された寸法に正確に合わせます。結果の画像は寸法を埋め、入力画像のアスペクト比を維持しません。