添加浮水印可以用於品牌推廣和宣傳,還可以協助保護圖片的著作權,防止他人未經授權使用圖片。ESA支援圖片浮水印和文字浮水印,可以將浮水印放在圖片的特定位置,並調整浮水印的透明度,以便在不干擾圖片內容的情況下顯示浮水印。
參數說明
操作名稱:watermark
基礎參數(浮水印位置)

參數
說明
取值範圍
t
指定浮水印圖片或浮水印文字的透明度。
0 ~ 100,預設值為100-完全不透明。g
指定浮水印在圖片中的位置。
nw:左上
north:中上
ne:右上
west:左中
center:中部
east:右中
sw:左下
south:中下
se:右下
x
指定浮水印的水平邊距, 即距離圖片邊緣的水平距離。這個參數只有當浮水印位置是左上、左中、左下、右上、右中、右下才有意義。
0 ~ 4096,預設值為10, 單位:px。y
指定浮水印的垂直邊距,即距離圖片邊緣的垂直距離。 這個參數只有當浮水印位置是左上、中上、右上、左下、中下、右下才有意義。
0 ~ 4096,預設值為10, 單位:px。說明水平邊距、垂直邊距不僅可以調節浮水印在圖片中的位置,當圖片存在多重浮水印時,還可以調節浮水印在圖中的布局。
圖片浮水印參數
參數
說明
取值範圍
image
指定可以訪問的圖片浮水印地址,須確保浮水印地址可以公開訪問,若有鑒權或使用權限設定,可能導致擷取浮水印地址失敗。
浮水印地址需進行Base64編碼。詳細資料,請參見浮水印編碼。
Base64編碼後的字串。
文字浮水印參數
參數
說明
取值範圍
text
指定文字浮水印的文字內容,文字內容需進行Base64編碼。詳細資料,請參見浮水印編碼。
Base64編碼後的字串,最大長度不能超過60個字元。
type
指定文字浮水印的字型,字型名稱需進行Base64編碼。詳細資料,請參見浮水印編碼。
共支援10種字型,字型及字型編碼請參見type參數中可選的文字類型及編碼。
color
指定文字浮水印的文字顏色,參數值為RGB顏色值。
RGB顏色值,預設值:
000000-黑色。rotate
指定文字順時針旋轉角度。
0~360,預設值:0-不旋轉,單位:度。fill
指定是否將文字浮水印鋪滿原圖。
可選值
0或者1,預設值為0。0:不將文字浮水印鋪滿原圖。
1:將文字浮水印鋪滿原圖。
size
指定文字浮水印的文字大小。
1 ~ 1000,預設值:40,單位:px。type參數中可選的文字類型及編碼如下表所示。
文字字型
中文含義
編碼值
alihyaihei
阿里漢儀智能黑體,預設字型
YWxpaHlhaWhlaQ
hysong
漢儀宋體
aHlzb25n
hyhei
漢儀黑體
aHloZWk
hyshuangxian
漢儀雙線體
aHlzaHVhbmd4aWFu
fzltzhk
方正蘭亭中黑
ZnpsdHpoaw
fzshengsks
方正盛世楷書
ZnpzaGVuZ3Nrcw
fzqusongjian
方正趣宋簡體
ZnpxdXNvbmdqaWFu
zzgfxingyan
造字工房星岩
enpnZnhpbmd5YW4
comfortaa
Comfortaa
Y29tZm9ydGFh
notosans
NotoSans
bm90b3NhbnM
說明若您使用的字型未在下表的10種字型中,系統將自動切換為預設字型
alihyaihei。
浮水印編碼
添加浮水印時,文字浮水印的文字內容、文字字型和圖片浮水印的浮水印地址需進行URL安全的Base64編碼。編碼方式如下:
將內容編碼成Base64。
說明推薦使用URL-safe Base64編碼工具對文字浮水印的文字內容、文字字型和圖片浮水印的浮水印地址進行編碼。浮水印編碼後的內容僅適合應用在浮水印操作的特定參數中,請勿將其用在簽名字串(Signature)的內容裡。
替換編碼結果中的部分編碼。
將結果中的加號
+替換成短劃線-。將結果中的正斜線
/替換成底線_。將結果中尾部的等號
=省略。
操作樣本
僅添加文字浮水印:
對文字浮水印的內容
Hello World進行URL安全的Base64位編碼。具體操作,請參見浮水印編碼,編碼結果為SGVsbG8gV29ybGQ;hysong字型的為編碼為aHlzb25n。圖片處理URL為:http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n同時添加文字和圖片浮水印:
文字浮水印內容:
新年快樂,進行URL安全的Base64位編碼結果為:5paw5bm05b-r5LmQ,浮水印位置是右下、水平邊距10、垂直邊距10:g_se,x_10,y_10圖片浮水印地址:
http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png,Base64編碼後為aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n。浮水印圖片位於原圖的左上方、水平邊距10、垂直邊距10:g_nw,x_10,y_10圖片處理URL:
http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10