添加水印可以用于品牌推廣和宣傳,還可以幫助保護圖片的版權,防止他人未經授權使用圖片。ESA支持圖片水印和文字水印,可以將水印放在圖片的特定位置,并調整水印的透明度,以便在不干擾圖片內容的情況下顯示水印。
參數說明
操作名稱:watermark
基礎參數(水印位置)
參數 | 說明 | 取值范圍 |
t | 指定水印圖片或水印文字的透明度。 | [0,100] 默認值為100, 表示透明度100%(即不透明)。 |
g | 指定水印在圖片中的位置。 |
詳情請參見上方基準點圖片。 |
x | 指定水印的水平邊距, 即距離圖片邊緣的水平距離。這個參數只有當水印位置是左上、左中、左下、右上、右中、右下才有意義。 | [0,4096] 默認值為10 ,單位:px(像素)。 |
y | 指定水印的垂直邊距,即距離圖片邊緣的垂直距離。 這個參數只有當水印位置是左上、中上、右上、左下、中下、右下才有意義。 | [0,4096] 默認值為10, 單位:px(像素)。 |
水平邊距、垂直邊距、中線垂直偏移不僅可以調節水印在圖片中的位置,當圖片存在多重水印時,還可以調節水印在圖中的布局。
圖片水印參數
參數 | 說明 | 取值范圍 |
image | 指定可以訪問的圖片水印地址,水印地址可以公開訪問,若有鑒權或權限設置,可能導致獲取水印地址失敗。 水印地址需進行Base64編碼。詳細信息,請參見水印編碼。 | Base64編碼后的字符串。 |
文字水印參數
參數 | 說明 | 取值范圍 |
text | 指定文字水印的文字內容,文字內容需進行Base64編碼。詳細信息,請參見水印編碼。 | Base64編碼后的字符串,最大長度不能超過60個字符。 |
type | 指定文字水印的字體,字體名稱需進行Base64編碼。詳細信息,請參見水印編碼。 | 共支持10種文字字體,字體及字體編碼請參見type參數中可選的文字類型及編碼如下表所示。。 說明 如果您使用的是10種文字字體之外的其他字體,系統會識別出您使用的是默認字體alihyaihei。 |
color | 指定文字水印的文字顏色,參數值為RGB顏色值。 | RGB顏色值,例如:000000表示黑色,FFFFFF表示白色。 默認值:000000(黑色)。 |
rotate | 指定文字順時針旋轉角度。 | [0,360] 默認值:0,表示不旋轉。 |
fill | 指定是否將文字水印鋪滿原圖。 | [0,1],默認值為0。
|
size | 指定文字水印的文字大小。 | (0,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 |
水印編碼
添加水印時,文字水印的文字內容、文字字體和圖片水印的水印地址需進行URL安全的Base64編碼。編碼方式如下:
將內容編碼成Base64。
推薦使用URL-safe Baes64編碼工具對文字水印的文字內容、文字字體和圖片水印的水印地址進行編碼。水印編碼后的內容僅適合應用在水印操作的特定參數中,請勿將其用在簽名字符串(Signature)的內容里。
替換編碼結果中的部分編碼。
將結果中的加號(+)替換成短劃線(-)。
將結果中的正斜線(/)替換成下劃線(_)。
將結果中尾部的等號(=)省略。
操作示例
添加Hello World的文字水印:
對文字水印的內容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