在網站做相關宣傳推廣或版權保護的場景中,通常會在對應圖片上添加水印,以達成相應效果。
開通圖片處理后,客戶可通過URL請求中攜帶的相關參數,在原圖上添加水印,目前同時支持文字水印和圖片水印。
注意圖片處理為付費服務,目前處于公測期間,暫不收取費用,收費時間另行通知。
參數說明及示例
文字水印
參數名稱:textwatermarks。
| 參數 | 說明 | 默認值 |
|---|---|---|
| text | 經url_safe_base64編碼后的水印文字。例如對“天翼云”做base64編碼后為 "5aSp57-85LqR"。 | 無 |
| size | 字號,值類型為int。 | 無 |
| color | 顏色,值為十六進制編碼(hex)形式,范圍為[000000-FFFFFF],例如:"FF0000"代表紅色。 | 默認為白色,即"FFFFFF" |
| angle | 旋轉角度,值范圍為[0,360]。 | 默認為0 |
| t | 水印文字的透明度,值為[0,100] ;數字越小透明度越高,100代表完全不透明。 | 默認為100 |
| g | 由一組g,x,y值唯一指定水印在圖片中的基準點位置,這里的基準點隨g值的不同而不同。 g代表原圖及水印的基準點位置,值為如下: NW:左上 N:上,左右居中 NE:右上 W : 左,上下居中 C :全圖居中 E : 右,上下居中 SW:左下 S : 下,左右居中 SE:右下 |
默認為NW左上 |
| x | 距離原圖基準點g的水平距離,需在圖片寬度范圍內,單位:px(像素),與y成對出現;x軸的方向為從左到右,但g值為NE、E、SE時,向右會超出原圖,故這3個g值對應x軸方向為從右向左。 | 默認為0 |
| y | 距離原圖基準點g的垂直距離,需在圖片高度范圍內,單位:px(像素),與x成對出現;y軸的方向為從上到下,但g值為SW、S、SE時,向下會超出原圖,故這3個g值對應y軸方向為從下到上。 | 默認為0 |
| font | 字體, 支持如下值: SourceHanSans,中文為思源黑體 SourceHanSerif,中文為思源宋體 SourceHanMono,中文為思源等寬 GenShinGothic,中文為思源真黑 GenJyuuGothic,中文為思源柔黑 NotoSans NotoSansMono |
默認為思源黑體 |
相同的x,y值,以及相同水印大小情況下,g代表的基準點(包含原圖及水印)不同時,水印的位置如下圖所示:
藍色圓點:代表基于g值的原圖基準點及水印基準點;
綠色長方形:代表基于g值的原圖基準點及x、y軸距離得出水印基準點后(水印基準點取值與原圖基準點相同),再基于size大小得出的水印位置示意圖。
一組g,x,y值定義的原點及x、y軸方向如下:
N:上部中間位置為坐標原點,x軸方向從左到右,y軸方向從上到下。
NE:右上角位置為坐標原點,x軸方向從右到左,y軸方向從上到下。
W:左邊緣中間位置為坐標原點,x軸方向從左到右,y軸方向從上到下。
C:正中間位置為坐標原點,x軸方向從左到右,y軸方向從上到下。
E:右邊緣的中間位置為坐標原點,x軸方向從右到左,y軸方向從上到下。
SW:左下角為坐標原點,x軸方向從左到右,y軸方向從下到上。
S:下邊緣的中間為坐標原點,x軸方向從左到右,y軸方向從下到上。
SE:右下角坐標原點,x軸方向從右到左,y軸方向從下到上。
訪問示例:
//test.daliqc.cn/a.jpg?action=textwatermarks:text_5aSp57-85LqR,size_50,color_FF0000,x_50,y_50,font_SourceHanSerif,其中5aSp57-85LqR為“天翼云”做base64編碼后的結果。
訪問該URL時,將以原圖的左上角NW向右50像素,向下50像素點作為文字水印左上角的位置,插入字號為50,字體為思源宋體的“天翼云”水印logo。
圖片水印
參數名稱:imagewatermarks。
| 參數 | 說明 | 默認值 |
|---|---|---|
| image | 經url_safe_base64編碼后的水印圖片URL。 注:僅支持可直接響應200的URL,如果對應URL存在鑒權,則可能無法拉取成功。 | 無 |
| w,h | 水印在原圖中的大小,即寬和高。默認為原水印圖片大小,單位:px(像素); w和h成對出現, 且不能超出原圖寬高范圍,最大限制為1000*1000。 | 默認為原始水印圖片大小 |
| angle | 旋轉角度,支持值為0,90,180,270,方向為順時針。 | 默認為0,即不旋轉 |
| t | 水印的透明度,值為[0,100] ;數字越小透明度越高,100代表完全不透明。 | 默認100 |
| g | 由一組g,x,y值唯一指定的水印在圖片中的基準點位置,這里的基準點隨g值的不同而不同。 g代表原圖及水印的基準點位置,值為如下: NW: 左上 N : 上, 左右居中 NE: 右上 W : 左, 上下居中 C : 全圖居中 E : 右, 上下居中 SW: 左下 S : 下, 左右居中 SE: 右下 |
默認為NW左上 |
| x | x,距離原圖基準點g的水平距離,需在原圖寬度范圍內,單位:px(像素),與y成對出現;x軸的方向為從左到右,但g值為NE、E、SE時,向右會超出原圖,故這3個g值對應x軸方向為從右向左。 | 默認為0 |
| y | y,距離原圖基準點g的垂直距離,需在原圖高度范圍內,單位:px(像素),與x成對出現;y軸的方向為從上到下,但g值為SW、S、SE時,向下會超出原圖,故這3個g值對應y軸方向為從下到上。 具體位置和含義與“文字水印”部分相同。 |
默認為0 |
訪問示例:
//test.daliqc.cn/a.jpg?action=imagewatermarks:image_aHR0cDovL3Rlc3QuY29tL2xvZ28ucG5n,angle_90,t_50,其中aHR0cDovL3Rlc3QuY29tL2xvZ28ucG5n為對//test1.daliqc.cn/logo.png做base64編碼后的結果。
訪問上述URL時,CDN將從//test1.daliqc.cn/logo.png地址獲取水印圖片,并按照水印原圖大小,順時針旋轉90度,并作50%透明度處理后,放在原圖a.jpg的左上角位置。