Dokumentation Dynamic Media Image Serving and Rendering API

req req

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler
Benutzende

Anfragetyp. Gibt den Typ der angeforderten Daten an.

debug

Führen Sie Befehle im Debug-Modus aus.

Inhalt

Gibt Informationen zu den Objekten in der Vignette zurück.

img

Führen Sie Befehle aus und geben Sie das gerenderte Bild zurück.

imageprops

Gibt Eigenschaften der angegebenen Vignette zurück.

map

Gibt in die Vignette eingebettete Imagemap-Daten zurück.

Objekt

Führen Sie Befehle aus und geben Sie das gerenderte Bild, das der aktuellen Objektauswahl maskiert ist, zurück.

props

Führen Sie Befehle aus und geben Sie Eigenschaften des Antwortbilds zurück.

userdata

Gibt den Inhalt von vignette::UserData zurück.

Sofern in den detaillierten Beschreibungen nichts anderes angegeben ist, 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 Fehlerinformationen und Debugging-Informationen 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 Antwortdatenformat und der Antworttyp werden durch fmt= bestimmt.

imageprops

Gibt ausgewählte Eigenschaften der Vignettendatei oder des Katalogeintrags zurück, die bzw. der im URL-Pfad angegeben ist. Eine Beschreibung der Antwortsyntax und des MIME-Typs der Antwort finden Sie unter Eigenschaften . Andere Befehle in der Anfrage werden ignoriert. Die folgenden Eigenschaften werden zurückgegeben:

Eigenschaft

Typ

Beschreibung

image.expiration

Double

attribute::Expiration oder die standardmäßige Live-Zeit.

image.height

Integer

Höhe mit voller Auflösung in Pixel.

image.iccProfile

Zeichenfolge

Name/Beschreibung des mit dieser Vignette verknüpften Profils.

image.embeddedIccProfile

Boolesch

1, wenn das verknüpfte Profil in die Vignette eingebettet ist.

image.embedded FotoshopPaths

Boolesch

1, wenn die Vignette Pfaddaten einbettet.

image.modifier

Zeichenfolge

attribute::Modifier oder leer, wenn kein Katalogeintrag vorhanden ist.

image.pixType

Enum

Pixeltyp des Antwortbilds; kann "CMYK", "RGB"oder "BW"sein (bei Graustufenbildern).

image.printRes

Real

Standardmäßige Druckauflösung in dpi.

image.timeStamp

Zeichenfolge

Änderungsdatum/-uhrzeit (aus Katalog::TimeStamp oder der Vignettendatei).

image.width

Integer

Breite mit voller Auflösung in Pixel.

vignette.name

Zeichenfolge

Vignettenname (Name des Wurzel-Vignettenobjekts).

vignette.res

Real

Maximale Objektauflösung in MaterialauflösungEinheiten (normalerweise Pixel/Zoll).

vignette.res.avg

Real

Durchschnittliche Objektauflösung in MaterialauflösungEinheiten (normalerweise Pixel/Inc Materialauflösungh).

vignette.res.min

Real

Minimale Objektauflösung in MaterialauflösungEinheiten (normalerweise Pixel/Zoll).

vignette.version

Integer

Versionsnummer der Vignette-Datei.

map

Gibt in der Vignette enthaltene Imagemap-Daten zurück. Standardmäßig werden die Zuordnungsdaten für alle äußersten Gruppen zurückgegeben. Die Zuordnungsdaten für alle innersten Gruppen können mit

req=map&groupLevel=-1

Die Zuordnungsdaten werden nicht auf wid= oder hei= skaliert oder anderweitig geändert. Der MIME-Typ der Antwort ist <text/xml>.

Die Antwortdaten bestehen aus einem <map> -Element, das einen Satz von <area> -Elementen enthält, ähnlich dem HTML <AREA> -Tag.

Jedes Element <area> enthält die standardmäßigen Attribute type= und coord= sowie ein Attribut name=, das den Vignettengruppennamen oder Namenspfad angibt. Mehrere <area> -Elemente mit demselben Namen sind vorhanden, wenn die Masken der entsprechenden Objektgruppe unterschiedliche Bereiche aufweisen.

Zusätzlich zu den Standardattributen können Vignetten zusätzliche Attribute definieren, sofern dies der Fall ist. Solche benutzerdefinierten Attribute werden als Objektgruppenattribute definiert. Die Namen der benutzerdefinierten Attribute müssen mit map beginnen, damit sie in die <area> -Elemente aufgenommen werden. Wenn die Gruppenattribute beispielsweise map.href=http://www.scene7.com enthalten, enthält das entsprechende Element <area> href="http://www.scene7.com".

Wenn die Vignette keine Zuordnungsdaten enthält, wird ein XML-Dokument mit einem leeren <map> -Element zurückgegeben.

object

Führt die angegebenen Befehle aus und gibt das gerenderte Bild zurück, das durch die Restobjektauswahl maskiert wurde (die Gruppe oder das Objekt, die bzw. das mit dem letzten Befehl sel= oder obj= 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 sowie Gruppen- oder Objekteigenschaften zurück, anstatt das gerenderte Bild. Eine Beschreibung der Antwortsyntax und des MIME-Antworttyps finden Sie unter Eigenschaften . Die Standardauswahl gilt, es sei denn, obj= oder sel= ist ebenfalls angegeben (siehe obj=).

Die Antwort kann die folgenden Eigenschaften enthalten:

Eigenschaft

Typ

Beschreibung

image.bgc

Zeichenfolge

Hintergrundfarbe des Antwortbilds.

image.height

Integer

Antwortbildhöhe in Pixel.

image.iccEmbed

Boolesch

True , wenn das ICC-Profil in das Antwortbild eingebettet ist (siehe iccEmbed=).

image.iccProfile

Zeichenfolge

Kurzbefehl des Profils, das mit dem Antwortbild verknüpft 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 Antwortbilds, kann "CMYK", "RGB"oder "BW"sein (für Graustufenbilder)

image.printRes

Real

Druckauflösung (dpi)

image.quality

Ganzzahl, boolesch

JPEG-Qualität und Chroma-Markierung (siehe qlt=)

image.type

Zeichenfolge

MIME-Typ für das Antwortbild (siehe fmt=).

image.width

Integer

Antwortbildbreite in Pixel.

selection.attributes

Zeichenfolge

Attributzeichenfolge für die aktuelle Auswahl.

selection.count

Integer

Anzahl der Objekte in der aktuellen Auswahl.

selection.ident

Integer

Einzugswert der aktuellen Auswahl.

select selection.attributes ion.name

Zeichenfolge

Vollständiger Namenspfad der aktuellen Objektauswahl.

selection.überlappend

Integer

Anzahl der überlappenden Objekte in der aktuellen Auswahl.

selection.renderable

Integer

Anzahl der renderbaren Objekte in der aktuellen Auswahl.

selection.texturable

Integer

Anzahl der texturierbaren Objekte in der aktuellen Auswahl.

selection.visible

Integer

Aktueller Ein-/Ausblendestatus der aktuellen Auswahl.

selection.zorder

Integer

z-order-Wert des ersten überlappenden Objekts in der aktuellen Auswahl.

userdata

Gibt den Inhalt von vignette::UserData zurück. Der Server ersetzt alle Vorkommen von '??' in vignette::UserData durch Zeilenende-Zeichen ( <cr><lf>). Die Antwort wird als Textdaten formatiert, wobei der MIME-Antworttyp auf <text/plain> festgelegt ist.

Wenn das im URL-Pfad angegebene Objekt nicht in einen gültigen Vignettenzuordnungs-Eintrag aufgelöst wird oder wenn der vignette::UserData leer ist, enthält die Antwort nur einen Zeilenende-Wert ( CR/LF).

Alle anderen Befehle in der Anforderungszeichenfolge werden ignoriert.

Eigenschaften section-e44092e190ff4f6380583e8ed6ea5b0b

Anforderungsbefehl. Kann an einer beliebigen Stelle in der Anforderungszeichenfolge auftreten.

Standard section-00c593cbf1af4364b6b78812e6b93c64

Wenn die URL keinen Bildpfad oder keine Modifikatoren enthält, dann:

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

Andernfalls req=img

req req

Eigenschaften section-e44092e190ff4f6380583e8ed6ea5b0b

Standard section-00c593cbf1af4364b6b78812e6b93c64

Verwandte Themen section-f7a955525fb44ef2ae7cd7ede25a96c3