Nesten en insluiten aanvragen request-nesting-and-embedding

Image Serving ondersteunt het onbeperkt nesten van aanvragen voor beeldweergave, het insluiten van aanvragen voor het renderen van afbeeldingen en het insluiten van afbeeldingen die zijn opgehaald van externe servers. Alleen laagafbeeldingen en laagmaskers ondersteunen deze mechanismen.

Aanvragen voor geneste afbeeldingen section-6954202119e0466f8ff27c79f4f039c8

Een volledig Beeld dat verzoek van de Beeldserver kan als laagbron worden gebruikt door het in te specificeren in src= (of mask=) gebruiken met de volgende syntaxis:

…&src=is( nestedRequest)&…

De is token is hoofdlettergevoelig.

Het geneste verzoek mag niet het hoofdpad van de server bevatten (doorgaans http:// *server*/is/image/').

Regels voor voorbewerking worden toegepast op geneste aanvragen.

De volgende opdrachten worden genegeerd wanneer deze worden opgegeven in geneste aanvragen (in de aanvraag-URL of in catalog::Modifier of catalog::PostModifier):

Als de resultaatafbeelding van de geneste aanvragen maskergegevens (alfa-gegevens) bevat, wordt deze als laagmasker doorgegeven aan de insluitlaag.

Ook genegeerd attribute::MaxPixen attribute::DefaultPix van de afbeeldingscatalogus die van toepassing is op de geneste aanvraag.

Het afbeeldingsresultaat van een geneste IS-aanvraag kan optioneel in de cache worden opgeslagen door cache=on. Het in cache plaatsen van tussentijdse gegevens is standaard uitgeschakeld. Caching zou slechts moeten worden toegelaten wanneer het middenbeeld naar verwachting in een verschillend verzoek binnen een redelijke termijn opnieuw zal worden gebruikt. Standaard cachebeheer op de server is van toepassing. Gegevens worden in cache opgeslagen in een indeling zonder gegevensverlies.

Aanvragen voor het renderen van ingesloten afbeelding section-69c5548db930412b9b90d9b2951a6969

Wanneer Dynamic Media Image Rendering is ingeschakeld op de server, kunnen renderverzoeken worden gebruikt als laagbronnen door deze op te geven in de opdracht src= (of mask=). Gebruik de volgende syntaxis:

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

De ir token is hoofdlettergevoelig.

renderRequest is de gebruikelijke aanvraag voor het renderen van afbeeldingen, exclusief het HTTP-hoofdpad http:// *server*/ir/render/.

De volgende opdrachten voor het renderen van afbeeldingen worden genegeerd wanneer deze worden opgegeven in geneste aanvragen:

Ook genegeerd attribute::MaxPix en attribute::DefaultPix van de materiaalcatalogus die van toepassing is op de geneste renderaanvraag.

Het beeldresultaat van een genest verzoek van AIR kan naar keuze in het voorgeheugen worden opgeslagen door te omvatten cache=on. Het in cache plaatsen van tussentijdse gegevens is standaard uitgeschakeld. Caching zou slechts moeten worden toegelaten wanneer het middenbeeld naar verwachting in een verschillend verzoek binnen een redelijke termijn opnieuw zal worden gebruikt. Standaard cachebeheer op de server is van toepassing. Gegevens worden in cache opgeslagen in een indeling zonder gegevensverlies.

Ingesloten FXG-renderaanvragen section-c817e4b4f7da414ea5a51252ca7e120a

Wanneer de FXG grafische renderer (ook bekend als AGMServer) is geïnstalleerd en ingeschakeld met Beeldserver, FXG-aanvragen kunnen worden gebruikt als laagbronnen door ze op te geven in src= (of mask=). Gebruik de volgende syntaxis:

…&src=fxg( renderRequest)&…

De fxg token is hoofdlettergevoelig.

renderRequest is de gebruikelijke FXG-renderaanvraag, exclusief het HTTP-hoofdpad http:// *server*/agm/render/.

De volgende FXG-opdrachten worden genegeerd wanneer deze worden opgegeven in geneste aanvragen:

Externe afbeeldingsbronnen section-84e83ecfcd1a43748cdfc7a6f8c04cb8

Image Serving ondersteunt toegang tot bronafbeeldingen op externe HTTP-servers.

Een externe URL opgeven voor een src= of mask= scheidt u het externe URL- of URL-fragment met haakjes:

…&src=( foreignUrl)&…

Belangrijk De scheidingstekens ( '(',')') en de opdrachtscheidingstekens ( '?', '&', '=') in geneste aanvragen mag niet via HTTP worden gecodeerd. Ingesloten aanvragen moeten feitelijk op dezelfde manier worden gecodeerd als de aanvraag voor buitenste insluiten.

Volledige absolute URL's (als attribute::AllowDirectUrls is ingesteld) en URL's ten opzichte van attribute::RootUrl zijn toegestaan. Er treedt een fout op als een absolute URL is ingesloten en een kenmerk: AllowDirectUrls is 0 of als een relatieve URL is opgegeven en attribute::RootUrl is leeg.

Hoewel externe URL's niet rechtstreeks in de padcomponent van de aanvraag-URL kunnen worden opgegeven, is het mogelijk een voorbewerkingsregel in te stellen om de conversie van relatieve paden naar absolute URL's toe te staan (zie het voorbeeld hieronder).

Externe afbeeldingen worden door de server in het cachegeheugen opgeslagen volgens de headers die bij de HTTP-respons worden geleverd. Als geen van beide ETag er is geen laatste aangepaste HTTP-antwoordheader aanwezig, de reactie is niet in de cache opgeslagen. Dit kan slechte prestaties voor herhaalde toegang tot het zelfde buitenlandse beeld veroorzaken, aangezien de Serving van het Beeld het beeld bij elke toegang moet re-halen en opnieuw bevestigen.

Dit mechanisme ondersteunt dezelfde indelingen voor afbeeldingsbestanden die worden ondersteund door het hulpprogramma Image Convert (IC), met uitzondering van bronafbeeldingen met 16 bits per component.

Beperkingen section-fb68e3f0d40947feb94d7bf183b64929

De grootte van de afbeelding die wordt gegenereerd door geneste/ingesloten aanvragen, wordt normaal gesproken automatisch geoptimaliseerd. Als plaatsing in cache van geneste aanvraagafbeeldingen is ingeschakeld, kunnen de prestaties toenemen door de exacte grootte van de geneste afbeelding op te geven, zodat er geen verdere schaling nodig is wanneer het cacheitem opnieuw wordt gebruikt.

De belangrijke Serving van het Beeld steunt dubbel-coderen van genestelde of ingebedde verzoeken niet. Geneste en ingesloten aanvragen moeten net als eenvoudige aanvragen HTTP-gecodeerd zijn.

Voorbeelden section-d800cfc31abe46d2a964f8e7929231f1

Laagsjabloon met caching:

Met nesten kunt u caching toevoegen aan een laagsjabloon. Een beperkt aantal achtergrondafbeeldingen wordt bedekt met zeer variabele tekst. De eerste sjabloontekenreeks ziet er als volgt uit:

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

Met kleine wijzigingen kunnen we de afbeelding met laag 0 vooraf schalen en deze blijvend in cache plaatsen, waardoor de serverlading afneemt:

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

Aanvragen voor Dynamic Media-beeldweergave insluiten

Een sjabloon gebruiken die is opgeslagen in myCatalog/myTemplate; genereer de afbeelding voor laag2 van de sjabloon met behulp van 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

Noteer de geneste accolades. Met de aanvraag Afbeelding renderen sluit u een aanroep terug naar Image Serving om een herhaalbare structuur op te halen.

Zie ook section-109a0a9a3b144158958351139c8b8e69

src= , mask=, Voorbewerking aanvragen, referentie afbeeldingsweergave, Sjablonen, Hulpprogramma's voor afbeeldingsservices