全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

图片缩放

更新时间:2017-09-06 13:11:24

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

说明:图片处理支持的格式: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
limit 指定当目标缩略图大于原图时是否处理。值是 1 表示不处理;值是 0 表示处理。 0/1, 默认是 1
color 当缩放模式选择为pad(缩略填充)时,可以选择填充的颜色(默认是白色)参数的填写方式:采用16进制颜色码表示,如00FF00(绿色)。 [000000-FFFFFF]
  • 按比例缩放
名称 描述 取值范围
p 倍数百分比。 小于100,即是缩小,大于100即是放大。 1-1000

注意事项

  • 对于原图:
    • 图片格式只能是:jpg、png、bmp、gif、webp、tiff。
    • 文件大小不能超过20MB。
    • 使用图片旋转时图片的宽或者高不能超过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

示例

单边缩略

  • 将图缩略成高度为100,宽度按比例处理。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,h_100

强制宽高缩略

  • 将图强制缩略成宽度为100,高度为100。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_fixed,h_100,w_100

等比缩放,限定在矩形框内

  • 将图缩略成宽度为100,高度为100,按长边优先。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_lfit,h_100,w_100

  • 将图缩略成宽度为100,高度为100,按长边优先,将图片保存成png格式。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_lfit,h_100,w_100/format,png

等比缩放,限定在矩形框外

  • 将图缩略成宽度为100,高度为100,按短边优先。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_mfit,h_100,w_100

固定宽高,自动裁剪

  • 将图自动裁剪成宽度为100,高度为100的效果图。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_fill,h_100,w_100

固定宽高,缩略填充

  • 将原图指定按短边缩略100x100, 剩余的部分以单色填充。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_pad,h_100,w_100

  • 将图按短边缩略到100x100, 然后按红色填充。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,m_pad,h_100,w_100,color_FF0000

  • 将图按比例缩略到原来的1/2。

http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,p_50

本文导读目录