請求巢狀內嵌

「影像伺服」支援無限制的「影像伺服」請求巢狀、內嵌「影像演算」請求，以及內嵌從外部伺服器擷取的影像。 只有圖層影像和圖層遮色片才支援這些機制。

巢狀影像伺服請求

使用下列語法，在src=（或mask=）命令中指定整個影像伺服請求，即可將其用作圖層來源：

…&src=is( nestedRequest)&…

is代號區分大小寫。

巢狀請求不得包含伺服器根路徑（通常為 http:// *[!DNL server]*/is/image/'）。

預處理規則會套用至巢狀請求。

在巢狀請求（在請求URL中或catalog::Modifier或catalog::PostModifier中）中指定時，會忽略下列命令：

• fmt=
• qlt=
• iccEmbed=
• printRes=
• quantize=
• req=
• bgc=

如果巢狀請求的結果影像包括掩碼(alpha)資料，則將其作為層掩碼傳遞到嵌入層。

套用至巢狀請求的影像目錄的attribute::MaxPix和attribute::DefaultPix也會被忽略。

巢狀IS請求的影像結果可選擇性地加入cache=on來快取。 預設情況下，會禁用中間資料的快取。 只有當中間影像預期在合理時段內於不同請求中重複使用時，才應啟用快取。 套用標準伺服器端快取管理。 資料以無損格式快取。

內嵌影像演算請求

在伺服器上啟用「動態媒體影像演算」時，演算請求可在src=（或mask=）命令中指定，以做為圖層來源。 使用下列語法：

…&src=ir( *[!DNL renderRequest]*)&…

ir代號區分大小寫。

renderRequest 是通常的「影像轉換」請求，排除HTTP根路徑 http:// *[!DNL server]*/ir/render/。

在巢狀請求中指定下列影像演算命令時，會忽略：

• fmt=
• qlt=
• icc=
• iccEmbed=
• printRes=
• req=

套用至巢狀演算請求的材質目錄的attribute::MaxPix和attribute::DefaultPix也會被忽略。

可選擇性地通過包括cache=on來快取嵌套IR請求的影像結果。 預設情況下，會禁用中間資料的快取。 只有當中間影像預期在合理時段內於不同請求中重複使用時，才應啟用快取。 套用標準伺服器端快取管理。 資料以無損格式快取。

內嵌的FXG演算請求

當安裝FXG圖形渲染器（又稱AGMServer）並啟用「影像服務」時，FXG請求可通過在src=（或mask=）命令中指定來用作層源。 使用下列語法：

…&src=fxg( renderRequest)&…

fxg代號區分大小寫。

renderRequest 是通常的FXG演算請求，排除HTTP根路徑 http:// *[!DNL server]*/agm/render/。

在巢狀請求中指定下列FXG命令時，將忽略：

• fmt=
• qlt=
• icc=
• iccEmbed=
• cache=

外來影像來源

「影像伺服」支援存取外來HTTP伺服器上的來源影像。

要為src=或mask=命令指定外來URL，請用括弧分隔外來URL或URL片段：

…&src=( foreignUrl)&…

重要：巢狀請求中的分隔字元('(',')')和命令分隔字元('?'、'&'、'=')不得使用HTTP編碼。 有效地，內嵌請求的編碼必須與外部（內嵌）請求相同。

完整絕對URL（若已設定attribute::AllowDirectUrls），且允許相對於attribute::RootUrl的URL。 如果嵌入了絕對URL且屬性：AllowDirectUrls為0，或如果指定了相對URL且attribute::RootUrl為空。

雖然無法直接在請求URL的路徑元件中指定外來URL，但是可以設定預處理規則，以允許將相對路徑轉換為絕對URL（請參閱以下範例）。

伺服器會根據HTTP回應所包含的快取標題，快取外來影像。 如果ETag或「上次修改的HTTP」回應標題都不存在，則不會快取回應。 這可能會導致相同外來影像重複存取時效能不佳，因為「影像伺服」需要在每次存取時重新擷取並重新驗證影像。

此機制支援影像轉換(IC)實用程式支援的影像檔案格式相同，但每個元件16位的源影像除外。

限制

巢狀／內嵌請求所產生的影像大小通常會自動最佳化。 如果啟用了嵌套請求影像的快取，則可以通過指定嵌套影像的確切大小來實現增量效能提升，因此當重新使用快取條目時不需要進一步縮放。

重要：影像伺服不支援對巢狀或內嵌請求進行雙重編碼。 巢狀和內嵌的請求必須像簡單請求一樣HTTP編碼。

範例

使用快取分層範本：

使用巢狀功能將快取新增至分層範本。 有限數量的背景影像會覆蓋高度可變的文字。 初始範本字串可能如下所示：

layer=0&src=$img$&size=300,300&layer=1&text=$txt$

只要稍加修改，我們就可以預先縮放第0層影像並持續快取它，從而降低伺服器負載：

layer=0&src=is(?src=$img$&size=300,300&cache=on)&layer=1&text=$txt$

內嵌動態媒體影像演算要求

使用儲存在myCatalog/myTemplate中的模板；使用動態媒體影像演算為範本的第2層產生影像：

http://server/is/image/myCatalog/myTemplate?layer=2&src=ir(myRenderCatalog/myRenderObject?id=myIdValue&sel=group&src=is(myCatalog/myTexture1?res=30)&res=30)&wid=300

請注意巢狀大括弧。 「影像演算」要求會內嵌回呼「影像服務」，以擷取可重複的紋理。

另請參閱

src= , mask= ，請求預處理，影像渲染參考，模板 ，模板，影像服 務實用程式