IIIF Image URL Parameter Sequence Formatter (v2)
Assemble a canonical IIIF Image API 2.1 request URL, using the v2 default size keyword 'full' and percent-encoding special characters—including slashes—inside the image identifier.
Description
Format a canonical IIIF Image API 2.1 image request with encoded identifier and v2 region, size, rotation, quality, and format order.
Assemble a canonical IIIF Image API 2.1 request URL, using the v2 default size keyword 'full' and percent-encoding special characters—including slashes—inside the image identifier.
When to use IIIF Image URL Parameter Sequence Formatter (v2)
- Format a canonical IIIF Image API 2.1 image request with encoded identifier and v2 region, size, rotation, quality, and format order.
- Apply the same explicit rule consistently during ingest, quality control, reporting, or preservation planning.
- Expose records that need human review without silently rewriting the source data.
How the calculation works
IIIF v2 uses full as its canonical unconstrained-size keyword; max is the version 3 replacement. Slashes inside identifiers must be percent-encoded.1
{base}/{identifier}/{region}/{size}/{rotation}/{quality}.{format} Interpreting the result
IIIF v2 uses full as its canonical unconstrained-size keyword; max is the version 3 replacement. Slashes inside identifiers must be percent-encoded.
Assumptions and limitations
- The formatter does not contact the image server or check advertised profile support, image dimensions, region bounds, mirroring, or non-default extensions.
- Preserve the original value and record the rule version when using this result in an archival workflow.
References
-
IIIF Image API 2.1.1 — IIIF Consortium