图片基本处理(imageView)

描述

imageView是七牛云存储提供的一种简易却强大的图片处理接口,只需要填写少数几个参数即可对图片进行缩放操作,生成各种缩略图。
本接口不再进行功能扩展,建议开发者使用新的imageView2接口

接口规格

注意:接口规格不含任何空格与换行符,下列内容经过格式化以便阅读。

imageView/<mode>
         /w/<width>
         /h/<height>
         /q/<quality>
         /format/<format>
参数名称 必填 说明
/<mode> 图像缩放处理模式
/w/<width> 目标图片的宽度,单位:像素(px)
/h/<height> 目标图片的高度,单位:像素(px)
/q/<quality> 目标图片的图像质量,取值范围:1-100,缺省为85
/format/<format> 目标图片的输出格式,取值范围:jpg,gif,png,webp等,缺省为原图格式

其中 <mode> 分为如下几种情况:

模式 说明
<mode>=1 同时指定宽度和高度,等比裁剪原图正中部分并缩放为x大小的新图片
<mode>=2 同时指定宽度和高度,原图缩小为不超出x大小的缩略图,避免裁剪长边
<mode>=2 仅指定宽度,高度等比缩小
<mode>=2 仅指定高度,宽度等比缩小

请求

请求报文格式

GET <imageDownloadURI>?<接口规格> HTTP/1.1
Host: <imageDownloadHost>

请求头部

头部名称 必填 说明
Host 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

响应

响应报文格式

HTTP/1.1 200 OK
Content-Type: <imageMimeType>

<imageBinaryData>

响应头部

头部名称 必填 说明
Content-Type MIME类型,成功时为图片的MIME类型,失败时为application/json
Cache-Control 缓存控制,失败时为no-store,不缓存

响应内容

■ 如果请求成功,返回图片的二进制数据。

■ 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):

{
    "code":     <httpCode  int>, 
    "error":   "<errMsg    string>",
}
字段名称 必填 说明
code HTTP状态码,请参考响应状码
error 与HTTP状态码对应的消息文本

响应状态码

HTTP状态码 含义
200 缩放成功
400 请求报文格式错误
404 资源不存在
599 服务端操作失败。

如遇此错误,请将完整错误信息(包括所有HTTP响应头部)通过邮件发送给我们。


附注

  • imageView生成的图片会被七牛云存储缓存以加速下载,但不会持久化。需要持久化的缩略图,请参考触发持久化处理saveas处理
  • 如果原图带有EXIF信息且包含Orientation字段,imageView缺省根据此字段的值进行自动旋转修正。

示例

  1. 裁剪正中部分,等比缩小生成200x200缩略图:

    http://developer.qiniu.com/resource/gogopher.jpg?imageView2/1/w/200/h/200
    

    查看效果图

  2. 裁剪正中部分,等比放大生成500x500放大图:

    http://developer.qiniu.com/resource/gogopher.jpg?imageView/1/w/500/h/500
    

    查看效果图

  3. 宽度固定为200px,高度等比缩小,生成200x133缩略图:

    http://developer.qiniu.com/resource/gogopher.jpg?imageView2/2/w/200
    

    查看效果图

  4. 高度固定为200px,宽度等比缩小,生成300x200缩略图:

    http://developer.qiniu.com/resource/gogopher.jpg?imageView2/2/h/200
    

    查看效果图


内部参考资源


如果有任何问题,请进入 七牛云存储问答社区 或者发送 工单 咨询