全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

缩放

最近更新时间:2026-03-31 13:51:03

缩放

通过resize操作能够使图片按照一定规则进行缩小或放大,支持按照指定宽高和比例进行缩放。

使用限制

限制

项目

说明

原图限制

图片格式

原图支持 JPG, PNG, WEBP, BMP, GIF, TIFF, HEIC, WBMP, PPM, MNG, AVIF, DNG, PIC, SVG

图片大小

不超过 20MB

图片宽高

像素数不超过 2.5亿。

总像素计算方式为 宽*高*帧数

图片帧数

不超过 200帧

结果图限制

图片缩放

宽高均不超过 4096像素

参数说明

操作名称:resize

具体参数说明如下表所示。

参数

取值说明

代码样例

m

设置缩略的类型。取值为lfit、mfit、fill、pad和fixed,默认值为lfit。

lfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形内最大的图片。

mfit:指定一个w和h的矩形,将图片进行等比缩放,取在矩形延伸区域的最小图片。

fill:指定一个w和h的矩形,将图片进行等比缩放,取在延伸区域的最小图片,并进行居中裁剪。即将mfit缩略类型的图片进行居中剪裁。

pad:指定一个w和h的矩形,将图片进行等比缩放,居中取在矩形内最大的图片,并在矩形空白处进行颜色填充。即lfit缩略类型的图片在矩形空白处进行颜色填充。

fixed:强制按照固定的宽高进行缩略。

ratio:指定一个w和h的目标比例,取原图内满足目标比例的最大的图片,强制缩放。

当缩放模式设置为m模式下的任意值,并且指定了目标缩放图的wh,则目标缩放图的ls的设定将不会生效。

image/resize,m_lfit,h_100,w_100

p

等比例缩放的倍数百分比。取值范围为[1,1000]。当取值为:

<100:缩小。

=100:保持原图大小。

>100:放大。

image/resize,p_50

h

目标缩略图的高度。取值为[1,4096],且输出总像素数不超过 2.5亿。

image/resize,m_lfit,h_100

w

目标缩略图的宽度。取值为[1,4096],且输出总像素数不超过 2.5亿。

image/resize,m_fixed,h_100,w_100

l

指定目标缩略图的最长边。取值为[1, 4096],且输出总像素数不超过 2.5亿。

长边为指定的值,短边按照比例缩放。

长边即宽度或高度中较大的那一边。例如原图为100 px * 200 px,200那条是长边,100那条是短边。

image/resize,l_100

s

指定目标缩略图的最短边。取值为[1, 4096],且输出总像素数不超过 2.5亿。

短边为指定的值,长边按照比例缩放。

image/resize,s_100

color

填充的颜色。选择pad(缩略后填充)模式时可以使用。

格式为十六进制颜色码,取值为000000到FFFFFF,默认值为白色。

image/resize,m_pad,h_100,w_100,color_FF0000

limit

是否在目标缩略图比原图大时进行限制放大。取值为0或1,默认值为1。

0:不进行限制。

1:进行限制。

目标缩放图比原图尺寸大时,默认返回原图。如果您想放大图片,您需要增加limit_0参数。

image/resize,p_150,limit_0

说明:
1. 只有未指定参数 w h l s 时,参数 p 才有效。
2. 使用参数 p 进行等比缩放时参数 limit 和 m 无效。
3. 若缩放时只指定宽度、高度、长边、短边其中一个:
缩放模式为lfit,mfit,fixed时,会按比例缩放图片。例如原图为256px*144 px,将高缩放为100 px,则宽缩放为178px。
缩放模式为pad,fill时,会将原图宽高均按照指定值进行缩放。例如原图为256px*144px,将高缩放为100 px,则宽也缩放为100 px。

缩放计算方式

原图大小

指定缩放参数

缩放模式

缩放后大小

200 px*100 px

m_lfit,w_150,h_80

lfit(默认值)

等比缩放,缩略图限制在指定w与h的矩形内的最大图片。

150 px*75 px

m_lfit,w_150,h_80

mfit

等比缩放,缩略图为延伸出指定w与h的矩形框外的最小图片。

160 px*80 px

m_fill,w_150,h_80

fill

等比缩放,缩略图为延伸出指定w与h的矩形框外的最小图片,之后按照固定宽高进行居中裁剪。

150 px*80 px

m_pad,w_150,h_80

pad

等比缩放,缩略图限制在指定w与h的矩形内的最大图片再按照固定宽高进行颜色填充。

150 px*80 px

m_fixed,w_150,h_80

fixed

按照固定宽高强制缩放,若宽高与原图宽高比例不同,则会导致图片变形。

150 px*80 px

m_ratio,w_3,h_2

ratio

指定一个w和h的目标比例,计算结果图的宽高,取原图内满足目标比例的最大的图片,按照该宽高强制缩放,若宽高与原图宽高比例不同,则会导致图片变形。

150px*100px

示例

  • 指定高为100,宽度按比例处理(默认为lfit)。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_lfit,h_100

  • 等比缩放,按短边将图片样式缩略为100*100。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_lfit,h_100,w_100

  • 指定长边为100,短边按照比例缩放。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,l_100

  • 固定宽高,居中自动裁剪,将图片样式缩略为100*100。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_fill,h_100,w_100

  • 强制将缩略图的宽和高固定为100。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_fixed,h_100,w_100

  • 固定宽高,按短边将图片样式缩略为100*100,填充白色。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_pad,h_100,w_100

  • 固定宽高,按短边将图片样式缩略为100*100,填充红色。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_pad,h_100,w_100,color_FF0000

  • 等比例放大150%,调用参数“limit_0”取到放大图片。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,p_150,limit_0

  • 调用p参数将图等比例缩小为30%。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,p_30

  • 指定宽高比例,将原图宽高比例缩放至3:2。

https://ks3tools.ks3-cn-beijing.ksyuncs.com/images/sample.jpg?x-kss-process=image/resize,m_ratio,w_3,h_2

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈