URL格式

http://imgx.sinacloud.net/<bucket>/<處理指令>/<文件路徑>?<querystring>

或者

http://<bucket>.imgx.sinacloud.net/<處理指令>/<文件路徑>?<querystring>

• bucket : 您在新浪云存儲(chǔ)(SCS)中創(chuàng)建的bucket名稱；
• 處理指令 : 對(duì)原始圖片的處理指令，下面有詳細(xì)介紹；
• 文件路徑 : 原始圖片文件在SCS中的存儲(chǔ)路徑；
• querystring : 主要是簽名相關(guān)的參數(shù)；

舉例

例如：原始圖片在云存儲(chǔ)中的url為：http://sinacloud.net/yun/demo/1.jpg 可以看出：

• bucket為：yun
• object為：demo/1.jpg

下面我們進(jìn)行下列操作：

• 裁剪人臉區(qū)域, 并將圖片縮略：400x400：c_thumb,g_face,w_400,h_400
• 將圖片變成圓角，半徑為最大(正圓)：r_max
• 將圖片亮度增加8%：e_brightness:8
• 將圖片格式轉(zhuǎn)換為png格式：f_png

處理指令為：c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png 我們可以通過URL直接進(jìn)行訪問：

http://imgx.sinacloud.net/yun/c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png/demo/1.jpg

或者

http://yun.imgx.sinacloud.net/c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png/demo/1.jpg

或者創(chuàng)建一個(gè)json文件(如果您不想將處理指令暴露在URL中)，內(nèi)容為：

[
    {  
        "crop" : "thumb",
        "gravity" : "face",
        "width" : 400,
        "height" : 400,
        "radius" : "max",
        "effect" : "brightness:8",
        "format" : "png"
    }
]

將文件保存到您對(duì)應(yīng)的bucket下的路徑：

imgx/t/my_thumb.json    #其中文件名(my_thumb)是您自定義的“指令集名稱”，類似css中的class

然后就可以通過下面的URL進(jìn)行訪問（也就是說，處理指令也可以不用放在URL中，直接隱藏到您自定義的json文件中）：

http://imgx.sinacloud.net/yun/t_my_thumb/demo/1.jpg

指令格式

• 指令名和指令值之間用”_“連接 c_fit
• 相關(guān)指令使用逗號(hào)隔開“,” c_fit,w_100,h_100,g_face
• 多組指令之間用“--”隔開 c_fit,w_100,h_100,g_face,r_max--l_text:my_font:hello+word,w_100,h_40

簽名 & 認(rèn)證

• 建議您使用URL簽名，目的在于您的圖片處理指令不會(huì)被別人濫用而耗費(fèi)您的流量，并且可以保護(hù)原圖不被盜取。
• 注意：簽名算法兼容SCS《簽名算法》，<處理指令>/<文件路徑>作為object參與簽名
• 如果您不想使用簽名，需要對(duì)您的bucket設(shè)置一條ACL，對(duì)SINA000000000000IMGX開放讀寫權(quán)限，可以通過調(diào)用API設(shè)置，也可以使用控制臺(tái)設(shè)置ACL，如下圖：
• 如果您不想使用簽名，不需要開放匿名權(quán)限的ACL，只需要開放SINA000000000000IMGX的權(quán)限；
• 簽名算法參見：《簽名算法》

緩存 & CDN

• 處理后的圖片生成緩存，下次請(qǐng)求不在重復(fù)生成，默認(rèn)緩存7天
• 處理后的圖片會(huì)自動(dòng)推送到CDN節(jié)點(diǎn)
• 如果您的原圖修改了，可以使用v指令重新生成圖片，后面詳細(xì)介紹

圖片處理指令

水印功能詳細(xì)介紹

1. 水印分為：圖片水印 和 文字水印；
2. 如果您使用了水印 l 指令，則和 l 一組的其他指令將針對(duì) 水印圖片或者文字 進(jìn)行處理（如：w、h、g、x、y、o、bo、e、a、r等），后面舉例介紹。

圖片水印

您需要預(yù)先將水印貼圖保存到對(duì)應(yīng)的bucket下 imgx/l/<filename>.png，圖片必須是png格式，下面兩張圖為例：

下面舉例介紹具體功能

文字水印

您需要預(yù)先將文字水印的字體配置(json格式的文件)保存到對(duì)應(yīng)的bucket下 imgx/l/<file>.json，例如：

{
    "font_family" : "Xingkai SC",
    "font_style" : "bold",
    "font_size" : 30,
    "font_color" : "000000",
    "background" : "ff0000cc",
    "padding" : 10,
    "word_spacing" : 1,
    "kerning" : 1,
    "line_spacing" : 2,
    "pierced" : false,
    "tile" : false,
    "text" : "默認(rèn)值",
}

對(duì)應(yīng)路徑：imgx/l/my_font.json

字體參數(shù)介紹

所有參數(shù)非必填項(xiàng)

示例1：

imgx/l/simple_font.json :

{
    "font_family" : "Microsoft YaHei",
    "font_size" : 40,
    "font_color" : "ffffff"
}

一個(gè)最簡(jiǎn)單的文字水印

指令：

w_800,f_png--l_text:simple_font:Hello+SCS!!,x_20,y_20,a_-25

示例2：

imgx/l/subtitles.json :

{
    "font_size" : 22,
    "font_color" : "ffffff"
}

imgx/l/subtitles_s.json :

{
    "font_size" : 16,
    "font_color" : "ffffff"
}

咱們也搞一個(gè)大片效果, 應(yīng)用到兩張圖上：

指令：

f_png,c_fill,w_800,h_400,e_brightness:-8--c_pad,w_800,h_550,g_center,b_000000ff,e_yellow:30--l_text:subtitles:%E4%B8%BA%E5%BC%80%E5%8F%91%E8%80%85%E6%8F%90%E4%BE%9B%E4%B8%80%E5%A5%97%E4%BA%91%E7%AB%AF%E5%9B%BE%E7%89%87%E5%A4%84%E7%90%86%E6%9C%8D%E5%8A%A1,g_south,y_100--l_text:subtitles_s:SinaImgx%20is%20the%20image%20back-end%20for%20web%20and%20mobile%20developers,g_south,y_80

示例3：

imgx/l/my_font.json :

{
    "font_family" : "Xingkai SC",
    "font_style" : "bold",
    "font_size" : 40,
    "font_color" : "000000",
    "background" : "ff0000cc",
    "padding" : 18
}

過年了，咱們做一個(gè)對(duì)聯(lián)：

指令：

w_800,f_png--l_text:my_font:%E9%A9%AC%E9%A9%B0%E5%A4%A7%E9%81%93%E5%BE%81%E9%80%94%E8%BF%9C,g_south_west,w_40,x_20,y_40--l_text:my_font:%E7%BE%8A%E4%B8%8A%E5%A5%87%E5%B3%B0%E6%99%AF%E8%89%B2%E5%A8%87,g_south_east,w_40,x_20,y_40--l_text:my_font:%E6%96%B0%E6%B5%AA%E4%BA%91%E5%AD%98%E5%82%A8,g_north,y_20

示例4：

imgx/l/font_me.json :

{
    "font_family": "Microsoft YaHei",
    "font_size": 60,
    "font_color": "ffffff",
    "font_style": "bold",
    "background": "0000008f",
    "pierced": true,
    "tile": false,
    "padding": 24,
    "word_spacing": 2.2,
    "line_spacing": 1.2,
    "kerning": 1.5
}

鏤空字效果

指令：

l_text:font_me:%E4%BD%A0%E5%A5%BD%EF%BC%8C%E4%BA%91%E5%AD%98%E5%82%A8,g_west,x_50,y_-200--w_800

示例5：

imgx/l/tile.json :

{
    "font_family" : "Microsoft YaHei",
    "font_style" : "bold",
    "font_size" : 40,
    "font_color" : "000000",
    "background" : "ff000066",
    "padding" : 18,
    "tile": true
}

平鋪效果

指令：

w_800,f_png--l_text:tile:Hello+SCS!!,g_south

示例6：

imgx/l/badge.json :

{
    "font_style" : "bold",
    "font_size" : 30,
    "font_color" : "ffffff",
    "background" : "ff0000cc",
    "padding" : 15
}

增加一個(gè)badge(數(shù)字徽章)

指令：

c_thumb,g_face,w_200,h_200,r_max,bo_6_ffffff80,f_png--l_text:badge:69,r_max,g_south_east,w_34,h_34,x_-1,y_-5

使用“指令集”

如果您不希望把指令暴露在URL中，很簡(jiǎn)單：

下面舉例說明，自動(dòng)識(shí)別照片上的人臉位置并做一張帶有邊框的圓形縮略圖：

• 先創(chuàng)建一個(gè)json文件，保存到對(duì)應(yīng)的bucket中： 路徑： imgx/t/avatar.json ：

[
    {
        "crop" : "thumb",
        "gravity" : "face:center",
        "width" : 200,
        "height" : 200,
        "radius" : "max",
        "border" : "6_ffffff80",
        "format" : "png"
    },
    {
        "overlay" : "icon_v",
        "gravity" : "south_east",
        "width" : 60,
        "x" : -1,
        "y" : -5
    }
]

• 通過下面的方式訪問：

http://imgx.sinacloud.net/yun/t_avatar/demo/1.jpg
http://imgx.sinacloud.net/yun/t_avatar/demo/3.png

• 效果：

字體 (font_family)

• STZhongsong
• Heiti SC
• Yuppy SC
• Hannotate TC
• SimHei
• Lucida Console
• STHupo
• Wawati SC
• Candara
• Meiryo
• STKaiti
• Kaiti TC
• Bookshelf Symbol 7
• MS PGothic
• Candelita
• MS Reference Specialty
• Marlett
• SimSun-ExtB
• Baoli SC
• Adobe Kaiti Std
• Adobe Fangsong Std
• STHeiti
• MS Reference Sans Serif
• Gulim
• Xingkai SC
• STXingkai
• Libian SC
• MJNgai PRC
• STLiti
• Batang
• Franklin Gothic Medium
• Heiti TC
• PMingLiU
• Lantinghei SC
• MS PMincho
• Yuanti SC
• HanziPen TC
• STFangsong
• SimSun
• Lantinghei TC
• MS Gothic
• Weibei SC
• Kaiti SC
• Cambria
• Consolas
• Adobe Heiti Std
• Constantia
• Brush Script MT
• Hannotate SC
• HanziPen SC
• Hiragino Sans GB
• KaiTi
• Perpetua
• MS Mincho
• Lucida Sans Unicode
• Tw Cen MT
• Gill Sans MT
• STXinwei
• Songti SC
• SentyPaperCut
• Villasukat
• Calibri
• Franklin Gothic Book
• FangSong
• Songti TC
• Adobe Song Std
• Microsoft YaHei
• Corbel
• STSong