Image Parameters
Last updated
This page lists the query parameters GET /c/img/{path} accepts, their defaults, and their precedence.
Parameters
| Parameter | Alias | Values | Default | Description |
|---|---|---|---|---|
o |
origin |
1 |
— | Return the original file, ignoring every other parameter |
s |
size |
integer (px) | — | Short-edge length, proportional |
w |
width |
integer (px) | — | Width |
h |
height |
integer (px) | — | Height |
q |
quality |
0–100 |
WebP/JPG 75, AVIF 50 |
Output quality; unused for PNG |
t |
type |
webp/avif/jpg/jpeg/png |
webp |
Output format; other values fall back to webp |
d |
dark |
1/0 |
0 |
Color scheme of the 404 image when the file is missing |
When a short name and its alias both appear, the short name wins (?s=200&size=400 uses 200).
Precedence
| Order | Condition | Result |
|---|---|---|
| 1 | .pdf / .svg extension |
Original streamed as-is; all parameters ignored |
| 2 | o=1 |
Original streamed as-is |
| 3 | s present |
Scaled by short edge; w/h ignored |
| 4 | Both w and h |
Cropped to that size |
| 5 | Only w or h |
Scaled proportionally by that edge |
| 6 | None | Long edge shrunk to 1024px when the short edge exceeds 1024px |
See Sizing Rules for how each case computes dimensions.
Examples
# 480px short edge, quality 60, AVIF
curl -fsS -o a.avif "http://localhost:8080/c/img/blog/a.jpg?s=480&q=60&t=avif"
# Cropped 400x400 JPG
curl -fsS -o a.jpg "http://localhost:8080/c/img/blog/a.jpg?w=400&h=400&t=jpg"
# Original
curl -fsS -o origin.jpg "http://localhost:8080/c/img/blog/a.jpg?o=1"
# Missing image, dark 404 placeholder
curl -fsS -o missing.svg "http://localhost:8080/c/img/blog/none.jpg?d=1"