智能多媒体服务

  • 智能多媒体服务 > API 文档 > 图片处理 >图片基本处理(imageView2)

    图片基本处理(imageView2)

    最近更新时间: 2024-03-15 10:54:25

    简介

    imageView2 提供简单快捷的图片格式转换、缩略、质量变换功能。只需要填写几个参数,即可对图片进行缩略操作,生成各种缩略图。图片处理为收费项,详细的计费说明请参见 计费与定价

    功能 说明
    缩略 等比缩放、设定目标宽高缩放等多种方式
    格式转换 格式转换、GIF 颜色控制
    渐进显示 图片渐进显示
    质量变换 对图片质量进行调节

    限制说明

    使用服务时有如下限制:

    • 原图格式支持: psdjpegpnggifwebptiffbmpavifheic

      • webp动图,仅支持持久化处理
    • 输出限制

      • 输出为 gif,一般处理时间比较长,建议优先使用持久化处理
      • 输出为 webp 时,宽或高不能超过16383
    • 同步处理

      • 原图只支持 20MB 以内的图片,超过 20MB 的图片请使用持久化处理
      • 处理前的gif最大帧数为 200
      • 处理前的图片wh参数不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后的图片wh参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
    • 持久化处理

      • 图片文件大小没有限制
      • 处理前的gifwebp动图,最大帧数为 500
      • 处理前的图片wh 不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后的图片wh 不能超过14999像素,总像素不得超过59999999(6000w-1)像素

    参数说明

    注意:接口规格不含任何空格与换行符。

    imageView2/<mode>/w/<LongEdge>
                     /h/<ShortEdge>
                     /format/<Format>
                     /interlace/<Interlace>
                     /q/<Quality>
                     /colors/<colors>
                     /ignore-error/<ignoreError>
    

    参数说明

    参数名称 必填 说明
    /mode 定义等比缩放、设定目标宽高缩放的多种不同方式,取值范围:[0,5]的整数,必填项。
    分为如下几种情况:
    mode=0,使用姿势:/0/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的长边最多为<LongEdge>,短边最多为<ShortEdge>,进行等比缩放,不裁剪。
    2、如果只指定 w 参数则表示限定长边(短边自适应),只指定 h 参数则表示限定短边(长边自适应)。
    mode=1,使用姿势:/1/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的宽最少为<LongEdge>,高最少为<ShortEdge>,进行等比缩放,居中裁剪。
    2、转后的缩略图通常恰好是 <LongEdge>x<ShortEdge> 的大小(有一个边缩放的时候会因为超出矩形框而被裁剪掉多余部分)。
    3、如果只指定 w 参数或只指定 h 参数,代表限定为长宽相等的正方图。
    mode=2,使用姿势:/2/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,不裁剪。
    2、如果只指定 w 参数则表示限定宽(高自适应),只指定 h 参数则表示限定高(宽自适应)。
    3、它和模式0类似,区别只是限定宽和高,不是限定长边和短边。从应用场景来说,模式0适合移动设备上做缩略图,模式2适合PC上做缩略图。
    mode=3,使用姿势:/3/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,不裁剪。
    2、如果只指定 w 参数或只指定 h 参数,代表长宽限定为同样的值。你可以理解为模式1是模式3的结果再做居中裁剪得到的。
    mode=4,使用姿势:/4/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,不裁剪。
    2、如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。这个模式很适合在手持设备做图片的全屏查看(把这里的长边短边分别设为手机屏幕的分辨率即可),生成的图片尺寸刚好充满整个屏幕(某一个边可能会超出屏幕)。
    mode=5,使用姿势:/5/w/<LongEdge>/h/<ShortEdge>
    1、限定缩略图的长边最少为<LongEdge>,短边最少为<ShortEdge>,进行等比缩放,居中裁剪。
    2、如果只指定 w 参数或只指定 h 参数,表示长边短边限定为同样的值。同上模式4,但超出限定的矩形部分会被裁剪。
    /format/<Format> 图片输出格式
    1、取值:copy,保持原图格式输出。
    2、取值:jpggifpngwebp等,参考支持转换的图片格式
    3、取值:heicavif ,属于 图片高级压缩 格式,按照图片高级压缩收费,当前仅支持 持久化处理 来使用。
    注意
    ● 必须指定mode参数,否则不生效。
    ● 当原图为heicavif 时,设置format/copy 会保持原图格式不变,且不按照图片高级压缩收费;如果不指定 format 参数,将会输出jpeg
    /colors/<colors> 控制图片颜色数量
    ● 源图片为 GIF 时,控制输出 GIF 中不同颜色的数量,取值可为2、4、8、16、32、64、128、256,不使用该参数时的默认值为128。
    ● 输出图片为 PNG 时,控制输出 PNG 中不同颜色的数量,取值可为2、4、8、16、32、64、128、256,不使用该参数时默认关闭。
    注意
    ● 必须指定mode参数,否则不生效。
    ● 如果只设置图片颜色数量,不做其他缩放处理,建议使用 图片高级处理-格式转换
    /interlace/<Interlace> 是否支持渐进显示
    取值范围:1 支持渐进显示,0不支持渐进显示(默认为0)。
    适用目标格式:jpg
    效果:网速慢时,图片显示由模糊到清晰。新图的输出格式,必须指定mode参数,否则不生效。
    注意
    ● 必须指定mode参数,否则不生效。
    ● 如果只设置渐渐显示,不做其他缩放处理,建议使用 图片高级处理-渐进显示
    /q/<Quality> 新图的图片质量
    ● 取值范围是[1, 100]
    ● 输入是 jpeg,且不强制指定质量条件下,七牛会根据原图质量算出一个修正值,取修正值和指定值中的小值。

    注意
    ● 必须指定mode参数,否则不生效。
    ● 指定值后面可以增加 !,表示强制使用指定值,如100!
    ● heic:默认值35
    ● avif:默认值50
    ● 其他格式:默认值75
    ● 如果只设置图片质量,不做其他缩放处理,建议使用 图片高级处理-质量变换
    /ignore-error/<ignoreError> 主要针对图片兼容性的问题导致无法处理,取值为1时,则处理失败时返回原图;
    不设置此参数,默认处理失败时返回错误信息。
    注意
    ● 必须指定mode参数,否则不生效。

    注意:

    • 所有模式都可以只指定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中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式

    以上内容是否对您有帮助?
  • Qvm free helper
    Close