将图片按照要求生成缩略图,或者进行特定的缩放。

说明
图片处理支持的格式:jpg、png、bmp、gif、webp、tiff。

参数

操作名称:resize

  • 指定宽高缩放
    名称 描述 取值范围
    m 指定缩略的模式:
    • lfit:等比缩放,限制在设定在指定w与h的矩形内的最大图片。
    • mfit:等比缩放,延伸出指定w与h的矩形框外的最小图片。
    • fill:固定宽高,将延伸出指定w与h的矩形框外的最小图片进行居中裁剪。
    • pad:固定宽高,缩略填充。
    • fixed:固定宽高,强制缩略。
    [lfit,mfit,fill,pad,fixed],默认为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

示例

单边缩略-按宽高
单边缩略-按长边短边
强制宽高缩略
等比缩放,限定在矩形框内
等比缩放,限定在矩形框外
固定宽高,自动裁剪