resize.md

图片缩放

更新时间：2024-08-22 13:53:25

注意事项

• 原图限制

  • 图片格式只能是：JPG、PNG、BMP、GIF、WebP、TIFF。

  • 宽或高不能超过30,000 px，且总像素不能超过2.5亿 px。

    动态图片（例如GIF图片）的像素计算方式为宽*高*图片帧数；非动态图片（例如PNG图片）的像素计算方式为宽*高。

• 缩放图限制

  宽或高不能超过16,384 px，且总像素不能超过16,777,216 px。

• 缩放优先级

  如果图片处理URL中同时指定按宽高缩放和等比缩放参数，则只执行指定宽高缩放。

• 缩放时只指定宽度或者高度

  • 等比缩放时，会按比例缩放图片。例如原图为200 px*100 px，将高缩放为100 px，则宽缩放为50 px。
  • 固定宽高缩放时，会将原图宽高按照指定值进行缩放。例如原图为200 px*100 px，将高缩放为100 px，则宽也缩放为100 px。

参数说明

操作名称：resize

指定宽高缩放

• 参数说明

  名称	是否必选	描述	取值范围
  m	是	指定缩放的模式。	lfit（默认值）：等比缩放，缩放图限制为指定w与h的矩形内的最大图片。mfit：等比缩放，缩放图为延伸出指定w与h的矩形框外的最小图片。fill：将原图等比缩放为延伸出指定w与h的矩形框外的最小图片，然后将超出的部分进行居中裁剪。pad：将原图缩放为指定w与h的矩形内的最大图片，然后使用指定颜色居中填充空白部分。fixed：固定宽高，强制缩放。
  w	否	指定目标缩放图的宽度。	[1,16384]
  h	否	指定目标缩放图的高度。	[1,16384]
  color	是（仅当m为pad时）	当缩放模式选择为pad（缩放填充）时，可以设置填充的颜色。	RGB颜色值，例如：000000表示黑色，FFFFFF表示白色。默认值：FFFFFF（白色）

• 使用示例

  原图大小为200 px*100 px，缩放参数为w=150 px，h=80 px。则不同的缩略模式，得到的缩放图如下：

  • 等比缩放：要求缩放图的w/h等于原图的w/h。所以，若w=150 px，则h=75 px；若h=80 px，则w=160 px。
  • 限制在指定w与h的矩形内的最大图片：即缩放图的wh不能大于150 px80 px。

  通过以上条件得出缩略图大小为150 px*75 px。

  

操作方式

您可以通过文件URL、API方式设置图片处理参数。本文以文件URL为例进行介绍。本文示例使用的examples/example.jpg，

该测试基于

综合示例

图片访问地址为：

http://127.0.0.1:8080/file/example.jpg

• 等比缩放

  • 按宽高缩放

    需求及处理参数如下：

    • 图片缩放为高100 px：resize,h_100
    • 缩放模式为lfit：m_lfit

    图片处理的URL为http://127.0.0.1:8080/file/example.jpg?x-oss-process=image/resize,h_100,w_300,m_lfit

    

    处理后，原图从400 px300 px等比缩放为133 px100 px的图片。

• 固定宽高缩放

  需求及处理参数如下：

  • 将原图缩放成宽高100 px：resize,h_100,w_100
  • 缩放模式fixed：m_fixed

  图片处理的URL为：http://127.0.0.1:8080/file/example.jpg?x-oss-process=image/resize,m_fixed,h_100,w_100

  处理后，原图从400 px300 px固定缩放为100 px100 px的图片，图片出现变形。

• 固定宽高，自动裁剪

  需求及处理参数如下：

  • 将原图缩放成宽高100 px：resize,h_100,w_100
  • 缩放模式fill：m_fill

  图片处理的URL为：http://127.0.0.1:8080/file/example.jpg?x-oss-process=image/resize,m_fill,h_100,w_100

  

  处理后，原图从400 px300 px缩放为133 px100 px，然后居中裁剪为100px，得到大小为100 px*100 px的缩放图。

• 固定宽高，缩放填充

  需求及处理参数如下：

  • 将原图缩放成宽高100 px：resize,h_100,w_100

  • 缩放模式pad：m_pad

    说明

    m_pad参数不支持原图为PNG的4颜色通道的图片。

  • 以红色填充：color_FF0000

  图片处理的URL为：http://127.0.0.1:8080/file/example.jpg?x-oss-process=image/resize,m_pad,h_100,w_100,color_FF0000

  

  处理后，原图从400 px300 px缩放为100 px75 px，然后将h居中填充到100px，得到大小为100 px*100 px的缩放图，同时填充红色。

• 按比例缩放

  需求及处理参数如下：

  将原图缩放50%：resize,p_50

  图片处理的URL为：http://127.0.0.1:8080/file/example.jpg?x-oss-process=image/resize,p_50

  

  处理后，原图从400 px300 px等比缩放为200 px150 px，缩放为原来的50%。