全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

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

最近更新时间:2023-12-18 19:29:43

接口

imageScale

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

缩放

  1. 指定宽高

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

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

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

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

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

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

  1. 等比缩放

  • 指定倍数百分比。小于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>    

请求参数:

参数

参数含义

必填

默认值

取值范围

解释说明

tag

操作标志

操作标志,取值为接口名称。比如进行缩放/裁剪/旋转/格式转换/渐进显示的操作,则URL中tag=imageScale 。

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倍

so

图片放大

0

值为1时开启图片放大

指定为放大模式

q

图片质量

75

0-100

决定JPG图片的相对quality,对原图压缩,0表示高压缩低质量,100表示低压缩高质量

F

目标缩略图输出格式

默认按照原图格式输出。输出格式支持PNG,JPG,JPEG,GIF,WBMP,TIFF,TIF,BMP,WebP,HEIF

r

旋转模式

0

0

按原图默认处理

1

按原图EXIF信息自动旋转图片

2

自定义旋转角度,旋转角度由<rotate>参数指定

c

是否裁剪

0

0

不进行裁剪

1

对缩放后超出范围的图片内容进行剪裁,这种情况一般发生在按照短边优先的等比缩放中。缩放会以图片中线为中心,进行上下/左右的裁剪,得到相应的尺寸

f

是否固定宽高

0

0

不固定宽高

1

以图片中线为中心,裁剪指定w和h的区域,此参数与参数c配合使用,当使用f时会固定图片的宽高,进行非缩放裁剪

s

是否支持去除元数据

1

0

不支持去除元数据

1

支持去除元数据

cox

裁剪起始横坐标

居中裁剪

此参数与参数c及参数f配合使用,当不设置裁剪起始横坐标时则默认居中裁剪

coy

裁剪起始纵坐标

居中裁剪

此参数与参数c及参数f配合使用,当不设置裁剪起始纵坐标时则默认居中裁剪

rotate

旋转角度

0

1-360

缺省为不旋转。自定义旋转角度需指定参数<r>等于2

et

是否增加背景

0

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格式

1

表示保存成渐进显示的JPG、JPEG格式

请求头部

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

响应:

响应头部

头部名称

是否必选

说明

Content-Type

MIME类型,成功时为图片固定的MIME类型image/*,失败时为application/json

响应内容:

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

特殊错误:

HTTP状态码

描述

200

操作成功

400

请求报文格式错误

404

资源不存在

500

服务器端操作失败。如果遇到此种错误,请及时联系我们

示例

只设置缩略宽,按照宽进行等比例缩放:

宽度为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

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈