DocumentationAPI de diffusion et de rendu d’images Dynamic Media

req req

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Utilisateur ou utilisatrice

Type de requête. Indique le type de données demandé.

req=debug|contents|img|imageprops|map|object|props|userdata|validate

debug
Exécutez les commandes en mode de débogage.
contents
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.
map
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’objet 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 textuelles avec le 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 au lieu 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 à 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
Double
attribute::Expiration ou heure d’activation par défaut.
image.height
Entier
Hauteur totale de 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 la vignette.
image.embedded PhotoshopPaths
Boolean
1 si la vignette incorpore les données de chemin.
image.modifier
Chaîne
attribute::Modificateur ou vide s’il ne s’agit pas d’une entrée de catalogue.
image.pixType
Enum
Type de pixel de l’image de réponse ; peut être "CMJN", "RGB" 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 de la résolution totale en pixels.
vignette.name
Chaîne
Nom de la vignette (chaîne de nom de l’objet de vignette racine).
vignette.res
Réel
Résolution maximale de l’objet en unités de résolution(généralement pixels/pouce).
vignette.res.avg
Réel
Résolution moyenne de l’objet en unités de résolution de matériau(généralement pixels/inc résolution de matériauh).
vignette.res.min
Réel
Résolution minimale de l’objet en unités de résolution de matériau(généralement 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 de réponse MIME 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 d’HTML <AREA>.

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

En plus des 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 pour être inclus 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’objet résiduelle (le groupe ou l’objet sélectionné avec la dernière commande sel= ou obj= dans la requête). Généralement 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 situées à 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 Properties pour obtenir une description de la syntaxe de la réponse et du type MIME de la réponse. La sélection par défaut s’applique sauf si obj= ou sel= est é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 de fond 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 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 inclut des données de chemin d’accès (voir pathEmbed=).
image.pixType
Chaîne
Type d’image de réponse, peut être "CMJN", "RGB" ou "BW" (pour les images en niveaux de gris)
image.printRes
Réel
Résolution d’impression (ppp)
image.quality
Entier, booléen
Qualité du JPEG et indicateur chromatique (voir qlt=)
image.type
Chaîne
Type MIME de 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
Valeur de retrait de la sélection actuelle.
select selection.attributes ion.name
Chaîne
Chemin d’accès complet au nom de la sélection d’objet active.
selection.recouvrement
Entier
nombre d’objets de chevauchement dans la sélection actuelle.
selection.renderable
Entier
Nombre d’objets de rendu dans la sélection actuelle.
selection.texturable
Entier
Nombre d’objets texturables dans la sélection actuelle.
selection.visible
Entier
Etat d’affichage/de masquage actuel de la sélection actuelle.
selection.zorder
Entier
Valeur d’ordre réduit du premier objet de chevauchement dans la sélection actuelle.

userdata

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

Si l’objet spécifié dans le chemin d’URL ne se résout pas en une entrée de vignette map 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.

Propriétés section-e44092e190ff4f6380583e8ed6ea5b0b

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

Par défaut section-00c593cbf1af4364b6b78812e6b93c64

Si l’URL ne contient pas de chemin d’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

Voir aussi section-f7a955525fb44ef2ae7cd7ede25a96c3

fmt= , attribute::ErrorImagePath, vignette::UserData, Properties

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