翻译：码农宋襄公

原文链接：https://iiif.io/api/image/3.0/compliance/

文档状态

此版本：3.0.0
最新稳定版：3.0.0

目录

1. 介绍
2. 兼容性
3. 图像参数
3.1 区域
3.2 Size
3.3 旋转
3.4 色质
3.5 格式
4. HTTP功能
5. 级别0兼容

1. 介绍

本文件是IIIFImageAPI3.0规范的配套文件。它定义了一组支持的参数，这些参数对应于API的不同遵从性级别。

2. 兼容性

定义了三个兼容性级别。级别0是必须实现的最小参数和功能集，以使服务符合IIIF图像API规范。级别1是推荐实施的一组参数和功能。请注意，服务器可能不支持所有支持的参数和功能的所有组合，如下文相应部分所述。
下表中 image.png 表示支持是必须的，而 image.png 表示支持是可选的。

3. 图像参数

3.1 区域

语法 功能名称 级别 0 级别 1 级别 2
full image.png image.png image.png
x,y,w,h regionByPx image.png image.png image.png
pct:x,y,w,h regionByPct image.png image.png image.png
square regionSquare image.png image.png image.png

另请参见“尺寸”一节中关于可能不受支持的尺寸和区域组合的注释。

3.2 尺寸

语法 功能名称 级别 0 级别 1 级别 2
max image.png image.png image.png
w, sizeByW image.png image.png image.png
,h sizeByH image.png image.png image.png
pct:n sizeByPct image.png image.png image.png
!w,h sizeByConfinedWh image.png image.png image.png
w,h sizeByWh image.png image.png image.png
^size sizeUpscaling image.png image.png image.png

在任何合规性级别上，其图像信息响应包括sizes属性的图像服务必须支持对所列尺寸的请求，而其图像信息响应包括tiles属性的服务必须支持对tiles给定的宽度width、高度height和缩放因子scaleFactors值中隐含的尺寸的请求。

请注意，服务器可能会使用可选的maxWidth、maxHeight和/或maxArea技术属性对图像的可用大小进行限制。服务器是兼容的，前提是它们支持上面所示的大小参数形式，以使图像大小达到指定的限制。客户端不应假定图像信息响应中指定的宽度和高度的完整图像将可用。完整图像将以最大尺寸提供，该尺寸可能小于宽度width和高度height。

3.3 旋转

语法 功能名称 级别 0 级别 1 级别 2
0 image.png image.png image.png
90,180,270 rotationBy90s image.png image.png image.png
arbitrary rotationArbitrary image.png image.png image.png
!n mirroring image.png image.png image.png

3.4 色质

语法 级别 0 级别 1 级别 2
default image.png image.png image.png
color image.png image.png image.png (如果有的话)
gray image.png image.png image.png (如果有的话)
bitonal image.png image.png image.png

3.5 格式

语法 级别 0 级别 1 级别 2
jpg image.png image.png image.png
png image.png image.png image.png
tif image.png image.png image.png
gif image.png image.png image.png
pdf image.png image.png image.png
jp2 image.png image.png image.png
webp image.png image.png image.png

4. HTTP功能

HTTP 功能 功能名称 级别 0 级别 1 级别 2
base URI redirects baseUriRedirect image.png image.png image.png
CORS cors image.png image.png image.png
json-ld media type jsonldMediaType image.png image.png image.png
profile link header profileLinkHeader image.png image.png image.png
canonical link header canonicalLinkHeader image.png image.png image.png

5. 级别0兼容

[

](https://iiif.io/community/#how-to-get-involved)
与0级兼容的图像服务器可选在图像信息响应中为分幅指定缩放因子scaleFactors和/或宽度width和高度height值。在0级兼容性下，服务只需要交付使用图像信息响应中声明的缩放因子计算的大小的图像。如有规定，应使用以下特殊含义解释：

缩放因子scaleFactors-仅支持指定的缩放因子

磁贴tils的宽度width、高度height-客户端应仅请求对应于指定尺寸的输出磁贴的区域

符合0级的图像服务器可选指定尺寸sizes，以指示整个full区域可用尺寸的特定宽度width和高度height值。

如果客户端请求这些参数之外的大小和区域组合，则图像服务器可选会拒绝该请求，并出现错误。