Tipo di richiesta. Specifica il tipo di dati richiesti.
req=debug|contents|img|imageprops|map|object|props|userdata|validate
debug |
Eseguire i comandi in modalità debug. |
contents |
Restituisce informazioni sugli oggetti nella vignettatura. |
img |
Eseguite i comandi e restituite l’immagine di cui è stato effettuato il rendering. |
imageprop |
Restituisce le proprietà della vignettatura specificata. |
map |
Restituisce i dati della mappa immagine incorporati nella vignettatura. |
object |
Eseguire i comandi e restituire l'immagine di cui è stato eseguito il rendering mascherata alla selezione oggetto corrente. |
prop |
Eseguire i comandi e le proprietà di ritorno dell'immagine di risposta. |
userdata |
Restituisce il contenuto della vignettatura ::UserData . |
Se non diversamente indicato nelle descrizioni dettagliate, il server restituisce risposte testuali con tipo MIME <text/plain>.
debug
Esegue i comandi specificati e restituisce l'immagine di cui è stato effettuato il rendering. Se si verifica un errore, vengono restituite informazioni di errore e debug invece dell'immagine di errore ( attribute::ErrorImagePath
).
contents
Restituisce una rappresentazione XML della gerarchia di oggetti nella vignettatura, inclusi gli attributi oggetto selezionati. Altri comandi nella richiesta vengono ignorati.
img
Esegue i comandi specificati e restituisce l'immagine di cui è stato effettuato 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 specificate nel percorso URL. Per una descrizione della sintassi di risposta e del tipo MIME di risposta, vedere Properties. Altri comandi nella richiesta vengono ignorati. Vengono restituite le seguenti proprietà:
Proprietà |
Tipo |
Descrizione |
---|---|---|
image.expires |
Doppio |
attribute::Scadenza o durata predefinita. |
image.height |
Intero |
Altezza della risoluzione completa in pixel. |
image.iccProfile |
Stringa |
nome/descrizione del profilo associato a questa vignettatura. |
image.embeddedIccProfile |
Booleano |
1 se il profilo associato è incorporato nella vignettatura. |
image.embedded PhotoshopPaths |
Booleano |
1 se la vignettatura incorpora i dati del percorso. |
image.modifier |
Stringa |
attribute::Modificatore o vuoto se non è presente una voce di catalogo. |
image.pixTyp |
Enum |
tipo di pixel dell’immagine di risposta; possono essere 'CMYK', 'RGB' o 'BW' (per le immagini in scala di grigio). |
image.printRes |
Real |
Risoluzione di stampa predefinita in dpi. |
image.timeStamp |
Stringa |
Data/ora di modifica (da catalogo::TimeStamp o dal file di vignettatura). |
image.width |
Intero |
Larghezza ad alta risoluzione in pixel. |
vignette.name |
Stringa |
Nome vignettatura (stringa nome dell'oggetto vignettatura principale). |
vignette.res |
Real |
Risoluzione massima dell'oggetto in unità di risoluzione del materiale (in genere pixel/pollice). |
vignette.res.avg |
Real |
Risoluzione media dell'oggetto in unità di risoluzione del materiale (in genere pixel/inc risoluzione del materiale h). |
vignette.res.min |
Real |
Risoluzione minima dell'oggetto in unità di risoluzione del materiale (in genere pixel/pollice). |
vignette.version |
Intero |
Numero versione del file di vignettatura. |
map
Restituisce i dati della mappa immagine inclusi nella vignettatura. Per impostazione predefinita, vengono restituiti i dati della mappa per tutti i gruppi più esterni. I dati mappa per tutti i gruppi più interni possono essere ottenuti con
req=map&groupLevel=-1
I dati della mappa non vengono ridimensionati in wid=
o hei=
o in altro modo modificati. Il tipo MIME della risposta è <text/xml>
.
I dati di risposta sono costituiti da un elemento <map>
contenente un set di elementi <area>
, simile al tag HTML <AREA>
.
Ogni elemento <area>
include gli attributi standard type=
e coord=
, nonché un attributo name=
, che specifica il nome o il percorso del gruppo di vignettature. Se le maschere del gruppo di oggetti corrispondente hanno aree non continue, saranno presenti più elementi <area>
con lo stesso nome.
Oltre agli attributi predefiniti, le vignettature possono definire attributi aggiuntivi, se lo si desidera. Tali attributi personalizzati sono definiti come attributi del gruppo di oggetti. I nomi degli attributi personalizzati devono iniziare con map
. da includere negli elementi <area>
. Ad esempio, se gli attributi del gruppo includono map.href=http://www.scene7.com
, l’elemento <area>
corrispondente includerà href="http://www.scene7.com"
.
Se la vignettatura non include i dati della mappa, viene restituito un documento XML con un elemento <map>
vuoto.
object
Esegue i comandi specificati e restituisce l'immagine sottoposta a rendering mascherata dalla selezione dell'oggetto residuo (il gruppo o l'oggetto selezionato con l'ultimo comando sel=
o obj=
nella richiesta). Generalmente utilizzato insieme a un formato immagine che supporta l'alfa (vedere fmt=). Se viene utilizzato un formato immagine che non supporta l'alfa, le aree esterne alla maschera sono nere.
props
Esegue i comandi specificati e restituisce le proprietà della vignettatura e le proprietà del gruppo o dell'oggetto, anziché l'immagine di cui è stato eseguito il rendering. Per una descrizione della sintassi di risposta e del tipo MIME di risposta, vedere Properties. La selezione predefinita si applica a meno che non sia specificato anche obj=
o sel=
(vedere obj=
).
Nella risposta possono essere incluse le seguenti proprietà:
Proprietà |
Tipo |
Descrizione |
---|---|---|
image.bgc |
Stringa |
Rispondi al colore di sfondo dell’immagine. |
image.height |
Intero |
Rispondi all’altezza dell’immagine in pixel. |
image.iccEmbed |
Booleano |
True se il profilo ICC verrà incorporato nell'immagine di risposta (vedere iccEmbed= ). |
image.iccProfile |
Stringa |
Nome del collegamento del profilo associato all'immagine di risposta (vedere icc= ). |
image.mask |
Booleano |
True se l'immagine di risposta include l'alfa. |
image.pathEmbed |
Booleano |
True se l'immagine di risposta include i dati del percorso (vedere pathEmbed= ). |
image.pixTyp |
Stringa |
Rispondi al tipo di immagine, può essere 'CMYK', 'RGB' o 'BW' (per le immagini in scala di grigio) |
image.printRes |
Real |
Risoluzione di stampa (dpi) |
image.quality |
Integer, boolean |
Contrassegno di qualità JPEG e crominanza (vedere qlt= ) |
image.type |
Stringa |
Mime type per l'immagine di risposta (vedere fmt= ). |
image.width |
Intero |
Rispondi alla larghezza dell’immagine in pixel. |
selection.attribute |
Stringa |
Stringa Attributi per la selezione corrente. |
selection.count |
Intero |
Numero di oggetti nella selezione corrente. |
selection.ident |
Intero |
Rientra il valore della selezione corrente. |
select selection.attribute ion.name |
Stringa |
Percorso del nome completo della selezione dell'oggetto corrente. |
selection.sovrapposizione |
Intero |
numero di oggetti di sovrapposizione nella selezione corrente. |
selection.rendeable |
Intero |
Numero di oggetti di rendering nella selezione corrente. |
selection.texturable |
Intero |
Numero di oggetti con texture nella selezione corrente. |
selection.visible |
Intero |
Mostra/nascondi lo stato corrente della selezione corrente. |
selection.zorder |
Intero |
Valore ordine Z del primo oggetto di sovrapposizione nella selezione corrente. |
userdata
Restituisce il contenuto di vignette::UserData
. Il server sostituirà 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 della risposta impostato su <text/plain>.
Se l'oggetto specificato nel percorso dell'URL non viene risolto in una voce di mappa di vignettatura valida, o se l' vignette::UserData
è vuoto, la risposta conterrà solo un terminatore di riga ( CR/LF
).
Tutti gli altri comandi nella stringa di richiesta vengono ignorati.
Richiedi, comando. Può verificarsi in qualsiasi punto della stringa di richiesta.
Se l’URL non include un percorso immagine o modificatori, allora:
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.
In caso contrario, req=img
fmt= , attributo::ErrorImagePath, vignettatura::UserData, Properties