Altro

SlideShow

SlideShow è un applet Java che permette di visualizzare una sequenza di immagini all'interno di una pagina web, come accade ad esempio in questa pagina. Per il download di questa applet e la sua configurazione, seguire le seguenti istruzioni.

Indice

1. Come funziona
2. Preparazione delle immagini
3. Preparazione dello slide-list file
4. Preparazione della pagina web
5. Configurazione dei parametri dell'applet
6. Download
7. Licenza d'uso
8. Contatti
9. Dati tecnici

1. Come funziona

Vediamo innanzi tutto quali sono gli elementi che entrano in gioco per la creazione ed esecuzione di uno slide show. Innanzi tutto c'è l'applet, una piccola applicazione Java che viene invocata da una pagina web. L'applet contiene la logica per scaricare sul browser del visitatore le immagini dello slide show e mostrarle in sequenza. L'applet accetta alcuni parametri di configurazione che permettono di personalizzare alcuni aspetti della sequenza. Il secondo elemento è l'insieme delle immagini che partecipano alla sequenza. Le immagini devono essere presenti sul web server che ospita la pagina web da cui viene invocata l'applet. Il terzo ed ultimo elemento è un file che descrive la sequenza delle immagini, da ora chiamato slide-list file. La sequenza di funzionamento è pressocchè la seguente:

Il visitatore carica la pagina web da cui viene invocata l'applet.
L'applet è automaticamente avviata dal browser.
L'applet legge la propria configurazione, fra cui l'indirizzo dello slide-list file.
L'applet scarica lo slide-list file, da cui legge gli indirizzi delle foto da scaricare e visualizzare.
L'applet scarica le foto e le visualizza in sequenza secondo i parametri di configurazione.

2. Preparazione delle immagini

L'applet può mostrare un qualsiasi numero di immagini. Le immagini possono avere anche dimensioni diverse fra loro poichè l'applet adatta ciascuna immagine allo spazio disponibile per la visualizzazioni. L'adattamento dell'immagine può avvenire in due modi: ridemnsionandala oppure posizionandola opportunamente. Ad ogni modo, per ottenere una sequenza di qualità, il caso ideale è che le immagini abbiano le stesse dimensioni o dimensioni non molto differenti. Le immagini devono essere collocate sullo stesso web server che ospita la pagina web da cui viene invocata l'applet. Il loro indirizzo web (URL) verrà poi riportato nello slide-list file.

3. Preparazione dello slide-list file

Lo slide-list file è un semplice file di testo in cui occorre elencare le informazioni delle immagini che fanno parte della sequenza. Il file ha un formato ben preciso che va rispettato rigorosamente. Il formato è il seguente:

URL immagine 1
URL thumbnail 1
descrizione immagine 1
URL immagine 2
URL thumbnail 2
descrizione immagine 2
...

Ogni immagine occupa tre linee consecutive: nella prima viene indicata l'URL dell'immagine, nella seconda l'URL della thumbnail (una piccola immagine rappresentativa dell'immagine originale) e nella terza la descrizione. Se un'immagine è priva della thumbnail e/o della descrizione le rispettive linee vanno lasciate vuote. Nella versione attuale le thumbnail non sono usate. Ecco un esempio concreto di slide-list file.

http://www.thebananatours.com/other/download/slideshow/images/amsterdam.jpg
http://www.thebananatours.com/other/download/slideshow/images/thumbs/amsterdam.jpg
Amsterdam
http://www.thebananatours.com/other/download/slideshow/images/lisbona.jpg
http://www.thebananatours.com/other/download/slideshow/images/thumbs/lisbona.jpg
Lisbona

Nell'esempio precedente è stata indicata l'URL completa di ciascuna immagine. Allo scopo di evitare la ripetizione inutile dell'indirizzo del sito è possibile omettere quest'ultimo. In questo caso l'applet dedurrà l'indirizzo del sito dall'indirizzo della pagina che invoca l'applet. Seguendo questa convenzione lo slide list file diventa:

/other/download/slideshow/images/amsterdam.jpg
/other/download/slideshow/images/thumbs/amsterdam.jpg
Amsterdam
/other/download/slideshow/images/lisbona.jpg
/other/download/slideshow/images/thumbs/lisbona.jpg
Lisbona

Una ulteriore semplificazione è possibile nel caso in cui le immagini si trovino allo stesso livello della pagina web o ad un livello inferiore. Ad esempio, l'URL di questa pagina è

    http://www.thebananatours.com/other/download/slideshow/index.html

e le immagini mostrate nello slide show si trovano all'URL

    http://www.thebananatours.com/other/download/slideshow/images

che è a un livello inferiore rispetto alla pagina web. In questo caso è possibile indicare solo la parte dell'URL dell'imagine relativa all'URL della pagina web. Seguendo questa convenzione lo slide list file diventa:

images/amsterdam.jpg
images/thumbs/amsterdam.jpg
Amsterdam
images/lisbona.jpg
images/thumbs/lisbona.jpg
Lisbona

4. Preparazione della pagina web

All'interno della pagina web in cui si vuole visualizzare lo slide show occorre inserire il codice HTML che invoca l'applet Java e configura l'applet stessa. Un esempio di codice HTML è il seguente

<applet
    archive="/tools/java/slideshow/slideshow.jar" 
    code="SlideShowApplet.class"
    width="307" 
    height="260">
    <param name="slideListUrl" value="example.txt">
    <param name="slideDelay" value="3">
    <param name="background" value="FFFFFF">
    <param name="foreground" value="0033FF">
    <param name="showSlideArea" value="true">
</applet>

Alcuni dei valori di configurazione dell'applet vanno opportunamente configurati. La seguente tabella mostra il significato di ciascun parametro.

archive	E' l'URL sul web server del file slideshow.jar che contiene l'applet Java. Questo file deve essere scaricato da questo sito e copiato sul proprio web server in una locazione a piacere (ad esempio /tools/java/slideshow). La URL completa da assegnare ad archive sarà la locazione dove è stato copiato il file seguito dal nome del file (ad esempio /tools/java/slideshow/slideshow.jar).
code	E' il nome della classe Java che contiene l'implementazione della classe Java java.applet.Applet. Questa impostazione non può essere modificata e deve sempre essere code="SlideShowApplet.class"
width	E' la larghezza in pixel dell'area grafica della pagina web in cui l'applet visualizzerà le immagini.
heigth	E' l'altezza in pixel dell'area grafica della pagina web in cui l'applet visualizzerà le immagini. Nel caso in cui sia attivata la visualizzazione della bar di avanzamento e delle descrizioni delle immagini, occorre tenere in conto che 30 pixel di height verranno sottratti all'area di visualizzazione delle immagini. Ad esempio, se si desidera riservare 200 pixel per le immagini e si vuole visualizzare le descrizioni (30 pixel) occorrerà impostare height uguale a 200 + 30 = 230 pixel.
param	I tag param consentono di specificare alcuni parametri di configurazione dell'applet. Essi hanno come attributi il name che rappresenta il nome del parametro configurativo e value che è l'effetivo valore del parametro configurativo. Ad esempio, per impostare il tempo di visualizzazione in secondi di ogni immagine (slideDelay) di tre secondi: <param name="slideDelay" value="3"> Una completa descrizione di tutti i parametri di configurazione verrà data nell'apposita sezione.

5. Configurazione dei parametri dell'applet

Tramite i tag param è possibile specificare alcuni parametri di configurazione che permettono di personalizzare la sequenza delle immagini. I parametri possono essere obbligatori o opzionali. Nel primo caso se non specificati oppure specificati in modo non corretto, l'applet potrebbe non funzionare. Nel secondo caso i parametri possono non essere specificati ed in tal caso verrà usato un valore di default. Alcuni parametri possono accettare solo un particolare insieme di valori, altri devono rispettare una particolare sintassi. Per ciascun parametro viene data un'ampia descrizione nella seguente tabella.

slideListUrl	Obbligatorio E' l'URL sul web server dello slide-list file. Anche per questa URL valgono le stesse regole di abbrevazione indicate per le URL delle immagini dello slide-list file. Lo slide-list file deve essere sullo stesso web server che ospita la pagina web.
slideDelay	Opzionale, default="3" E' il tempo di visualizzazione in secondi di ogni immagine.
background	Opzionale, default="000000" E' la rappresentazione RGB esadecimale del colore da utilizzare come sfondo dell'area grafica dell'applet. Il valore di default è il nero ("000000").
foreground	Opzionale, default="FFFFFF" E' la rappresentazione RGB esadecimale del colore da utilizzare come primo-piano dell'area grafica dell'applet. Il valore di default è il bianco ("FFFFFF").
bestFit	Opzionale, default="false", valori="true","false" Indica l'operazione da applicare nel caso in cui l'immagine abbia almeno una dimensione (altezza e/o larghezza) maggiore dell'area grafica dell'applet. Se bestFit è impostato a "true", qualora sia necessario, le immagini verranno ridotte quanto basta per entrare nell'area grafica dell'applet. La riduzione avviene in scala nel senso che il rapporto fra l'altezza e la larghezza dell'immagine resta costante. Se bestFit è impostato a "false", le immagini non verranno ridotte ma semplicemente centrate rispetto all'area grafica. Le parti eccedenti della foto non verranno visualizzate.
showStatusArea	Opzionale, default="true", valori="true","false" Indica se mostrare o no la status-area cioè l'area dove vengono visualizzati la bar di avanzamento delle immagini e la loro descrizione. Se showStatusArea viene impostato a "true" allora la status-area viene visualizzata ed occupa 30 pixel dell'altezza dell'area grafica dell'applet.
trace	Opzionale, default="false", valori="true","false" Abilita o disabilita le tracce di diagnostica dell'applet che vengono visualizzate nella Java Console del browser.

6. Download

Clicca su questo link per scaricare l'Applet jar-file.

7. Licenza d'uso

L'applicazione SlideShow può essere usata per fini non commerciali secondo le condizioni stabilite dalla Creative Commons Attribution-NonCommercial-ShareAlike 2.0 Italy License.

8. Contatti

Per ogni suggerimento, problema o idea per il miglioramento di questa applicazione è possibile inviare una email all'indirizzo di posta elettronica postmaster@thebananatours.com.

9. Dati tecnici

versione applet	1.2.3
data rilascio	10 gennaio 2006
versione compilatore Java	Java 2 SDK, Standard Edition 1.4.2_10
piattaforme verificate	Windows XP, Firefox 1.5, Sun JRE 1.4.2_10 Windows XP, Internet Explorer 6.0, Sun JRE 1.4.2_10 Linux Suse 9, Firefox 1.0, Sun JRE 1.5.0_06
modifiche	[SS003] Inserimento del supporto delle thumbnail nello slide-show file. Inserita nella versione 1.2.3.
problemi noti	[SS002] In caso di errore fatale l'applet Java non segnala la causa dell'errore nell'area grafica, ma esclusivamente nelle tracce. Trovato nella versione 1.2.1.
problemi risolti	[SS001] L'applet Java non legge lo slide-list file se la pagina web è aperta localmente utilizzando il protocollo file. Trovato nella versione 1.2.1. Risolto nella versione 1.2.2.