顺序无关
转换参数中键值对是顺序无关的,即"120w_120h_90q"和"90q_120w_120h"都能取到想要的图片,系统会对参数按照本规范以下定义的顺序重新排序后再处理。(由于参数的顺序不同有时会表达不同的语义,如“100w_100h_200p”表达的是“先缩放到100*100,再放大2倍”,即得到200*200的图片;而"200p_100w_100h"按照字面顺序理解是“先放大2倍再缩放到100*100”,即得到100*100的图片,为了避免这样的理解误差,同时简化处理方式,OOS会对参数按照文档中出现的顺序排序后处理。上例中的"200p_100w_100h"会被理解为“100w_100h_200p”,得到200*200的图片。)
覆盖处理
如果转换参数中出现多个相同“键”,后面定义的覆盖前面定义。如“120w_120h_240w”等同于“120h_240w”。
长边与短边
关于“长边”和“短边”的定义需要特别注意,它们表达的是在缩放中相对比例的长或短。“长边”是指原尺寸与目标尺寸的比值大的那条边;“短边”是指原尺寸与目标尺寸的比值小的那条边如原图400*200,缩放为800*100,(400/800=0.5,200/100=2,0.5 < 2),所以在这个缩放中200那条是长边,400是短边。
图片格式
- 只能转换图片文件格式的文件,支持的原图片格式为:jpg、 png、 bmp、 webp。
- 转换后的图片格式支持jpg、png、bmp和webp。其中:
- jpg、 png、 bmp、 webp的图片可以保存为jpg、png、bmp和webp中的任意一种格式;
- 图片如果不指定保存格式,默认保存为原格式。例如:格式为png的图片,默认保存为png格式的图片。
- 原图片的大小不能超过20MiB。
- 缩略后的图片的大小有限制,目标缩略图的宽与高的乘积不能超过4096 * 4096, 而且单边的长度不能超过4096 * 4。
- 一次转换请求最多支持4个管道处理。
存储桶属性限制
处理的图片所在存储桶(Bucket)的“存储桶属性”>“访问权限”不可以设置为私有。存储桶的访问权限修改详见查看/修改存储桶属性。