更新时间:2024-03-04 GMT+08:00

设置缩略

此功能支持控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。通过resize操作能够使图片按照一定规则进行缩放,支持按照指定宽高和比例进行缩放。

  • 关于长短边:长边是指原尺寸与目标尺寸的比值大的那条边,短边同理。例如原图为400px*200px,缩放为100px*100px,由于 400/100=4,200/100=2,4>2,所以在这个缩放中400那条是长边,200那条是短边。
  • 目标缩略图最长边不能超过9999,宽和高乘积不能超过24999999。
  • 仅指定高或宽进行缩略时,缩略后宽高比例为原图宽高比例,且按照原图格式返回。
  • resize操作默认限制原图的放大。如果请求的目标缩略图比原图大时,需要调用参数limit,0才可以取到放大后的图片,否则将返回原图。调用格式如下:

    https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/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://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0,添加该参数后的链接为https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0/marker,u_plus

示例