Req

Dernière mise à jour : 15 août 2025
  • 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éboguerExécutez les commandes en mode débogage.
contenuRenvoie des informations sur les objets figurant dans le fichier vignette
imgExécuter des commandes et renvoyer l’image rendue.
imagepropsRenvoie les propriétés de la vignette spécifiée.
carteRenvoie les données de zone cliquable incorporées dans le vignette.
objetExécuter les commandes et renvoyer l’image rendue masquée à la sélection d’objet en cours.
accessoiresCommandes d’exécution et propriétés de renvoi de l’image de réponse.
Données utilisateurRenvoie 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éTypeDescription
image.expirationDoubleattribute ::Expiration ou la durée de vie par défaut.
image.heightEntierHauteur pleine résolution en pixels.
image.iccProfileChaîneNom/description du profil associé à cette vignette.
image.embeddedIccProfileBoolean1 si le profil associé est incorporé dans le fichier vignette ;
PhotoshopPaths image.embeddedBoolean1 si la vignette inclut des données de chemin.
Modificateur d’image.Chaîneattribute ::Modifier ou vide s’il ne s’agit pas d’une entrée de catalogue.
image.pixTypEnumType de pixels de l’image de réponse ; peut être « CMJN », « RVB » ou « BW » (pour les images en niveaux de gris).
image.printResRéelRésolution d’impression par défaut en ppp.
image.timeStampChaîneDate/heure de modification (à partir de catalog ::TimeStamp ou du fichier de vignette ).
image.widthEntierLargeur pleine résolution en pixels.
vignette.nameChaîneNom de la vignette (chaîne de nom de l’objet vignette racine).
vignette.resRéelRésolution maximale de l’objet en unités de résolutionde matériau (généralement pixels/pouce).
vignette.res.avgRéelRésolution moyenne de l’objet en unités de résolutionde matériau (généralement pixels/résolution de matériauh).
vignette.res.minRéelRésolution minimale de l’objet en unités de résolutionde matériau (généralement pixels/pouce).
vignette.versionEntierNumé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éTypeDescription
image.bgcChaîneCouleur d’arrière-plan de l’image de réponse.
image.heightEntierHauteur de l’image de réponse en pixels.
image.iccEmbedBooleanTrue si le profil ICC est incorporé dans l’image de réponse (voir iccEmbed= ).
image.iccProfileChaîneNom du raccourci du profil associé à l’image de réponse (voir icc= ).
image.maskBooleanTrue si l’image de réponse inclut une valeur alpha.
image.pathEmbedBooleanValeur True si l’image de réponse comprend des données de chemin (voir pathEmbed= ).
image.pixTypChaîneType d’image de réponse, peut être « CMJN », « RVB » ou « BW » (pour les images en niveaux de gris)
image.printResRéelRésolution d’impression (ppp)
image.qualityNombre entier, booléenQualité JPEG et drapeau chromatique (voir qlt= )
image.typeChaîneType Mime pour l’image de réponse (voir fmt= ).
image.widthEntierLargeur de l’image de réponse en pixels.
selection.attributesChaîneChaîne d’attributs pour la sélection actuelle.
selection.countEntierNombre d’objets dans la sélection actuelle.
selection.identEntierMet la valeur de la sélection actuelle.
Sélectionnez selection.attributes , ion.nameChaîneNom complet de la sélection de l’objet sélectionné.
selection.overlappingEntierNombre d’objets de chevauchement dans la sélection actuelle.
selection.renderableEntierNombre d’objets pouvant faire l’objet d’un rendu dans la sélection actuelle.
selection.texturableEntierNombre d’objets texturables dans la sélection actuelle.
selection.visibleEntierAffichage/masquage actuel de l’état de la sélection actuelle.
selection.zorderEntierValeur 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.