You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

创建图片样式

最近更新时间：2024.03.20 19:30:02

首次发布时间：2023.06.07 21:52:26

我的收藏

图片样式是指包含格式转换、渐进显示等多个图片处理参数的一个模板。您可以使用图片样式统一处理多个图片，达到简化操作的目的。本文介绍使用图形化界面和 API 代码的方式创建图片样式的相关操作。

注意事项

一个存储桶最多支持 100 个样式。

使用图形化界面创建样式

  1. 登录对象存储控制台。

  2. 在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

  3. 在左侧导航栏，选择数据处理 > 图片处理。

  4. 在图片处理页面，单击创建样式。

  5. 在创建样式页面基础编辑按钮下，设置如下参数，单击确定。

    说明

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

    参数

    说明

    规则名称

    设置样式的名称。命名规范如下：

    • 只能以大小写字母、数字、下划线（_）开头。
    • 只能包含数字、大小写字母、下划线（_）、中划线（-）以及英文句号（.）。
    • 长度限制为 1~256 个字符。

    说明

    • 最多可以创建 100 个样式。
    • 样式名称可以相同，如果您想为同一个样式配置多个规则生效前缀时，您需要创建多个名称相同的样式。

    规则生效前缀

    设置样式生效的对象前缀，若没有填写，则默认对桶内所有对象生效。前缀的填写规范如下：

    • 支持中文、英文、数字及常见字符。
    • 不支持以正斜线（/）或 反斜线（\）开头，不支持使用连续的正斜线（/）。
    • 不支持使用 .. 作为目录名称。

    说明

    同一个样式最多配置 10 个不同的规则生效前缀，且前缀之间不能存在包含关系，例如为同一个样式设置多个规则生效前缀时，前缀 1 设置为 event，则前缀 2 不支持设置为 event/test。您可以创建多个名称相同的样式，然后为其中的每个样式配置不同的规则生效前缀，实现同一个样式处理不同前缀的图片，效果不同。

    格式转换

    设置图片转换的格式，支持原图格式、jpg、jpeg、png、bmp、gif、webp 或 tiff 格式。默认为原图格式。

    渐进显示

    选择是否开启先模糊后清晰的呈现方式，即先显示整个图片的模糊轮廓，然后逐渐加载直至显示完整的图片。默认关闭渐进显示。

    说明

    仅对格式为 JPG 的图片有效。

    自适应方向

    选择是否根据原图中 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. 登录对象存储控制台。

  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。
    目前已支持的图片处理参数，请参见图片处理参数。

后续步骤

图片样式创建成功后，您可以使用图片样式处理图片。具体操作，请参见使用图片样式。

相关操作

  • 导出样式
    在图片处理页面，勾选样式，单击导出样式，即可将样式文件保存至本地。
  • 导入样式
    在图片处理页面，单击导入样式，在本地选择样式文件，单击打开，即可导入样式。

    说明

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