文档首页/ 对象存储服务 OBS/ 图片处理（此文档即将下线，请查阅用户指南）/ 设置缩略
更新时间：2024-03-04 GMT+08:00
查看PDF
分享

设置缩略

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

示例