req

Senast uppdaterad: 22 juli 2024
  • Ämnen:

Skapat för:

  • Utvecklare
  • Användare

Typ av begäran. Anger vilken typ av data som begärs.

req=debug|contents|img|imageprops|map|object|props|userdata|validate

debugKör kommandon i felsökningsläge.
innehållReturnera information om objekten i vinjetteringen.
imgKör kommandon och returnera den återgivna bilden.
imagepropsReturnerar egenskaper för den angivna vinjetteringen.
kartaReturnerar data för bildscheman som är inbäddade i vinjetteringen.
objektKör kommandon och returnera den återgivna bilden som maskerats till den aktuella objektmarkeringen.
propsKör kommandon och returnera egenskaper för svarsbilden.
användardataReturnerar innehållet i -vinjett::UserData .

Om inget annat anges i de detaljerade beskrivningarna returnerar servern textsvar med MIME-typen <text/plain>.

debug

Kör de angivna kommandona och returnerar den återgivna bilden. Om ett fel inträffar returneras felinformation och felsökningsinformation i stället för felbilden ( attribute::ErrorImagePath).

contents

Returnerar en XML-representation av objekthierarkin i vinjetteringen, inklusive valda objektattribut. Andra kommandon i begäran ignoreras.

img

Kör de angivna kommandona och returnerar den återgivna bilden. Svarsdataformatet och svarstypen bestäms av fmt=.

imageprops

Returnerar markerade egenskaper för den vinjettfil eller katalogpost som anges i URL-sökvägen. I Egenskaper finns en beskrivning av MIME-typen för svarssyntax och svar. Andra kommandon i begäran ignoreras. Följande egenskaper returneras:

EgenskapTypBeskrivning
image.expirationDubbel-attribut::Förfallotid eller standardtid för direktuppspelning.
image.heightHeltalHöjd med full upplösning i pixlar.
image.iccProfileSträngnamn/beskrivning av profilen som är associerad med den här vinjetteringen.
image.embeddedIccProfileBoolean1 om den associerade profilen är inbäddad i vinjetteringen.
image.embedded PhotoshopPathsBoolean1 om vinjetteringen bäddar in sökvägsdata.
image.modifierSträng-attribut::Modifier eller tom om det inte är en katalogpost.
image.pixTypeEnumSvarsbildens pixeltyp; kan vara CMYK, RGB eller BW (för gråskalebilder).
image.printResRealStandardutskriftsupplösning i dpi.
image.timeStampSträngÄndringsdatum/tid (från -katalog::TimeStamp eller vinjettfilen).
image.widthHeltalFull upplösningsbredd i pixlar.
vignette.nameSträngVinjettnamn (namnsträng för rotvinjetteringsobjektet).
vignette.resRealMaximal objektupplösning i materialupplösningarenheter (vanligen pixlar/tum).
vignette.res.avgRealGenomsnittlig objektupplösning i materialupplösningsenheter(vanligen pixlar/inc materialupplösningh).
vignette.res.minRealLägsta objektupplösning i materialupplösningarenheter (vanligen pixlar/tum).
vignette.versionHeltalVersionsnummer för vinjettfil.

map

Returnerar bildmappsdata som ingår i vinjetteringen. Som standard returneras kartdata för alla yttersta grupper. Kartdata för alla innersta grupper kan hämtas med

req=map&groupLevel=-1

Kartdata skalas inte till wid= eller hei= eller ändras inte på något annat sätt. MIME-typen för svar är <text/xml>.

Svarsdata består av ett <map>-element som innehåller en uppsättning <area>-element som liknar taggen HTML <AREA> .

Varje <area>-element innehåller standardattributen type= och coord= samt ett name=-attribut som anger namn eller sökväg för vinjetteringsgruppen. Det finns flera <area>-element med samma namn om maskerna för motsvarande objektgrupp har icke sammanhängande regioner.

Förutom standardattributen kan vinjetter definiera ytterligare attribut om de är skapade på det sättet. Sådana anpassade attribut definieras som objektgruppsattribut. Namnen på anpassade attribut måste börja med map för att inkluderas i elementen <area>. Om gruppattributen t.ex. innehåller map.href=http://www.scene7.com innehåller motsvarande <area>-element href="http://www.scene7.com".

Ett XML-dokument med ett tomt <map>-element returneras om vinjetteringen inte innehåller mappningsdata.

object

Kör de angivna kommandona och returnerar den återgivna bilden som maskeras av markeringen för det kvarvarande objektet (gruppen eller objektet som markerades med det sista sel=- eller obj=-kommandot i begäran). Används vanligtvis med ett bildformat som stöder alfa (se fmt=). Om du använder ett bildformat som inte har stöd för alfa, blir områdena utanför masken svarta.

props

Kör de angivna kommandona och returnerar vinjettegenskaper och grupp- eller objektegenskaper i stället för den återgivna bilden. I Egenskaper finns en beskrivning av svarssyntaxen och MIME-svarstypen. Standardvalet gäller om inte obj= eller sel= också anges (se obj=).

Följande egenskaper kan ingå i svaret:

EgenskapTypBeskrivning
image.bgcSträngSvarsbildens bakgrundsfärg.
image.heightHeltalSvarets bildhöjd i pixlar.
image.iccEmbedBooleanTrue if the ICC profile is embedded in the reply image (see iccEmbed=).
image.iccProfileSträngKortkommandonamn för den profil som är associerad med svarsbilden (se icc=).
image.maskBooleanTrue if the reply image includes alpha.
image.pathEmbedBooleanTrue if the reply image includes path data (see pathEmbed=).
image.pixTypeSträngSvarsbildtyp, kan vara CMYK, RGB eller BW (för gråskalebilder)
image.printResRealUtskriftsupplösning (dpi)
image.qualityHeltal, booleskJPEG och chroma-flagga (se qlt=)
image.typeSträngMime-typ för svarsbilden (se fmt=).
image.widthHeltalSvarsbildens bredd i pixlar.
selection.attributesSträngAttributsträng för den aktuella markeringen.
selection.countHeltalAntal objekt i den aktuella markeringen.
selection.identHeltalDra in värdet för den aktuella markeringen.
select selection.attributes ion.nameSträngDen fullständiga namnsökvägen för den aktuella objektmarkeringen.
selection.overlappingHeltalantalet överlappande objekt i den aktuella markeringen.
selection.renderableHeltalAntal återgivningsbara objekt i den aktuella markeringen.
selection.texturableHeltalAntal texturerbara objekt i den aktuella markeringen.
selection.visibleHeltalAktuell status för att visa/dölja den aktuella markeringen.
selection.zorderHeltalZ-ordningsvärdet för det första överlappningsobjektet i den aktuella markeringen.

userdata

Returnerar innehållet i vignette::UserData. Servern ersätter alla förekomster av '??' i vignette::UserData med radslutstecken ( <cr><lf>). Svaret formateras som textdata med MIME-svarstypen inställd på <text/plain>.

Om objektet som anges i URL-sökvägen inte kan tolkas som en giltig vinjettmappningspost, eller om vignette::UserData är tom, innehåller svaret bara en radavslutning ( CR/LF).

Alla andra kommandon i begärandesträngen ignoreras.