文档

图片水印

更新时间:

为保护OSS存储的图片或文件的所有权,防止资源未经授权被复制或使用,您可以为存储的资源增加水印。

使用场景

  • 版权保护:为保护自己的作品不被未授权使用或复制,需要在图片上加上水印来标识版权。

  • 品牌推广:企业或个人为了宣传自己的品牌或标识,会在图片、视频或文档上加上带有品牌标志或名称的水印。

  • 防止篡改:在某些官方文件、证书或报告上添加水印,可以增加篡改的难度,减少文件被伪造的风险。

  • 抵制盗图:在网络环境中,图片很容易被他人下载和再次发布。加水印可以作为一种警示,减少他人直接盗用图片的情况。

  • 法律要求:某些情况下,法律或合同条款可能要求在特定内容发布时必须加上水印,以符合规定。

注意事项

  • 您可以通过文件URL、SDK、API方式设置图片处理参数。本文以文件URL为例进行介绍。文件URL仅适用于公共访问的图片。如果是私有访问的图片,请使用SDK、API处理图片。更多信息,请参见图片处理操作方式

  • 图片水印只能使用当前存储空间内的图片,网络或本地图片需上传至当前存储空间内方可使用。

  • 图片水印目前仅支持JPG、PNG、BMP、WebP、TIFF格式。

  • 单张图片最多支持添加6张不同的图片水印,且各个图片水印的位置不能完全重叠。

  • 文字水印暂不支持繁体中文。

参数说明

操作名称: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)

    水平边距、垂直边距、中线垂直偏移不仅可以调节水印在图片中的位置,当图片存在多重水印时,还可以调节水印在图中的布局。

    区域数值以及每个区域对应的基准点如下图所示。origin

  • 图片水印参数

    参数

    是否必须

    描述

    取值范围

    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编码。编码步骤如下:

  1. 将内容编码成Base64。

  2. 将结果中的部分编码替换。

    • 将结果中的加号(+)替换成短划线(-)。

    • 将结果中的正斜线(/)替换成下划线(_)。

    • 将结果中尾部的所有等号(=)省略。

推荐通过base64url encoder对文字水印的文字内容、文字颜色、文字字体、图片水印的水印图片名称等参数进行编码。

重要

水印编码后的内容仅应用在水印操作的特定参数中,请勿将其用在签名字符串(Signature)中。

示例一:添加文字水印

以杭州地域名为oss-console-img-demo-cn-hangzhou-3az的Bucket中的图片example.jpg为例,图片访问URL为https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg原图

为example.jpg图片添加文字水印示例如下:

示例二:添加图片水印

为example.jpg图片添加图片水印示例如下:

示例三:添加图片和文字混合水印

为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后直接添加图片处理参数。如果您想要对私有文件进行图片处理,需要将图片处理参数加入到签名中。更多信息,请参见图片处理

添加水印时支持垂直排列么?

如果您希望在添加水印时垂直排列,可以拆分成多个水印操作,通过多个watermark算子实现垂直排列效果。

例如:https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/watermark,text_SGVsbG8gV29ybGQ/watermark,text_SGVsbG8gV29ybGQy,y_60

垂直水印

  • 本页导读 (1)
文档反馈