Erf

Letzte Aktualisierung: 23. Dezember 2024
  • Themen:

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.
imgFü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.
PropsFü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:

EigenschaftTypBeschreibung
image.expirationDouble::Expiration oder die Standardlebensdauer.
image.heightIntegerHöhe in voller Auflösung in Pixeln.
image.iccProfile-ZeichenfolgeName/Beschreibung des mit dieser Vignette verknüpften Profils.
image.embeddedIccProfile-Boolesch1 , wenn das zugehörige Profil in die Vignette eingebettet ist.
image.embedded FotoshopPathsBoolesch1 Wenn die Vignette Pfaddaten einbettet.
image.modifier-Zeichenfolge::Modifier oder leer, wenn es sich nicht um einen Katalogeintrag handelt.
image.pixTypeAufzählungPixeltyp des Antwortbildes. Kann „CMYK“, "RGB" oder „BW“ (für Graustufenbilder) sein.
image.printRes-ReellStandardmäßige Druckauflösung in dpi.
image.timeStamp-ZeichenfolgeÄnderungsdatum/-uhrzeit (aus Katalog::TimeStamp oder der Vignettendatei).
image.widthIntegerBreite in voller Auflösung in Pixel.
vignette.nameZeichenfolgeName der Vignette (Namenszeichenfolge des Stamm-Vignettenobjekts)
vignette.resReellMaximale Objektauflösung in Materialauflösungs- (normalerweise Pixel/Zoll).
vignette.res.avgReellDurchschnittliche Objektauflösung in Materialauflösungs- (typischerweise Pixel/ Materialauflösungh).
vignette.res.minReellMinimale Objektauflösung in Materialauflösungs- (normalerweise Pixel/Zoll).
vignette.versionIntegerVersionsnummer 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:

EigenschaftTypBeschreibung
image.bgcZeichenfolgeHintergrundfarbe des Antwortbildes.
image.heightIntegerHöhe des Antwortbildes in Pixel.
image.iccEmbed-BooleschTrue, wenn das ICC-Profil in das Antwortbild eingebettet ist (siehe iccEmbed=).
image.iccProfile-ZeichenfolgeVerknüpfungsname des Profils, das dem Antwortbild zugeordnet ist (siehe icc=).
image.maskBooleschTrue, wenn das Antwortbild Alpha enthält.
image.pathEmbed-BooleschTrue, wenn das Antwortbild Pfaddaten enthält (siehe pathEmbed=).
image.pixTypeZeichenfolgeTyp des Antwortbildes, kann 'CMYK', 'RGB' oder 'BW' (für Graustufenbilder) sein
image.printRes-ReellDruckauflösung (dpi)
image.qualityGanze Zahl, booleschJPEG-Qualität und Chroma-Flag (siehe qlt=)
image.typeZeichenfolgeMIME-Typ des Antwortbildes (siehe fmt=).
image.widthIntegerBreite des Antwortbildes in Pixel.
.attributesZeichenfolgeAttributzeichenfolge für die aktuelle Auswahl.
selection.countIntegerAnzahl der Objekte in der aktuellen Auswahl.
selection.identIntegerWert der aktuellen Auswahl einrücken.
select selection.attributes ion.nameZeichenfolgeVollständiger Namenspfad der aktuellen Objektauswahl.
selection.overlapIntegerAnzahl der Überschneidungsobjekte in der aktuellen Auswahl.
selection.renderableIntegerAnzahl der renderfähigen Objekte in der aktuellen Auswahl.
selection.texturableIntegerAnzahl der texturierbaren Objekte in der aktuellen Auswahl.
.visibleIntegerAktueller Einblenden-/Ausblenden-Status der aktuellen Auswahl.
selection.zorder-IntegerZ-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.