Dokumentation Dynamic Media Image Serving and Rendering-API

Erf req

Last update: Mon Dec 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler
Benutzende

Anfragetyp. Gibt den Typ der angeforderten Daten an.

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 section-e44092e190ff4f6380583e8ed6ea5b0b

Befehl anfordern. Kann an beliebiger Stelle in der Anfragezeichenfolge auftreten.

Standard section-00c593cbf1af4364b6b78812e6b93c64

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

Erf req

Eigenschaften section-e44092e190ff4f6380583e8ed6ea5b0b

Standard section-00c593cbf1af4364b6b78812e6b93c64

Verwandte Themen section-f7a955525fb44ef2ae7cd7ede25a96c3