使用说明
媒体存储支持通过特定规则的URI来进行提供图片处理操作，用户可根据需求选择对应的参数进行使用。
图片处理参数可参考图片处理-概述，根据概述指引获取相关参数。
前提条件
使用URL参数进行图片处理前，用户需登录控制台并上传图片文件。
图片处理仅在部分资源池适用，具体可参考：资源池与区域节点。
URL规则
媒体存储的图片处理URL由4个部分组成，包括：对象存储域名、原图所在桶名称、原图片名称和处理命令及样式参数组成。
URL规则为：https://endpoint/bucket/objectName?x-amz-process=image/processCommands。
其中：
- endpoint：桶所在资源池对应的对象存储终端节点，可以在桶基础信息中获取。
- bucket：原图片所在的桶名称。
- objectName：原图片的名称。
- processCommands：处理命令及样式参数。处理命令和样式参数间以多种符号区分。若不输入任何处理命令，则返回原图片。
处理参数
| 图片处理 | 参数 | 说明 |
|---|---|---|
| 图片缩放 | resize | 将图片缩放至指定大小。 |
| 格式转换 | format | 转换图片格式。 |
| 旋转 | rotate | 按指定角度以顺时针方向旋转图片。 |
| EXIF信息 | info/strip | 获取或删除图片的exif信息。 |
| 质量变换 | quality | 调整JPG和WebP格式图片的质量。 |
| 亮度 | bright | 调整图片亮度。 |
| 渐进显示 | interlace | 将JPG格式的图片调整为渐进显示。 |
| 模糊 | blur | 对图片进行模糊处理。 |
| 自定义裁剪 | crop | 裁剪指定大小的矩形图片。 |
| 图片水印 | watermark | 为图片添加图片或文字水印。 |
| 自适应方向 | auto-orient | 将携带旋转参数的图片进行自适应旋转。 |
| 获取平均色调 | average-hue | 获取图片平均色调信息。 |
| 锐化 | sharpen | 通过锐化参数，提高原图的清晰度。 |
| 对比度 | contrast | 调整原图的对比度。 |
| 内切圆 | circle | 将图片处理成内切圆。 |
| 圆角矩形 | rounded-corners | 将图片的4个角切成圆角。 |
| 索引切割 | indexcrop | 按指定大小分割原图并截取需要的图片。 |
符号说明
| 名称 | 符号 | 顺序 | 说明 |
|---|---|---|---|
| 参数连接符 | _ | 固定顺序 | 样式参数与参数值之间的连接符 |
| 样式分隔符 | , | 无序 | 多个样式参数之间的分隔符 |
| 命令分隔符 | / | 有序 | 多个处理命令之间的分隔符 |
具体样式参数请参考各个具体图片处理操作的说明文档。
使用示例
示例使用的Bucket为image-demo，图片外网访问地址为：https://gdoss.xstore.ctyun.cn/image-demo/demo.jpg
对图片进行半径为3，标准差为2的模糊处理，则处理参数为"blur"，处理参数值为"r_3,s_2”。
则图片处理的URL为：https://gdoss.xstore.ctyun.cn/image-demo/demo.jpg?x-amz-process=image/blur,r_3,s_2
