智能多媒体服务

  • 智能多媒体 > API 文档 > 图片处理 >图片高级处理(imageMogr2) >缩放

    缩放

    最近更新时间:2021-10-12 14:50:37

    简介

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

    限制说明

    • 原图限制
      • 原图格式支持: psdjpegpnggifwebptiffbmp(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/thumbnail/!<Scale>p 
              /thumbnail/!<Scale>px
              /thumbnail/!x<Scale>p
              /thumbnail/<Width>x
              /thumbnail/x<Height>
              /thumbnail/<Width>x<Height>
              /thumbnail/!<Width>x<Height>r
              /thumbnail/<Width>x<Height>!
              /thumbnail/<Width>x<Height>>
              /thumbnail/<Width>x<Height><
              /thumbnail/<Area>@
              /ignore-error/<ignoreError>
    
    参数名称 必填 说明
    /thumbnail/!<Scale>p 基于原图的长宽,按指定百分比缩放。Scale取值范围1-999。
    /thumbnail/!<Scale>px 以百分比形式指定目标图片宽度,高度不变。Scale取值范围1-999。
    /thumbnail/!x<Scale>p 以百分比形式指定目标图片高度,宽度不变。Scale取值范围1-999。
    /thumbnail/<Width>x 指定目标图片宽度,高度等比缩放,Width取值范围1-9999。
    /thumbnail/x<Height> 指定目标图片高度,宽度等比缩放,Height取值范围1-9999。
    /thumbnail/<Width>x<Height> 等比缩放,比例值为宽缩放比和高缩放比的较小值,Width 和 Height 取值范围1-9999。


    注意: 宽缩放比:目标宽/原图宽 高缩放比:目标高/原图高

    /thumbnail/!<Width>x<Height>r 等比缩放,比例值为宽缩放比和高缩放比的较大值,Width 和 Height 取值范围1-9999。


    注意: 宽缩放比:目标宽/原图宽 高缩放比:目标高/原图高

    /thumbnail/<Width>x<Height>! 按指定宽高值强行缩略,可能导致目标图片变形,width和height取值范围1-9999。
    /thumbnail/<Width>x<Height>> 等比缩小,比例值为宽缩放比和高缩放比的较小值。如果目标宽和高都大于原图宽和高,则不变,Width 和 Height 取值范围1-9999。


    注意: 宽缩放比:目标宽/原图宽 高缩放比:目标高/原图高;

    /thumbnail/<Width>x<Height>< 等比放大,比例值为宽缩放比和高缩放比的较小值。如果目标宽(高)小于原图宽(高),则不变,Width 和 Height 取值范围1-9999。


    注意: 宽缩放比:目标宽/原图宽 高缩放比:目标高/原图高;

    /thumbnail/<Area>@ 按原图高宽比例等比缩放,缩放后的像素数量不超过指定值,Area取值范围1-24999999。
    /ignore-error/<ignoreError> 取值为 1 时,则处理失败时返回原图;取值为 0 时,则处理失败时返回错误信息。默认值为 0。

    示例

    1. 生成 480x320 缩略图

    等比缩小 75%:

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/!75p
    

    img

    按原宽度 75% 等比缩小:

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/!75px
    

    img

    按原高度 75% 等比缩小:

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/!x75p
    

    img

    2. 生成 700x467 放大图

    指定新宽度为 700px:

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/700x
    

    img

    指定新高度为 467px:

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/x467
    

    img

    3. 限定长边,生成不超过 300x300 的缩略图

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/300x300
    

    img

    4. 限定短边,生成不小于 200x200 的缩略图

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/!200x200r
    

    img

    5. 强制生成 200x300 的缩略图

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/200x300!
    

    img

    6. 原图大于指定长宽矩形,按长边自动缩小为 200x133 缩略图

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/200x300>
    

    img

    7. 原图小于指定长宽矩形,按长边自动拉伸为 700x467 放大图

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/700x600<
    

    img

    8. 生成图的像素总数小于指定值

    https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/thumbnail/350000@
    

    img

    操作方式

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

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