文字水印
添加文字水印时使用的参数，包括字体大小、字体类型以及文字颜色等。具体文字水印参数如表1所示。
|
参数 |
取值说明 |
代码样例 |
|---|---|---|
|
text |
添加文字水印时的必选参数。
须知：
必须是URL安全base64编码。encodeText = url_safe_base64_encode(fontText)，最大长度为64个字符（支持最多16个中文字符）。 |
image/watermark,text_SGVsbG8g5Zu- 54mH5pyN5YqhIQ,size_60,color_FF0000,type_ ZmFuZ3poZW5nc2h1c29uZw==,g_center,rotate_30 |
|
size |
可选参数，表示文字水印的文字大小。取值范围为(0，1000]。默认值为40。 |
|
|
type |
可选参数，表示文字水印的文字类型。取值见下方表2所示。默认值为wqy-zenhei（文泉驿正黑，编码后的值：d3F5LXplbmhlaQ）。
须知：
1、必须是URL安全base64编码。encodeText = url_safe_base64_encode(fontType)。 2、当前不支持换行。 |
|
|
color |
可选参数，表示文字水印的文字颜色。 格式为六位十六进制颜色码，取值为000000到FFFFFF，默认值为黑色。 |
|
|
shadow |
可选参数，表示文字水印的阴影透明度。取值范围为(0，100]。 |
|
|
fill |
可选参数，表示水印的铺满效果。取值为0或1。
|
|
|
rotate |
可选参数，表示文字水印的按顺时针旋转的角度。取值范围为(0，360)。 |
|
参数 |
URL安全base64编码后的值 |
取值说明 |
备注 |
|---|---|---|---|
|
droidsansfallback |
ZHJvaWRzYW5zZmFsbGJhY2s= |
DroidSansFallback |
根据RFC，可省略填充符=变为ZHJvaWRzYW5zZmFsbGJhY2s |
|
fangzhengfangsong |
ZmFuZ3poZW5nZmFuZ3Nvbmc= |
方正仿宋 |
根据RFC，可省略填充符=变为ZmFuZ3poZW5nZmFuZ3Nvbmc |
|
fangzhengheiti |
ZmFuZ3poZW5naGVpdGk= |
方正黑体 |
根据RFC，可省略填充符=变为ZmFuZ3poZW5naGVpdGk |
|
fangzhengkaiti |
ZmFuZ3poZW5na2FpdGk= |
方正楷体 |
根据RFC，可省略填充符=变为ZmFuZ3poZW5na2FpdGk |
|
fangzhengshusong |
ZmFuZ3poZW5nc2h1c29uZw== |
方正书宋 |
根据RFC，可省略填充符=变为ZmFuZ3poZW5nc2h1c29uZw |
|
wqy-microhei |
d3F5LW1pY3JvaGVp |
文泉微米黑 |
- |
|
wqy-zenhei |
d3F5LXplbmhlaQ== |
文泉驿正黑 |
根据RFC，可省略填充符=变为d3F5LXplbmhlaQ |
接口调用示例
- 在原图加上文字水印，文字内容为：Hello，文字大小设置为60，颜色设置为红色，字体为方正书宋。
文字内容：对应安全Base64编码：SGVsbG8g5Zu，即text_SGVsbG8g5Zu
文字大小：size_60
文字颜色：color_FF0000
字体：type_ZmFuZ3poZW5nc2h1c29uZw==
URL请求如下：
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==
- 在原图加上文字水印，水印位置居中，文字顺时针旋转30度，其他参数同上。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==,g_center,rotate_30
- 同时实现图文混合水印。文字内容是：Hello，文字大小为60，阴影设置为50，字体颜色为红色，位置在右下角。
图文水印透明为50，排版方式是图片在前，对齐方式是下对齐。
https://obs.region.example.com/image-demo/example.jpg?x-image-process=image/watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5n,text_SGVsbG8g5Zu,size_60,color_FF0000,shadow_50,type_ZmFuZ3poZW5nc2h1c29uZw==,g_br,x_10,y_10,align_2,order_0
- 分开实现图文混合水印。文字内容是：Hello，文字大小为60，字体颜色为红色，位置在右下角。
水印图片是logo.png，水平边距和垂直边距分别是40，10。
图片水印透明为90，先实现图片水印，再实现文字水印。
https://obs.region.example.com/example.jpg?x-image-process=image/watermark,image_ZS1zaGFyZS9pbWFnZS1kZW1vL2xvZ28ucG5n,g_br,t_90,x_45,y_10/watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==,g_br,x_0,y_330
