Text Watermark Parameters

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:

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 details. 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.

  • 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.

Example

  • The watermark file is: logo.png (logo address: image-demo/logo.png). The watermark locates at the bottom right corner. The transparency value is 90, and both the horizontal and vertical edge spacing are set to 10 by default.

    Parameters are as follows:

    Watermark image: image-demo/logo.png

    Base64 code: aW1hZ2UtZGVtby9sb2dvLnBuZw==

    Watermark at the bottom right: g_br

    Transparency: t_90

    Horizontal spacing and horizontal spacing: x_10,y_10

    The URL request is as follows:

    https://obs.cn-north-1.myhwclouds.com/ya89soshla6s4uma-ims-example-cn-north-1/example.jpg?x-image-process=image/watermark,image_aW1hZ2UtZGVtby9sb2dvLnBuZw==,g_br,t_90,x_10,y_10

  • The watermark image file is: logo.png. Resize the watermark image by setting its width to 50 for pre-processing. Other parameters are set in a way similar to the previous example.

    Parameters are as follows:

    The watermark image: image-demo/logo.png?x-image-process=image/resize,w_50

    URL Base64 code: aW1hZ2UtZGVtby9sb2dvLnBuZz94LWltYWdlLXByb2Nlc3M9aW1hZ2UvcmVzaXplLHdfNTA=

    Watermark at the bottom right: g_br

    Transparency: t_90

    Horizontal spacing and horizontal spacing: x_10,y_10

    The URL request is as follows:

    https://obs.cn-north-1.myhwclouds.com/ya89soshla6s4uma-ims-example-cn-north-1/example.jpg?x-image-process=image/watermark,image_aW1hZ2UtZGVtby9sb2dvLnBuZz94LWltYWdlLXByb2Nlc3M9aW1hZ2UvcmVzaXplLHdfNTA=,g_br,t_90,x_10,y_10

  • Add a text watermark to the original image. The text content is: Hello Image Processing!. The font size is set to 60, the color is set to red, and the font type is set to FZShuSong.

    Parameters are as follows:

    URL Base64 code: SGVsbG8gSW1hZ2UgUHJvY2Vzc2luZyE, namely text_SGVsbG8gSW1hZ2UgUHJvY2Vzc2luZyE

    Font size: size_60

    Font color: color_FF0000

    Font type: type_ZmFuZ3poZW5nc2h1c29uZw==

    The URL request is as follows:

    https://obs.cn-north-1.myhwclouds.com/ya89soshla6s4uma-ims-example-cn-north-1/example.jpg?x-image-process=image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==

  • 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://obs.cn-north-1.myhwclouds.com/ya89soshla6s4uma-ims-example-cn-north-1/example.jpg?x-image-process=image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ,size_60,color_FF0000,type_ZmFuZ3poZW5nc2h1c29uZw==,g_center,rotate_30

  • Watermark mixed by image and text. The text content is: Hello Image Processing!. The text 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.

    https://obs.cn-north-1.myhwclouds.com/ya89soshla6s4uma-ims-example-cn-north-1/example.jpg?x-image-process=image/watermark,image_aW1hZ2UtZGVtby9sb2dvLnBuZw==,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ,size_60,color_FF0000,shadow_50,type_ZmFuZ3poZW5nc2h1c29uZw==,g_br,x_10,y_10,align_2,order_0

Registration