可以通過HTTP GET操作,對Object進行圖片處理,并下載處理后的圖片。
說明
下面只給出各個接口的示例,具體使用可以參考示例代碼。
單邊固定縮略
可以對圖片某一邊(寬或高)進行固定到一個長度,另外一邊按照比例進行調整。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| w | 指定目標縮略圖的寬度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| h | 指定目標縮略圖的高度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| l | 目標縮略圖大于原圖是否處理。 | 整數形式,取值:
默認值是0。 |
注意
對縮略后的圖片的大小有限制,目標縮略圖的寬與高的乘積不能超過4096 * 4096,而且單邊的長度不能超過4096 * 4。
示例
將圖縮略成高度為100,寬度按比例處理://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h。
將圖縮略成寬度為100,高度按比例處理://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100w。
將圖縮略成寬度為500,高度按比例處理,如果目標縮略圖大于原圖不處理://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|500w_1l。
指定寬高縮略
可以對圖片指定寬或高,按照長邊短邊進行調整。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| w | 指定目標縮略圖的寬度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| h | 指定目標縮略圖的高度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| e | 縮放優先邊, 由于圖片縮放過程中,原圖尺寸與縮放尺寸不一定是相同比例,需要指定以長邊還是短邊優先進行縮放。 如原圖200 * 400(比例1:2),需要縮放為100 * 100(比例1:1),長邊優先時(e=0),縮放為50*100;短邊優先時(e=1),縮放為100*200,若不特別指定,則代表長邊優先。 | 取值:
默認值是0。 |
| l | 目標縮略圖大于原圖是否處理。 | 取值:
默認值是0。 |
注意
對縮略后的圖片的大小有限制,目標縮略圖的寬與高的乘積不能超過4096 * 4096, 而且單邊的長度不能超過4096 * 4。
示例
將圖縮略成寬度為100,高度為100,按長邊優先://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w_0e。
將圖縮略成寬度為100,高度為100,按短邊優先://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w_1e。
強制寬高縮略
可以強制指定目標縮略圖的高度和寬度,忽略原圖的寬高比。注意這可能會導致圖片變形。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| w | 指定目標縮略圖的寬度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| h | 指定目標縮略圖的高度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| e | 縮放優先邊。如果是強制縮略,值是2。 | 強制縮略,取值為2。 |
| l | 目標縮略圖大于原圖是否處理。 | 整數形式,取值:
默認值是0。 |
注意
如果壓縮后的圖與原圖比例不一致,壓縮后的圖會變形。
示例
將圖強制縮略成寬度為100,高度為100://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w_2e。
自動裁剪
自動裁剪表示圖片先按短邊縮略,然后從縮略的目標圖片裁剪出中間部分得到對應指定高度和寬度的目標縮略圖。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| w | 指定目標縮略圖的寬度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| h | 指定目標縮略圖的高度。 | 整數形式,取值是[1, 4096],單位是像素(px)。 |
| e | 縮放優先邊,這里指定按短邊優化。 | 整數形式,取值是1。 |
| c | 是否對圖形進行自動裁剪。 | 整數形式,取值:
默認值是0。 |
| l | 如果目標縮略圖大于原圖,是否處理。 | 整數形式,取值:
默認值是0。 |
注意
自動裁剪從按短邊優先縮略的圖中間進行裁剪,如果想從裁剪出圖的左邊部分或者右邊部分。即不指定裁剪參數c,然后再利用管道實現。
示例
將圖自動裁剪成寬度為100,高度為100的效果圖://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w_1e_1c。
將圖片按短邊裁剪然后,裁剪出左半部分://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w_1e|0-0-100-100a。
按比例縮放
可以通過指定一個比例百分比參數,讓圖片按照指定的比例進行縮略或者放大。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| p | 倍數百分比。 | 整數形式,取值是[1, 1000]。
|
注意
- 如果參數p跟w、h合用時,p將直接作用于w, h (乘以p%) 得到新的w、h, 如100w_100h_200p 的作用跟200w_200h 的效果是一樣的。
- 如果對圖片進行倍數放大,單邊的最大長度不能超過4096 * 4 。
示例
將圖按比例放大兩倍://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|200p。
將圖按比例縮略到原來的1/2://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|50p。
高級裁剪
可以通過指定起始橫坐標,縱坐標及裁剪的寬度和裁剪的高度對圖進行高級裁剪。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| a | 參數的類型:x-y-width-length 如:100-50-200-150a 一共四個參數,每個參數之間以“-”隔開。
如100-50-200-150a 表示從點(100, 50) 裁剪大小為(200, 150)的圖片。 注意:可以將第三個參數,第四個參數置為0, 表示裁剪到圖片的邊緣。如100-50-0-0a 表示從點(100, 50) 裁剪到圖片的最后。 | width, height的為整數形式,取值是[1, 4096],單位是像素(px)。 |
注意
- 如果指定的起始橫縱坐標大于原圖,則返回錯誤信息,不返回原圖。
- 如果從起點開始指定的寬度和高度超過了原圖,將會直接裁剪到原圖結尾。
示例
裁剪圖從起點(100, 50)到圖的結束://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100-50-0-0a。
裁剪圖從起點(100, 50)到裁剪100x100的大小://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100-50-100-100a。
質量變換
如果圖片保存成jpg, 可以支持質量變換。
參數
| 名稱 | 描述 | 取值 |
|---|---|---|
| q | 決定jpg圖片的quality,對原圖按照q%進行quality壓縮。 | 整數形式,取值是[1, 100],默認值是75。 |
注意
如果不填q 這個參數,這樣有可能會導致圖片占用大小變大。
示例
將原圖縮略成100w_100h,圖片質量80%的jpg圖://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100w_100h_80q。
格式轉換
可以將圖片轉換成對應格式(jpg、 png、webp、bmp)
參數
| 名稱 | 描述 |
|---|---|
| jpg | 將原圖保存成jpg格式,如果原圖是png,webp, bmp存在透明通道,默認會把透明填充成黑色。如果想把透明填充成白色可以指定1wh參數 |
| png | 將原圖保存成png格式 |
| webp | 將原圖保存成webp格式 |
| bmp | 將原圖保存成bmp格式 |
注意
- wh只有當原圖是四通道(即有透明背景)的png, webp, bmp轉換成jpg格式時才有效果。即把原圖當中的透明背景以白色填充,如果不指定wh,那么上述圖轉換成jpg時,透明背景將會變成黑色。
- 保存成jpg格式時,默認保存成標準型的jpg(Baseline JPEG)。
示例
將png保存成jpg格式://oos-cn.ctyunapi.cn/docs/panda.png@oosImage|.jpg。
將png保存成jpg格式,透明的地方填充成白色://oos-cn.ctyunapi.cn/docs/panda.png@oosImage|1wh.jpg。
將jpg保存成高度為100, 寬度為100的png格式://oos-cn.ctyunapi.cn/docs/example.jpg@oosImage|100h_100w.png。
獲取最基本信息和exif信息
可以通過@infoexif來獲取獲取文件的基本信息包括寬度,長度,文件大小,格式。并且如果文件有exif信息,就返回exif信息,如果沒有exif信息,就只返回基本信息。返回結果是json格式。
示例
示例1:沒有exif
{
"FileSize": {"value": "21839"},
"Format": {"value": "jpg"},
"ImageHeight": {"value": "267"},
"ImageWidth": {"value": "400"}
}
? 示例2:有exif
{
"DateTime": {"value": "2015:02:11 15:38:27"},
"FileSize": {"value": "23471"},
"Format": {"value": "jpg"},
"GPSLatitude": {"value": "0deg "},
"GPSLatitudeRef": {"value": "North"},
"GPSLongitude": {"value": "0deg "},
"GPSLongitudeRef": {"value": "East"},
"ImageHeight": {"value": "333"},
"ImageWidth": {"value": "424"},
"Orientation": {"value": "7"}
}