Type de demande. Indique le type de données demandé.
req=debug|contents|img|imageprops|map|object|props|userdata|validate
déboguer |
Exécutez les commandes en mode débogage. |
contenu |
Renvoie des informations sur les objets de la vignette. |
img |
Exécutez les commandes et renvoyez l’image rendue. |
imageprops |
Renvoie les propriétés de la vignette spécifiée. |
carte |
Renvoie les données de zone cliquable incorporées dans la vignette. |
objet |
Exécutez les commandes et renvoyez l’image rendue masquée à la sélection d’objets active. |
props |
Exécutez les commandes et renvoyez les propriétés de l’image de réponse. |
userdata |
Renvoie le contenu de vignette::UserData . |
Sauf indication contraire dans les descriptions détaillées, le serveur renvoie des réponses texte de type MIME <text/plain>.
debug
Exécute les commandes spécifiées et renvoie l’image rendue. Si une erreur se produit, les informations d'erreur et de débogage sont renvoyées à la place de l'image d'erreur ( attribute::ErrorImagePath
).
contents
Renvoie une représentation XML de la hiérarchie d’objets dans la vignette, y compris les attributs d’objet sélectionnés. Les autres commandes de la requête sont ignorées.
img
Exécute les commandes spécifiées et renvoie l’image rendue. Le format des données de réponse et le type de réponse sont déterminés par fmt=
.
imageprops
Renvoie les propriétés sélectionnées du fichier de vignette ou de l’entrée de catalogue spécifiée dans le chemin d’accès de l’URL. Voir Propriétés pour une description de la syntaxe de réponse et du type MIME de réponse. Les autres commandes de la requête sont ignorées. Les propriétés suivantes sont renvoyées :
Propriété |
Type |
Description |
---|---|---|
image.expiration |
Doublon |
attribute::Expiration ou l'heure par défaut à vivre. |
image.height |
Entier |
Hauteur de résolution totale en pixels. |
image.iccProfile |
Chaîne |
nom/description du profil associé à cette vignette. |
image.beddedIccProfile |
Boolean |
1 si le profil associé est incorporé dans la vignette. |
image.bedded PhotoshopPaths |
Boolean |
1 si la vignette incorpore des données de chemin. |
image.modifier |
Chaîne |
attribut::Modificateur ou vide si ce n'est pas une entrée de catalogue. |
image.pixTyp |
Enum |
Type de pixel de l'image de réponse ; peut être CMJN, RVB ou BW (pour les images en niveaux de gris). |
image.printRes |
Real |
Résolution d’impression par défaut en ppp. |
image.timeStamp |
Chaîne |
Date/heure de modification (à partir du catalogue::TimeStamp ou du fichier de vignette). |
image.width |
Entier |
Largeur en pleine résolution, en pixels. |
vignette.name |
Chaîne |
Nom de la vignette (chaîne de nom de l’objet de vignette racine). |
vignette.res |
Real |
Résolution d’objet maximale en unités de résolution de matériau (généralement pixels/pouce). |
vignette.res.avg |
Real |
Résolution moyenne d'objet en unités de résolution de matériau (généralement en pixels/inc de résolution de matériau h). |
vignette.res.min |
Real |
Résolution d’objet minimale en unités de résolution de matériau (généralement en pixels/pouce). |
vignette.version |
Entier |
Numéro de version du fichier de vignette. |
map
Renvoie les données de zone cliquable incluses dans la vignette. Par défaut, les données de mappage pour tous les groupes les plus éloignés sont renvoyées. Les données de mappage pour tous les groupes les plus internes peuvent être obtenues avec
req=map&groupLevel=-1
Les données de mappage ne sont pas mises à l’échelle sur wid=
ou hei=
ou modifiées d’une autre manière. Le type MIME de réponse est <text/xml>
.
Les données de réponse se composent d’un élément <map>
contenant un ensemble d’éléments <area>
, similaire à la balise HTML <AREA>
.
Chaque élément <area>
comprend les attributs standard type=
et coord=
, ainsi qu'un attribut name=
, en spécifiant le nom du groupe de vignettes ou le chemin d'accès au nom. Plusieurs éléments <area>
portant le même nom seront présents si les masques du groupe d’objets correspondant comportent des régions discontinues.
Outre les attributs par défaut, les vignettes peuvent définir des attributs supplémentaires si elles sont créées. Ces attributs personnalisés sont définis comme des attributs de groupe d’objets. Les noms des attributs personnalisés doivent commencer par map
. à inclure dans les éléments <area>
. Par exemple, si les attributs de groupe incluent map.href=http://www.scene7.com
, l’élément <area>
correspondant inclut href="http://www.scene7.com"
.
Un document XML avec un élément <map>
vide est renvoyé si la vignette n’inclut pas de données de mappage.
object
Exécute les commandes spécifiées et renvoie l’image rendue masquée par la sélection d’objets résiduelle (groupe ou objet sélectionné avec la dernière commande sel=
ou obj=
dans la requête). Habituellement utilisé avec un format d’image qui prend en charge alpha (voir fmt=). Si un format d’image n’est pas compatible avec le format alpha, les zones extérieures au masque sont noires.
props
Exécute les commandes spécifiées et renvoie les propriétés de vignette et de groupe ou d’objet, plutôt que l’image rendue. Voir Propriétés pour une description de la syntaxe de réponse et du type MIME de réponse. La sélection par défaut s'applique à moins que obj=
ou sel=
ne soit également spécifié (voir obj=
).
Les propriétés suivantes peuvent être incluses dans la réponse :
Propriété |
Type |
Description |
---|---|---|
image.bgc |
Chaîne |
Couleur d’arrière-plan de l’image de réponse. |
image.height |
Entier |
Hauteur de l’image de réponse en pixels. |
image.iccEmbed |
Boolean |
True si le profil ICC sera incorporé à l’image de réponse (voir iccEmbed= ). |
image.iccProfile |
Chaîne |
Nom de raccourci du profil associé à l’image de réponse (voir icc= ). |
image.mask |
Boolean |
True si l’image de réponse contient alpha. |
image.pathEmbed |
Boolean |
True si l’image de réponse contient des données de chemin d’accès (voir pathEmbed= ). |
image.pixTyp |
Chaîne |
Le type d’image de réponse peut être CMJN, RVB ou BW (pour les images en niveaux de gris). |
image.printRes |
Real |
Résolution d’impression (ppp) |
image.quality |
Entier, booléen |
Qualité JPEG et indicateur de chroma (voir qlt= ) |
image.type |
Chaîne |
Type Mime pour l’image de réponse (voir fmt= ). |
image.width |
Entier |
Largeur de l’image de réponse en pixels. |
selection.attributes |
Chaîne |
Chaîne d’attributs pour la sélection actuelle. |
selection.count |
Entier |
Nombre d’objets dans la sélection actuelle. |
selected.ident |
Entier |
Retrait de la valeur de la sélection actuelle. |
select selection.attributes ion.name |
Chaîne |
Chemin d’accès au nom complet de la sélection d’objets active. |
selection.overlapping |
Entier |
nombre d’objets de chevauchement dans la sélection actuelle. |
selection.renderable |
Entier |
Nombre d’objets à rendre dans la sélection actuelle. |
selection.texturable |
Entier |
Nombre d’objets de texte dans la sélection actuelle. |
selection.visible |
Entier |
Afficher/masquer l’état actuel de la sélection actuelle. |
selection.zorder |
Entier |
Ordre Z du premier objet de chevauchement dans la sélection actuelle. |
userdata
Renvoie le contenu de vignette::UserData
. Le serveur remplacera toutes les occurrences de '??'
dans vignette::UserData
par des terminateurs de ligne ( <cr><lf>
). La réponse est formatée sous la forme de données texte, le type MIME de la réponse étant défini sur <text/plain>.
Si l’objet spécifié dans le chemin d’accès de l’URL ne correspond pas à une entrée de mappage de vignettes valide ou si vignette::UserData
est vide, la réponse contient uniquement un terminateur de ligne ( CR/LF
).
Toutes les autres commandes de la chaîne de requête sont ignorées.
Commande Request. Peut se produire n’importe où dans la chaîne de requête.
Si l’URL n’inclut pas de chemin d’accès à l’image ou de modificateurs, alors :
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.
Sinon, req=img
fmt= , attribut::ErrorImagePath, vignette::UserData, propriétés