对象 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
转换为物理文件路径的详细信息,请参阅 服务器配置指南 中的 管理内容。
object.
中不允许使用逗号“,”字符支持的图像文件格式 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