アスペクト比

ar

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

arfit=cropfit=fillfit=smart-crop と組み合わせて動作します。scaleclipmax では無視されます。

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

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