图片基本处理(imageView2)
简介
imageView2 提供简单快捷的图片格式转换、缩略、质量变换功能。只需要填写几个参数,即可对图片进行缩略操作,生成各种缩略图。图片处理为收费项,详细的计费说明请参见 计费与定价。
功能 | 说明 |
---|---|
缩略 | 等比缩放、设定目标宽高缩放等多种方式 |
格式转换 | 格式转换、GIF 颜色控制 |
渐进显示 | 图片渐进显示 |
质量变换 | 对图片质量进行调节 |
限制说明
使用服务时有如下限制:
-
原图限制
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
(webp动图,仅支持持久化处理)
- 原图格式支持:
-
输出限制
- 输出为
gif
,一般处理时间比较长,建议优先使用持久化处理 - 输出为
webp
时,宽或高不能超过16383
- 输出为
-
同步处理
- 只支持 20MB 以内的图片,超过 20MB 的图片需要使用持久化处理
- 处理前的
gif
最大帧数为 200 - 处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 处理后的图片
w
和h
参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
-
持久化处理
- 图片文件大小没有限制
- 处理前的
gif
、webp动图
,最大帧数为 500 - 处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素 - 处理后的图片
w
和h
参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素
参数说明
注意:接口规格不含任何空格与换行符。
imageView2/<mode>/w/<LongEdge>
/h/<ShortEdge>
/format/<Format>
/interlace/<Interlace>
/q/<Quality>
/colors/<colors>
/ignore-error/<ignoreError>
参数说明
其中 <mode>
必填,分为如下几种情况:
模式 | 说明 |
---|---|
/0/w/<LongEdge>/h/<ShortEdge> |
限定缩略图的长边最多为<LongEdge> ,短边最多为<ShortEdge> ,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定长边(短边自适应),只指定 h 参数则表示限定短边(长边自适应)。 |
/1/w/<Width>/h/<Height> |
限定缩略图的宽最少为<Width> ,高最少为<Height> ,进行等比缩放,居中裁剪。转后的缩略图通常恰好是 <Width>x<Height> 的大小(有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分)。如果只指定 w 参数或只指定 h 参数,代表限定为长宽相等的正方图。 |
/2/w/<Width>/h/<Height> |
限定缩略图的宽最多为<Width> ,高最多为<Height> ,进行等比缩放,不裁剪。如果只指定 w 参数则表示限定宽(高自适应),只指定 h 参数则表示限定高(宽自适应)。它和模式0类似,区别只是限定宽和高,不是限定长边和短边。从应用场景来说,模式0适合移动设备上做缩略图,模式2适合PC上做缩略图。 |
/3/w/<Width>/h/<Height> |
限定缩略图的宽最少为<Width> ,高最少为<Height> ,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。 |
/4/w/<LongEdge>/h/<ShortEdge> |
限定缩略图的长边最少为<LongEdge> ,短边最少为<ShortEdge> ,进行等比缩放,不裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看(把这里的长边短边分别设为手机屏幕的分辨率即可),生成的图片尺寸刚好充满整个屏幕(某一个边可能会超出屏幕)。 |
/5/w/<LongEdge>/h/<ShortEdge> |
限定缩略图的长边最少为<LongEdge> ,短边最少为<ShortEdge> ,进行等比缩放,居中裁剪。如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。同上模式4,但超出限定的矩形部分会被裁剪。 |
/format/<Format> |
新图的输出格式 取值范围: jpg ,gif ,png ,webp 等,默认为原图格式。注:当原图为heic时,不指定输出格式,会输出jpg。 |
/interlace/<Interlace> |
是否支持渐进显示 取值范围: 1 支持渐进显示,0 不支持渐进显示(默认为0)。适用目标格式: jpg 效果:网速慢时,图片显示由模糊到清晰。 |
/colors/<colors> |
1、源图片为 GIF 时,控制输出 GIF 中不同颜色的数量,取值可为2、4、8、16、32、64、128或256,不使用该参数时的默认值为128。2、输出图片为 PNG 时,控制输出 PNG 中不同颜色的数量,取值可为2、4、8、16、32、64、128或256,不使用该参数时默认关闭。 |
/q/<Quality> |
新图的图片质量 ● 取值范围是[1, 100] ● 输入是 jpeg ,且不强制指定质量条件下,七牛会根据原图质量算出一个修正值,取修正值和指定值中的小值。注意: ● 指定值后面可以增加 ! ,表示强制使用指定值,如100! 。● heic:默认值35 ● avif:默认值50 ● 其他格式:默认值75 |
/ignore-error/<ignoreError> |
主要针对图片兼容性的问题导致无法处理,取值为1 时,则处理失败时返回原图;不设置此参数,默认处理失败时返回错误信息。 |
注意:
-
所有模式都可以只指定
w
参数或只指定h
参数,并获得合理结果。在w、h
为限定最大值时,未指定某参数等价于将该参数设置为无穷大(自适应);在w、h
为限定最小值时,未指定参数等于给定的参数,也就限定的矩形是正方形。 -
新图的宽/高/长边/短边,不会比原图大,即本接口总是
缩小图片
。 -
如果原图带有
EXIF
信息且包含Orientation
字段且不能被识别出来,imageView2
默认根据此字段的值进行自动旋转修正。 -
当一张含有透明区域的图片,转换成不支持透明的格式
jpg
,bmp
等时,透明区域填充白色。 -
<Quality>
修正值算法:-
原图 quality <= 90:min[90, 原图quality*sqrt,原图长宽乘积/结果图片长宽乘积
-
原图 quality > 90: 原图quality*sqrt,原图长宽乘积/结果图片长宽乘积
-
示例
-
原图
-
裁剪正中部分,等比缩小生成200x200缩略图:
https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200
-
宽度固定为200px,高度等比缩小,生成200x133缩略图:
https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/w/200
-
高度固定为200px,宽度等比缩小,生成300x200缩略图:
https://dora-doc.qiniu.com/gogopher.jpg?imageView2/2/h/200
-
渐进显示图片:
https://dora-doc.qiniu.com/gogopher.jpg?imageView2/1/w/200/h/200/interlace/1
-
设置图片质量为55:
https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageView2/1/w/200/h/200/q/55
操作方式
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)