功能說明

通過圖片縮放參數，可以調整媒體存儲內存儲的圖片大小。

參數說明

操作名稱：resize

指定寬高縮放

使用示例

原圖大小為200 px x 100 px，縮放參數為w=150 px，h=80 px。則不同的縮略模式，得到的縮放圖如下：

• lfit
  • 等比縮放：要求縮放圖的w/h等于原圖的w/h。所以，若w=150 px，則h=75 px；若h=80 px，則w=160 px。
  • 通過以上條件得出縮略圖大小為150 px x 75 px。
    
• mfit

  • 等比縮放：要求縮放圖的w/h等于原圖的w/h。所以，若w=150 px，則h=75 px；若h=80 px，則w=160 px。

  • 延伸出指定w與h的矩形框外的最小圖片：即縮放圖必須是大于150 px x 80 px的一個最小矩形。

  • 通過以上條件得出縮放圖的大小為160 px x 80 px。

    

• fill

  • fill參數會先將圖片等比縮放為延伸出指定w與h的矩形框外的最小圖片，之后按照固定寬高進行裁剪。

  • 即先將原圖縮放為160 px x 80 px.

  • 之后將w居中裁剪為150 px，得到大小為150 px x 80 px的縮放圖。

    

• pad

  • pad參數會先將圖片等比縮放為限制在指定w與h的矩形內的最大圖片，之后按照固定寬高進行填充。即先將原圖縮放為150 px x 75 px，之后將h居中填充到80 px，得到大小為150 px x 80 px的縮放圖。

    

  • 填充可指定顏色，默認為FFFFFF（白色）。

• fixed
  • fixed參數會將圖片按照固定寬高進行縮放，若寬高與原圖寬高比例不同，則會導致圖片變形。
    

按比例縮放

注意事項

• 原圖限制：

  • 圖片格式只能是：JPG、PNG、BMP、GIF、WebP、TIFF。其中GIF格式的圖片支持指定寬高縮放，不支持等比縮放（等比縮放情況下，動態圖會變成靜態圖）。
  • 對原圖大小沒有限制，但總像素不能超過2.5億 px（動態圖片（例如GIF圖片）的像素計算方式為寬 x 高 x 圖片幀數；非動態圖片（例如PNG圖片）的像素計算方式為寬 x 高）。

• 縮放圖限制：目標縮放寬高不超過4,096 px。

• 若縮放時只指定寬度或者高度：

  • 等比縮放時，會按比例縮放圖片。例如原圖為200 px x100 px，將高縮放為100 px，則寬縮放為50 px。
  • 固定寬高縮放時，會將原圖寬高按照指定值進行縮放。例如原圖為200 px x 100 px，將高縮放為100 px，則寬也縮放為100 px。

• 目標縮放圖比原圖尺寸大時，默認返回原圖。您可以增加如下參數放大圖片。

  limit_0
  

  例如：//qh3oss.xstore.daliqc.cn/image-demo/demo.jpg?x-amz-process=image/resize,w_500,limit_0

• pad模式下，指定color參數，圖片背景顏色為color參數，如果沒有指定color參數，則默認白色背景。

示例

等比縮放

按寬高縮放

圖片縮放為高100 px：resize,h_100，縮放模式為lfit：m_lfit，具體圖片處理參數為：

 ?x-amz-process=image/resize,h_100,m_lfit

按長短邊縮放

圖片縮放為長邊100 px：resize,l_100，縮放模式mfit：m_mfit，具體圖片處理參數為：

?x-amz-process=image/resize,l_100,m_mfit

固定寬高縮放

將原圖縮放成寬高100 px：resize,h_100,w_100，縮放模式fixed：m_fixed，具體圖片處理參數為：

?x-amz-process=image/resize,m_fixed,h_100,w_100

固定寬高，自動裁剪

將原圖縮放成寬高100 px：resize,h_100,w_100，縮放模式fill：m_fill，具體圖片處理參數為：

?x-amz-process=image/resize,m_fill,h_100,w_100

固定寬高，縮放填充

將原圖縮放成寬高100 px：resize,h_100,w_100，縮放模式pad：m_pad，以紅色填充：color_FF0000，具體圖片處理參數為：

?x-amz-process=image/resize,m_pad,h_100,w_100,color_FF0000

按比例縮放

將原圖縮放50%：resize,p_50，具體圖片處理參數為：

?x-amz-process=image/resize,p_50