You need to enable JavaScript to run this app.
导航
图片水印
最近更新时间:2024.07.22 16:45:59首次发布时间:2022.11.18 17:58:41

图片水印功能(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

图片水印

图片水印参数可以指定水印图片以及水印图片的预处理参数,具体参数如下所示。

说明

例如使用 watermark.jpg 作为水印图片,经过 url 安全的 base64 编码处理之后,图片水印的最终参数为 image/watermark,image_d2F0ZXJtYXJrLmpwZw

参数

参数说明

取值说明

是否必须

image

水印图片的对象名称,需要进行 url 安全的 base64 编码,且必须与目标图片位于同一个存储桶内。

base64 编码的字符串。

添加水印图片时必须

P

对水印图片进行百分比缩放。

resize 功能特殊参数,只能在水印图片预处理过程中使用。

其他预处理操作

对水印图片进行预处理。

图片缩放、自定义裁剪、索引切割、以及图片旋转操作中的所有功能对水印图片进行预处理。

注意

水印图片预处理参数是 image 的参数值,也需要进行 base64 编码,例如使用 watermark.jpg 作为水印图片,并对其进行 30% 的缩放预处理,原始参数为 image_watermark.jpg?x-tos-process=image/resize,P_30,url 安全的 base64 编码之后为 image_d2F0ZXJtYXJrLmpwZz94LXRvcy1wcm9jZXNzPWltYWdlL3Jlc2l6ZSxQXzMw

文字水印

文字水印参数可以指定文字内容、文字大小、文字类型以及文字颜色等,具体参数如下所示。

说明

使用 "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

示例

说明

图片和文字水印参数均需要进行 base64 编码,您可以使用URL-safe Baes64编码工具,完成图片和文字水印参数的 base64 编码。

文字水印示例

图片水印示例

水印原图:https://tos-tools.tos-cn-beijing.volces.com/misc/watermark1.png
图片

图文混合水印

说明

该处图文混合水印是指在一个 watermark 功能中同时指定文字和图片水印,您可以通过图文混合水印参数调整文字和图片的排布方式。

添加多个图片和文字水印

添加两个图片水印 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
图片