Updated on 2024-03-04 GMT+08:00

Text Watermarks

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.

Table 1 Text watermark parameters

Parameter

Value Description

Code Example

text

Required parameter when adding text watermarks.

NOTICE:

The parameter value must be encoded using URL-safe Base64, for example, encodeText = url_safe_base64_encode(fontText), with a maximum length of 64 characters.

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:

- The parameter value must be encoded using URL-safe Base64, for example, encodeText = url_safe_base64_encode(fontType).

- Line breaks are currently not supported.

color

Optional parameter that represents the font color of watermarks.

The value is a six-digit hexadecimal code, from 000000 to FFFFFF (which represents black and is the default value).

shadow

Optional parameter that represents 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 0 or 1.

  • 0: No effect.
  • 1: Overspread.

rotate

Optional parameter, representing the clockwise angle of text watermarks. The angle is larger than 0 and smaller than 360 degrees.

Table 2 Cross reference for font type encoding

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 Call Examples