设置水印-九游平台

公共参数

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

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

添加水印中的文字内容和字体或图片水印路径均需使用用于url传输的base64编码。标准的base64编码并不适合直接放在url里传输。用于url传输的base64编码的编码方式基本过程是：先用标准base64编码将内容编码为字符串，然后检查该字符串，将字符串中的加号（）换成中划线（-），并且将斜杠（/）换成下划线（_）。详细编码规范请参考rfc4648标准中的相关描述。

操作名称：watermark

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

表1 公共参数
参数	取值说明	代码样例
g	可选参数，表示水印处于图片的位置。取值为tl、top、tr、left、center、right、bl、bottom和br，共9个取值。默认值为tl。取值的九宫格如图1所示，每个取值位置均位于每一小格的左上角顶点。	image/watermark,image_aw1hz2utzgvtby 9sb2dvlnbuzw==,g_br,t_90,x_10,y_10
x	可选参数，表示距离图片边缘的水平距离，默认左上角为原点。取值范围为[0，4096]。默认值为10。单位为像素（px）。
y	可选参数，表示距离图片边缘的垂直距离，默认左上角为原点。取值范围为[0，4096]。默认值为10。单位为像素（px）。
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]。

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

图1 水印位置九宫格
点击放大

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

图片水印

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

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

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

表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 z2utzgvtby9sb2dvlnbuzz94lwltywdllxbyb 2nlc3m9aw1hz2uvcmvzaxpllfbfmza=,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

url请求如下：

图2 示例1
水印图片文件是：logo.png（logo图片地址：e-share/image-demo/logo.png），对水印图片按宽度缩略为50进行预处理。其他参数同上一用例。
构造参数如下：

水印图片：e-share/image-demo/logo.png?x-image-process=image/resize,w_50

对应安全base64编码：zs1zagfyzs9pbwfnzs1kzw1vl2xvz28ucg5np3gtaw1hz2utchjvy2vzcz1pbwfnzs9yzxnpemusd181ma

水印图片放右下角：g_br

透明度：t_90

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

url请求如下：

图3 示例2

水印图片文件是：logo.png（logo图片地址：e-share/image-demo/logo.png），对水印图片按原图比例缩小50%进行预处理。其他参数同上一用例。
构造参数如下：

水印图片：e-share/image-demo/logo.png?x-image-process=image/resize,p_50

对应安全base64编码：zs1zagfyzs9pbwfnzs1kzw1vl2xvz28ucg5np3gtaw1hz2utchjvy2vzcz1pbwfnzs9yzxnpemusuf81ma

水印图片放右下角：g_br

透明度：t_90

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

url请求如下：

图4 示例3

图片水印设置界面示例

图片水印可以通过obs控制台新建图片样式设置。水印图片文件是：logo.png（logo图片地址：e-share/image-demo/logo.png），水印图片置于右下角，透明度为90，水平边距和垂直边距默认值都为10。在控制台上的具体操作步骤如下：

在obs管理控制台九游平台首页，单击目标桶名称，在左侧导航栏中选择“数据处理 > 图片处理”。
单击“创建”，进入样式编辑界面。
在编辑页面，输入“样式名称”，“编辑模式”选择“图形界面模式”，并选择“水印设置”。

样式名称只能由大写或小写的英文字母、数字、英文句号（.）、下划线（_）和连字符（-）组成。长度为1~256个字符。例如：rotate_0001。
设置如下水印参数。
- 水印类型：选择“图片水印”
- 水印图路径：输入“e-share/image-demo/logo.png”
- 图片尺寸(%)：根据是否缩小水印图标设置
- 亮度：保持默认值0
- 对比度：保持默认值0
- 透明度：设置为90
- 水印位置：选择右下角的箭头
- 垂直边距：保持默认值10
- 水平边距：保持默认值10
图5 设置图片水印
完成样式的编辑后，单击“确定”保存样式。新建成功的样式将会显示在样式列表中。
后续即可参考步骤四：使用图片样式使用新建的水印样式处理图片。

文字水印

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

表3 文字水印参数
参数	取值说明	代码样例
text	添加文字水印时的必选参数。须知：必须是url安全base64编码。encodetext = url_safe_base64_encode(fonttext)，最大长度为64个字符（支持最多16个中文字符）。	image/watermark,text_sgvsbg8g5zu- 54mh5pyn5yqhiq,size_60,color_ff0000,type_ zmfuz3pozw5nc2h1c29uzw==,g_center,rotate_30
size	可选参数，表示文字水印的文字大小。取值范围为(0，1000]。默认值为40。
type	可选参数，表示文字水印的文字类型。取值见下方表4所示。默认值为wqy-zenhei（文泉驿正黑，编码后的值：d3f5lxplbmhlaq）。须知： 1、必须是url安全base64编码。encodetext = url_safe_base64_encode(fonttype)。 2、当前不支持换行。
color	可选参数，表示文字水印的文字颜色。格式为六位十六进制颜色码，取值为000000到ffffff，默认值为黑色。
shadow	可选参数，表示文字水印的阴影透明度。取值范围为(0，100]。
fill	可选参数，表示水印的铺满效果。取值为0或1。 0：无效果。 1：铺满。
rotate	可选参数，表示文字水印的按顺时针旋转的角度。取值范围为(0，360)。

表4 文字类型编码对照表
参数	url安全base64编码后的值	取值说明	备注
droidsansfallback	zhjvawrzyw5zzmfsbgjhy2s=	droidsansfallback	根据rfc，可省略填充符=变为zhjvawrzyw5zzmfsbgjhy2s
fangzhengfangsong	zmfuz3pozw5nzmfuz3nvbmc=	方正仿宋	根据rfc，可省略填充符=变为zmfuz3pozw5nzmfuz3nvbmc
fangzhengheiti	zmfuz3pozw5nagvpdgk=	方正黑体	根据rfc，可省略填充符=变为zmfuz3pozw5nagvpdgk
fangzhengkaiti	zmfuz3pozw5na2fpdgk=	方正楷体	根据rfc，可省略填充符=变为zmfuz3pozw5na2fpdgk
fangzhengshusong	zmfuz3pozw5nc2h1c29uzw==	方正书宋	根据rfc，可省略填充符=变为zmfuz3pozw5nc2h1c29uzw
wqy-microhei	d3f5lw1py3jvagvp	文泉微米黑	-
wqy-zenhei	d3f5lxplbmhlaq==	文泉驿正黑	根据rfc，可省略填充符=变为d3f5lxplbmhlaq

文字水印接口调用示例

在原图加上文字水印，文字内容为：hello，文字大小设置为60，颜色设置为红色，字体为方正书宋。
构造参数如下：

文字内容：对应安全base64编码：sgvsbg8g5zu，即text_sgvsbg8g5zu

文字大小：size_60

文字颜色：color_ff0000

字体：type_zmfuz3pozw5nc2h1c29uzw==

url请求如下：
在原图加上文字水印，水印位置居中，文字顺时针旋转30度，其他参数同上。
同时实现图文混合水印。文字内容是：hello，文字大小为60，阴影设置为50，字体颜色为红色，位置在右下角。
水印图片是logo.png，水平边距和垂直边距都是10。

图文水印透明为50，排版方式是图片在前，对齐方式是下对齐。
分开实现图文混合水印。文字内容是：hello，文字大小为60，字体颜色为红色，位置在右下角。
水印图片是logo.png，水平边距和垂直边距分别是40，10。

图片水印透明为90，先实现图片水印，再实现文字水印。

案例：创建文字水印并使用（控制台图形界面模式）

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

在管理控制台九游平台首页，选择“服务列表 > 存储 > 对象存储服务”。
在桶列表中单击待操作的桶，进入“对象”页面。
单击“上传对象”，进入“上传对象”页面。
单击图6红框内按钮选择文件。
图6 上传图片
选择待上传的图片，单击“打开”。
单击“上传”，开始上传图片。上传完成后的图片会显示在对象列表。
在左侧导航栏，选择“数据处理 > 图片处理”。
单击“创建”，进入样式编辑界面。具体如图7所示。
图7 创建样式
输入样式名称为“obs-111”。编辑模式选择“图形界面模式”。
单击“水印设置”页签。
1. 在水印类型下拉列表中选择“文字水印”。
2. 在文字内容输入框中输入“hello”。
3. 文字字体选择“方正书宋”。
4. 文字大小输入“600”。
5. 水印透明度保持默认值“100”。
6. 水印位置选择左上。
7. 文字阴影保持不开启。
8. 垂直边距和水平边距保持默认值“10”。
右侧会实时显示设置的样式效果。最终的样式效果如图8所示。

图8 样式obs-111
完成样式的编辑后，单击“确定”保存样式。新建成功的“obs-111”样式就会显示在样式列表中。
选中左侧导航栏中的“对象”。单击对象列表中的“mountain.jpg”，进入文件详情页面。
单击“图片预览”页签，您可以在此页面预览使用该图片样式的图片效果。
图9 图片预览
单击“复制链接”，按钮提示“复制成功”时，即可获取到图片文件的访问地址来使用图片。