图文水印

您可以通过图文水印配置项，在上传至 veImageX 的图片中添加文字、图片或图文组合水印。本文将为您介绍图文水印类型、注意事项、使用方法和相关案例讲解。

水印类型

• 图片水印：支持上传图片作为水印；
• 文字水印：文字水印支持文字内容、字体、字号、颜色、透明度、对齐方式、行间距等设置，其中输入通过 URL 当做参数输入水印时需要 Base64 URL Safe编码，适用于用文字水印做 UID 等用户信息场景；
• 图文水印：支持水印堆叠、交错、位置、间距等图片和文字综合添加时的设置。

注意事项

• 仅支持处理静图格式的水印添加。
• 支持图片、文字、图文组合三种方式向图片添加水印。
• 不展示水印图大于原图的图片内容。
• 仅支持字体列表内的输入内容转化为水印，对于不支持转化为水印的内容以图形框展示。
• 控制台支持通过 URL 动态输入文本水印。
• 图文水印为 veImageX 的基础图片处理功能，其计费详情请参见后付费-按量计费。

效果图

veImageX 支持图片 + 文字的组合水印配置，下图为您展示了图文水印组合案例中的部分参数介绍。

示例图访问地址如下所示，您可在网站输入该地址并自定义文本水印，查看多种水印图片效果：

http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-watermark-v1:dmVJbWFnZVgg5Zu-54mH5pyN5Yqh.image

使用方法

使用控制台

Step 1：创建模板

您可以通过登录 veImageX 控制台创建图文水印模板，具体操作详情请参考新建模板。

Step 2：获取结果图访问地址

如果您已在控制台创建好模板，则在控制台获取您的水印结果图访问地址的具体操作请参考获取结果图 URL。

使用 OpenAPI

Step 1：创建模板

您可以通过调用 CreateImageTemplate创建您的图文水印模板，veImageX 也支持在该接口与其他功能进行组合配置创建模板。

Step 2：获取结果图访问地址

在创建模板后，您可以通过调用 GetResourceURL获取经模板处理后的结果图访问地址。

案例讲解

在调用 CreateImageTemplate 接口创建模板时，您需要设置Filters组合参数配置您的图片处理功能配置，具体的参数配置请参考图片编辑数据结构。

• Name取值为watermark：即图文水印功能名称；
• Param为具体的操作参数：Key为图文水印各参数名称，Value为相应图文水印参数设置。

上图案例配置的部分关键参数如下所示：

"Filters":[
      {
         "Name":"watermark",
         "Param":{
            "adapt.dx":90,                         //绝对位置下水平边距为90px
            "adapt.dy":90,                         //绝对位置下垂直边距为90px
            "adapt.location":3,                    //图文水印所在指定位置为3，即原图右上角
            "adapt.wratio":0.25,                   //图文水印相对于底图的宽度最小值
            "adapt.wratio_max":0.7,                //图文水印相对于底图的宽度最大值
            "adapt.xm_max":0,                      //图文水印水平边距最大值
            "adapt.xmratio":0,                     //相对位置下图文水印水平边距
            "adapt.xym_same":true,                 //水平和垂直边距保持相同
            "adapt.ym_max":0,                      //图文水印垂直边距最大值
            "adapt.ymratio":0,                     //相对位置下图文水印垂直边距系数
            "pic.opacity":100,                     //水印图片的透明度
            "pic.uri":"tos-cn-i-nn**mq/85**71.png",       //上传的水印图片 URI
            "text.align":0,                        //多行文本对齐方式为左对齐
            "text.color":"#FFFFFF",                //文本颜色为白色
            "text.content":"veImageX 图片服务",     //文本水印内容
            "text.dx":310,                         //文本水印相对于图片水印的水平偏移量为310px
            "text.dy":100,                         //文本水印相对于图片水印的垂直偏移量为100px
            "text.font":"思源黑体",                 //文本水印字体格式
            "text.linespace":0.25,                 //多行文本行间距为0.25px
            "text.location":3,                     //文本水印在图片水印下侧 
            "text.opacity":100,                    //文本水印的透明度为100
            "text.shadow":false,                   //文本水印不带阴影
            "text.size":80,                        //文本的字号为80磅
            "water.angle": 0,                      //水印旋转角度为0
            "water.full":false,                    //不开启水印铺满
            "water.random":false                   //水印位置为指定位置
         }
      }
   ]