圖片讀取參數
最後更新
本頁說明
GET /c/img/*path 接受的 query 參數、預設值與正規化規則。參數
每個參數都有短名與長名,由
utils.GetQuery 依序取第一個非空值:| 短名 | 長名 | 預設值 | 說明 |
|---|---|---|---|
o | origin | 0 | 1 時直接回傳原檔,忽略其他轉檔參數 |
s | size | — | 短邊長度(px),優先於 w/h |
w | width | — | 寬度(px) |
h | height | — | 高度(px) |
q | quality | 75(AVIF 為 50) | 輸出品質,限制於 0–100 |
t | type | webp | 輸出格式 |
b | blur | 0 | 高斯模糊 sigma,限制於 0–100 |
B | bright | 1 | 亮度倍率 |
d | dark | — | 1 或 dark 時錯誤回應使用深色佔位圖 |
b 與 B 區分大小寫,分別代表模糊與亮度。格式與品質
t 值 | 輸出 | Content-Type | 品質 |
|---|---|---|---|
webp、空值、不合法值 | WebP | image/webp | q,預設 75 |
jpg、jpeg | JPEG(jpeg 正規化為 jpg) | image/jpeg | q,預設 75 |
avif | AVIF | image/avif | q,預設 50 |
png | PNG | image/png | 不套用 |
q、b 無法解析為數字時使用預設值;B 無法解析時轉檔失敗並回佔位圖。範例
- # 短邊 480 px、AVIF、品質 60
- curl -o a.avif "http://localhost:8080/c/img/blog/photo.jpg?s=480&t=avif&q=60"
- # 寬 800 px、模糊 10、亮度 0.8,失敗時回深色佔位圖
- curl -o b.webp "http://localhost:8080/c/img/blog/photo.jpg?width=800&blur=10&bright=0.8&dark=1"
- # 原檔
- curl -o c.jpg "http://localhost:8080/c/img/blog/photo.jpg?o=1"
尺寸參數如何換算成輸出大小見 尺寸計算;處理順序見 影像處理流程。