文档中心

对象存储

图片处理

图片缩放

图片缩放

图片缩放功能（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 为放大。	是

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

参数按以下顺序生效：w、h ＞ l、s ＞ p，详细执行顺序说明如下：

指定 w 或 h 参数：

同时指定 w 和 h 参数：使用 w 和 h 构造缩放矩形框。

w 和 h 仅指定其中一个：

lfit、mfit、fixed 模式：根据原图尺寸比例计算另一个参数构造缩放矩形框。

fill、pad 模式：根据指定的参数构造一个正方形缩放矩形框。

仅当 w 和 h 参数均未指定时，才判断l 和 s：

同时指定 l 和 s 参数：缩放矩形框的长边设置为 l，短边设置为 s。

l 和 s 仅指定其中一个：

lfit、mfit、fixed 模式：根据原图尺寸比例计算另一个参数构造缩放矩形框。

fill、pad 模式：根据指定的参数构造一个正方形缩放矩形框。

若 w、h、l 和 s 参数均未指定时：使用 p 参数进行等比例缩放。

参数计算举例

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

指定缩放参数 w 为 100，h 为 100，根据参数优先级，使用 w 和 h 构造缩放矩形，尺寸 100×100。各个模式得到的缩放图如下：

lfit 模式
mfit 模式
fixed 模式
fill 模式
pad 模式

原图等比缩小，缩放矩形框刚好能完全包含缩放图片时，即为该模式的缩放结果（100×50）。

指定缩放参数 w 为 200，根据参数的优先级说明，原图宽、高比为 2:1，计算 h 为100，此时缩放矩形框大小为 200×100，之后按第 1 步的规则，在 fit、mfit、fixed、fill 和 pad 各模式下进行缩放操作。

指定缩放参数 l 为 200，s 为 100，此时缩放矩形框的长边为 200，短边为 100，由于原图宽为长边、高为短边，因此等效于 200×100 的缩放矩形框，之后按第 1 步的规则，在 fit、mfit、fixed、fill 和 pad 各模式下进行缩放操作。

指定缩放参数 l 为 200，原图宽为长边，且宽、高比为 2:1，因此此时等效于 200×100 的缩放矩形框，之后按第 1 步的规则，在 fit、mfit、fixed、fill 和 pad 各模式下进行缩放操作。

示例

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

说明

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

指定缩放宽度为 100，进行等比缩放。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100

指定缩放高度为 100，进行等比缩放。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,h_100

指定缩放长边为 100，进行等比缩放。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,l_100

指定缩放短边为 100，进行等比缩放。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,s_100

指定缩放宽度为 200，高度为 200，模式为 lfit。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_lfit

指定缩放宽度为 200，高度为 200，模式为 mfit。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_mfit

指定缩放宽度为 200，高度为 200，模式为 fixed。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed

指定缩放宽度为 200，高度为 200，模式为 fill。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fill

指定缩放宽度为 200，高度为 200，模式为 pad，填充颜色为红色 FF0000。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_pad,color_FF0000

等比缩小为 30%。

https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_30

最近更新时间：2026.09.17 11:13:06

这个页面对您有帮助吗？

有用

有用

无用

无用