智能多媒体服务

  • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理(imageMogr2) >质量变换

    质量变换

    最近更新时间: 2023-11-20 10:02:56

    简介

    imageMogr2 提供一系列高级图片处理功能,本文介绍 图片质量变换,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价

    限制说明

    • 原图限制
      • 原图格式支持: psdjpegpnggifwebptiffbmpavifheif(webp动图,仅支持持久化处理)
    • 输出限制
      • 如果您有多张多帧 gif 图片需要处理,可在图片上传完成后异步进行预转,这样不必在初次访问时进行图片处理,访问速度更快。建议优先使用持久化处理
    • 同步处理
      • 同步处理只支持 20MB 以内的图片,超过 20MB 的图片需要使用持久化处理
      • 同步处理前的gif最大帧数为 200
      • 同步处理前的图片wh参数不能超过3万像素,总像素不能超过1.5亿像素
      • 同步处理后的图片wh参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
    • 持久化处理
      • 持久化处理无大小限制
      • 持久化处理前的gifwebp动图,最大帧数为 500
      • 持久化处理前的图片wh参数不能超过3万像素,总像素不能超过1.5亿像素
      • 持久化处理后的图片wh参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素

    参数说明

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

    imageMogr2/quality/<Quality>
              /size-limit/<sizeLimit>
              /ignore-error/<ignoreError>            
    

    参数说明

    参数名称 必填 说明
    /quality/<Quality> 新图的图片质量
    ● 取值范围是[1, 100]
    ● 输入是 jpeg,且不强制指定质量条件下,七牛会根据原图质量算出一个修正值,取修正值和指定值中的小值。

    注意
    ● 指定值后面可以增加 !,表示强制使用指定值,如100!
    ● heic:默认值35
    ● avif:默认值50
    ● 其他格式:默认值75
    size-limit/<sizeLimit> 限制图片转换后的大小,支持以兆字节和千字节为单位的图片。
    1.仅对于jpg格式的图片,可以用于限制图片转换后的大小,支持魔法变量$(fsize)表示原图大小。如:http://developer.qiniu.com/resource/Ship.jpg?imageMogr2/size-limit/$(fsize)


    2.对于所有图片格式,若在尾部加上!,表示用转换后的图片大小与原图大小做比较,如果转换后的图片比原图小,则返回转换后的图片,否则返回原图。如:https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/size-limit/15k!。这个主要用于保证返回的图片不会比原图大。


    注意:需要根据图片实际大小设置合理的sizeLimit大小。

    /ignore-error/<ignoreError> 可选
    取值:1
    ● 未设置此参数时,正常返回处理结果。
    ● 设置了此参数时,若图像处理的结果失败,则返回原图。
    ● 设置了此参数时,若图像处理的结果成功,则正常返回处理结果。

    <Quality>修正值算法:

    • 原图 quality <= 90: min[90, 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)]
    • 原图 quality > 90: 原图quality*sqrt(原图长宽乘积/结果图片长宽乘积)

    示例

    • 原图

      img

    • 设置图片质量为55:

      https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/quality/55
      

      img

    操作方式

    您可以通过 同步处理持久化处理图片样式设置CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式

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