You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/用户指南/数据处理/图片处理/图片缩放
图片缩放
最近更新时间：2024.07.01 10:14:36首次发布时间：2022.11.18 17:58:41
我的收藏

图片缩放功能（resize）可以对原图大小进行调整。本文介绍图片缩放功能的参数说明及使用示例。

参数说明

指定宽高缩放

参数

参数说明

取值说明

是否必选

m

图片缩放模式

  • lfit（默认值）：根据 w 和 h 构造一个缩放矩形框，对原图进行等比缩放，缩放过程中全部落入缩放矩形框中的最大图片作为 lfit 缩放结果。
  • mfit：根据 w 和 h 构造一个缩放矩形框，对原图进行等比缩放，缩放过程中完全覆盖缩放矩形框的最小图片作为mfit缩放结果。
  • fill：根据 w 和 h 构造一个缩放矩形框，对原图进行等比缩放，首先确定完全覆盖缩放矩形框的最小图片（即 mfit），然后按照缩放矩形框大小进行居中裁剪。
  • pad：根据 w 和 h 构造一个缩放矩形框，对原图进行等比缩放，首先确定完全落入缩放矩形框的最大图片（即lfit），然后在缩放矩形框内居中放置该图片，并对剩余空白区域进行颜色填充（color 参数）。
  • fixed：强制按照固定的宽、高进行缩放。

否

w

目标缩放图宽度

[1,16384]

是

h

目标缩放图高度

[1,16384]

是

l

目标缩放图长边

[1,16384]

是

s

目标缩放图短边

[1,16384]

是

limit

指定目标缩放图大于原图时是否进行缩放

  • 1（默认值）：不按指定参数进行缩放，直接返回原图。
  • 0：按指定参数进行缩放。

否

color

填充颜色（pad 缩放模式时使用）

十六进制颜色码，取值为 000000 到 FFFFFF，默认值为 FFFFFF（白色）。

否

说明

  • 是否必须：使用 resize 功能，您必须指定必选参数中的其中一个，否则会出现 MissingArgument 错误。
  • 长边：原尺寸与目标尺寸的比值大的边。
  • 短边：原尺寸与目标尺寸的比值小的边。

按百分比缩放

参数

参数说明

取值说明

是否必须

p

等比缩放百分比

[1,1000]
小于 100 为缩小，大于 100 为放大。

是

缩放矩形框计算方式以及参数优先级说明

  1. 同时指定 w 和 h 参数：使用 w 和 h 构造缩放矩形框。
  2. w 和 h 仅指定其中一个：
    1. lfit、mfit、fixed：根据原图尺寸比例计算另一个参数构造缩放矩形框。
    2. fill、pad：根据指定的参数构造一个正方形缩放矩形框。
  3. 如果不含 w 和 h 参数
    1. 如果同时包含 l 和 s 参数：缩放矩形框的长边设置为 l，短边设置为 s。
    2. l 和 s 仅指定一个：
      1. lfit、mfit、fixed：根据原图尺寸比例计算另一个参数构造缩放矩形框。
      2. fill、pad：根据指定的参数构造一个正方形缩放矩形框。
    3. 如果不含 l 和 s 参数：使用 p 参数进行等比例缩放。

参数计算举例

本文档中使用的原图尺寸为 400×200。

  1. 指定缩放参数 w 为 100，h 为 100，根据参数优先级，使用 w 和 h 构造缩放矩形，尺寸 100×100：
    • lfit 模式：原图等比缩小，缩放矩形框刚好能完全包含缩放图片时，即为该模式的缩放结果（100×50）。
    • mfit 模式：原图等比缩小，缩放图片刚好能完全覆盖缩放矩形框时，即为该模式的缩放结果（200×100）。
    • fixed 模式：按指定宽、高强制缩放（100×100）。
    • fill 模式：先进行 mfit 放，然后将缩放图片和缩放矩形框中心对齐，将缩放图片超出缩放矩形的部分裁剪掉（100×100）。
    • pad 模式：先进行 lfit 缩放，然后将缩放图片和缩放矩形框中心对齐，对于空白的区域使用指定颜色填充（100×100）。
  2. 指定缩放参数 w 为 200，根据参数的优先级说明，原图宽、高比为 2:1，计算 h 为100，此时缩放矩形框大小为 200×100，之后同上进行缩放操作。
  3. 指定缩放参数 l 为 200，s 为 100，此时缩放矩形框的长边为 200，短边为 100，由于原图宽为长边、高为短边，因此等效于 200×100 的缩放矩形框，之后同上进行缩放操作。
  4. 指定缩放参数 l 为 200，原图宽为长边，且宽、高比为 2:1，因此此时等效于 200×100 的缩放矩形框，之后同上进行缩放操作。

示例

原图：https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png

说明

本帮助文档中所有静态图片均使用该图片进行测试。

图片