您可以通过图片水印参数，为您存储在OSS中的图片文件增加水印文字或水印图。本文介绍为图片添加水印时所用到的参数及示例。
注意事项
- 图片水印只能使用当前存储空间内的图片，网络或本地图片需上传至当前存储空间内方可使用。
- 图片水印目前仅支持JPG、PNG、BMP、WebP、TIFF格式。
- 单张图片最多支持添加3张不同的图片水印，且各个图片水印的位置不能完全重叠。
- 文字水印暂不支持繁体中文。
参数说明
操作名称：watermark
相关参数如下：
- 基础参数
参数 是否必须 描述 取值范围 t 否 指定图片水印或水印文字的透明度。 [0,100] 默认值：100， 表示透明度100%（不透明）。
g 否 指定水印在图片中的位置。 - nw：左上
- north：中上
- ne：右上
- west：左中
- center：中部
- east：右中
- sw：左下
- south：中下
- se（默认值）：右下
x 否 指定水印的水平边距， 即距离图片边缘的水平距离。这个参数只有当水印位置是左上、左中、左下、右上、右中、右下才有意义。 [0,4096] 默认值：10
单位：像素（px）
y 否 指定水印的垂直边距，即距离图片边缘的垂直距离， 这个参数只有当水印位置是左上、中上、右上、左下、中下、右下才有意义。 [0,4096] 默认值：10
单位：像素（px）
voffset 否 指定水印的中线垂直偏移。当水印位置在左中、中部、右中时，可以指定水印位置根据中线往上或者往下偏移。 [-1000,1000] 默认值：0
单位：像素（px）
fill 否 指定是否将图片水印或文字水印铺满原图。 说明 如果您需要使用图片水印平铺功能，请在配额中心申请。- 1：将图片水印或文字水印铺满原图。
- 0（默认值）：不将图片水印或文字水印铺满全图。
padx 否 水印平铺时单个水印间的水平间隔。仅在水印平铺开启时有效。 [0,4096] 默认值：0
单位：像素（px）
pady 否 水印平铺时单个水印间的垂直间隔。仅在水印平铺开启时有效。 [0,4096] 默认值：0
单位：像素（px）
水平边距、垂直边距、中线垂直偏移不仅可以调节水印在图片中的位置，当图片存在多重水印时，还可以调节水印在图中的布局。
区域数值以及每个区域对应的基准点如下图所示。
- 图片水印参数
参数 是否必须 描述 取值范围 image 是 用于指定作为图片水印Object的完整名称，Object名称需进行Base64编码。详情请参见水印编码。 例如，作为图片水印的Object为Bucket内image目录下的panda.png，则需要编码的内容为image/panda.png，编码后的字符串为
aW1hZ2UvcGFuZGEucG5n。说明 水印图片只能使用当前存储空间内的Object。Base64编码后的字符串。 - 水印图片预处理参数
您可以使用图片缩放、自定义裁剪、索引切割、圆角矩形及图片旋转操作中的所有参数对水印图片进行预处理。此外，水印图片在进行预处理时，还额外支持缩放参数P：
参数 描述 取值范围 P 指定图片水印按照要添加水印的原图的比例进行缩放，取值为缩放的百分比。如设置参数值为10，如果原图为100×100， 则图片水印大小为10×10。当原图变成了200×200，则图片水印大小为20×20。 [1,100] - 文字水印参数
参数 是否必须 描述 取值范围 text 是 指定文字水印的文字内容，文字内容需进行Base64编码。详情请参见水印编码。 Base64编码之前中文字符串的最大字节长度为64个字符。 type 否 指定文字水印的字体，字体名称需进行Base64编码。 支持的字体及字体编码详情请参见文字类型编码对应表。 默认值：wqy-zenhei（ 编码后的值为d3F5LXplbmhlaQ）
color 否 指定文字水印的文字颜色，参数值为RGB颜色值。 RGB颜色值，例如：000000表示黑色，FFFFFF表示白色。 默认值：000000（黑色）
size 否 指定文字水印的文字大小。 (0,1000] 默认值：40
单位：px
shadow 否 指定文字水印的阴影透明度。 [0,100] 默认值：0，表示没有阴影。
rotate 否 指定文字顺时针旋转角度。 [0,360] 默认值：0，表示不旋转。
type参数中可选的文字类型及编码如下表所示。
参数值 中文含义 编码值 wqy-zenhei 文泉驿正黑 d3F5LXplbmhlaQ wqy-microhei 文泉微米黑 d3F5LW1pY3JvaGVp fangzhengshusong 方正书宋 ZmFuZ3poZW5nc2h1c29uZw fangzhengkaiti 方正楷体 ZmFuZ3poZW5na2FpdGk fangzhengheiti 方正黑体 ZmFuZ3poZW5naGVpdGk fangzhengfangsong 方正仿宋 ZmFuZ3poZW5nZmFuZ3Nvbmc droidsansfallback DroidSansFallback ZHJvaWRzYW5zZmFsbGJhY2s - 图文混合水印参数
参数 是否必须 描述 取值范围 order 否 指定文字和图片水印的前后顺序。 0、1 - 0（默认值）：表示图片水印在前。
- 1：表示文字水印在前。
align 否 指定文字水印和图片水印的对齐方式。 0、1、2 - 0：表示文字水印和图片水印上对齐。
- 1：表示文字水印和图片水印中对齐。
- 2（默认值）：表示文字水印和图片水印下对齐。
interval 否 指定文字水印和图片水印间的间距。 [0,1000] 默认值：0
单位：px
水印编码
在添加水印操作中，文字水印的文字内容、文字字体、图片水印的水印图片名称等参数需要进行URL安全的Base64编码。编码步骤如下：
- 将内容编码成Base64。
- 将结果中的部分编码替换。
- 将结果中的加号（+）替换成短划线（-）。
- 将结果中的正斜线（/）替换成下划线（_）。
- 将结果中尾部的所有等号（=）省略。
推荐通过base64url encoder对文字水印的文字内容、文字颜色、文字字体、图片水印的水印图片名称等参数进行编码。
示例一：添加文字水印
您可以通过文件URL、SDK、API方式设置图片处理参数。本文以文件URL为例进行介绍。文件URL仅适用于公共访问的图片。如果是私有访问的图片，请使用SDK、API处理图片。更多信息，请参见图片处理操作方式。
为example.jpg图片添加文字水印示例如下：
- 快速添加Hello World的文字水印对文字水印的内容Hello World进行URL安全的Base64位编码。具体操作，请参见水印编码。编码结果为
SGVsbG8gV29ybGQ，图片处理URL为https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,text_SGVsbG8gV29ybGQ。
- 添加文字水印时配置多个图片处理参数
为example.jpg图片添加Hello World的文字水印的同时，需要对水印文字以及原图做如下相应处理：
- 将example.jpg缩略为宽高300：
resize,w_300,h_300 - 水印文字字体为文泉驿正黑：
type_d3F5LXplbmhlaQ（d3F5LXplbmhlaQ是文泉驿正黑经过Base64编码后的值） - 水印内容为“Hello World”：
text_SGVsbG8gV29ybGQ - 水印文字颜色为白色、字体大小为30：
color_FFFFFF,size_30 - 文字阴影透明度为50%：
shadow_50 - 水印文字位置是右下、水平边距10、中线垂直偏移10：
g_se,x_10,y_10
- 将example.jpg缩略为宽高300：
示例二：添加图片水印
为example.jpg图片添加图片水印示例如下：
- 快速添加名为panda.png的水印图片对水印图片名称panda.png进行URL安全的Base64位编码，编码结果为
cGFuZGEucG5n，图片处理URL为https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,image_cGFuZGEucG5n。
- 添加图片水印时配置多个图片处理参数
为example.jpg图片添加图片水印panda.png的同时，需要对图片水印以及原图做如下相应处理：
- 将example.jpg缩略为宽高300：
resize,w_300,h_300 - 将example.jpg图片质量设为90%：
quality,q_90 - 添加水印图片panda.png：
watermark,image_cGFuZGEucG5n（cGFuZGEucG5n是panda.png进行Base64编码后的值） - 水印图片透明度90%：
t_90 - 水印图片位于原图的右下方、水平边距10、中线垂直偏移10：
g_se,x_10,y_10
- 将example.jpg缩略为宽高300：
- 对图片水印进行预处理后配置多个图片处理参数
为example.jpg图片添加图片水印panda.png的同时，需要对图片水印以及原图做如下相应处理：
- 将example.jpg缩略为宽300：
resize,w_300 - 将水印图片panda.png进行预处理（缩放30%）：
image_cGFuZGEucG5nP3gtb3NzLXByb2Nlc3M9aW1hZ2UvcmVzaXplLFBfMzA（cGFuZGEucG5nP3gtb3NzLXByb2Nlc3M9aW1hZ2UvcmVzaXplLFBfMzA为panda.png?x-oss-process=image/resize,P_30经过Base64编码后的值） - 水印的透明度为90%、位置是右下、水平边距是10、中线垂直偏移是10：
t_90,g_se,x_10,y_10
- 将example.jpg缩略为宽300：
- 添加多个图片水印
为example.jpg图片添加2张图片水印，即panda.png和Tulips.jpg。
- 对水印图片名称panda.png进行URL安全的Base64位编码，编码结果为
cGFuZGEucG5n，图片参数处理结果为watermark,image_cGFuZGEucG5n。 - 对水印图片名称Tulips.jpg进行URL安全的Base64位编码，编码结果为
VHVsaXBzLmpwZw，图片水印位于原图左中部，水平边距10，中线垂直偏移10，图片参数处理结果为watermark,image_VHVsaXBzLmpwZw,g_west,x_10,y_10。
图片处理的URL为：
https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,image_cGFuZGEucG5n/watermark,image_VHVsaXBzLmpwZw,g_west,x_10,y_10
- 对水印图片名称panda.png进行URL安全的Base64位编码，编码结果为
示例三：添加图片和文字混合水印
为example.jpg图片添加图片和文字混合水印的示例如下：
常见问题
如何使用网络图片或本地图片作为水印图片？
通过OSS的图片处理为图片添加图片水印时，仅可以使用相同存储空间内的图片作为水印图片。若您希望使用网络图片或本地图片作为水印图片，需要先将图片上传到原图所在存储空间，之后再使用上传的图片作为水印图片处理原图。
添加文字水印时提示“font content is too large”怎么办？
通过OSS的图片处理为图片添加文字水印时，最长不能超过64个字符（1个汉字计为3个字符）。当提示“font content is too large”时，建议您缩短文字长度，然后为图片添加文字水印。更多信息，请参见示例一：添加文字水印。
私有文件添加图片水印失败怎么办？
私有文件的访问URL带有签名。OSS不支持在带签名的URL后直接添加图片处理参数。如果您想要对私有文件进行图片处理，需要将图片处理参数加入到签名中。更多信息，请参见生成带图片处理参数的文件签名URL。
添加图片水印时可以为水印增加背景色么？
不可以。
如何使用签名URL访问图片？
私有文件的访问URL带有签名。OSS不支持在带签名的URL后直接添加图片处理参数。如果您想要对私有文件进行图片处理，需要将图片处理参数加入到签名中。更多信息，请参见Java图片处理。
添加水印时支持垂直排列么？
如果您希望在添加水印时垂直排列，可以拆分成多个水印操作，通过多个watermark算子实现垂直排列效果。
