缩放/裁剪/旋转/格式转换/渐进显示

接口

imageScale

该接口提供对图片的缩放、裁剪、旋转、格式转换渐进显示和锐化等功能。使用此接口，必须是Bucket的所有者或具有ks3:GetObject权限。

缩放

1. 指定宽高

• 只设置缩略宽，按照宽进行等比例缩放。

• 只设置缩略高，按照高进行等比例缩放。

• 设置宽和高，在没有设置短边优先的情况下按照长边进行等比例缩放。

• 设置宽和高，在设置短边优先的情况下按照短边进行等比例缩放。

• 设置图片及背景的宽和高，进行缩略填充（BMP格式图片文件建议使用管道方式进行缩略填充）。

若您需要放大图片，请使用参数so并设置其值为1。等比放大时无需指定so。

2. 等比缩放

• 指定倍数百分比。小于100即是缩小，大于100即是放大，参数取值范围为1-1000。

图片放大情况下有如下限制：

• 图片小于等于1MB时，最大支持放大到10倍；图片大于1MB且小于2MB时，最大支持放大5倍；图片大于2MB时，最大支持放大3倍。

裁剪：

裁剪包括以下两大类：

• 居中裁剪：

  • 缩放后居中裁剪：在设定了缩略宽和高后，按照设定的宽和高对缩放后的图片进行居中裁剪。

  • 固定宽高后居中裁剪：在设定了固定宽和高后，按照设定的宽和高对图片进行居中裁剪。

• 任意位置裁剪：

  • 在设定了起始横坐标和纵坐标、裁剪宽和高后，按照设定的坐标及宽高进行裁剪。

旋转：

• 按照EXIF中包含的旋转角度进行旋转。

格式转换：

• 可按照指定图片格式输出，输出格式支持PNG，JPG，JPEG，GIF，WBMP，TIFF，TIF，BMP，WebP(静态)，HEIF。

注意：缩略、裁剪、旋转、格式转换四个操作的顺序是先进行旋转，然后进行缩略，然后裁剪，最后进行格式转换，与指定参数顺序无关。

渐进显示：

图片格式为JPG或JPEG时有两种呈现方式：

• 自上而下的扫描式。

• 先模糊后逐渐清晰（在网络环境比较差时明显）。

默认保存为第一种，如果要指定先模糊后清晰的呈现方式，请使用渐进显示参数。

锐化：

通过添加锐化参数，对图片进行锐化处理，使处理后的图片变得更清晰。

限制说明：

• 图片原图处理像素不能超过2.5亿px。

请求

请求语法

https://BucketName.${bucket所在region的域名}/object@base@
	tag=imgScale   
	&m=<mode>   
	&w=<width>   
	&h=<height>   
	&q=<quality>   
	&F=<format>   
	&r=<auto-orient>   
	&c=<cut>   
	&f=<fixed>     
	&s=<strip>
	&cox=<x-coordinate>
	&coy=<y-coordinate>
	&rotate=<degree>
	&et=<extent>
	&etw=<extent width>
	&eth=<extent height>
	&etc=<extent colour>    

请求参数：

请求头部

该请求不需要设置特殊的头部。

响应：

响应头部

响应内容：

如果请求处理成功，返回图片的二进制图片数据。

特殊错误：

示例

只设置缩略宽，按照宽进行等比例缩放：

宽度为200px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&w=200

只设置缩略高，按照高进行等比例缩放：

高度为200px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=200

设置宽和高，在没有设置短边优先的情况下按照长边进行等比例缩放：

高度为200px，宽度为100px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=200&w=100&m=0

设置宽和高，在设置短边优先的情况下按照短边进行等比例缩放：

高度为200px，宽度为100px，m为1

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=200&w=100&m=1

按比例缩小：

将图按比例缩略到原来的1/4

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&p=25

指定宽度等比放大：

宽度为400px，so为1

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&w=400&so=1

居中裁剪，在进行缩放以后对超出设定范围外的进行居中裁剪：

高度为30px，宽度为200px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=30&w=200&m=0&c=1

高度为200px，宽度为20px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=200&w=20&m=1&c=1

固定宽和高的情况下，按照固定的宽和高居中裁剪：

高度为100px，宽度为50px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&h=100&w=50&c=1&f=1

任意位置裁剪，起始横坐标和起始纵坐标必须在图片以内,设置起始横坐标和起始纵坐标进行裁剪：

起始横坐标为100，起始纵坐标为50，裁剪高度为200px，宽度为100px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&w=100&h=200&c=1&f=1&cox=100&coy=50

将图片按长边缩略到100x100，然后按红色填充：

背景高度为100px，背景宽度为100px，图片宽度（长边）为100px

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgscale&m=0&w=100&et=1&eth=100&etw=100&etc=FF0000

渐进显示：

对JPG或JPEG格式的图片指定先模糊后清晰的呈现方式

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&interlace=1

锐化：

锐化操作：进行锐化处理，锐化参数设置为锐化半径为3，锐化标准差为2

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=imgScale&spr=3&sps=2