使用流程_对象存储服务 OBS_特性指南_图片处理_开始图片处理（控制台）_华为云

(1)

对象存储服务

图片处理特性指南

文档版本 13

发布日期 2020-01-16

(2)

非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

商标声明

和其他华为商标均为华为技术有限公司的商标。

本文档提及的其他所有商标或注册商标，由各自的所有人拥有。

注意

您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声明或保证。

由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。

(3)

1 ^简介

1.1 什么是图片处理？

简介

图片处理特性（Image Processing）是对象存储服务（Object Storage Service，

OBS）为用户提供稳定、安全、高效、易用、低成本的图片处理服务，包括：图片瘦身、图片剪切、图片缩放、图片水印、格式转换等。

图片处理特性提供OBS管理控制台和RESTful API接口的使用方法，使用户可以在任何时间和地点对存储在对象存储中的图片进行处理，并且可以快速获取到处理后的图片。

架构

用户通过管理控制台、OBS客户端、RESTful API接口或者第三方客户端的方式将图片上传至OBS中进行存储。用户下载使用图片前，可以创建图片样式模板或传入图片处理参数对图片进行处理，例如剪切、压缩，并且可以获取到使用图片样式或经过参数处理的新图片URL。处理后的图片可以根据用户需求放入内容分发网络（Content Delivery Network，CDN）加速，后续请求可以直接从CDN下载。图片处理特性架构如图1-1所示。

图片处理特性指南 1 简介

(6)

图1-1 图片处理架构

说明

处理后的图片直接返回浏览器展示，不会保存在OBS中，也不会占用存储空间，不会产生存储费用。图片处理只收取处理的费用。

计费标准

请参见图片处理如何收费？

1.2 应用场景

图片处理支持用户在云端对图片进行简单的缩略、剪切、压缩等操作，不需下载占用空间巨大的本地图片处理软件即可直接在线对图片进行处理。

例如，可以随时随地在线对在云相册中的图片进行效果、缩略设置后，即刻在线将图片分享给好友、同事等。

需要频繁访问图片数据的购物网站等，可以使用图片处理对图片在线进行简单操作后，使用CDN加速，后续请求可以直接从CDN下载，提高访问效率。

1.3 约束条件

操作限制

● 所有的图片处理操作均不会修改原图。

● 归档存储不支持图片处理。

● 深度归档存储不支持图片处理。

● 当前只有桶版本号为3.0的桶支持图片处理。桶版本号可以在对象存储服务控制台

(7)

https://bucketname.obs.cn-north-4.myhuaweicloud.com/example.jpg?x-image- process=style/stylename

图片限制

● 支持的原图格式：jpg、jpeg、png、bmp、webp、gif、tiff。

● 支持的格式处理后的目标图格式：jpg、png、bmp、webp。

● 支持处理前的图片最大为25MB，且处理后的图片宽度限制为4096px，高度限制为5000px。

● 大于2M或者超过50帧的gif图片，直接返回原图，不作处理。

● 暂不支持CMYK颜色模式的图片。

命令限制

命令长度不超过512个字符，操作命令总数不超过20个。

区域限制

当前仅部分区域支持图片处理特性，支持的区域详情请在功能总览搜索“图片处理”

查看。

1.4 常用概念

样式

样式是将图片处理对图片设置的参数或界面操作设置保存成的一个集合。在对多张图片进行重复相同设置时，可以先创建一个图片样式，在不同的图片套用图片样式，就不需要进行重复的命令操作。每个桶最多支持创建100个样式。

Exif 信息

Exif（Exchangeable Image File）是“可交换图像文件”的缩写，在一些相机或手机拍摄的图片中会含有Exif信息。Exif信息是嵌在JPEG或TIFF格式的图片内的一组参数，

主要包括图片在拍摄时的参数如相机型号、拍摄时间、拍摄模式等，还有缩略图和其他属性信息。

1.5 访问图片处理的方式

您可以使用两种方式访问图片处理。

● 通过管理控制台查看OBS中图片使用相应图片样式模板的图片预览效果。

用户可以在管理控制台图片处理界面通过按钮或编辑代码操作创建图片样式模板，在图片预览区域预览图片使用相应样式模板的效果，通过复制链接按钮获取使用样式后的图片URL进行使用。

控制台访问方式快速入门请参考开始图片处理（控制台）。

● 通过应用程序调用简单的RESTful API接口来访问图片处理服务。

OBS提供了REST接口。REST从资源的角度来观察整个网络，分布在各处的资源由 URI（Uniform Resource Identifier）确定，而客户端的应用通过URL（Unified Resource Locator）来获取资源。URL的一般格式为：https://Endpoint/uri。用

(8)

户只需在浏览器地址栏中输入符合图片处理命令规则的URL，即可获取到处理后的图片。更多接口访问信息请参见《对象存储服务API参考》。

API接口访问方式快速入门请参考开始图片处理（接口）。

1.6 图片处理功能概述

图片处理为存储在OBS上的图片提供如表1-1所示功能。

表1-1 图片处理功能一览表

功能说明使用方式

获取图片信息获取图片的基本信息，包括：图片格式、大

小、平均色值等。

接口调用

设置图片效果支持对图片进行基础效果的设置，包括设置

图片亮度、对比度，对图片进行整体锐化及模糊等处理。

控制台图形界面控制台代码编辑接口调用图片缩略支持对图片按照指定宽高和比例进行缩放。控制台代码编辑

接口调用

设置图片水印支持在图片指定位置添加文字、图片、图文

混合的水印，并支持设置文字的颜色、字体和大小，对水印图片进行缩略、旋转和剪切等预处理。

控制台图形界面控制台代码编辑接口调用

转换图片格式支持将图片转换为支持的图片格式，并支持

对转换格式后的图片设置渐进显示。

控制台图形界面控制台代码编辑接口调用图片旋转支持将图片按照顺时针方向进行旋转，以及

根据相机或手机的旋转信息进行自动旋转。

控制台代码编辑接口调用图片剪切支持将图片按照指定宽高、内切圆半径、索

引方式和圆角矩形大小进行剪切。控制台代码编辑接口调用图片压缩支持按照相对质量和绝对质量对jpg格式的

图片进行压缩，压缩后的图片画质降低，占用的空间变小，在对图片质量要求不高的场景下可以节省流量、减少加载时间。

控制台代码编辑接口调用

图片瘦身支持在图片画质基本不变的情况下对图片进行瘦身，减小图片占用的空间，此功能可以在不影响图片质量的情况，有助于节省获取图片导致的流量开销，提升终端加载速度。

图片处理持久化支持将处理后的图片异步存储至指定的OBS

桶中，方便下次直接访问处理后的图片，减

(9)

功能说明使用方式按顺序对图片进

行多种处理支持在图片URL后输入多组图片处理命令，

并通过指定的分割符连接，最终按照从左至右的顺序依次对图片进行处理。

自定义图片样式支持通过创建图片样式对图片进行集中处

理。对于需要相同处理操作的多张图片，可以通过创建样式避免重复的设置操作。

控制台图形界面控制台代码编辑

(10)

2 开始图片处理（控制台）

2.1 使用流程

用户可以在OBS管理控制台图片处理界面通过按钮或编辑代码操作创建图片样式，在图片预览区域预览图片使用相应样式模板的效果，通过复制链接按钮获取使用样式后的图片URL进行使用。

本章简要展示使用控制台方式访问和使用图片处理的流程，具体如图2-1所示。

图2-1 控制台场景使用流程

图片处理特性指南 2 开始图片处理（控制台）

(11)

2.2 登录 OBS 控制台

在使用图片处理前，您需要拥有一个云服务帐号并且成功开通OBS。开通OBS服务成功后图片处理也随之成功开通，使用OBS服务之前必须先充值，充值完成后即可进行访问和使用。若您已经开通OBS且完成充值，请跳过此章节。

操作步骤

步骤1 打开华为云网站www.huaweicloud.com。

步骤2 注册帐号。

使用OBS前需注册一个华为云帐号。若您已有帐号，请从步骤3开始。

1. 在顶部导航栏右侧，单击“注册”。

2. 在注册页面，根据提示信息完成注册。

注册成功后，系统会自动跳转至您的个人信息界面。

步骤3 在顶部导航栏右侧，单击“登录”，输帐号名和密码。

步骤4 在顶部导航栏右侧，单击“控制台”，进入华为云控制台。

步骤5 单击“所有服务”，选择“存储 > 对象存储服务”，进入OBS管理控制台。

步骤6 为保证您正常使用OBS服务，建议您先充值购买OBS服务。

----结束

2.3 上传图片

您可以通过OBS管理控制台、OBS客户端、RESTful API方式上传图片。

本章节介绍如何使用OBS管理控制台上传图片。若您的桶中已经存在需要处理的图片，请跳过此章节。

说明

关于上传图片的格式和大小的约束与限制请参见约束条件。

前提条件

至少已创建了一个桶。

操作步骤

步骤1 在管理控制台首页，选择“所有服务 > 存储 > 对象存储服务”。

步骤2 在桶列表中单击待操作的桶，进入“概览”页面。

步骤3 在左侧导航栏，单击“对象”。

步骤4 单击“上传对象”，进入“上传对象”页面。

步骤5 单击图2-2红框内按钮选择文件。

(12)

图2-2 上传图片

步骤6 选择待上传的图片，单击“打开”。

步骤7 单击“上传”。

----结束

2.4 创建图片样式

背景信息

可以通过创建图片样式对图片进行剪切、压缩、添加水印等处理。对于需要相同处理操作的多张图片，可以通过创建样式避免重复的设置操作。创建成功的样式可以被桶中的多张图片使用。

在创建样式过程中，可以在右侧的样例图片中实时看到设置的样式效果。

使用RESTful API接口访问时，可以在URL中直接调用样式名称对图片进行处理，避免输入复杂的处理命令。接口访问的域名规则请参见样式访问方式。

每个桶您最多可以创建100个样式。

您可以新建图片处理样式，也可以从其他桶复制已有图片处理样式。

新建图片处理样式

(13)

图2-3 图片处理

步骤3 单击“创建”，进入样式编辑界面。具体如图2-4所示。

(14)

图2-4 创建样式

步骤4 在编辑页面，可以进行编辑样式名称和基本属性，设置缩略方式、旋转/剪切、图片水印、图片输出等操作。

● 样式名称

输入方便记忆的样式名称，只能由大写或小写的英文字母、数字、英文句号

（.）、下划线（_）和连字符（-）组成。长度为1~256个字符。例如：

rotate_0001。

● 编辑模式

可以选择图形界面模式进行可视化样式编辑，也可以选择代码编辑模式进行样式编辑。

代码编辑样例如下：

image/sharpen,100/blur,r_1,s_1/resize,m_lfit,h_400,w_400,limit_1

● 参数设置

根据需要设置图片效果、缩略、水印和输出的参数值。

说明

水印图片需要和样例图片在同一区域，否则会预览失败。

步骤5 完成样式的编辑后，单击“确定”保存样式。新建成功的样式将会显示在样式列表中。

----结束

复制图片处理样式

(15)

步骤3 单击“复制”。

步骤4 选择复制源，即图片处理样式所在的源桶。

说明

● 从源桶复图片处理样式的操作为增量复制，不会删除当前桶已存在的图片处理样式，与已存在的图片处理样式冲突的规则不会复制。

● 源桶和目标桶的桶版本号都必须是3.0。

● 您可以按需移除不需要复制的图片处理样式。

图2-5 复制图片处理样式

步骤5 单击“确定”，将源桶的图片处理样式复制到当前桶。

----结束

2.5 使用图片样式

当桶中存在已经创建好的图片样式时，您可以通过以下两种方法使用图片样式。

● 复制链接：在OBS控制台上通过图片对象详情页面的图片预览，获取访问链接，

在浏览器中打开即可获取到使用图片样式处理后的图片。其具体操作步骤如复制链接所示。

● 拼写域名：参照以下域名拼写规则，将拼写的域名在浏览器中打开以快速获取使用图片样式处理后的图片。

<图片链接>?x-image-process=style/<样式名称>

图片链接从对象详情页面获取，具体操作步骤请参见拼写域名。

复制链接

步骤2 选中样式所在桶，在左侧导航栏中选择“对象”。

步骤3 单击已存在的图片文件名称或者上传新图片后，进入文件详情页面。

步骤4 单击“图片预览”页签，您可以在此页面预览使用图片样式的图片效果。具体如图2-6 所示。

(16)

图2-6 图片预览

步骤5 单击“复制链接”，按钮提示“复制成功”时，即可获取到使用样式的图片文件访问地址在浏览器中使用。

----结束

拼写域名

步骤1 在OBS对象列表页面，单击待处理图片名称，进入图片详情页面。

步骤2 在“对象ACL > 公共访问权限 > 匿名用户”中，单击“编辑”为匿名用户授予对象读取权限后，单击“保存”，如图2-7所示。

图2-7 授予匿名用户对象读取权限

(17)

示例：

https://bucketname.obs.cn-north-4.myhuaweicloud.com/example.jpg?x-image- process=style/stylename

说明

以上图片链接以及样式名称均为示例，使用过程中请根据实际情况修改。

----结束

(18)

3 开始图片处理（接口）

3.1 使用流程

OBS提供了REST接口。REST从资源的角度来观察整个网络，分布在各处的资源由URI

（Uniform Resource Identifier）确定，而客户端的应用通过URL（Unified Resource Locator）来获取资源。URL的一般格式为：https://Endpoint/uri。用户只需在浏览器地址栏中输入符合图片处理命令规则的URL，即可获取到处理后的图片。

本章简要展示使用RESTful API接口方式访问和使用图片处理的流程，具体如图3-1所示。

图3-1 接口场景使用流程

图片处理特性指南 3 开始图片处理（接口）

(19)

3.2 注册帐号并开通服务

在使用图片处理前，您需要拥有一个云服务帐号并且成功开通OBS。开通OBS服务成功后图片处理也随之成功开通，使用OBS服务之前必须先充值，充值完成后即可进行访问和使用。若您已经开通OBS且完成充值，请跳过此章节。

操作步骤

步骤1 打开华为云网站www.huaweicloud.com。

步骤2 单击“注册”。

步骤3 在注册页面，根据提示信息完成注册。

注册成功后，系统会自动跳转至您的个人信息界面。

步骤4 为保证您正常使用图片处理，建议您先购买OBS服务。

----结束

3.3 上传图片

您可以使用OBS管理控制台、OBS客户端和RESTful API方式上传图片。

使用OBS管理控制台上传图片请参见上传图片。

若您的桶中已经存在需要处理的图片，请跳过此章节。

说明

如果您需要通过自定义域名使用图片处理，需要为待处理的图片配置匿名用户读取权限。配置请参考对匿名用户授予指定对象的公共读权限进行配置。

3.4 处理图片

此章节介绍通过RESTestful API方式进行图片处理操作的URL构成。当已成功开通OBS 后，在浏览器地址中输入符合规则的URL即可通过RESTful API方式使用图片处理。

URL 组成形式

URL由OBS域名、OBS上的桶名、原图片名称、处理命令或样式名组成。

命令访问方式

URL形式为：https://bucketName.endpoint/objectName?x-image-process=image/

commands

● endpoint为桶所在区域对应的终端节点地址，可以在桶的基本信息处获取。有关 OBS区域和终端节点的更多信息，请参考地区和终端节点。

● bucketName为OBS中待处理图片存放的桶名。

● objectName为存储在OBS上bucketName桶下的原图片名称，后缀名必须为图片处理支持的图片格式。

(20)

● commands为处理命令。处理命令之间和命令参数之间会使用三种分隔符，参见分隔符。若不输入处理命令，将返回原图。

例如：https://image-demo.obs.cn-north-1.myhuaweicloud.com/example.jpg?x- image-process=image/crop,x_100,y_50

● 分隔符

分隔符是指URL中用来区分命令访问方式一些关键字段的分隔符号。具体说明如表3-1 所示。

表3-1 分隔符

名称样式顺序说明

参数分隔符 _ 固定顺序命令参数与参数值之间的分

隔符。

命令分隔符 , 无关多项处理命令参数之间的分

隔符。

管道分隔符 / 有关两组处理命令之间分隔符，

参见管道。

● 管道

如果一个图片，需要进行多重处理，如先剪切、后缩略等，则多组操作命令之间，需要以管道分隔符“/”进行连接，执行顺序按管道指定顺序从左至右执行。

例如：https://image-demo.obs.cn-north-1.myhuaweicloud.com/example.jpg?x- image-process=image/resize,w_100,h_100/quality,q_80为两个管道，执行顺序为 从左到右，左侧命令处理结果将会作为右侧命令的输入。

样式访问方式

URL形式为：https://bucketName.endpoint/objectName?x-image-process=style/

stylename

● endpoint为桶所在区域对应的终端节点地址，可以在桶的基本信息处获取。有关 OBS区域和终端节点的更多信息，请参考地区和终端节点。

● bucketName为OBS上的桶名。

● objectName为存储在OBS上bucketName桶下的原图片名称，后缀名必须为图片处理支持的图片格式。

● stylename为在控制台bucketName桶下创建好的样式名称。RESTful API方式现暂不支持其他样式相关等操作，如创建样式、更改样式和删除样式。

样例：https://image-demo.obs.cn-north-4.myhuaweicloud.com/example.jpg?x- image-process=style/stylename

(21)

4 ^典型案例

4.1 控制台图形界面模式

本章节提供控制台图形界面模式创建一个在图片左上角的位置添加方正书宋的文字水印的样式并进行使用的操作案例。

操作步骤

步骤4 单击“上传对象”，进入“上传对象”页面。

图片处理特性指南 4 典型案例

(22)

图4-1 上传图片

步骤7 单击“上传”，开始上传图片。上传完成后的图片会显示在对象列表。

步骤8 在左侧导航栏，选择“图片处理”。

步骤9 单击“创建”，进入样式编辑界面。具体如图4-2所示。

图4-2 创建样式

步骤10 输入样式名称为“obs-111”。在编辑页面，选中“图形界面模式”。

步骤11 单击“水印设置”页签。

(23)

4. 文字大小输入“600”。

5. 水印透明度保持默认值“100”。

6. 水印位置选择左上。 7. 文字阴影保持不开启。

8. 垂直边距和水平边距保持默认值“10”。

右侧会实时显示设置的样式效果。最终的样式效果如图4-3所示。

图4-3 样式 obs-111

步骤12 完成样式的编辑后，单击“确定”保存样式。新建成功的“obs-111”样式就会显示在样式列表中。

步骤13 选中左侧导航栏中的“对象”。单击对象列表中的“mountain.jpg”，进入文件详情页面。

步骤14 单击“图片预览”页签，您可以在此页面预览使用该图片样式的图片效果。具体如图 4-4所示。

(24)

图4-4 图片预览

步骤15 单击“复制链接”，按钮提示“复制成功”时，即可获取到图片文件的访问地址来使用图片。

----结束

4.2 控制台代码编辑模式

本章节提供控制台代码编辑模式创建一个缩略的样式并进行使用的操作案例。

操作步骤

步骤4 单击“上传”，进入“上传对象”页面。

(25)

图4-5 上传图片

步骤7 单击“上传”，开始上传图片。上传完成后的图片会显示在对象列表。

步骤8 单击目标桶名称，选择“图片处理”。

步骤9 单击“创建”，进入样式编辑界面。

步骤10 输入样式名称为“style002”。在编辑页面，选中“代码编辑模式”。

步骤11 在代码输入框中输入如下处理缩略命令和参数。

指定一个w和h为100的矩形，将图片进行等比缩放，取在这个100*100的矩形延伸区域的最小图片。

image/resize,m_mfit,h_100,w_100

右侧会实时显示设置的样式效果。最终的样式效果如图4-6所示。

图4-6 样式 style002

步骤12 完成样式的编辑后，单击“确定”保存样式。新建成功的“style002”样式就会显示在样式列表中。

步骤13 选中左侧导航栏中的“对象”。单击对象列表中的“mountain.jpg”，进入文件详情页面。

步骤14 单击“图片预览”页签，您可以在此页面预览使用该图片样式的图片效果。具体如图 4-7所示。

(26)

图4-7 图片预览

步骤15 单击“复制链接”，按钮提示“复制成功”时，即可获取到图片文件的访问地址来使用图片。

----结束

(27)

5 ^{获取图片信息}

此功能仅支持通过接口调用模式使用。

通过此操作可以获取到图片的基本信息：长、宽、以及文件的大小和格式。如果图片包含Exif信息，将按照json格式返回完整的Exif信息。

操作名称：info

示例

查询example.jpg信息。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/info

{

"format":"JPEG", "height":2000, "size":1046583, "width":2668 }

图片处理特性指南 5 获取图片信息

(28)

6 ^{获取图片平均色值}

此功能仅支持通过接口调用模式使用。

通过此操作可以获取图片的平均色值，平均色值将以json格式返回一个十六进制值。

操作名称：average-hue

示例

获取图片example.jpg的平均色值，可在浏览器直接访问以下地址。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/average-hue

返回如下类似结果，表示成功获取到图片的平均色值。

{"RGB":"#28577D"}

example.jpg原图如下：

图片处理特性指南 6 获取图片平均色值

(29)

获取到的平均色值（#28577D）对应的颜色为：

图片处理特性指南 6 获取图片平均色值

(30)

7 ^{设置图片效果}

7.1 亮度

此功能支持控制台图形界面模式和代码编辑模式使用，也支持通过接口调用模式使用。

具体的参数说明如表7-1所示。

操作名称：bright

表7-1 亮度参数说明

参数取值说明代码样例

value 调整图片亮度，取值范围为 [-100，100]。

原始的亮度值为0。亮度从-100至100递增。

image/bright,50

示例

● 将图片样式的亮度设置为50。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/bright,50

图片处理特性指南 7 设置图片效果

(31)

● 将图片样式的亮度设置为-50。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/bright,-50

(32)

7.2 对比度

操作名称：contrast

表7-2 对比度参数说明

value 调整图片对比度，取值范围为 [-100，100]。

原始的对比值为0。对比度从-100至100递增。

image/contrast,-50

示例

● 将图片样式的对比度设置为-50。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/contrast,-50

(33)

7.3 锐化

操作名称：sharpen

表7-3 锐化参数说明

参数取值范围代码样例

value 调整图片锐化程度，取值范围为[50，399]。

50为最低的锐化效果，推荐最优取值为100。数值越大清晰度越高。但数值过高容易使图片不真实。

image/sharpen,100

示例

● 将图片样式的锐化设置为100。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/sharpen,100

(34)

7.4 模糊

操作名称：blur 表7-4 模糊参数说明

r 模糊的半径，取值范围为

[1，50]。

数值越大模糊的范围越大。

image/blur,r_3,s_2

s 正态分布标准差，取值范围

为[1，50]。

数值越大图片越模糊。

说明

在图形界面模式中，对数值进行加减时两个参数为同增同减。

示例

● 将图片样式的模糊设置r为3，s为2。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/blur,r_3,s_2

(35)

(36)

8 ^设置缩略

此功能支持控制台图形界面模式和代码编辑模式使用，也支持通过接口调用模式使用。通过resize操作能够使图片按照一定规则进行缩放，支持按照指定宽高和比例进行缩放。

说明

● 关于长短边：长边是指原尺寸与目标尺寸的比值大的那条边，短边同理。例如原图为 400px*200px，缩放为100px*100px，由于 400/100=4，200/100=2，4>2，所以在这个缩放中400那条是长边，200那条是短边

● 目标缩略图最长边不能超过4096*4，宽和高乘积不能超过4096*4096。

● 仅指定高或宽进行缩略时，等比缩放模式默认为单边缩放，固定宽高模式默认为宽高相同。

缩略后将按照原图格式返回。

● resize操作默认限制原图的放大。如果请求的目标缩略图比原图大时，需要调用参数limit,0才可以取到放大后的图片，否则将返回原图。调用格式如下：

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_500,limit_0

具体参数说明如表8-1所示。

操作名称：resize

图片处理特性指南 8 设置缩略

(37)

表8-1 缩放设置

m 设置缩略的类型。取值为lfit、

mfit、fill、pad和fixed，默认值为lfit。

● lfit：指定一个w和h的矩形，

将图片进行等比缩放，取在矩形内最大的图片。

● mfit：指定一个w和h的矩形，将图片进行等比缩放，

取在矩形延伸区域的最小图片。

● fill：指定一个w和h的矩形，

将图片进行等比缩放，取在延伸区域的最小图片，并进行居中剪切。即将mfit缩略类型的图片进行居中剪裁。

● pad：指定一个w和h的矩形，将图片进行等比缩放，

取在矩形内最大的图片，并在矩形空白处进行颜色填充。即lfit缩略类型的图片在矩形空白处进行颜色填充。

● fixed：强制按照固定的宽高进行缩略。

image/

resize,m_lfit,h_100,w_1 00

p 等比例缩放的倍数百分比。使用

参数p时，无法使用其它参数。

取值范围为[1，1000]。当取值为：

● ＜100：缩小。

● =100：保持原图大小。

● ＞100：放大。

image/resize,p_50

h 目标缩略图的高度。取值为[1，

4096]。 image/

resize,m_lfit,h_100

w 目标缩略图的宽度。取值为[1，

4096]。 image/

resize,m_fixed,h_100,w _100

l 指定目标缩略图的最长边。取值

为[1, 4096]。

长边为指定的值，短边按照比例缩放。

image/resize,l_100

(38)

s 指定目标缩略图的最短边。取值

为[1, 4096]。

短边为指定的值，长边按照比例缩放。

image/resize,s_100

color 填充的颜色。选择pad（缩略后填充）模式时可以使用。

格式为十六进制颜色码，取值为 000000到FFFFFF，默认值为白色。

image/

resize,m_pad,h_100,w_

100,color_FF0000

limit 是否在目标缩略图比原图大时进行限制放大。取值为0或1，默认值为1。

● 0：不进行限制。

● 1：进行限制。

image/

resize,p_150,limit_0

示例

● 指定高为100，宽度按比例处理（默认为lfit）。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,m_lfit,h_100

● 等比缩放，按短边将图片样式缩略为100*100。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,m_lfit,h_100,w_100

● 指定长边为100，短边按照比例缩放。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,l_100

● 固定宽高，居中自动剪切，将图片样式缩略为100*100。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,m_fill,h_100,w_100

● 强制将缩略图的宽和高固定为100。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image-

(39)

● 固定宽高，按短边将图片样式缩略为100*100，填充白色。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,m_pad,h_100,w_100

● 固定宽高，按短边将图片样式缩略为100*100，填充红色。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,m_pad,h_100,w_100,color_FF0000

● 等比例放大150%，调用参数“limit,0”取到放大图片。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,p_150,limit_0

● 调用p参数将图等比例缩小为30%。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,p_30

(40)

(41)

9 ^旋转图片

9.1 旋转设置

此功能仅支持通过控制台代码编辑模式和接口调用模式使用。

对图片进行旋转设置后，图片将会按顺时针方向进行旋转。具体说明如表9-1所示。

操作名称：rotate

表9-1 图片旋转

value 按照顺时针旋转的角度，

取值范围为[0，360]。

默认值为0，0表示不旋转。数值越大，图片按顺时针方向旋转的角度越大。

image/rotate,90

说明

● 旋转后的图片可能会比原图尺寸大。

示例

将图片宽度设置为100且旋转角度设置为90。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100/rotate,90

将图片宽度设置为100且旋转角度设置为220。

图片处理特性指南 9 旋转图片

(42)

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100/rotate,220

9.2 自适应方向

在一些相机或手机拍摄的图片中会含有Exif信息，其中可能包含例如Orientation的方向参数。图片拍摄时相机或手机的旋转信息会记录在方向参数中，浏览器可以根据这个参数信息将图片自动旋转到正确的方向。

设置自适应方向，带有方向参数的图片会先根据方向参数信息进行自动旋转。具体说明如表9-2所示。

操作名称：auto-orient

表9-2 自适应方向说明

value 取值为0或1。默认值为

1。

0：不设置自适应方向。图片将不会进行自动旋转，

保持默认方向。

1：设置自适应方向。图片会先自动旋转后再进行缩略。

image/resize,w_100/

auto-orient,0

说明

● 图片的高度和宽度须均小于4096才能设置自适应方向。

● 如果图片的Exif信息不含有旋转参数或者不带有Exif信息，则使用auto-orient参数操作无效且对图片无任何影响。

示例

● 将图片宽度设置为100，不设置自适应方向。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100/auto-orient,0

图片处理特性指南 9 旋转图片

(43)

10 ^剪切图片

10.1 普通剪切

可以设置图片上的任意一点为起始点，根据指定宽高进行图片剪切，剪切后的图片为矩形。具体说明如表10-1所示。

操作说明：crop

表10-1 普通剪切

g 表示剪切起始原点位置。取值为

tl、top、tr、left、center、

right、bl、bottom和br，共9个取值。取值的九宫格如图10-1所示，每个取值位置均位于每一小格的左上角顶点。

image/

crop,x_10,y_10,w_200,h_

200,g_br

h 剪切的高度，取值范围为[0，图

片高度]。

w 剪切的宽度，取值范围为[0，图

片宽度]。

x 表示剪切起始点的横坐标，默认

左上角为原点。取值范围为[0，

图片边界]。

y 表示剪切起始点的纵坐标，默认

左上角为原点。取值范围为[0，

图片边界]。

剪切原点位置九宫格如图10-1所示。

图片处理特性指南 10 剪切图片

(44)

图10-1 剪切原点位置九宫格

说明

● 如果从剪切原点开始设置的x和y坐标大于原图，则剪切无法正常执行，将返回错误。

● 如果从剪切原点开始设置的h和w均大于原图，则会直接剪切至图片边界。

示例

● 剪切起点坐标设置为(1000，500)，剪切的宽和高均设置为1000。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/crop,x_1000,y_500,w_1000,h_1000

(45)

● 剪切起点设置在九宫格右下角br区，起点坐标为(10，10)，剪切的宽和高均设置为200。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/crop,x_10,y_10,w_200,h_200,g_br

10.2 内切圆

以图片的中心为圆心，根据指定的半径进行图片剪切，剪切后的图片为圆形。具体说明如表10-2所示。

操作名称：circle

(46)

表10-2 内切圆说明

r 图片剪切的圆形半径，取

值范围为[0，图片最短边的一半]。

image/circle,r_100

说明

● 如果图片的输出格式是jpg，则内切圆以外区域为白色。如果图片的输出格式是png、

webp、bmp等矢量图格式，则内切圆以外区域为透明。建议输出为png格式。

● 如果r取值超过图片最短边的一半，则输出的内切圆仍然是图片的最大内切圆。

示例

设置图片剪切的圆形半径为100，输出格式为jpg，内切圆以外区域为白色。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/circle,r_100

10.3 索引剪切

以图片左上角顶点为起始点，设宽为x轴，高为y轴。根据指定长度进行等长剪切，根据指定索引取出剪切后区域。具体说明如表10-3所示。

操作名称：indexcrop 表10-3 索引剪切说明

x 水平剪切的每块图片长

度。取值范围为[1，图片宽度]。x和y参数只能任选其一。

image/

indexcrop,x_1000,i_0

y 垂直剪切的每块图片长

度。取值范围为[1，图片高度]。

x和y参数只能任选其一。

(47)

i 若剪切后一共有n块，则i

的取值范围为[0，n-1]。0 表示第一块，超过最大的块数则返回原图。

示例

● 按照水平切割，每块图片的长度为1000，选择第一块。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/indexcrop,x_1000,i_0

● 按照水平切割，每块图片的长度为600，选择第一块。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/indexcrop,x_600,i_0

(48)

10.4 圆角剪切

指定圆角大小将图片剪切为圆角矩形。支持通过圆角半径大小和水平垂直大小两种方式设置，具体说明如表10-4所示。

操作名称：rounded-corners 表10-4 圆角剪切参数

r 将图片切出圆角，指定圆角的半径，

水平和垂直的值相同，可以使用像素数（如200）或百分比（如25p）。

像素数取值范围为[1，4096]，当像素数大于原图最小边的一半时，取最小边的二分之一。

百分比取值范围为[1p，50p]。

不能与rx和ry参数同时使用。

image/rounded- corners,r_100

(49)

参数取值说明代码样例 rx 圆角水平大小的参数，可以使用像素

数（如200）或百分比（如25p）。

需要与ry同时使用。

image/rounded- corners,rx_100,ry_200

ry 圆角垂直大小的参数，可以使用像素数（如200）或百分比（如25p）。

需要与rx同时使用。

说明

如果图片的输出格式是jpg，则非圆角区域为白色。如果图片的输出格式是png、webp、bmp等矢量图格式，则非圆角区域为透明。建议在圆角剪切后保存为png格式。

示例

● 将example.jpg图片设置为圆角大小为100、格式为png的圆角图片。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/rounded-corners,r_100/format,png

(50)

● 将example.jpg图片设置为水平圆角大小为100、垂直圆角大小为200的圆角图片。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/rounded-corners,rx_100,ry_200

(51)

11 ^设置水印

11.1 公共参数

此功能在控制台图形界面模式和代码编辑模式使用，也支持通过接口调用模式使用。

可以将文字内容或另一张图片设置为原图的水印。

添加水印中的文字内容和字体或图片水印路径均需使用用于URL传输的Base64编码。

标准的Base64编码并不适合直接放在URL里传输。用于URL传输的Base64编码的编码方式基本过程是：先用标准Base64编码将内容编码为字符串，然后检查该字符串，将字符串中的加号（+）换成中划线（-），并且将斜杠（/）换成下划线（_）。详细编码规范请参考RFC4648标准中的相关描述。

操作名称：watermark

公共参数为设置图片水印和文字水印均可以使用的参数，可以同时添加文字和图片水印。具体基础参数说明如表11-1所示。

表11-1 公共参数

g 可选参数，表示水印处于图片的位置。

取值为tl、top、tr、left、center、

right、bl、bottom和br，共9个取值。

默认值为tl。

取值的九宫格如图11-1所示，每个取值位置均位于每一小格的左上角顶点。

image/

watermark,image_aW1h Z2UtZGVtby

9sb2dvLnBuZw==,g_br,t_

90,x_10,y_10

x 可选参数，表示距离图片边缘的水平距离，默认左上角为原点。取值范围为 [0，4096]。默认值为10。单位为像素

（px）。

y 可选参数，表示距离图片边缘的垂直距离，默认左上角为原点。取值范围为 [0，4096]。默认值为10。单位为像素

（px）。

图片处理特性指南 11 设置水印

(52)

参数取值说明代码样例 voffset 可选参数，表示水印距离图片水平中线

的垂直偏移方向。可以使水印根据中线往上或往下偏移。取值范围为[-1000，

1000]。默认值为0。单位为像素

（px）。

当g取值为left、center、right才有意义，即位置为左中、正中、右中才有意义。

align 可选参数，水印文字和图片的对齐方式。取值为0、1或2。默认值为0。

● 0：表示上对齐。

● 1：表示中对齐。

● 2：表示下对齐。

order 可选参数，水印文字和图片的前后顺序。取值为0或1。默认值为0。

● 0：表示图片在前面。

● 1：表示文字在前面。

t 可选参数，文字或图片水印的透明度。

取值范围为[0，100]。默认值为100，

100%表示不透明。

interval 可选参数，表示文字和图片的间距。取值范围为[0，1000]。

水印位置九宫格如图11-1所示。

图11-1 水印位置九宫格

(53)

说明

如果为原图同时添加文字和图片水印时，水平距离x、垂直距离y和中线垂直偏移voffset可以用于调节水印位于原图中的位置，也可以调节两张水印的布局。

11.2 图片水印

添加图片水印时使用的参数。

可以在添加水印图片进行预处理操作，包括设置缩略、旋转图片和剪切图片，但不支持剪切为内切圆。进行缩略设置预处理时，还支持将水印图片按原图比例进行缩放。

具体图片水印参数说明如表11-2所示。

表11-2 图片水印参数

image 水印图路径，添加图片水印时的必选参数。

图片水印地址为：bucketName/ objectName（必须编码）或

bucketName/objectName?x-image- process=image/command（必须编码）

须知内容必须是URL安全base64编码。

encodedObject =

url_safe_base64_encode(object)。如object 为“panda.png”, 编码过后的内容为

“cGFuZGEucG5n”。

image/resize,w_400/

watermark,image_aW1h Z2UtZGVtby9sb2dvLnBuZz 94LWltYWdlLXByb

2Nlc3M9aW1hZ2UvcmVza XplLFBfMzA=,t_90,

g_br,x_10,y_10

P 水印图片尺寸，大写的P，表示将水印图片按原图（指被添加水印的图片）比例百分比P进行缩放。取值范围为[1，

100]。

须知此处resize操作只支持大写P参数，不支持小写p参数。如需调整水印图片的大小，请参照 resize参数（除小p参数之外）。

image-demo/logo.png?x- image-process=image/

resize,P_50

接口调用示例

● 水印图片文件是：logo.png（logo图片地址：e-share/image-demo/

logo.png），水印图片置于右下角，透明度为90，水平边距和垂直边距默认值都为10。

构造参数如下：

水印图片：e-share/image-demo/logo.png

对应安全Base64编码：ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5n 水印位置右下角：g_br

透明度：t_90

水平距离和垂直距离：x_10,y_10

(54)

URL请求如下：

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/

watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5n,g_br,t_90, x_10,y_10

图11-2

logo.png），对水印图片按宽度缩略为50进行预处理。其他参数同上一用例。

水印图片：e-share/image-demo/logo.png?x-image-process=image/resize,w_50 对应安全Base64编码：

ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5nP3gtaW1hZ2UtcHJvY2Vzcz1pbW FnZS9yZXNpemUsd181MA

水印图片放右下角：g_br 透明度：t_90

水平距离和垂直距离：x_10,y_10 URL请求如下：

watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5nP3gtaW1h Z2UtcHJvY2Vzcz1pbWFnZS9yZXNpemUsd181MA,g_br,t_90,x_10,y_10

(55)

图11-3

logo.png），对水印图片按原图比例缩小50%进行预处理。其他参数同上一用例。

水印图片：e-share/image-demo/logo.png?x-image-process=image/resize,P_50 对应安全Base64编码：

ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5nP3gtaW1hZ2UtcHJvY2Vzcz1pbW FnZS9yZXNpemUsUF81MA

水印图片放右下角：g_br 透明度：t_90

水平距离和垂直距离：x_10,y_10 URL请求如下：

watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5nP3gtaW1h Z2UtcHJvY2Vzcz1pbWFnZS9yZXNpemUsUF81MA,g_br,t_90,x_10,y_10

(56)

图11-4

图形界面示例

图片水印可以通过OBS控制台新建图片样式设置。水印图片文件是：logo.png（logo 图片地址：e-share/image-demo/logo.png），水印图片置于右下角，透明度为90，

水平边距和垂直边距默认值都为10。在控制台上的具体操作步骤如下：

步骤1 在OBS管理控制台首页，单击目标桶名称，在左侧导航栏中选择“图片处理”。

步骤2 单击“新建样式”，进入样式编辑界面。

步骤3 在编辑页面，输入“样式名称”，“编辑模式”选择“图形界面模式”，并选择“水印设置”。

说明

样式名称只能由大写或小写的英文字母、数字、英文句号（.）、下划线（_）和连字符（-）组成。长度为1~256个字符。例如：rotate_0001。

步骤4 设置如下水印参数，如图11-5所示。

● 水印类型：选择“图片水印”

● 水印图路径：输入“e-share/image-demo/logo.png”

● 图片尺寸(%)：根据是否缩小水印图标设置

● 亮度：保持默认值0

(57)

● 水印位置：选择右下角的箭头

● 垂直边距：保持默认值10

● 水平边距：保持默认值10

(58)

图11-5 设置图片水印

步骤5 完成样式的编辑后，单击“确定”保存样式。新建成功的样式将会显示在样式列表中。

(59)

11.3 文字水印

添加文字水印时使用的参数，包括字体大小、字体类型以及文字颜色等。具体文字水印参数如表11-3所示。

表11-3 文字水印参数

text 添加文字水印时的必选参数。

须知必须是URL安全base64编码。encodeText = url_safe_base64_encode(fontText)，最大长度为64个字符（支持最多16个中文字符）。

image/

watermark,text_SGVsbG8 g5Zu-

54mH5pyN5YqhIQ,size_6 0,color_FF0000,type_

ZmFuZ3poZW5nc2h1c29 uZw==,g_center,rotate_3 0

size 可选参数，表示文字水印的文字大小。取值范围为(0，1000]。默认值为40。

type 可选参数，表示文字水印的文字类型。取值见下方表11-4所示。默认值为wqy- zenhei（文泉驿正黑，编码后的值：

d3F5LXplbmhlaQ）。

须知必须是URL安全base64编码。encodeText =

url_safe_base64_encode(fontType)。

color 可选参数，表示文字水印的文字颜色。

格式为六位十六进制颜色码，取值为 000000到FFFFFF，默认值为黑色。

shadow 可选参数，表示文字水印的阴影透明度。

取值范围为(0，100]。

fill 可选参数，表示水印的铺满效果。取值为0 或1。

● 0：无效果。

● 1：铺满。

rotate 可选参数，表示文字水印的按顺时针旋转的角度。取值范围为(0，360)。

表11-4 文字类型编码对照表

参数 URL安全base64编码 后的值

取值说明备注

droidsansfallba

ck ZHJvaWRzYW5zZmF

sbGJhY2s= DroidSansFallb

ack 根据RFC，可省略填充符=变为ZHJvaWRzYW5zZmFsb GJhY2s

(60)

参数 URL安全base64编码 后的值

取值说明备注

fangzhengfang

song ZmFuZ3poZW5nZm

FuZ3Nvbmc= 方正仿宋根据RFC，可省略填充符=变为ZmFuZ3poZW5nZmFu Z3Nvbmc

fangzhengheiti ZmFuZ3poZW5naGV

pdGk= 方正黑体根据RFC，可省略填充符=变为ZmFuZ3poZW5naGVp dGk

fangzhengkaiti ZmFuZ3poZW5na2F

pdGk= 方正楷体根据RFC，可省略填充符=变为ZmFuZ3poZW5na2Fp dGk

fangzhengshus

ong ZmFuZ3poZW5nc2h

1c29uZw== 方正书宋根据RFC，可省略填充符=变为ZmFuZ3poZW5nc2h1c 29uZw

wqy-microhei d3F5LW1pY3JvaGVp 文泉微米黑 -

wqy-zenhei d3F5LXplbmhlaQ== 文泉驿正黑根据RFC，可省略填充符=变为d3F5LXplbmhlaQ

接口调用示例

● 在原图加上文字水印，文字内容为：Hello，文字大小设置为60，颜色设置为红色，字体为方正书宋。

文字内容：对应安全Base64编码：SGVsbG8g5Zu，即text_SGVsbG8g5Zu 文字大小：size_60

文字颜色：color_FF0000

字体：type_ZmFuZ3poZW5nc2h1c29uZw==

URL请求如下：

watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5n c2h1c29uZw==

(61)

● 在原图加上文字水印，水印位置居中，文字顺时针旋转30度，其他参数同上。

watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5n c2h1c29uZw==,g_center,rotate_30

● 图文混合水印。文字内容是：Hello，文字大小为60，阴影设置为50，字体颜色为红色，位置在右下角。

(62)

水印图片是logo.png，水平边距和垂直边距都是10。

图文水印透明为50，排版方式是图片在前，对齐方式是下对齐。

watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5n,text_SGV sbG8g5Zu,size_60,color_FF0000,shadow_50,type_ZmFuZ3poZW5nc2h1c29u Zw==,g_br,x_10,y_10,align_2,order_0

(63)

12 ^转化格式

12.1 格式转换

此功能在控制台图形界面模式和代码编辑模式使用，也支持通过接口调用模式使用。

可以将原图转换为支持的图片格式，具体说明如表12-1所示。

● 支持的原图格式：jpg、jpeg、png、bmp、webp、gif、tiff。

● 支持输出的目标图格式：jpg、png、bmp、webp。

操作名称：format 表12-1 格式转换

jpg 保存为jpg格式。如果原图

是webp、bmp、png等矢量图格式，则原图透明部分会填充为白色。

image/format,jpg

webp 保存为webp格式。 image/format,webp bmp 保存为bmp格式。 image/format,bmp png 保存为png格式。 image/format,png

示例

● 将格式为jpg的图片保存成png的格式。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/format,png

图片处理特性指南 12 转化格式

(64)

12.2 渐进显示

使用格式转换功能时，默认输出的jpg格式是标准型的jpg（Baseline JPEG）。如果需要输出能够渐进显示的jpeg（Progressive JPEG），使用此参数。具体参数说明如表 12-2所示。

● 标准型jpg格式图片的呈现方式：自上而下显示。

● 渐进显示jpeg格式图片的呈现方式：由模糊逐渐清晰。

操作名称：interlace 表12-2 渐进显示

value 取值为0或1。

0：表示输出为自上而下显示的jpg格式图片。

1：表示输出为可以渐进显示的jpeg格式图片。

image/format,jpg/

interlace,1

示例

(65)

● 将图片输出为自上而下显示的jpg格式图片。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/format,jpg/interlace,0

(66)

13 ^压缩图片

此功能支持在控制台代码编辑模式和接口调用模式使用。

可以对输出格式为jpg的图片进行图片压缩，不使用压缩则可能会使图片占用的空间变大。具体参数说明如表13-1所示。

操作名称：quality

表13-1 图片压缩

q 图片的相对质量，即将图片按照原图的 q%进行压缩。取值范围为[1，100]。

压缩公式：目标图质量=原图质量 * q%

例如：如果原图质量为100%，将图片压缩至80%的相对质量，则目标图片的质量为80%。如果原图的质量为80%，

将图片压缩至80%的相对质量，则目标图片的质量为64%。

image/

resize,w_100,h_100/

quality,q_80

Q 图片的绝对质量，即直接将图片压缩为 Q%，与原图不存在相对关系，不依赖于原图。取值范围为[1，100]。

压缩公式：

● 原图质量 > Q%，目标图质量 = Q%

● 原图质量 = Q%，目标图质量 = 原图质量 = Q%

● 原图质量 < Q%，目标图质量 = 原图质量

例如：如果原图质量为100%，将图片压缩至80%的绝对质量，则目标图片的质量为80%。如果原图质量为70%，将图片压缩至80%的绝对质量，则目标图

图片处理特性指南 13 压缩图片

(67)

说明

● q参数仅对输出格式为jpg的图片有效。

● 如果同时使用了q和Q参数，则以Q为输出结果。

● 输出格式为jpg格式以外的图片使用此参数则不会产生效果，也不会产生影响。

示例

● 先将图片缩略为高和宽均为100，输出相对质量80%格式为jpg的目标图。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100,h_100/quality,q_80

● 先将图片缩略为高和宽均为100，输出绝对质量80%格式为jpg的目标图。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100,h_100/quality,Q_80

图片处理特性指南 13 压缩图片

(68)

14 ^{设置图片瘦身}

图片瘦身支持通过OBS控制台代码编辑模式和接口调用模式使用。

图片瘦身是对图片压缩功能的简化，操作原理为输出绝对质量为75%的图片。无需配置参数，通过操作命令即可完成图片瘦身。

操作名称：imageslim 说明

● 仅支持对jpg格式的图片进行瘦身。

● 建议在其他图片处理操作后再进行图片瘦身。

示例

● 先将图片缩略为高和宽均为100，再对缩略后的图片进行瘦身。

https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image- process=image/resize,w_100,h_100/imageslim

图片处理特性指南 14 设置图片瘦身

(69)

15 ^{处理图片持久化}

图片处理持久化支持将处理后的图片异步存储至指定的OBS桶中，方便下次直接访问处理后的图片，减少图片处理花费的时间，提升用户体验。

图片处理持久化目前仅支持通过接口调用模式使用。在图片处理请求接口中，以参数名=参数值的格式，发送图片处理持久化请求，具体参数说明如表15-1所示。

表15-1 图片处理持久化

参数名参数值说明

x-image-

save-object objectName 必填参数。

指定目标对象名称，即处理后的图片存储至桶中的对象名。

对象命名要求如下：

● 不能包含以下特殊字符：\:*?"<>|

● 范围为1到1023位。

x-image-

save-bucket bucketName 选填参数。

指定目标存储桶，处理后的图片将存储至该桶。

如果不指定的话将默认保存至当前桶。

桶名范围为1到64位，且必须是在OBS中已存在的桶。

Java示例代码：

ObsClient obsClient = null;

String endPoint = "obs-endpoint"; // 当前所在region String ak = "your ak"; // 需填写Access Key ID String sk = "your sk"; // 需填写Secret Access Key try {

ObsConfiguration config = new ObsConfiguration();

config.setEndPoint(endPoint);

obsClient = new ObsClient(ak,sk ,config);

TemporarySignatureRequest request = new TemporarySignatureRequest();

request.setObjectKey("test.jpeg"); // 处理前的原对象名 Map<String, Object> queryParams = new HashMap<>();

queryParams.put("x-image-process", "image/resize,w_100");

String objectName = "your saves objectName"; // 处理后的对象名 // 非必选参数

图片处理特性指南 15 处理图片持久化

使用流程_对象存储服务 OBS_特性指南_图片处理_开始图片处理（控制台）_华为云

对象存储服务

图片处理特性指南

目 录

1 简介...1

2 开始图片处理（控制台）...6

3 开始图片处理（接口）... 14

4 典型案例...17

5 获取图片信息...23

6 获取图片平均色值... 24

7 设置图片效果...26

8 设置缩略...32

9 旋转图片...37

10 剪切图片... 39

11 设置水印... 47

12 转化格式... 59

13 压缩图片... 62

14 设置图片瘦身...64

15 处理图片持久化...65

16 常见问题... 67

A 修订记录... 70

1 简介

1.1 什么是图片处理？

简介

架构

计费标准

1.2 应用场景

1.3 约束条件

操作限制

图片限制

命令限制

区域限制

1.4 常用概念

样式

Exif 信息

1.5 访问图片处理的方式

1.6 图片处理功能概述

2 开始图片处理（控制台）

2.1 使用流程

2.2 登录 OBS 控制台

操作步骤

2.3 上传图片

前提条件

操作步骤

2.4 创建图片样式

背景信息

新建图片处理样式

复制图片处理样式

2.5 使用图片样式

复制链接

拼写域名

3 开始图片处理（接口）

3.1 使用流程

3.2 注册帐号并开通服务

操作步骤

3.3 上传图片

3.4 处理图片

URL 组成形式

命令访问方式

样式访问方式

4 典型案例

4.1 控制台图形界面模式

操作步骤

4.2 控制台代码编辑模式

操作步骤

5 获取图片信息

示例

6 获取图片平均色值

示例

7 设置图片效果

7.1 亮度

示例

7.2 对比度

示例

7.3 锐化

示例

7.4 模糊

示例

8 设置缩略

示例

目录

1 ^简介

4 ^典型案例

5 ^{获取图片信息}

6 ^{获取图片平均色值}

7 ^{设置图片效果}

8 ^设置缩略

9 ^旋转图片

10 ^剪切图片

11 ^设置水印

12 ^转化格式

13 ^压缩图片

14 ^{设置图片瘦身}

15 ^{处理图片持久化}