Begär kapsling och inbäddning request-nesting-and-embedding

Image Serving har stöd för obegränsad kapsling av Image Serving-begäranden, inbäddning av begäranden om bildåtergivning samt inbäddning av bilder som hämtats från externa servrar. Det är bara lagerbilder och lagermasker som har stöd för dessa mekanismer.

Begäranden om kapslad bildservering section-6954202119e0466f8ff27c79f4f039c8

En hel Image Serving-begäran kan användas som en lagerkälla genom att ange den i kommandot src= (eller mask=) med följande syntax:

…&src=is( nestedRequest)&…

Token is är skiftlägeskänslig.

Den kapslade begäran får inte innehålla serverrotsökvägen (vanligtvis http:// *server*/is/image/').

Förbearbetningsregler tillämpas på kapslade begäranden.

Följande kommandon ignoreras när de anges i kapslade begäranden (antingen i begärande-URL eller i catalog::Modifier eller catalog::PostModifier):

Om den resulterande bilden av den kapslade begäran innehåller maskdata (alfavärden) skickas den till inbäddningslagret som lagermask.

Även attribute::MaxPix och attribute::DefaultPix av bildkatalogen som gäller för den kapslade begäran ignoreras.

Bildresultatet av en kapslad IS-begäran kan cachelagras genom att inkludera cache=on. Som standard är cachelagring av mellanliggande data inaktiverad. Cachelagring bör endast aktiveras när den mellanliggande bilden förväntas återanvändas i en annan begäran inom en rimlig tidsperiod. Standardhantering av cacheminnet på serversidan gäller. Data cachelagras i ett förlustfritt format.

Begäranden om inbäddad bildåtergivning section-69c5548db930412b9b90d9b2951a6969

När Dynamic Media Image Rendering är aktiverat på servern kan återgivningsbegäranden användas som lagerkällor genom att ange dem med kommandot src= (eller mask=). Använd följande syntax:

…&src=ir( *renderRequest*)&…

Token ir är skiftlägeskänslig.

renderRequest är den vanliga begäran om bildåtergivning, exklusive HTTP-rotsökvägen http:// *server*/ir/render/.

Följande kommandon för bildåtergivning ignoreras när de anges i kapslade begäranden:

attribute::MaxPix och attribute::DefaultPix av materialkatalogen som gäller för den kapslade återgivningsbegäran ignoreras också.

Bildresultatet av en kapslad IR-begäran kan cachelagras genom att inkludera cache=on. Som standard är cachelagring av mellanliggande data inaktiverad. Cachelagring bör endast aktiveras när den mellanliggande bilden förväntas återanvändas i en annan begäran inom en rimlig tidsperiod. Standardhantering av cacheminnet på serversidan gäller. Data cachelagras i ett förlustfritt format.

Inbäddade FXG-renderingsbegäranden section-c817e4b4f7da414ea5a51252ca7e120a

När FXG-grafikåtergivaren (även AGMServer) är installerad och aktiverad med Image Serving, kan FXG-begäranden användas som lagerkällor genom att ange dem i kommandona src= (eller mask=). Använd följande syntax:

…&src=fxg( renderRequest)&…

Token fxg är skiftlägeskänslig.

renderRequest är den vanliga FXG-återgivningsbegäran, exklusive HTTP-rotsökvägen http:// *server*/agm/render/.

Följande FXG-kommandon ignoreras när de anges i kapslade begäranden:

Externa bildkällor section-84e83ecfcd1a43748cdfc7a6f8c04cb8

Image Serving stöder åtkomst till källbilder på externa HTTP-servrar.

Om du vill ange en extern URL för ett src=- eller mask=-kommando avgränsar du det externa URL- eller URL-fragmentet med parenteser:

…&src=( foreignUrl)&…

Viktigt! Avgränsningstecknen ( '(',')') och kommandoavgränsningstecknen ( '?', '&', '=') i kapslade begäranden får inte vara HTTP-kodade. Inbäddade begäranden måste i själva verket kodas på samma sätt som den yttre (inbäddade) begäran.

Fullständiga absoluta URL:er (om attribute::AllowDirectUrls har angetts) och URL:er i förhållande till attribute::RootUrl tillåts. Ett fel inträffar om en absolut URL är inbäddad och attributet: AllowDirectUrls är 0, eller om en relativ URL har angetts och attribute::RootUrl är tom.

Även om externa URL:er inte kan anges direkt i sökvägskomponenten i den begärda URL:en, går det att ställa in en förbearbetningsregel som tillåter konvertering av relativa sökvägar till absoluta URL:er (se exemplet nedan).

Externa bilder cachelagras av servern enligt de cachelagringsrubriker som ingår i HTTP-svaret. Om varken en ETag eller en Senast ändrad HTTP-svarshuvud finns, cachelagras inte svaret. Detta kan orsaka dålig prestanda vid upprepad åtkomst för samma externa bild, eftersom Image Serving måste hämta om och validera bilden vid varje åtkomst.

Den här funktionen stöder samma bildfilsformat som stöds av verktyget Bildkonvertering (IC), med undantag för källbilder med 16 bitar per komponent.

Begränsningar section-fb68e3f0d40947feb94d7bf183b64929

Storleken på bilden som skapas av kapslade/inbäddade begäranden optimeras normalt automatiskt. Om cachelagring av kapslade begärandebilder är aktiverat, kan inkrementella prestandavinster uppnås genom att ange den exakta storleken på den kapslade bilden, så att ingen ytterligare skalning krävs när cacheposten återanvänds.

Viktig bildhantering stöder inte dubbel kodning av kapslade eller inbäddade begäranden. Kapslade och inbäddade begäranden måste HTTP-kodas precis som enkla begäranden.

Exempel section-d800cfc31abe46d2a964f8e7929231f1

Lagermall med cachelagring:

Använd kapsling för att lägga till cachelagring i en lagermall. Ett begränsat antal bakgrundsbilder överlappas med mycket variabel text. Den inledande mallsträngen kan se ut så här:

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

Med mindre ändringar kan vi förskala bilden för lager 0 och cachelagra den permanent, vilket minskar serverbelastningen:

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

Bädda in begäranden om Dynamic Media bildåtergivning

Använd en mall som lagras i myCatalog/myTemplate. Generera bilden för lager2 i mallen med Dynamic Media Image Rendering:

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

Lägg märke till de kapslade klammerparenteserna. Begäran om bildåtergivning bäddar in ett anrop tillbaka till Image Serving för att hämta en repeterbar textur.

Se även section-109a0a9a3b144158958351139c8b8e69

src= , mask=, Begär förbearbetning, Referens för bildåtergivning, Mallar, Bildserververktyg