將圖片按照要求生成縮圖,或者進行特定的縮放。

说明 圖片處理支援的格式:jpg、png、bmp、gif、webp、tiff。

參數

操作名稱:resize

  • 指定寬高縮放
    名稱 描述 取值範圍
    m 指定縮略的模式:
    • lfit:等比縮放,限制在指定w與h的矩形內的最大圖片。
    • mfit:等比縮放,延伸出指定w與h的矩形框外的最小圖片。
    • fill:固定寬高,將延伸出指定w與h的矩形框外的最小圖片進行置中裁剪。
    • pad:固定寬高,縮略填充。
    • fixed:固定寬高,強制縮略。
    lfitmfitfillpadfixed,預設為lfit。
    w 指定目標縮圖的寬度。 1-4096
    h 指定目標縮圖的高度。 1-4096
    l 指定目標縮圖的最長邊。 1-4096
    s 指定目標縮圖的最短邊。 1-4096
    limit 指定當目標縮圖大於原圖時是否處理。值是 1 表示不處理;值是 0 表示處理。 0/1, 預設是 1
    color 當縮放模式選擇為pad(縮略填充)時,可以選擇填充的顏色(預設是白色)參數的填寫方式:採用16進位顏色碼錶示,如00FF00(綠色)。 [000000-FFFFFF]
  • 按比例縮放
    名稱 描述 取值範圍
    p 倍數百分比。 小於100,即是縮小,大於100即是放大。 1-1000

注意事項

  • 對於原圖:
    • 圖片格式只能是:jpg、png、bmp、gif、webp、tiff。
    • 檔案大小不能超過20 MB。
    • 使用圖片旋轉時圖片的寬或者高不能超過4096。
  • 對於縮圖:對縮略後的圖片大小有限制,目標縮圖寬與高的乘積不能超過 4096 x 4096,且單邊長度不能超過 4096 x 4。
  • 當只指定寬度或者高度時,在等比縮放的情況下,都會預設進行單邊的縮放。在固定寬高的模式下,會預設寬高一樣的情況下進行縮略。
  • 如果只指定寬度或者高度,原圖按原圖格式返回。如果想保存成其他格式,詳細可以查看品質變換格式轉換
  • 調用resize,預設是不允許放大。即如果請求的圖片對原圖大,那麼返回的仍然是原圖。如果想取到放大的圖片,即增加參數調用limit,0 (如:https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_500,limit_0

樣本

單邊縮略-按寬高
單邊縮略-按長邊短邊
強制寬高縮略
等比縮放,限定在矩形框內
等比縮放,限定在矩形框外
固定寬高,自動裁剪