图片样式是指包含格式转换、渐进显示等多个图片处理参数的一个模板。您可以使用图片样式统一处理多个图片,达到简化操作的目的。本文介绍使用图形化界面和 API 代码的方式创建图片样式的相关操作。
注意事项
一个存储桶最多支持 100 个样式。
使用图形化界面创建样式
登录对象存储控制台。
在左侧导航栏,单击桶列表,在桶列表页面单击目标桶名称。
在左侧导航栏,选择数据处理 > 图片处理。
在图片处理页面,单击创建样式。
在创建样式页面基础编辑按钮下,设置如下参数,单击确定。
说明
设置样式参数时,您可以在创建样式页面右侧预览参数处理后的图片效果,以及对应的代码。
参数 | 说明 |
---|
规则名称 | 设置样式的名称。命名规范如下: - 只能以大小写字母、数字、下划线(_)开头。
- 只能包含数字、大小写字母、下划线(_)、中划线(-)以及英文句号(.)。
- 长度限制为 1~256 个字符。
说明 - 最多可以创建 100 个样式。
- 样式名称可以相同,如果您想为同一个样式配置多个规则生效前缀时,您需要创建多个名称相同的样式。
|
规则生效前缀 | 设置样式生效的对象前缀,若没有填写,则默认对桶内所有对象生效。前缀的填写规范如下: - 支持中文、英文、数字及常见字符。
- 不支持以正斜线(/)或 反斜线(\)开头,不支持使用连续的正斜线(/)。
- 不支持使用
.. 作为目录名称。
说明 同一个样式最多配置 10 个不同的规则生效前缀,且前缀之间不能存在包含关系,例如为同一个样式设置多个规则生效前缀时,前缀 1 设置为 event,则前缀 2 不支持设置为 event/test。您可以创建多个名称相同的样式,然后为其中的每个样式配置不同的规则生效前缀,实现同一个样式处理不同前缀的图片,效果不同。 |
格式转换 | 设置图片转换的格式,支持原图格式、jpg、jpeg、png、bmp、gif、webp 或 tiff 格式。默认为原图格式。 |
渐进显示 | 选择是否开启先模糊后清晰的呈现方式,即先显示整个图片的模糊轮廓,然后逐渐加载直至显示完整的图片。默认关闭渐进显示。 |
自适应方向 | 选择是否根据原图中 EXIF 旋转参数进行旋转。默认开启自适应方向。 说明 如果原图没有旋转参数,则自适应方向功能无效且对图片无任何影响。 |
图片质量 | 选择是否对原图进行压缩,调整原图的质量。默认为相对质量,且压缩百分比为 90。参数说明如下: 说明 图片质量仅对 JPG 和 WEBP 格式的图片有效。对于 WEBP 格式的图片,相对质量等价于绝对质量,即相对质量和绝对质量的效果相同。 - 相对质量:将图片按照原图的 q% 进行压缩。
- 绝对质量:直接将图片压缩为 Q%,与原图不存在相对关系,不依赖于原图。
- 不压缩:对原图不进行压缩。
|
缩略方式 | 选择是否对图片进行缩放,默认为不使用缩略。支持不使用缩略、等比例缩小、等比例放大和指定宽高缩放。
如果您选择指定宽高缩放,您还可以选择宽度固定,高度自适应、高度固定,宽度自适应等选项,说明如下: - 宽度固定,高度自适应:根据固定宽度等比例缩放图片。
- 高度固定,宽度自适应:根据固定高度等比例缩放图片。
- 固定宽高,按长边缩放:根据固定宽高构造一个矩形框,对原图进行等比缩放,缩放过程中全部落入矩形框中的最大图片。
- 固定宽高,按短边缩放:根据固定宽高构造一个矩形框,对原图进行等比缩放,缩放过程中完全覆盖矩形框的最小图片。
- 固定宽高,缩略填充:根据固定宽高构造一个矩形框,对原图进行等比缩放,首先确定完全落入矩形框的最大图片,然后在矩形框内居中放置该图片,并对剩余空白区域进行颜色填充。
- 固定宽高,居中裁剪:根据固定宽高构造一个矩形框,对原图进行等比缩放,首先确定完全覆盖矩形框的最小图片,然后按照矩形框大小进行居中裁剪。
- 强制宽高:根据固定宽度和高度缩放图片。
|
图片亮度 | 设置图片的亮度。取值范围为 -100 ~ 100,默认为 0。取值说明如下: - 取值 <0:降低图片亮度。
- 取值 =0:不调整图片亮度。
- 取值 >0:提高图片亮度。
|
图片对比度 | 设置图片的对比度。取值范围为 -100 ~ 100,默认为 0。取值说明如下: - 取值<0:降低图片对比度。
- 取值 =0:维持原图对比度。
- 取值 >0:提高图片对比度。
|
图片锐化 | 调整图片的清晰度。取值范围为 50~399,默认关闭图片锐化。
取值越大,图片越清晰,但过大的值可能会导致图片失真。为达到较优效果,推荐取值 100。 |
图片模糊 | 选择是否为图片增加模糊效果,默认关闭图片模糊。开启图片模糊后,需要设置以下参数: - 模糊半径:取值范围为 1~50,该值越大,图片越模糊。
- 模糊标准差:取值范围为 1~50,该值越大,图片越模糊。
|
图片旋转 | 设置图片顺时针旋转的角度。取值范围为 0~360,默认为 0。 说明 - 若图片旋转的角度不是 90°、180°、270°、360° 时,会导致处理后的图片尺寸变大。
- 旋转功能对图片的尺寸有限制,图片的宽或者高不能超过 4096 px。
|
水印 | 选择是否为图片添加图片水印和文字水印,不支持同时设置图片水印和文字水印。默认为不使用水印。部分参数说明如下: - 图片水印
选择图片水印后,设置水印图路径、水印图预处理、透明度等参数。其中:说明 - 如果您想预览水印效果,您需要将水印图片的访问权限设置为公共读。
- 水印图与原图必须处于同一个存储桶,否则图片水印会失败。
- 水印图路径:存储桶中图片的路径,例如水印图片的名称为 abc.jpg,并且放在存储桶的 test 文件夹下,则水印图的路径为
test/abc.jpg 。 - 占比:水印图占图片大小的百分比。开启水印图预处理功能后,可以设置占比。
- 垂直边距:水印图与图片下边的距离。该参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。
- 水平边距:水印图与图片右侧边的距离。该参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。
- 文字水印
选择文字水印后,设置文字的内容、字体、文字大小、文字顺时针旋转的角度等参数。部分参数说明如下:
- 文字内容:仅支持 16 个以内字符。
- 文字字体:可选字体为默认字体(即文泉驿正黑)、文泉驿正黑、文泉微米黑、方正书宋、方正楷体、方正黑体、方正仿宋、DroidSansFallback。
- 垂直边距:文字与图片下边的距离。该参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。
- 水平边距:文字与图片右侧边的距离。该参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。
|
使用代码创建样式
登录对象存储控制台。
在左侧导航栏,单击桶列表,在桶列表页面单击目标桶名称。
在左侧导航栏,选择数据处理 > 图片处理。
在图片处理页面,单击创建样式。
在创建样式页面,单击高级编辑按钮,设置如下参数,单击确定。
参数 | 说明 |
---|
规则名称 | 设置样式的名称。命名规范如下: - 只能以大小写字母、数字、下划线(_)开头。
- 只能包含数字、大小写字母、下划线(_)、中划线(-)以及英文句号(.)。
- 长度限制为 1~256 个字符。
说明 - 最多可以创建 100 个样式。
- 样式名称可以相同,如果您想为同一个样式配置多个规则生效前缀时,您需要创建多个名称相同的样式。
|
规则生效前缀 | 设置样式生效的对象前缀,若没有填写,则默认对桶内所有对象生效。前缀的填写规范如下: - 支持中文、英文、数字及常见字符。
- 不支持以正斜线(/)或 反斜线(\)开头,不支持使用连续的正斜线(/)。
- 不支持使用 .. 作为目录名称。
说明 同一个样式最多配置 10 个不同的规则生效前缀,且前缀之间不能存在包含关系,例如为同一个样式设置多个规则生效前缀时,前缀 1 设置为 event,则前缀 2 不支持设置为 event/test。您可以创建多个名称相同的样式,然后为其中的每个样式配置不同的规则生效前缀,实现同一个样式处理不同前缀的图片,效果不同。 |
代码 | 输入代码,格式为 image/action1,parame_value1/action2,parame_value2/... ,例如指定缩放宽度为 200 的对应代码为 image/resize,w_200 。
目前已支持的图片处理参数,请参见图片处理参数。 |
后续步骤
图片样式创建成功后,您可以使用图片样式处理图片。具体操作,请参见使用图片样式。
相关操作
- 导出样式
在图片处理页面,勾选样式,单击导出样式,即可将样式文件保存至本地。 - 导入样式
在图片处理页面,单击导入样式,在本地选择样式文件,单击打开,即可导入样式。说明
导入的样式文件必须为 txt 格式,大小不能超过 256KB,且内容要符合样式规范。