# Image Parameters

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](/api-reference-sizing) for how each case computes dimensions.

## Examples

```bash
# 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"
```