圖片讀取參數

最後更新


本頁說明 GET /c/img/*path 接受的 query 參數、預設值與正規化規則。

參數


每個參數都有短名與長名,由 utils.GetQuery 依序取第一個非空值:
短名長名預設值說明
oorigin01 時直接回傳原檔,忽略其他轉檔參數
ssize—短邊長度(px),優先於 w/h
wwidth—寬度(px)
hheight—高度(px)
qquality75(AVIF 為 50)輸出品質,限制於 0–100
ttypewebp輸出格式
bblur0高斯模糊 sigma,限制於 0–100
Bbright1亮度倍率
ddark—1 或 dark 時錯誤回應使用深色佔位圖

b 與 B 區分大小寫,分別代表模糊與亮度。

格式與品質


t 值輸出Content-Type品質
webp、空值、不合法值WebPimage/webpq,預設 75
jpg、jpegJPEG(jpeg 正規化為 jpg)image/jpegq,預設 75
avifAVIFimage/avifq,預設 50
pngPNGimage/png不套用

q、b 無法解析為數字時使用預設值;B 無法解析時轉檔失敗並回佔位圖。

範例


  1. # 短邊 480 px、AVIF、品質 60
  2. curl -o a.avif "http://localhost:8080/c/img/blog/photo.jpg?s=480&t=avif&q=60"
  3. # 寬 800 px、模糊 10、亮度 0.8,失敗時回深色佔位圖
  4. curl -o b.webp "http://localhost:8080/c/img/blog/photo.jpg?width=800&blur=10&bright=0.8&dark=1"
  5. # 原檔
  6. curl -o c.jpg "http://localhost:8080/c/img/blog/photo.jpg?o=1"

尺寸參數如何換算成輸出大小見 尺寸計算;處理順序見 影像處理流程。
EN