DocumentationAPI de diffusion et de rendu d’images Dynamic Media

Req req

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

Type de demande. Spécifie 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 figurant dans le fichier vignette
img
Exécuter des commandes et renvoyer 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 le vignette.
objet
Exécuter les commandes et renvoyer l’image rendue masquée à la sélection d’objet en cours.
accessoires
Commandes d’exécution et propriétés de renvoi de l’image de réponse.
Données utilisateur
Renvoie le contenu de vignette ::UserData .

Sauf indication contraire dans les descriptions détaillées, le serveur renvoie des réponses textuelles de type MIME <text lain="">.</text>

debug

Exécute les commandes spécifiées et renvoie l’image rendue. Si une erreur survient, 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 et le type de données 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ées dans le chemin d’URL. Voir Propriétés pour obtenir 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
Double
attribute ::Expiration ou la durée de vie par défaut.
image.height
Entier
Hauteur pleine résolution en pixels.
image.iccProfile
Chaîne
Nom/description du profil associé à cette vignette.
image.embeddedIccProfile
Boolean
1 si le profil associé est incorporé dans le fichier vignette ;
PhotoshopPaths image.embedded
Boolean
1 si la vignette inclut des données de chemin.
Modificateur d’image.
Chaîne
attribute ::Modifier ou vide s’il ne s’agit pas d’une entrée de catalogue.
image.pixTyp
Enum
Type de pixels de l’image de réponse ; peut être « CMJN », « RVB » ou « BW » (pour les images en niveaux de gris).
image.printRes
Réel
Résolution d’impression par défaut en ppp.
image.timeStamp
Chaîne
Date/heure de modification (à partir de catalog ::TimeStamp ou du fichier de vignette ).
image.width
Entier
Largeur pleine résolution en pixels.
vignette.name
Chaîne
Nom de la vignette (chaîne de nom de l’objet vignette racine).
vignette.res
Réel
Résolution maximale de l’objet en unités de résolutionde matériau (généralement pixels/pouce).
vignette.res.avg
Réel
Résolution moyenne de l’objet en unités de résolutionde matériau (généralement pixels/résolution de matériauh).
vignette.res.min
Réel
Résolution minimale de l’objet en unités de résolutionde matériau (généralement pixels/pouce).
vignette.version
Entier
Numéro de version du fichier vignette.

map

Renvoie les données de zone cliquable incluses dans la vignette. Par défaut, les données cartographiques de tous les groupes périphériques sont renvoyées. Les données cartographiques pour tous les groupes les plus internes peuvent être obtenues en utilisant

req=map&groupLevel=-1

Les données cartographiques ne sont ni mises à l’échelle ni wid= modifiées d’une hei= autre manière. Le type MIME de réponse est <text/xml>.

Les données de réponse sont constituées d’un <map> élément contenant un ensemble d’éléments <area> , similaire à la balise HTML <AREA> .

Chaque <area> élément inclut la norme type= et coord= les attributs, ainsi qu’un attribut, spécifiant le nom du groupe de vignettes ou le chemin d’accès name= au nom. Plusieurs <area> éléments portant le même nom sont présents si les masques du groupe d’objets correspondant ont des régions discontinues.

Outre les attributs par défaut, les vignettes peuvent définir des attributs supplémentaires, le cas échéant. Ces attributs personnalisés sont définis en tant qu’attributs de groupe d’objets. Les noms des attributs personnalisés doivent commencer par map pour être inclus dans les <area> éléments. Par exemple, si les attributs de groupe incluent map.href=http://www.scene7.com, l’élément correspondant <area> inclut href="http://www.scene7.com".

Un document XML avec un élément vide <map> est renvoyé si la vignette n’inclut pas de données cartographiques.

object

Exécute les commandes spécifiées et renvoie l’image rendue masquée par la sélection d’objet résiduel (le groupe ou l’objet sélectionné avec la dernière commande ou sel= la dernière obj= commande dans la requête). Généralement utilisé avec un format d’image prenant en charge alpha (voir fmt=). Si un format d’image ne prenant pas en charge l’alpha est utilisé, les zones à l’extérieur du masque sont noires.

props

Exécute les commandes spécifiées et renvoie les propriétés de vignette et les propriétés de groupe ou d’objet, plutôt que l’image rendue. Voir Propriétés pour obtenir une description de la syntaxe de réponse et du type MIME de réponse. La sélection par défaut s’applique sauf indication obj= sel= contraire (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 est incorporé dans l’image de réponse (voir iccEmbed= ).
image.iccProfile
Chaîne
Nom du raccourci du profil associé à l’image de réponse (voir icc= ).
image.mask
Boolean
True si l’image de réponse inclut une valeur alpha.
image.pathEmbed
Boolean
Valeur True si l’image de réponse comprend des données de chemin (voir pathEmbed= ).
image.pixTyp
Chaîne
Type d’image de réponse, peut être « CMJN », « RVB » ou « BW » (pour les images en niveaux de gris)
image.printRes
Réel
Résolution d’impression (ppp)
image.quality
Nombre entier, booléen
Qualité JPEG et drapeau chromatique (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.
selection.ident
Entier
Met la valeur de la sélection actuelle.
Sélectionnez selection.attributes , ion.name
Chaîne
Nom complet de la sélection de l’objet sélectionné.
selection.overlapping
Entier
Nombre d’objets de chevauchement dans la sélection actuelle.
selection.renderable
Entier
Nombre d’objets pouvant faire l’objet d’un rendu dans la sélection actuelle.
selection.texturable
Entier
Nombre d’objets texturables dans la sélection actuelle.
selection.visible
Entier
Affichage/masquage actuel de l’état de la sélection actuelle.
selection.zorder
Entier
Valeur d’ordre Z du premier objet de chevauchement de la sélection actuelle.

userdata

Renvoie le contenu de vignette::UserData. Le serveur remplace toutes les occurrences de par '??' des terminateurs de vignette::UserData ligne ( <cr><lf>). La réponse est sous forme de données texte avec le type MIME de réponse défini sur <text lain="">.</text>

Si l’objet spécifié dans le chemin d’accès à l’URL n’est pas résolu en tant qu’entrée de mappage de vignette valide, ou si le champ 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.

Propriétés section-e44092e190ff4f6380583e8ed6ea5b0b

Commande Request. Peut se produire n’importe où dans la chaîne de requête.

Par défaut section-00c593cbf1af4364b6b78812e6b93c64

Si l’URL n’inclut pas de chemin d’accès ou de modificateurs d’image, alors :

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

Autrement req=img

Voir aussi section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt= , attribute ::ErrorImagePath, vignette ::UserData, Propriétés

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49