DokumentationDynamic Media Image Serving and Rendering API

req req

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ä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

debug
Kör kommandon i felsökningsläge.
innehåll
Returnera information om objekten i vinjetteringen.
img
Kör kommandon och returnera den återgivna bilden.
imageprops
Returnerar egenskaper för den angivna vinjetteringen.
karta
Returnerar data för bildscheman som är inbäddade i vinjetteringen.
objekt
Kör kommandon och returnera den återgivna bilden som maskerats till den aktuella objektmarkeringen.
props
Kör kommandon och returnera egenskaper för svarsbilden.
användardata
Returnerar 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:

Egenskap
Typ
Beskrivning
image.expiration
Dubbel
-attribut::Förfallotid eller standardtid för direktuppspelning.
image.height
Heltal
Höjd med full upplösning i pixlar.
image.iccProfile
Sträng
namn/beskrivning av profilen som är associerad med den här vinjetteringen.
image.embeddedIccProfile
Boolean
1 om den associerade profilen är inbäddad i vinjetteringen.
image.embedded PhotoshopPaths
Boolean
1 om vinjetteringen bäddar in sökvägsdata.
image.modifier
Sträng
-attribut::Modifier eller tom om det inte är en katalogpost.
image.pixType
Enum
Svarsbildens pixeltyp; kan vara CMYK, RGB eller BW (för gråskalebilder).
image.printRes
Real
Standardutskriftsupplösning i dpi.
image.timeStamp
Sträng
Ändringsdatum/tid (från -katalog::TimeStamp eller vinjettfilen).
image.width
Heltal
Full upplösningsbredd i pixlar.
vignette.name
Sträng
Vinjettnamn (namnsträng för rotvinjetteringsobjektet).
vignette.res
Real
Maximal objektupplösning i materialupplösningarenheter (vanligen pixlar/tum).
vignette.res.avg
Real
Genomsnittlig objektupplösning i materialupplösningsenheter(vanligen pixlar/inc materialupplösningh).
vignette.res.min
Real
Lägsta objektupplösning i materialupplösningarenheter (vanligen pixlar/tum).
vignette.version
Heltal
Versionsnummer 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:

Egenskap
Typ
Beskrivning
image.bgc
Sträng
Svarsbildens bakgrundsfärg.
image.height
Heltal
Svarets bildhöjd i pixlar.
image.iccEmbed
Boolean
True if the ICC profile is embedded in the reply image (see iccEmbed=).
image.iccProfile
Sträng
Kortkommandonamn för den profil som är associerad med svarsbilden (se icc=).
image.mask
Boolean
True if the reply image includes alpha.
image.pathEmbed
Boolean
True if the reply image includes path data (see pathEmbed=).
image.pixType
Sträng
Svarsbildtyp, kan vara CMYK, RGB eller BW (för gråskalebilder)
image.printRes
Real
Utskriftsupplösning (dpi)
image.quality
Heltal, boolesk
JPEG och chroma-flagga (se qlt=)
image.type
Sträng
Mime-typ för svarsbilden (se fmt=).
image.width
Heltal
Svarsbildens bredd i pixlar.
selection.attributes
Sträng
Attributsträng för den aktuella markeringen.
selection.count
Heltal
Antal objekt i den aktuella markeringen.
selection.ident
Heltal
Dra in värdet för den aktuella markeringen.
select selection.attributes ion.name
Sträng
Den fullständiga namnsökvägen för den aktuella objektmarkeringen.
selection.overlapping
Heltal
antalet överlappande objekt i den aktuella markeringen.
selection.renderable
Heltal
Antal återgivningsbara objekt i den aktuella markeringen.
selection.texturable
Heltal
Antal texturerbara objekt i den aktuella markeringen.
selection.visible
Heltal
Aktuell status för att visa/dölja den aktuella markeringen.
selection.zorder
Heltal
Z-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.

Egenskaper section-e44092e190ff4f6380583e8ed6ea5b0b

Begär kommando. Kan förekomma var som helst i begärandesträngen.

Standard section-00c593cbf1af4364b6b78812e6b93c64

Om URL:en inte innehåller någon bildsökväg eller modifierare:

#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.

Annars, req=img

Se även section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt= , attribute::ErrorImagePath, vignette::UserData, Properties

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49