圖片水印
更新時間 2025-07-22 11:08:37
最近更新時間: 2025-07-22 11:08:37
分享文章
本文幫助您了解圖片水印。
操作場景
ZOS支持圖片水印,您可以增加圖片水印和文字水印,保護圖片的所有權。
約束與限制
- 圖片水印目前僅支持JPG、PNG、WebP、TIFF。
- 原圖大小不能超過20 MB。寬或高不能超過30,000 px,且總像素不能超過2.5億 px。
- 圖片水印預處理中的請求不支持“|”拼接。
- 圖片水印與原圖需要在相同的存儲桶才能使用。
參數說明
操作符:watermark
添加圖片水印和文字水印的參數,需要進行URL的Base64編碼。編碼步驟如下:將內容編碼成Base64,然后將結果中的部分編碼替換。
基礎參數
| 參數名稱 | 參數用途 | 取值 | 是否必須 |
|---|---|---|---|
| t | 圖片水印或文字水印的透明度 | [0, 100] 默認值:100 |
否 |
| x | 水印距離圖片邊界的水平距離 | [0, 4096] 默認值:10 |
否 |
| y | 水印距離圖片邊界的垂直距離 | [0, 4096] 默認值:10 |
否 |
| g | 指定水印在圖片中的位置 | nw:左上(默認) north:中上 ne:右上 west:左中 center:中部 east:右中 sw:左下 south:中下 se:右下 |
否 |
不同區域位置,與區域中的基準點位置,如下圖所示:
圖片水印參數
| 參數名稱 | 參數用途 | 取值 | 是否必須 |
|---|---|---|---|
| image | 指定作為圖片水印對象的名稱 水印圖片需要和原圖存放在相同存儲桶 |
Base64編碼后的字符串 編碼后的字符串應該將’/’替換為’_’ 水印圖片可以直接作為水印附在原圖,也可以進行預處理操作 |
是 |
示例
進行圖片水印處理后,設置通用的透明度t為50。
- 直接處理
假設作為圖片水印的圖片為原圖所在bucket下的shuiyin.png。則需要編碼的內容為shuiyin.png,編碼后的字符串為c2h1aXlpbi5wbmc=。具體請求則是:
image/watermark,image_c2h1aXlpbi5wbmc=,t_50
- 預處理水印
使用shuiyin.png圖片,如果想對水印進行縮放50%加旋轉180度的操作,應對 shuiyin.png?x-zos-process=image/resize,p_50/rotate,180進行base64編碼操作,編碼后結果為:
c2h1aXlpbi5wbmc/eC16b3MtcHJvY2Vzcz1pbWFnZS9yZXNpemUscF81MC9yb3RhdGUsMTgw
將上述結果中的’/’替換為’_’。最終的具體請求是:
image/watermark,image_c2h1aXlpbi5wbmc_eC16b3MtcHJvY2Vzcz1pbWFnZS9yZXNpemUscF81MC9yb3RhdGUsMTgw,t_50
文字水印參數
| 參數名稱 | 參數用途 | 取值 | 是否必須 |
|---|---|---|---|
| text | 指定文字水印內容 | Base64編碼后的字符串,編碼結果字符串中‘/’要替換為‘_’ | 是 |
| color | 指定文字水印的顏色 | RGB顏色值 默認:FFFFFF(白色) |
否 |
| size | 指定文字水印的字體大小 | 默認值:40 | 否 |
| type | 指定文字水印的字體類型 | 支持英文字體,如Airal 支持中文字體包括yahei(微軟雅黑),heiti(黑體),kaishu(楷書),youyuan(幼圓) 默認值:kaishu(楷書) |
否 |
| rotate | 指定文字水印順時針旋轉角度 | [0, 360] 默認值:0 |
否 |
示例
對于圖片添加Chinatelecom文字字符,作為水印,同時指定黑體字體,顏色設置為FF0000紅色。大小設置為40,添加至原圖右下,透明度設置為80。而Chinatelecom編碼后結果為Q2hpbmF0ZWxlY29t。具體請求如下:
image/watermark,text_Q2hpbmF0ZWxlY29t,type_heiti,color_FF0000,size_40,g_se,t_80
常見問題
-
常見顏色對照表?
答:
#FFFFFF---白色
#0000FF---藍色
#FF0000---紅色
#00FF00---綠色
#808080---灰色
#FFFF00---黃色
#000000---黑色
-
添加圖片水印時可以為水印增加背景色么?
答:不可以。
-
如何將本地的圖片作為水印圖片?
答:可以先將本地圖片上傳至待添加水印的原圖的所在桶中。