源對象指定符。 影像、SVG和ICC配置檔案對象可以指定為影像目錄條目或相對檔案路徑
*
*[/]{[ *
*/] *
*}| *
objectrootIdobjIdpath*
rootId |
影像目錄的名稱(屬性::RootId ) |
objtId |
指定、主目錄或預設影像目錄中的影像、SVG、範本或ICC描述檔記錄ID |
路徑 |
相對影像、蒙版或ICC配置檔案路徑和名稱 |
物件 |
可能發生在主URL路徑中,或發生在 src= 、 mask= 或 icc= 命令中 |
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.
中不允許逗號','字元
有關支援的檔案格式的完整清單,請參閱IC(影像轉換器)實用程式的說明。
使用動態媒體金字塔TIFF(PTIF)多解析度格式時,需要多種不同解析度的影像資料的應用程式效能最佳。 IC實用程式用於從任何支援的影像格式建立PTIF影像。
在兩個不同的影像目錄中存取影像和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