智能多媒体服务

  • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理(imageMogr2) >格式转换

    格式转换

    最近更新时间: 2023-09-01 16:05:37

    简介

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

    限制说明

    • 原图限制
      • 原图格式支持: psdjpegpnggifwebptiffbmpavif(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> 新图的输出格式
    取值范围:jpggifpngwebp等,默认为原图格式。
    /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