Tipo di richiesta. Specifica il tipo di dati richiesti.
req=debug|contents|img|imageprops|map|object|props|userdata|validate
debug |
Esegui comandi in modalità debug. |
sommario |
Restituire informazioni sugli oggetti nella vignettatura. |
img |
Esegui i comandi e restituisce l’immagine di cui è stato eseguito il rendering. |
imageprops |
Restituisce le proprietà della vignettatura specificata. |
mappa |
Restituisce i dati della mappa immagine incorporati nella vignettatura. |
oggetto |
Esegui i comandi e restituisce l'immagine di cui è stato eseguito il rendering mascherata alla selezione dell'oggetto corrente. |
prop |
Esegui i comandi e restituisce le proprietà dell'immagine di risposta. |
userdata |
Restituisce il contenuto di vignettatura::DatiUtente . |
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 errore e debug 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. Consulta Proprietà per una descrizione della sintassi di risposta e del tipo MIME di risposta. Altri comandi nella richiesta vengono ignorati. Vengono restituite le seguenti proprietà:
Proprietà |
Tipo |
Descrizione |
---|---|---|
image.expiration |
Doppio |
attribute::Scadenza o il valore predefinito time to live. |
image.height |
Intero |
Altezza massima risoluzione in pixel. |
image.iccProfile |
Stringa |
nome/descrizione del profilo associato a questa vignettatura. |
image.embeddedIccProfile |
Booleano |
1 se il profilo associato è incorporato nella vignetta. |
image.embedded PhotoshopPaths |
Booleano |
1 se la vignettatura incorpora i dati del percorso. |
image.modifier |
Stringa |
attribute::Modificatore o vuoto se non è una voce di catalogo. |
image.pixType |
Enum |
Tipo di pixel dell’immagine di risposta; può essere "CMYK", "RGB" o "BW" (per immagini in scala di grigio). |
image.printRes |
Reale |
Risoluzione di stampa predefinita in dpi. |
image.timeStamp |
Stringa |
Data/ora di modifica (da catalogo::Timestamp o il file di vignettatura). |
image.width |
Intero |
Larghezza a risoluzione massima in pixel. |
vignette.name |
Stringa |
Nome vignettatura (stringa di nome dell'oggetto vignettatura principale). |
vignettatura.res |
Reale |
Risoluzione massima oggetto in risoluzione del materiale (in genere pixel/pollice). |
vignette.res.avg |
Reale |
Risoluzione media dell'oggetto in risoluzione del materiale (in genere pixel/pollici) risoluzione del materiale h). |
vignettatura.res.min |
Reale |
Risoluzione minima dell'oggetto in risoluzione del materiale (in genere pixel/pollice). |
vignette.version |
Intero |
Numero di versione del file di vignettatura. |
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 scalati in wid=
o hei=
o altrimenti modificato. Il tipo MIME di risposta è <text/xml>
.
I dati di risposta sono costituiti da <map>
elemento contenente un set di <area>
elementi, simili al HTML <AREA>
tag.
Ogni <area>
L'elemento include lo standard type=
e coord=
attributi e un name=
specifica il nome o il percorso del nome del gruppo di vignettatura. Più <area>
gli elementi con lo stesso nome sono presenti se le maschere del gruppo di oggetti corrispondente presentano aree discontinue.
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
da includere nel <area>
elementi. Ad esempio, se gli attributi del gruppo includono map.href=http://www.scene7.com
, il corrispondente <area>
l’elemento include href="http://www.scene7.com"
.
Documento XML con un valore vuoto <map>
L'elemento viene restituito se la vignettatura non include i dati della mappa.
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 sel=
o obj=
nella richiesta). Generalmente utilizzato con un formato di immagine che supporta il formato alfa (vedi 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. Consulta Proprietà per una descrizione della sintassi di risposta e del tipo MIME di risposta. La selezione predefinita viene applicata a meno che obj=
o sel=
viene specificato (vedere obj=
).
Le seguenti proprietà possono essere incluse nella risposta:
Proprietà |
Tipo |
Descrizione |
---|---|---|
image.bgc |
Stringa |
Colore di sfondo immagine di risposta. |
image.height |
Intero |
Altezza immagine di risposta in pixel. |
image.iccEmbed |
Booleano |
True se il profilo ICC è incorporato nell'immagine di risposta (vedere iccEmbed= ). |
image.iccProfile |
Stringa |
Nome del collegamento del profilo associato all’immagine di risposta (consulta icc= ). |
image.mask |
Booleano |
True se l'immagine di risposta include il formato alfa. |
image.pathEmbed |
Booleano |
True se l'immagine di risposta include i dati del percorso (vedere pathEmbed= percorso ). |
image.pixType |
Stringa |
Tipo di immagine di risposta, che può essere "CMYK", "RGB" o "BW" (per immagini in scala di grigio) |
image.printRes |
Reale |
Risoluzione di stampa (dpi) |
image.quality |
Intero, booleano |
qualità JPEG e flag chroma (vedere qlt= ) |
image.type |
Stringa |
Tipo MIME per l’immagine di risposta (vedi fmt= ). |
image.width |
Intero |
Larghezza immagine di risposta in pixel. |
selection.attributes |
Stringa |
Stringa di attributi per la selezione corrente. |
selection.count |
Intero |
Numero di oggetti nella selezione corrente. |
selection.ident |
Intero |
Valore del rientro della selezione corrente. |
seleziona selection.attributes ion.name |
Stringa |
Percorso del nome completo della selezione oggetto corrente. |
selection.overlapping |
Intero |
numero di oggetti sovrapposti nella selezione corrente. |
selection.renderable |
Intero |
Numero di oggetti renderizzabili nella selezione corrente. |
selection.texturable |
Intero |
Numero di oggetti texturable nella selezione corrente. |
selection.visible |
Intero |
Stato corrente per mostrare/nascondere la 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 sostituisce tutte le occorrenze di '??'
in vignette::UserData
con 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 conterrà solo un terminatore di riga ( CR/LF
).
Qualsiasi altro comando nella stringa di richiesta viene ignorato.
Comando di richiesta. Può verificarsi ovunque nella stringa di richiesta.
Se l’URL non include uno o più modificatori di immagine, effettua le seguenti operazioni:
#S7Z OK
#Mon Aug 18 17:28:32 PDT 2014
copyright=Copyright (c) 1995-2014 Adobe Systems Incorporated. All rights reserved.
Altrimenti, req=img
fmt= , attribute::ErrorImagePath, vignettatura::DatiUtente, Proprietà