对象 object

Source对象说明符。 可以将图像、SVG和ICC配置文件对象指定为图像目录条目或相对文件路径

*对象*[/]{[ *rootId*/] *objId*}| *路径*

rootId ​标识图像目录。 （有关详细信息，请参阅图像目录。） 如果在URL路径中指定了​ rootId，则该目录将成为此请求的​ 主目录。 否则，将默认目录用作主目录。 同一请求中可以使用多个不同的图像目录。

服务器最初假设src=、mask=和icc=命令中省略​ rootId，并尝试在主目录中找到目录条目。 实际上，服务器尝试将整个​ object ​字符串用作​ objId.

如果找到目录条目，则使用该条目；否则，服务器下一步将尝试匹配图像目录的​ rootId。 如果标识了目录，则会搜索该目录​ objId。 如果找到和条目，则使用它。

否则，object ​被假定为显式文件路径。 在本例中，如果在主目录中设置attribute::FullMatch，则忽略此对象的目录，并改用默认目录。 如果未设置attribute::FullMatch，则使用主目录进行进一步处理。

rootId ​和​ objId ​都区分大小写。 path ​仅在UNIX上区分大小写。

如果指定了前导/，则搜索默认目录而不是主目录。 当显式路径需要default::RootPath而不是主目录的attribute::RootPath时，这非常有用，但也可以用于获取对默认目录中的条目的访问权限，否则，这些条目将被主目录中的条目覆盖。

有关如何将​ path ​转换为物理文件路径的详细信息，请参阅​ 服务器配置指南 ​中的​ 管理内容。

支持的图像文件格式 section-12c85aead78e4f759856ca9ff10637d7

有关支持的文件格式的完整列表，请参阅IC（图像转换器）实用程序的说明。

当使用Dynamic Media金字塔TIFF(PTIF)多分辨率格式时，需要多个不同分辨率的图像数据的应用程序性能最佳。 IC实用程序用于从任何支持的图像格式创建PTIF图像。

示例 section-728ca9b566b54ea1afdf8f5f0a031a57

访问两个不同图像目录中的图像和ICC配置文件

检索标识为“myCatalog”的图像目录中的图像“myImage”，并附加位于名为“myProfiles”的图像目录中的ICC配置文件“sRGB”：

http:// *服务器*/myCatalog/myImage?icc=myProfiles/sRGB&iccEmbed=true

将单个图像目录与分层结合使用

构建包含三个层的简单复合图像，所有层均从“myCatalog”中检索：

http:// *服务器*/myCatalog?layer=0&src=img0&layer=1&src=img1&layer=2&src=img2&wid=200

直接访问图像文件，同时仍使用目录提供属性

使用myImageCatalog中配置的默认jpg属性访问my/image/path/myImage.tif：

http://server/myImageCatalog/my/image/path/myImage.tif?wid=200

另请参阅 section-b6eccefad63f441d922699c4aba58fc9

IC实用工具，src=，掩码=，属性：：FullMatch