Erf
Erstellt für:
- Entwickler
- Benutzende
Anfragetyp. Gibt den Typ der angeforderten Daten an.
req=debug|contents|img|imageprops|map|object|props|userdata|validate
- | Führen Sie Befehle im Debugging-Modus aus. |
- | Gibt Informationen zu den Objekten in der Vignette zurück. |
img | Führt Befehle aus und gibt das gerenderte Bild zurück. |
ImageProps- | Gibt die Eigenschaften der angegebenen Vignette zurück. |
Gibt die in die Vignette eingebetteten Imagemap-Daten zurück. | |
- | Führt Befehle aus und gibt das gerenderte Bild, das maskiert ist, an die aktuelle Objektauswahl zurück. |
Props | Führt Befehle aus und gibt Eigenschaften des Antwortbildes zurück. |
UserData- | Gibt den Inhalt Vignette::UserData- zurück. |
Sofern in den detaillierten Beschreibungen nicht anders angegeben, gibt der Server Textantworten mit dem MIME-Typ <text/plain> zurück.
debug
Führt die angegebenen Befehle aus und gibt das gerenderte Bild zurück. Wenn ein Fehler auftritt, werden Fehler- und Debuginformationen anstelle des Fehlerbilds ( attribute::ErrorImagePath
) zurückgegeben.
contents
Gibt eine XML-Darstellung der Objekthierarchie in der Vignette zurück, einschließlich ausgewählter Objektattribute. Andere Befehle in der Anfrage werden ignoriert.
img
Führt die angegebenen Befehle aus und gibt das gerenderte Bild zurück. Das Format der Antwortdaten und der Antworttyp werden durch fmt=
bestimmt.
imageprops
Gibt ausgewählte Eigenschaften der Vignettendatei oder des Katalogeintrags zurück, die im URL-Pfad angegeben sind. Unter Eigenschaften finden Sie eine Beschreibung der Antwortsyntax und des MIME-Typs der Antwort. Andere Befehle in der Anfrage werden ignoriert. Die folgenden Eigenschaften werden zurückgegeben:
Eigenschaft | Typ | Beschreibung |
---|---|---|
image.expiration | Double | ::Expiration oder die Standardlebensdauer. |
image.height | Integer | Höhe in voller Auflösung in Pixeln. |
image.iccProfile- | Zeichenfolge | Name/Beschreibung des mit dieser Vignette verknüpften Profils. |
image.embeddedIccProfile- | Boolesch | 1 , wenn das zugehörige Profil in die Vignette eingebettet ist. |
image.embedded FotoshopPaths | Boolesch | 1 Wenn die Vignette Pfaddaten einbettet. |
image.modifier- | Zeichenfolge | ::Modifier oder leer, wenn es sich nicht um einen Katalogeintrag handelt. |
image.pixType | Aufzählung | Pixeltyp des Antwortbildes. Kann „CMYK“, "RGB" oder „BW“ (für Graustufenbilder) sein. |
image.printRes- | Reell | Standardmäßige Druckauflösung in dpi. |
image.timeStamp- | Zeichenfolge | Änderungsdatum/-uhrzeit (aus Katalog::TimeStamp oder der Vignettendatei). |
image.width | Integer | Breite in voller Auflösung in Pixel. |
vignette.name | Zeichenfolge | Name der Vignette (Namenszeichenfolge des Stamm-Vignettenobjekts) |
vignette.res | Reell | Maximale Objektauflösung in Materialauflösungs- (normalerweise Pixel/Zoll). |
vignette.res.avg | Reell | Durchschnittliche Objektauflösung in Materialauflösungs- (typischerweise Pixel/ Materialauflösungh). |
vignette.res.min | Reell | Minimale Objektauflösung in Materialauflösungs- (normalerweise Pixel/Zoll). |
vignette.version | Integer | Versionsnummer der Vignettendatei. |
map
Gibt die in der Vignette enthaltenen Imagemap-Daten zurück. Standardmäßig werden die Zuordnungsdaten für alle äußersten Gruppen zurückgegeben. Die Kartendaten für alle innersten Gruppen können abgerufen werden mit
req=map&groupLevel=-1
Die Zuordnungsdaten werden nicht auf wid=
oder hei=
skaliert oder anderweitig geändert. Der Antwort-MIME-Typ ist <text/xml>
.
Die Antwortdaten bestehen aus einem <map>
, das eine Reihe von <area>
enthält, ähnlich dem HTML-<AREA>
-Tag.
Jedes <area>
-Element enthält die standardmäßigen type=
- und coord=
-Attribute sowie ein name=
-Attribut, das den Namen der Vignettengruppe oder den Namenspfad angibt. Mehrere <area>
mit demselben Namen sind vorhanden, wenn die Masken der entsprechenden Objektgruppe unterbrochene Bereiche aufweisen.
Zusätzlich zu den Standardattributen können Vignetten bei Bedarf zusätzliche Attribute definieren. Solche benutzerdefinierten Attribute werden als Objektgruppenattribute definiert. Die Namen von benutzerdefinierten Attributen müssen mit map
beginnen, damit sie in die <area>
Elemente aufgenommen werden können. Wenn die Gruppenattribute beispielsweise map.href=http://www.scene7.com
enthalten, enthält das entsprechende <area>
-Element href="http://www.scene7.com"
.
Ein XML-Dokument mit einem leeren <map>
wird zurückgegeben, wenn die Vignette keine Zuordnungsdaten enthält.
object
Führt die angegebenen Befehle aus und gibt das gerenderte Bild zurück, das durch die Auswahl des Restobjekts maskiert ist (die Gruppe oder das Objekt, die bzw. das mit dem letzten sel=
- oder obj=
-Befehl in der Anfrage ausgewählt wurde). Wird normalerweise mit einem Bildformat verwendet, das Alpha unterstützt (siehe fmt=). Wenn ein Bildformat verwendet wird, das Alpha nicht unterstützt, sind die Bereiche außerhalb der Maske schwarz.
props
Führt die angegebenen Befehle aus und gibt Vignetteneigenschaften und Gruppen- oder Objekteigenschaften anstelle des gerenderten Bildes zurück. Unter Eigenschaften finden Sie eine Beschreibung der Antwortsyntax und des MIME-Typs der Antwort. Die Standardauswahl gilt, sofern nicht auch obj=
oder sel=
angegeben ist (siehe obj=
).
Die Antwort kann die folgenden Eigenschaften enthalten:
Eigenschaft | Typ | Beschreibung |
---|---|---|
image.bgc | Zeichenfolge | Hintergrundfarbe des Antwortbildes. |
image.height | Integer | Höhe des Antwortbildes in Pixel. |
image.iccEmbed- | Boolesch | True, wenn das ICC-Profil in das Antwortbild eingebettet ist (siehe iccEmbed=). |
image.iccProfile- | Zeichenfolge | Verknüpfungsname des Profils, das dem Antwortbild zugeordnet ist (siehe icc=). |
image.mask | Boolesch | True, wenn das Antwortbild Alpha enthält. |
image.pathEmbed- | Boolesch | True, wenn das Antwortbild Pfaddaten enthält (siehe pathEmbed=). |
image.pixType | Zeichenfolge | Typ des Antwortbildes, kann 'CMYK', 'RGB' oder 'BW' (für Graustufenbilder) sein |
image.printRes- | Reell | Druckauflösung (dpi) |
image.quality | Ganze Zahl, boolesch | JPEG-Qualität und Chroma-Flag (siehe qlt=) |
image.type | Zeichenfolge | MIME-Typ des Antwortbildes (siehe fmt=). |
image.width | Integer | Breite des Antwortbildes in Pixel. |
.attributes | Zeichenfolge | Attributzeichenfolge für die aktuelle Auswahl. |
selection.count | Integer | Anzahl der Objekte in der aktuellen Auswahl. |
selection.ident | Integer | Wert der aktuellen Auswahl einrücken. |
select selection.attributes ion.name | Zeichenfolge | Vollständiger Namenspfad der aktuellen Objektauswahl. |
selection.overlap | Integer | Anzahl der Überschneidungsobjekte in der aktuellen Auswahl. |
selection.renderable | Integer | Anzahl der renderfähigen Objekte in der aktuellen Auswahl. |
selection.texturable | Integer | Anzahl der texturierbaren Objekte in der aktuellen Auswahl. |
.visible | Integer | Aktueller Einblenden-/Ausblenden-Status der aktuellen Auswahl. |
selection.zorder- | Integer | Z-Reihenfolgenwert des ersten Überschneidungsobjekts in der aktuellen Auswahl. |
userdata
Gibt den Inhalt von vignette::UserData
zurück. Der Server ersetzt alle Vorkommen von '??'
in vignette::UserData
durch Zeilenabschlüsse ( <cr><lf>
). Die Antwort ist als Textdaten formatiert, wobei der MIME-Typ der Antwort auf <text/plain> festgelegt ist.
Wenn das im URL-Pfad angegebene Objekt nicht in einen gültigen Vignettenzuordnungseintrag aufgelöst wird oder der vignette::UserData
leer ist, enthält die Antwort nur einen Zeilenabschluss ( CR/LF
).
Alle anderen Befehle in der Anfragezeichenfolge werden ignoriert.
Eigenschaften
Befehl anfordern. Kann an beliebiger Stelle in der Anfragezeichenfolge auftreten.
Standard
Wenn die URL keinen Bildpfad oder keine Modifikatoren enthält, gehen Sie wie folgt vor:
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.
Andernfalls req=img
Verwandte Themen
fmt= , attribute::ErrorImagePath, vignette::UserData, Properties