更新时间:2024-02-29 GMT+08:00

设置缩略

此功能支持控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。通过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

表1 缩放设置

参数

取值说明

代码样例

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的目标比例,取原图内满足目标比例的最大的图片。比例范围为1-1000。

image/resize,m_lfit,h_100,w_100

p

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

  • <100:缩小。
  • =100:保持原图大小。
  • >100:放大。

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。

  • 0:不进行限制。
  • 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