图片缩放功能（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（白色）。 |否 | :::tip * 是否必须：使用 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。各个模式得到的缩放图如下： ```mixin-react return ( ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8e1c59890c094a76a9ad026391d7d946~tplv-goo7wpa0wc-image.image =684x) `}> ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ba083fc68e1241baa29e09f09e39f0af~tplv-goo7wpa0wc-image.image =668x) `}> ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/09dd2b64a98f45c6bec69cd54998e35b~tplv-goo7wpa0wc-image.image =668x) `}> ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a6823bc4980b475bb24702da78d2f416~tplv-goo7wpa0wc-image.image =691x) `}> ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ee943a0c9ebc4048aa4521bb12727c9d~tplv-goo7wpa0wc-image.image =723x) `}>); ``` 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png) :::tip 本帮助文档中所有静态图片均使用该图片进行测试。 ::: ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_61b9240da9c944b7ae6cc5c3580bda03.png =864x) * 指定缩放宽度为 100，进行等比缩放。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d132be27067500a3fecd7a5a597fecbe.png =100x) * 指定缩放高度为 100，进行等比缩放。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,h_100](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,h_100) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_efd9b6e2a95072e3584301be483dfa28.png =150x) * 指定缩放长边为 100，进行等比缩放。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,l_100](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,l_100) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_db2c39ce40dd76c4042716ba039bd9e9.png =100x) * 指定缩放短边为 100，进行等比缩放。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,s_100](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,s_100) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d5ab1ce8f66d7c8e7fb6fd769899b9ff.png =150x) * 指定缩放宽度为 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_lfit) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_03398b2ddb6aaa5bfa289bc0281316c9.png =200x) * 指定缩放宽度为 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_mfit) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1ae039212c9ad0f610225c99240fc8b8.png =300x) * 指定缩放宽度为 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fixed) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6ecf0f89798ad7521a0659f51cf17c03.png =200x) * 指定缩放宽度为 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_fill) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ae693c757698a5875feebdad8c712c49.png =200x) * 指定缩放宽度为 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](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_200,h_200,m_pad,color_FF0000) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e736560735f4f4a3733c41bdc6af3532.png =200x) * 等比缩小为 30%。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_30](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_30) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3090f6d3ccd4c6cc589d5ca5b7bba5f6.png =307x)

对象存储