文档中心

图片缩放

最近更新时间：2023.04.24 16:43:13

首次发布时间：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（白色）。	否

说明

参数	参数说明	取值说明	是否必须
p	等比缩放百分比	[1,1000] 小于 100 为缩小，大于 100 为放大。	是

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

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

指定缩放参数 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）。
指定缩放参数 w 为 200，根据参数的优先级说明，原图宽、高比为 2:1，计算 h 为100，此时缩放矩形框大小为 200×100，之后同上进行缩放操作。
指定缩放参数 l 为 200，s 为 100，此时缩放矩形框的长边为 200，短边为 100，由于原图宽为长边、高为短边，因此等效于 200×100 的缩放矩形框，之后同上进行缩放操作。
指定缩放参数 l 为 200，原图宽为长边，且宽、高比为 2:1，因此此时等效于 200×100 的缩放矩形框，之后同上进行缩放操作。