req

Tipo di richiesta. Specifica il tipo di dati richiesti.

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

Se non diversamente indicato nelle descrizioni dettagliate, il server restituisce risposte di testo con tipo MIME <text/plain>.

debug

Esegue i comandi specificati e restituisce l'immagine di cui è stato eseguito il rendering. Se si verifica un errore, vengono restituite informazioni di debug e di errore anziché l'immagine di errore ( attribute::ErrorImagePath).

contents

Restituisce una rappresentazione XML della gerarchia degli oggetti nella vignettatura, inclusi gli attributi degli oggetti selezionati. Altri comandi nella richiesta vengono ignorati.

img

Esegue i comandi specificati e restituisce l'immagine di cui è stato eseguito il rendering. Il formato dei dati di risposta e il tipo di risposta sono determinati da fmt=.

imageprops

Restituisce le proprietà selezionate del file di vignettatura o della voce di catalogo specificata nel percorso URL. Per una descrizione della sintassi di risposta e del tipo MIME di risposta, vedere Proprietà. Altri comandi nella richiesta vengono ignorati. Vengono restituite le seguenti proprietà:

map

Restituisce i dati della mappa immagine inclusi nella vignettatura. Per impostazione predefinita, vengono restituiti i dati di mappa per tutti i gruppi più esterni. I dati della mappa per tutti i gruppi più interni possono essere ottenuti con

req=map&groupLevel=-1

I dati della mappa non vengono ridimensionati a wid= o hei= o modificati in altro modo. Il tipo MIME di risposta è <text/xml>.

I dati di risposta sono costituiti da un elemento <map> contenente un set di elementi <area>, simile al tag <AREA> di HTML.

Ogni elemento <area> include gli attributi standard type= e coord= e un attributo name= che specifica il nome o il percorso del nome del gruppo di vignettatura. Se le maschere del gruppo di oggetti corrispondente presentano aree discontinue, sono presenti più elementi <area> con lo stesso nome.

Oltre agli attributi predefiniti, le vignettature possono definire attributi aggiuntivi, se così creati. Tali attributi personalizzati sono definiti come attributi del gruppo di oggetti. I nomi degli attributi personalizzati devono iniziare con map per essere inclusi negli elementi <area>. Ad esempio, se gli attributi del gruppo includono map.href=http://www.scene7.com, l'elemento <area> corrispondente include href="http://www.scene7.com".

Se la vignettatura non include i dati di mapping, viene restituito un documento XML con un elemento <map> vuoto.

object

Esegue i comandi specificati e restituisce l'immagine di rendering mascherata dalla selezione dell'oggetto residuo (il gruppo o l'oggetto selezionato con l'ultimo comando sel= o obj= nella richiesta). In genere viene utilizzato con un formato immagine che supporta alfa (vedere fmt=). Se si utilizza un formato di immagine che non supporta l'alfa, le aree esterne alla maschera sono nere.

props

Esegue i comandi specificati e restituisce le proprietà di vignettatura e le proprietà di gruppo o oggetto, anziché l'immagine di cui è stato eseguito il rendering. Per una descrizione della sintassi di risposta e del tipo MIME di risposta, vedere Proprietà. La selezione predefinita viene applicata a meno che non sia specificato anche obj= o sel= (vedere obj=).

Le seguenti proprietà possono essere incluse nella risposta:

userdata

Restituisce il contenuto di vignette::UserData. Il server sostituisce tutte le occorrenze di '??' in vignette::UserData con i terminatori di riga ( <cr><lf>). La risposta viene formattata come dati di testo con il tipo MIME di risposta impostato su <text/plain>.

Se l'oggetto specificato nel percorso URL non viene risolto in una voce di mappa di vignettatura valida o se vignette::UserData è vuoto, la risposta contiene solo un terminatore di riga ( CR/LF).

Qualsiasi altro comando nella stringa di richiesta viene ignorato.