Text watermark
Text watermark parameters are the parameters used when adding text watermarks. These parameters include the font size, type, and color of texts. Table 1 lists the descriptions for text watermark parameters in detail.
|
Parameter |
Value Description |
Code Example |
|---|---|---|
|
text |
Required parameter when adding text watermarks.
NOTICE:
It must be the URL Base64 code. encodeText = url_safe_base64_encode(fontText), with the maximum length of 64 characters (roughly 20 Chinese characters at most). |
image/watermark,text_SGVsbG8g5Zu- 54mH5pyN5YqhIQ,size_60,color_FF0000,type_ ZmFuZ3poZW5nc2h1c29uZw==,g_center,rotate_30 |
|
size |
Optional parameter that represents the font size of watermarks. It ranges from 0 to 1000, and it is set to 40 by default. |
|
|
type |
Optional parameter that represents the font type of watermarks. Table 2 shows the values in detail. The default value is wqy-zenhei (The value after encoding is d3F5LXplbmhlaQ).
NOTICE:
It must be the URL Base64 code. encodeText = url_safe_base64_encode(fontType). |
|
|
color |
Optional parameter that represents the font color of watermarks. The color is set by a six-digit hexadecimal code, from 000000 to FFFFFF. The default color is black. |
|
|
shadow |
Optional parameter, representing the extent of transparency of text watermarks. It ranges from 0 to 100. |
|
|
fill |
Optional parameter, representing the overspread effect of watermarks. The value can be set to 0 or 1.
|
|
|
rotate |
Optional parameter, representing the clockwise angle of text watermarks. The angle is larger than 0 and smaller than 360 degrees. |
|
Parameter |
Value After URL base64 Encoding |
Value Description |
Remarks |
|---|---|---|---|
|
droidsansfallback |
ZHJvaWRzYW5zZmFsbGJhY2s= |
DroidSansFallback |
According to Request For Comments (RFC), the fuller "=" can be omitted, and the value becomes ZHJvaWRzYW5zZmFsbGJhY2s. |
|
fangzhengfangsong |
ZmFuZ3poZW5nZmFuZ3Nvbmc= |
FZFongSong |
According to RFC, the fuller "=" can be omitted, and the value becomes ZmFuZ3poZW5nZmFuZ3Nvbmc. |
|
fangzhengheiti |
ZmFuZ3poZW5naGVpdGk= |
FZSimHei |
According to RFC, the fuller "=" can be omitted, and the value becomes ZmFuZ3poZW5naGVpdGk. |
|
fangzhengkaiti |
ZmFuZ3poZW5na2FpdGk= |
FZKaiTi |
According to RFC, the fuller "=" can be omitted, and the value becomes ZmFuZ3poZW5na2FpdGk. |
|
fangzhengshusong |
ZmFuZ3poZW5nc2h1c29uZw== |
FZShuSong |
According to RFC, the fuller "=" can be omitted, and the value becomes ZmFuZ3poZW5nc2h1c29uZw. |
|
wqy-microhei |
d3F5LW1pY3JvaGVp |
WenQuanYi Micro Hei |
- |
|
wqy-zenhei |
d3F5LXplbmhlaQ== |
WenQuanYi Zen Hei |
According to RFC, the fuller "=" can be omitted, and the value becomes d3F5LXplbmhlaQ. |
API calling example:
- Add a text watermark Hello to the original image. Set text size to 60, color to red, and font to FZShuSong.
Parameters are as follows:
URL Base64 code: SGVsbG8g5Zu, namely text_SGVsbG8g5Zu
Font size: size_60
Font color: color_FF0000
Font type: type_ZmFuZ3poZW5nc2h1c29uZw==
The URL request is as follows:

- Add the text watermark to the original image and center the watermark. Rotate the text 30 degrees clockwise. Other parameters are set in a way similar to the previous example.
https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image-process=image/watermark,text_SGVsbG8g5Zu,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==,g_center,rotate_30

- Watermark mixed by image and text. The text watermark Hello is at the bottom right, with font size set to 60, shadow to 50, and color to red.
The watermark is logo.png, with both horizontal and vertical spacing set to 10.
In this mixed watermark, the transparency is set to 50. The image is in front, while the text is behind. The align mode is Align Bottom.

Last Article: Image watermark
Next Article: Converting Formats
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.