自定義裁剪
更新時間 2025-10-21 10:45:54
最近更新時間: 2025-10-21 10:45:54
分享文章
本文介紹自定義裁剪圖片時所用到的參數及示例。
功能說明
您可以通過自定義裁剪參數,在媒體存儲存儲的原圖上裁剪指定大小的矩形圖片。
參數說明
操作名稱:crop
參數說明如下:
| 參數 | 描述 | 取值范圍 |
|---|---|---|
| w | 指定裁剪寬度。 | [0,圖片寬度] 默認為最大值。 |
| h | 指定裁剪高度。 | [0,圖片高度] 默認為最大值。 |
| x | 指定裁剪起點橫坐標(默認左上角為原點)。 | [0,圖片邊界] |
| y | 指定裁剪起點縱坐標(默認左上角為原點)。 | [0,圖片邊界] |
| g | 設置裁剪的原點位置。原點按照九宮格的形式分布,一共有九個位置可以設置,為每個九宮格的左上角頂點。 | nw:左上 north:中上 ne:右上 west:左中 center:中部 east:右中 sw:左下 south:中下 se:右下 默認值:nw 詳情請參見下方裁剪原點位置參數示意圖。 |
裁剪原點位置參數示意圖如下。
注意事項
在使用自定義裁剪功能時,請注意以下事項:
- 如果指定起點的橫縱坐標大于原圖,將會返回
BadRequest錯誤,錯誤信息為:Advance cut’s position is out of image。 - 如果從起點開始指定的寬度和高度超過了原圖,將會直接裁剪到原圖邊界為止。
示例
從(100,50)開始,裁減至圖片邊界,裁剪起點為(100,50):crop,x_100,y_50,裁減至圖片邊界:裁剪時默認使用w和h的最大值,所以可省略w和h參數。具體圖片處理參數為:
?x-amz-process=image/crop,x_100,y_50
從(100,50)開始,裁剪100 px100 px大小的圖片,裁剪起點為(100,50):crop,x_100,y_50,裁減范圍100 px100 px:w_100,h_100。具體圖片處理參數為:
?x-amz-process=image/crop,x_100,y_50,w_100,h_100
裁剪原圖右下角200 px200 px的范圍,裁剪起點為原圖右下角:crop,g_se,裁減范圍200 px200 px:w_200,h_200,具體圖片處理參數為:
?x-amz-process=image/crop,w_200,h_200,g_se
裁剪圖右下角200 px200 px的范圍,起點為相對右下九宮格的左上頂點再位移(10,10),起點為原圖右下角再位移(10,10):crop,g_se,x_10,y_10,裁減范圍200 px200 px:w_200,h_200,具體圖片處理參數為:
?x-amz-process=image/crop,x_10,y_10,w_200,h_200,g_se