图片样式是指包含格式转换、渐进显示等多个图片处理参数的一个模板。您可以使用图片样式统一处理多个图片，达到简化操作的目的。本文介绍使用图形化界面和 API 代码的方式创建图片样式的相关操作。 ## 使用图形化界面创建样式 1. 登录[对象存储控制台](https://console.volcengine.com/tos)。 2. 在左侧导航栏，单击**桶列表**，在**桶列表**页面单击目标桶名称。 3. 在左侧导航栏，选择**数据处理** \> **图片处理**。 4. 在**图片处理**页面，单击**样式**页签，然后单击**创建样式**。 5. 在**创建样式**页面**基础编辑**按钮下，设置如下参数，单击**确定**。

说明

设置样式参数时，您可以在创建样式页面右侧预览参数处理后的图片效果，以及对应的代码。

|**参数** |**说明** |约束限制 | |---|---|---| |规则名称 |设置样式的名称。命名规范如下：

* 只能以大小写字母、数字、下划线（_）开头。

* 只能包含数字、大小写字母、下划线（_）、中划线（\-）以及英文句号（.）。

* 长度限制为 1~256 个字符。 |* 最多可以创建 100 个样式。

* 样式名称可以相同，如果您想为同一个样式配置多个规则生效前缀时，您需要创建多个名称相同的样式。 | |规则生效前缀 |设置样式生效的对象前缀，若没有填写，则默认对桶内所有对象生效。前缀的填写规范如下：

* 支持中文、英文、数字及常见字符。

* 不支持以正斜线（/）或反斜线（\）开头，不支持使用连续的正斜线（/）。

* 不支持使用 `..` 作为目录名称。 |* 同一个样式最多配置 10 个不同的规则生效前缀，且前缀之间不能存在包含关系，例如为同一个样式设置多个规则生效前缀时，前缀 1 设置为 event，则前缀 2 不支持设置为 event/test。

* 您可以创建多个名称相同的样式，然后为其中的每个样式配置不同的规则生效前缀，实现同一个样式处理不同前缀的图片，效果不同。 | |格式转换 |设置图片转换的格式，支持**原图格式**、**jpg**、**jpeg**、**png**、**bmp**、**gif**、**webp** **或** **tiff** 格式。默认为**原图格式**。 |\- | |渐进显示 |选择是否开启先模糊后清晰的呈现方式，即先显示整个图片的模糊轮廓，然后逐渐加载直至显示完整的图片。默认关闭**渐进显示**。 |仅对格式为 JPG 的图片有效。 | |自适应方向 |选择是否根据原图中 EXIF 旋转参数进行旋转。默认开启**自适应方向**。 |如果原图没有旋转参数，则自适应方向功能无效且对图片无任何影响。 | |图片质量 |选择是否对原图进行压缩，调整原图的质量。默认为**相对质量**，且压缩百分比为 **90**。参数说明如下：

* **相对质量**：将图片按照原图的 q% 进行压缩。

* **绝对质量**：直接将图片压缩为 Q%，与原图不存在相对关系，不依赖于原图。

* **不压缩**：对原图不进行压缩。 |* 图片质量仅对 JPG 和 WEBP 格式的图片有效。

* 对于 WEBP 格式的图片，相对质量等价于绝对质量，即相对质量和绝对质量的效果相同。 | |缩略方式 |选择是否对图片进行缩放。

* **不使用缩略（默认）**

* **等比例缩小**

* **等比例放大**

* **指定宽高缩放**

* **宽度固定，高度自适应**：根据固定宽度等比例缩放图片。

* **高度固定，宽度自适应**：根据固定高度等比例缩放图片。

* **固定宽高，按长边缩放**：根据固定宽高构造一个矩形框，对原图进行等比缩放，缩放过程中全部落入矩形框中的最大图片。

* **固定宽高，按短边缩放**：根据固定宽高构造一个矩形框，对原图进行等比缩放，缩放过程中完全覆盖矩形框的最小图片。

* **固定宽高，缩略填充**：根据固定宽高构造一个矩形框，对原图进行等比缩放，首先确定完全落入矩形框的最大图片，然后在矩形框内居中放置该图片，并对剩余空白区域进行颜色填充。

* **固定宽高，居中裁剪**：根据固定宽高构造一个矩形框，对原图进行等比缩放，首先确定完全覆盖矩形框的最小图片，然后按照矩形框大小进行居中裁剪。

* **强制宽高**：根据固定宽度和高度缩放图片。 |\- | |图片亮度 |设置图片的亮度。取值范围为 \-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。

* **垂直边距**：文字与图片下边的距离。该参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。

* **水平边距**：文字与图片右侧边的距离。该参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。 |**图片水印**

* 如果您想预览水印效果，需要将水印图片的访问权限设置为公共读。

* 水印图与原图必须处于同一个存储桶，否则图片水印会失败。 | |去除元信息 |是否去除图片元信息。 |* 仅支持去除图片的 bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、tEXt、zCCP、zTXt 信息。

* 去除图片元信息时，会去除图片的所有元信息，不支持保留个别元信息。 | ## 使用代码创建样式 1. 登录[对象存储控制台](https://console.volcengine.com/tos)。 2. 在左侧导航栏，单击**桶列表**，在**桶列表**页面单击目标桶名称。 3. 在左侧导航栏，选择**数据处理** \> **图片处理**。 4. 在**图片处理**页面，单击**样式**页签，然后单击**创建样式**。 5. 在**创建样式**页面，单击**高级编辑**按钮，设置如下参数，单击**确定**。 |**参数** |**说明** |约束限制 | |---|---|---| |规则名称 |设置样式的名称。命名规范如下：

* 只能以大小写字母、数字、下划线（_）开头。

* 只能包含数字、大小写字母、下划线（_）、中划线（\-）以及英文句号（.）。

* 长度限制为 1~256 个字符。 |* 最多可以创建 100 个样式。

* 样式名称可以相同，如果您想为同一个样式配置多个规则生效前缀时，您需要创建多个名称相同的样式。 | |规则生效前缀 |设置样式生效的对象前缀，若没有填写，则默认对桶内所有对象生效。前缀的填写规范如下：

* 支持中文、英文、数字及常见字符。

* 不支持以正斜线（/）或反斜线（\）开头，不支持使用连续的正斜线（/）。

* 不支持使用 .. 作为目录名称。 |* 同一个样式最多配置 10 个不同的规则生效前缀，且前缀之间不能存在包含关系，例如为同一个样式设置多个规则生效前缀时，前缀 1 设置为 event，则前缀 2 不支持设置为 event/test。

* 您可以创建多个名称相同的样式，然后为其中的每个样式配置不同的规则生效前缀，实现同一个样式处理不同前缀的图片，效果不同。 | |代码 |输入代码，格式为 `image/action1,parame_value1/action2,parame_value2/...`，例如指定缩放宽度为 200 的对应代码为 `image/resize,w_200`。

目前已支持的图片处理参数，请参见[图片处理参数](https://www.volcengine.com/docs/6349/153623)。 |\- | ## 后续步骤图片样式创建成功后，您可以使用图片样式处理图片。具体操作，请参见[使用图片样式](https://www.volcengine.com/docs/6349/926256)。 ## 相关操作 * 导出样式在**图片处理**页面，勾选样式，单击**导出样式**，即可将样式文件保存至本地。 * 导入样式在**图片处理**页面，单击**导入样式**，在本地选择样式文件，单击打开，即可导入样式。

说明

导入的样式文件必须为 txt 格式，大小不能超过 256KB，且内容要符合样式规范。