图片缩放
缩放类型
单边固定缩略
可以将图片的某一边(宽或高)固定为指定长度,另一边按照比例进行调整。
参数
名称 | 描述 | 取值范围 |
---|---|---|
w | 指定目标缩略图宽度 | 1-4096 |
h | 指定目标缩略图高度 | 1-4096 |
I | 目标缩略图大于原图是否处理。值为1,即不处理,为0,表示处理。 | 0/1, 默认为0 |
注意事项
- 如果未指定格式,输出图片将使用jpeg格式,如果原图是png, webp, bmp格式,可能会导致图片出现变形。
示例
- 将图片缩略成高度为200,宽度按比例处理。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@200h
- 将图片缩略成宽度为100,高度按比例处理。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@100w
指定宽高缩略
可以指定图片等宽和高,按照长边或短边优先顺序进行缩放。
参数
名称 | 描述 | 取值范围 |
---|---|---|
w | 指定目标缩略图的宽度。 | 1-4096 |
h | 指定目标缩略图的高度。 | 1-4096 |
e | 缩放优先边,默认值:0(长边)关于“长边”和“短边”的定义需要特别注意,它们表达的是在缩放中相对比例的大小。“长边”是指原尺寸与目标图尺寸比值大的那条边;“短边”是指原图尺寸与目标图尺寸比值小的那条边。如原图400*200 ,缩放为300*100 ,(400/300=1.33,200/100=2。1.33<2),所以在这个缩放中200那条是长边,400是短边。由于图片缩放过程中,原图尺寸与缩放尺寸不一定是相同比例,所以需要确定以长边还是短边优先进行缩放,如原图200*400 (比例1:2),需要缩放为100*100 (比例1:1)长边优先时(e=0),缩放为50*100 ,短边优先时(e=1),缩放为100*200 ,如不特别指定,则代表长边优先。 |
0表示按长边优先(默认值),1表示按短边优先。 |
l | 目标缩略图大于原图是否处理。如果值是1,即不处理,是0,表示处理 | 0/1,默认是0。 |
注意事项
- 如果未指定格式,输出图片将使用jpeg格式,如果原图是png, webp, bmp格式,可能会导致图片出现变形
示例
- 将图缩略成宽度为100,高度为100,按长边优先。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@100h_100w_0e
- 将图缩略成宽度为100,高度为100,按短边优先。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@100h_100w_1e
强制宽高缩略
可以强制指定目标缩略图的高度和宽度,忽略原图的宽高比。
参数
名称 | 描述 | 取值范围 |
---|---|---|
w | 指定目标缩略图的宽度。 | 1-4096 |
h | 指定目标缩略图的高度 | 1-4096 |
e | 缩放优先边,如果是强制缩略,值是2。 | 2(强制缩略) |
l | 目标缩略图大于原图是否处理。如果值是1,即不处理,是0,表示处理。 | 0/1,默认是0. |
注意事项
- 此操作会导致图变形。
- 如果未指定格式,输出图片将使用jpeg格式,如果原图是png, webp, bmp格式,可能会导致图片出现变形。
示例
- 将图强制缩略成宽度为100,高度为100。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@100h_100w_2e
按比例缩放
可以指定一个比例,将图片按照比例进行缩放。
参数
名称 | 描述 | 取值范围 |
---|---|---|
p | 倍数百分比。小于100即是缩小,大于100即是放大。 | 1-1000 |
注意事项
- 如果未指定格式,输出图片将使用jpeg格式,如果原图是png, webp, bmp格式,可能会导致图片出现变形。
- 如果参数p和w,h合用时,p将直接作用于w,h(按照相应比例对w,h进行缩放)得到新的w,h,如100w_100h_200p的作用跟200w_200h等价。
示例
- 将图按比例缩略到原来的1/10
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@10p
缩略后填充
先把图按长边优先缩略,然后再用指定颜色填充剩余区域。
参数
名称 | 描述 | 取值范围 |
---|---|---|
w | 指定目标缩略图的宽度。 | 1-4096 |
h | 指定目标缩略图的高度。 | 1-4096 |
e | 缩略优先边,这里必须指定值为4。 | 4 |
bgc | 填充的背景颜色,默认色为白色。参数格式:<red>-<green>-<blue>bgc 如:100-100-100bgc 表示rgb(100,100,100)。 |
red, green, blue[0-255] |
注意事项
- 如果未指定格式,输出图片将使用jpeg格式,如果原图是png, webp, bmp格式,可能会导致图片出现变形。
示例
- 将图按长边缩略到100x100, 然后按红色填充。
http://www.ct-accel-demo.com/api/v1/vendor1/test2.jpeg@100w_100h_4e_100-0-0bgc