图片水印功能（watermark）可以为 TOS 存储桶内的图片添加文字水印、图片水印以及图文水印。本文介绍水印功能相关的参数说明及使用示例。 ## 约束限制 * 文字水印功能暂时不支持繁体中文。 * 用作水印的图片格式仅支持 jpg/jpeg、png、bmp、gif、webp 和 tiff。 ## 基础参数基础参数为文字水印和图片水印均可使用的参数，具体参数如下所示。 |**参数** |**参数说明** |**取值说明** |**是否必须** | |---|---|---|---| |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 | | ## 图片水印图片水印参数可以指定水印图片以及水印图片的预处理参数，具体参数如下所示。 :::tip 例如使用 watermark.jpg 作为水印图片，经过 url 安全的 base64 编码处理之后，图片水印的最终参数为 `image/watermark,image_d2F0ZXJtYXJrLmpwZw`。 ::: |**参数** |**参数说明** |**取值说明** |**是否必须** | |---|---|---|---| |image |水印图片的对象名称，需要进行 url 安全的 base64 编码，且必须与目标图片位于同一个存储桶内。 |base64 编码的字符串。 |添加水印图片时必须 | |P |指定图片水印按照待添加水印的原图的比例进行缩放。|取值为缩放的百分比。|否 |\ | |该参数为 resize 功能特殊参数，只能在水印图片预处理过程中使用。 |例如：参数值为 10，如果原图为 100×100，则图片水印大小为 10×10；当原图变成 200×200，则图片水印大小为 20×20。 | | |其他预处理操作 |对水印图片进行预处理。 |图片缩放、自定义裁剪、索引切割、以及图片旋转操作中的所有功能对水印图片进行预处理。 |否 | :::warning 水印图片预处理参数是 image 的参数值，也需要进行 base64 编码，例如使用 watermark.jpg 作为水印图片，并对其进行 30% 的缩放预处理，原始参数为 `image_watermark.jpg?x-tos-process=image/resize,P_30`，url 安全的 base64 编码之后为 `image_d2F0ZXJtYXJrLmpwZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxQXzMw`。 ::: ## 文字水印文字水印参数可以指定文字内容、文字大小、文字类型以及文字颜色等，具体参数如下所示。 :::tip 使用 "Hello world" 作为水印文字，字体选择方正书宋，顺时针旋转 45 度，原始参数为 `text_Hello world,type_fangzhengshusong,rotate_45`，文字内容以及字体经过 url 安全的 base64 编码之后为参数为`text_SGVsbG8gd29ybGQ,type_ZmFuZ3poZW5nc2h1c29uZw,rotate_45`。 ::: |**参数** |**参数说明** |**取值说明** |**是否必须** | |---|---|---|---| |text |文字水印内容，需要进行 url 安全的 base64 编码。 |编码之前中文字符串的最大字节长度为 64 个字符。 |添加文字水印时必须 | |type |文字水印的字体，需要进行 url 安全的 base64 编码。 |可选字体为文泉驿正黑（默认）、文泉微米黑、方正书宋、方正楷体、方正黑体、方正仿宋、DroidSansFallback，字体的具体编码，请参见下表。 |否 | |color |文字水印的颜色。 |十六进制颜色码，取值为 000000 到 FFFFFF，默认值为000000（黑色）。 |否 | |size |文字水印的文字大小。 |(0,1000]|否 |\ | | |默认值：40| |\ | | |单位：px | | |shadow |文字水印的阴影透明度。 |[0,100]|否 |\ | | |默认值：0，表示没有阴影。 | | |rotate |文字水印按顺时针方向旋转的角度。 |[0,360]|否 |\ | | |默认值：0，表示不旋转。 | | |fill |是否将水印文字平铺满原图。 |* 1：表示将文字水印铺满原图。|否 |\ | | |* 0（默认值）：表示不将文字水印铺满全图。 | | **type** 参数中可选的文字类型及编码如下表所示。 |**原始参数** |**url** **安全的 base64 编码** |**字体名称** |**备注** | |---|---|---|---| |wqy\-zenhei |d3F5LXplbmhlaQ |文泉驿正黑 |已省略填充符= | |wqy\-microhei |d3F5LW1pY3JvaGVp |文泉微米黑 |无 | |fangzhengshusong |ZmFuZ3poZW5nc2h1c29uZw |方正书宋 |可省略填充符= | |fangzhengkaiti |ZmFuZ3poZW5na2FpdGk |方正楷体 |可省略填充符= | |fangzhengheiti |ZmFuZ3poZW5naGVpdGk |方正黑体 |可省略填充符= | |fangzhengfangsong |ZmFuZ3poZW5nZmFuZ3Nvbmc |方正仿宋 |可省略填充符= | |droidsansfallback |ZHJvaWRzYW5zZmFsbGJhY2s |DroidSansFallback |可省略填充符= | ## 图文混合水印在一个水印功能中同时指定图片和文字水印，通过图文混合水印参数可以调整图片和文字的排列关系，具体参数如下所示。 |**参数** |**参数说明** |**取值说明** |**是否必须** | |---|---|---|---| |order |文字水印和图片水印的前后顺序。 |* 0（默认值）：表示图片水印在前。|否 |\ | | |* 1：表示文字水印在前。 | | |align |文字水印和图片水印的对齐方式。 |* 0：表示文字水印和图片水印上对齐。|否 |\ | | |* 1：表示文字水印和图片水印中对齐。| |\ | | |* 2（默认值）：表示文字水印和图片水印下对齐。 | | |interval |文字水印和图片水印间的间距。 |* 取值范围：[0,1000]|否 |\ | | |* 默认值：0| |\ | | |* 单位：px | | ## 示例 :::tip 图片和文字水印参数均需要进行 base64 编码，您可以使用[URL-safe Baes64编码工具](https://simplycalc.com/base64url-encode.php?spm=a2c4g.11186623.0.0.59c724cbw8IPL4)，完成图片和文字水印参数的 base64 编码。 ::: ### **文字水印示例** * 添加文字水印，文字内容为 Hello，文字大小设置为 72，颜色设置为红色，字体设置为方正书宋。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a75b56571afc3584cb55049a5a4a13dc.png =1023x) * 添加文字水印，水印位置居中，文字顺时针旋转 45 度，其他参数同上。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3b818a875660c1cf95bdbe4d896bfad0.png =1023x) * 添加文字水印，平铺原图，其他参数同上。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45,fill_1](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/watermark,text_SGVsbG8,size_72,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw,g_center,rotate_45,fill_1) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bfcb67960a8033a57da90a809ffdac99.png =1023x) ### **图片水印示例** 水印原图：[https://tos-tools.tos-cn-beijing.volces.com/misc/watermark1.png](https://tos-tools.tos-cn-beijing.volces.com/misc/watermark1.png) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b4f56f2b7034cf2ad876bec5f03b9beb.png =3955x) * 原图等比缩放 60%，直接添加图片水印，水印等比缩放10%，`misc/watermark1.png?x-tos-process=image/resize,p_10` 编码为 `bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw`。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cfda5f59c022df9094e4992bb263597e.png =613x) * 添加图片水印，水印位置居中，顺时针旋转 45 度，其他参数同上。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,g_center,rotate_45](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,g_center,rotate_45) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f046889977d1c26414122a1594b1d79d.png =613x) ### **图文混合水印** :::tip 该处图文混合水印是指在一个 watermark 功能中同时指定文字和图片水印，您可以通过图文混合水印参数调整文字和图片的排布方式。 ::: * 图文混合水印，默认参数。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_94f9f9e48d53806ab6e564fdbf90ab0b.png =613x) * 图文混合水印，文字在左，图片在右，中线对齐，文字、图片间隔 100。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8,align_1,order_1,interval_100](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzEw,text_SGVsbG8,align_1,order_1,interval_100) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_56c2ba17fdc5a1add108a17f70230722.png =612x) ### **添加多个图片和文字水印** 添加两个图片水印 watermark1.png 和 watermark2.png，以及两个文字水印“Hello World”和“你好”，水印说明如下： * 原图等比缩放 60%。 * “Hello World”文字大小 60，字体为方正书宋，位置右上角，颜色黑色 000000。 * “你好”文字大小 50，字体为方正楷体，位置居中，颜色红色 FF0000。 * watermark1.png，等比缩放 5%，位置左下角，透明度 60，`misc/watermark1.png?x-tos-process=image/resize,p_5` 编码为 `bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=`。 * watermark2.png 图片，等比缩放 5%，位置位于右下角，`misc/watermark2.png?x-tos-process=image/resize,p_5` 编码为 `bWlzYy93YXRlcm1hcmsyLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=`。 [https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_sw/watermark,image_bWlzYy93YXRlcm1hcmsyLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_se/watermark,text_SGVsbG8gV29ybGQ,g_ne,size_60,type_ZmFuZ3poZW5nc2h1c29uZw/watermark,text_5L2g5aW9,g_center,size_50,type_ZmFuZ3poZW5na2FpdGk,color_FF0000](https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,p_60/watermark,image_bWlzYy93YXRlcm1hcmsxLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_sw/watermark,image_bWlzYy93YXRlcm1hcmsyLnBuZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxwXzU=,g_se/watermark,text_SGVsbG8gV29ybGQ,g_ne,size_60,type_ZmFuZ3poZW5nc2h1c29uZw/watermark,text_5L2g5aW9,g_center,size_50,type_ZmFuZ3poZW5na2FpdGk,color_FF0000) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b08e192ecc527c91d798806eba4eb95c.png =609x)

对象存储