金山云-文档中心-缩放/裁剪/旋转/格式转换/渐进显示

接口

imageScale

描述

该功能提供对图像的缩放、裁剪、旋转、格式转换和渐进显示等功能。

缩放具有多种方式：

指定宽高

只设置缩略宽，按照宽进行等比例缩放；
只设置缩略高，按照高进行等比例缩放；
设置宽和高，在没有设置短边优先的情况下按照长边进行等比例缩放；
设置宽和高，在设置短边优先的情况下按照短边进行等比例缩放；
设置图像及背景的宽和高，进行缩略填充（BMP格式图像文件建议使用管道方式进行缩略填充）。

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

等比缩放

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

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

图像长边像素值*倍数最大支持5000；
图像小于等于1MB时，最大支持放大到10倍；图像大于1MB且小于2MB，最大支持放大5倍，图像大于2MB，最大支持放大3倍。

裁剪具有三种使用方式：

居中裁剪，在进行缩放以后对超出设定范围外的进行居中裁剪，该裁剪只会发生在设定了缩略宽和高的情况下。
在设定了固定宽和高的情况下，选择裁剪会按照固定的宽和高居中裁剪。
任意位置裁剪，设置起始横坐标和起始纵坐标，设置裁剪宽和高进行裁剪。

旋转：

按照Exif中包含的旋转角度进行选转。

格式转换：

可按照指定图像格式输出，输出格式支持JPG、JPEG、PNG、GIF、WBMP、BMP、WEBP。

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

渐进显示：

图像格式为 jpg或jpeg 时有两种呈现方式：

自上而下的扫描式
先模糊后逐渐清晰（在网络环境比较差时明显）

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

权限

该接口操作需要具备GetObject权限，假如获取对象不存在，你可能存在以下两种返回：

假如用户具有该对象所在Bucket的ListBucket权限，会返回状态码404错误；
假如用户不具备该对象所在Bucket的ListBucket权限，会返回状态码403错误。

请求

语法

https://BucketName.${bucket所在region的域名}/[email protected]@
	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>    
HTTP/1.1
Host: BucketName.${bucket所在region的域名}

请求参数：

参数	参数含义	必填	默认值	取值范围	解释说明
tag	操作标志	是
m	缩略模式	否	0	0	长边优先缩放，缩放按照较长边的缩放比例进行缩放，不剪裁
				1	短边优先缩放，缩放按照较短边的缩放比例进行缩放，不剪裁
				2	限定缩略图的宽最少为<width>，高最少为<height>，进行等比缩放
w	缩略宽度/裁剪宽度	w/h必须有一个		1-4096	指定目标缩略图或裁剪图的宽度，单位：像素(px)。当单独使用时，代表按照宽度等比缩放
h	缩略高度/裁剪高度	w/h必须有一个		1-4096	指定目标缩略图或裁剪图的高度，单位：像素(px)。当单独使用时，代表按照高度等比缩放
p	图像按比例缩放	否		1-1000	倍数百分比。小于 100，即是缩小，大于 100 即是放大，放大时p值取值范围如下：图像小于等于1MB时，最大支持放大到10倍；图像大于1MB且小于2MB，最大支持放大5倍，图像大于2MB，最大支持放大3倍图像长边像素值*倍数最大支持5000
so	图像放大	否	0	值为1时开启图像放大	指定为放大模式
q	图像质量	否	75	0-100	决定 jpg 图像的相对quality，对原图压缩，0表示高压缩低质量，100表示低压缩高质量
F	目标缩略图输出格式	否			默认按照原图格式输出。输出格式支持JPG、JPEG、PNG、GIF、WBMP、BMP、WEBP
r	旋转模式	否	0	0	按原图默认处理
				1	按原图 EXIF 信息自动旋转图像
				2	自定义旋转角度，旋转角度由<rotate>参数指定
c	是否裁剪	否	0	0	不进行裁剪
c	是否裁剪	否	0	1	对缩放后超出范围的图像内容进行剪裁，这种情况一般发生在按照短边优先的等比缩放中。缩放会以图像中线为中心，进行上下/左右的裁剪，得到相应的尺寸
f	是否固定宽高	否	0	0	不固定宽高
f	是否固定宽高	否	0	1	以图像中线为中心，裁剪指定w和h的区域，此参数与参数 cut 配合使用，当使用 f 时会固定图像的宽高，进行非缩放裁剪
s	是否支持去除元数据	否	1	0	不支持去除元数据
s	是否支持去除元数据	否	1	1	支持去除元数据
cox	裁剪起始横坐标	否	居中裁剪		此参数与参数cut及参数fixed配合使用，当不设置裁剪起始横坐标时则默认居中裁剪
coy	裁剪起始纵坐标	否	居中裁剪		此参数与参数cut及参数fixed配合使用，当不设置裁剪起始纵坐标时则默认居中裁剪
rotate	旋转角度	否	0	1-360	缺省为不旋转。自定义旋转角度需指定参数<r>等于2
et	是否增加背景	否	0	0	不增加
et	是否增加背景	否	0	1	对缩放后空白范围的图像内容进行背景填充
etw	指定背景宽度	否	原图最大宽度	1-4096	单位：像素（px），若eth与etw均没有设置，则默认取原图高度和宽度的最大值，构成正方形；若只设置etw，则高度默认为原图高度
eth	指定背景高度	否	原图最大高度	1-4096	单位：像素（px），若eth与etw均没有设置，则默认取原图高度和宽度的最大值，构成正方形；若只设置eth，则宽度默认为原图宽度
etc	指定背景颜色	否	FFFFFF		支持RRGGBB格式（透明色为“transparent”，透明背景色支持图像格式为PNG、GIF）
interlace	渐进显示	否	0	0	表示保存成普通的jpg、jpeg格式
interlace	渐进显示	否	0	1	表示保存成渐进显示的jpg、jpeg格式