アスペクト比

ar

両方のピクセル寸法を固定する代わりに、出力アスペクト比を指定します。W:H 形式で記述します(例:4:5)。WxH、W,H、または小数比(例:1.85 → 1.85:1)も受け付けます。

ar は fit=crop、fit=fill、fit=smart-crop と組み合わせて動作します。scale、clip、max では無視されます。

不足している寸法の解決方法は、他に指定したパラメータによって異なります:

  • ar + w または h のどちらか — もう一方の寸法がアスペクト比から導出されます。ar=4:5&w=400 → 400×500。
  • ar + w と h の両方 — この組み合わせはバウンディングボックスとして扱われ、その中に収まる最大のアスペクト比の矩形が出力されます。
  • ar のみ — ソースがネイティブ解像度でアスペクト比にリフレーム(fit=crop/smart-crop ではクロップ、fit=fill ではパディング)されます。