智能多媒体服务

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

    质量变换

    最近更新时间: 2024-03-05 16:05:34

    简介

    imageMogr2 提供一系列高级图片处理功能,本文介绍 图片格式转换、gif 颜色控制,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价

    限制说明

    • 原图格式支持: 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)像素

    参数说明

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

    imageMogr2/format/<Format>
              /colors/<colors>
              /ignore-error/<ignoreError>
    

    参数说明

    参数名称 必填 说明
    /format/<Format> 图片输出格式
    1、取值:jpggifpngwebp等,参考 支持转换的图片格式
    2、取值:heicavif ,属于 图片高级压缩 格式,按照图片高级压缩收费,当前仅支持 持久化处理 来使用。
    3、取值:缺省,默认保持原图格式输出。
    注意
    ● 必须指定mode参数,否则不生效。
    ● 当原图为heicavif 时,如果 format 值缺省,会输出jpeg
    /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,不使用该参数时默认关闭。
    /ignore-error/<ignoreError> 主要针对图片兼容性的问题导致无法处理,取值为1时,则处理失败时返回原图;
    不设置此参数,默认处理失败时返回错误信息。

    注意:

    • 当一张含有透明区域的图片,转换成不支持透明区域的图片格式 jpg、bmp 等时,透明区域填充白色。

    示例

    • 原图

      img

    • 转为gif格式:

      https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/gif
      

      img

    操作方式

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

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