设置缩略
此功能支持控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。通过resize操作能够使图片按照一定规则进行缩放,支持按照指定宽高和比例进行缩放。
- 关于长短边:长边是指原尺寸与目标尺寸的比值大的那条边,短边同理。例如原图为400px*200px,缩放为100px*100px,由于 400/100=4,200/100=2,4>2,所以在这个缩放中400那条是长边,200那条是短边。
- 目标缩略图最长边不能超过9999,宽和高乘积不能超过24999999。
- 仅指定高或宽进行缩略时,缩略后宽高比例为原图宽高比例,且按照原图格式返回。
- resize操作默认限制原图的放大。如果请求的目标缩略图比原图大时,需要调用参数limit,0才可以取到放大后的图片,否则将返回原图。调用格式如下:
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,w_500,limit_0
具体参数说明如表1所示。
操作名称:resize
参数 |
取值说明 |
代码样例 |
---|---|---|
m |
设置缩略的类型。取值为lfit、mfit、fill、pad和fixed,默认值为lfit。
|
image/resize,m_lfit,h_100,w_100 |
p |
等比例缩放的倍数百分比。取值范围为[1,1000]。当取值为:
|
image/resize,p_50 |
h |
目标缩略图的高度。取值为[1,9999],且输出宽高乘积不超过24999999。 |
image/resize,m_lfit,h_100 |
w |
目标缩略图的宽度。取值为[1,9999],且输出宽高乘积不超过24999999。 |
image/resize,m_fixed,h_100,w_100 |
l |
指定目标缩略图的最长边。取值为[1, 4096],且输出宽高乘积不超过24999999。 长边为指定的值,短边按照比例缩放。 |
image/resize,l_100 |
s |
指定目标缩略图的最短边。取值为[1, 4096],且输出宽高乘积不超过24999999。 短边为指定的值,长边按照比例缩放。 |
image/resize,s_100 |
color |
填充的颜色。选择pad(缩略后填充)模式时可以使用。 格式为十六进制颜色码,取值为000000到FFFFFF,默认值为白色。 |
image/resize,m_pad,h_100,w_100,color_FF0000 |
limit |
是否在目标缩略图比原图大时进行限制放大。取值为0或1,默认值为1。
|
image/resize,p_150,limit_0 |
如果缩略后的图片出现颗粒感或锯齿感,可以通过在图片处理的URL后加“/marker,u_plus”来进行优化。
如:图片处理URL为https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0,添加该参数后的链接为https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0/marker,u_plus。
示例
- 指定高为100,宽度按比例处理(默认为lfit)。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_lfit,h_100
- 等比缩放,按短边将图片样式缩略为100*100。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_lfit,h_100,w_100
- 指定长边为100,短边按照比例缩放。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,l_100
- 固定宽高,居中自动剪切,将图片样式缩略为100*100。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_fill,h_100,w_100
- 强制将缩略图的宽和高固定为100。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_fixed,h_100,w_100
- 固定宽高,按短边将图片样式缩略为100*100,填充白色。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_pad,h_100,w_100
- 固定宽高,按短边将图片样式缩略为100*100,填充红色。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,m_pad,h_100,w_100,color_FF0000
- 等比例放大150%,调用参数“limit,0”取到放大图片。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,p_150,limit_0
- 调用p参数将图等比例缩小为30%。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,p_30
- 指定宽高比例,将原图宽高比例缩放至3:2。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/resize,p_30