Il tool permette di catturare immagini da dispositivi di acquisizione video in modo automatico e di renderle disponibili su web organizzando anche una galleria di immagini. Sono disponibili un gran numero di opzioni per facilitare la personalizzazione delle caratteristiche principali di acquiszione, processazione delle immagini catturate e di generazione della galleria e delle anteprime (thumbnails). Il caricamento on-line (su dominio) avviene tramite ftp (file transfer protocol).

Nella parte inferiore della finestra sono visualizzate le immagini relative alle ultime quattro operazioni di grab (cattura) dell'immagine del dispositivo video sorgente selezionato. Tali immagini sono mostrate comunque, anche se le operazioni di caricamento sul server FTP non sono andate abuon fine. L'immagine piu' a sinistra è relativa alla cattura più recente. Anche accedendo alle varie pagine di setup (tab pages) le immagini rimangono visibili al fine di verificare lo stato di cattura.

Nella parte superiore sono presenti varie pagine tramite le quali si possono modificare le varie impostazioni dell'applicativo.
Nella prima pagina "Preview" è mostrata l'anteprima (se atiivata) dell'immagine correntemente ripresa dal dispositivo video sorgente.
Tramite il riquadro (groupbox) "Preview" è possibile avviare o interrompere la visualizzazione real-time della ripresa e impostarne la frame rate, ovvero la frequenza con cui l'immagine viene aggiornata. Un aggiornamento particolarmente rapido comporta un maggiore carico di memoria e di tempo di processore CPU. La frequenza massima di aggiornamento reale dipende anche dalla massima frame rate supportata dalla sorgente di acquisizione e/o dal sistema operativo, nonchè naturalmente dalla configurazione hardware della macchina utilizzata.
Quando non viene visualizzata l'anteprima viene fermato il flusso video per risparmiare risorse. Ad esempio ciò avviene se la pagina del tab visualizzata non è quella di preview, oppure se l'applicazione viene minimizzata ad icona.
Nella parte superiore della pagina di "Preview" sono presenti anche i pulsanti "Select source device" e "Select format" che permettono di impostare la sorgente di aquisizione e le sue caratteristiche. Tali proprietà dipendono naturalmente dalle capabilities di tali dispositivi e dei relativi drivers.
Selezionando un formato con risoluzione e profondità di colore elevato si ottengono immagini di maggiore qualità a scapito di una maggiore richiesta di risorse di calcolo e di memoria.

Per la selezione, le regolazioni e lo stream video si utilizza la libreria di sistema "avicap32.dll".
All'avvio dell'applicazione viene selezionato l'ultimo dispositivo di acquisizione selezionato (o un valore di default) anche da altri applicativi che utilizzano tale dll. Si consiglia di verificare che la sorgente video corrisponda a quella scelta ad ogni avvio dell'applicazione. Si ricorda inoltre che non è consentito l'utilizzo della stessa sorgente di acquisizione video da parte di piu' applicativi o da differenti istanze dello stesso. La risorsa è di tipo "esclusivo". E' consentito l'utilizzo contemporaneo da parte di due o piu' applicativi di dispositivi di acquisizione differenti.

Cliccando sul pulsante "Manual grab" viene effettuata la cattura dell'immagine e l'invio al server FTP della stessa e delle immagini della galleria (se abilitata).
L' elaborazione dell'immagine (resize, overlay, etc...) e l'invio tramite FTP avviene lanciando un nuovo thread che opera concorrentemente alla gestione dell'interfaccia dell'applicazione. Per motivi di sicurezza non sono consentiti più thread contemporanei inquanto potrebbero essere causa di problemi di sovraccarico di richieste sul server FTP a cui ci si connette.

La pagina "Img modify" contiene un insieme di opzioni per l'elaborazione delle immagini acquisite (sia in preview che in cattura).
E' possibile impostare un angolo di rotazione di 0,90,180,270 gradi ed un flip (inversione) rispetto agli assi X,Y,XY.
Le caselle di testo numeriche consentono la modifica delle dimensioni finali dell'immagine. Attenzione: per ottenere immagini di qualità e non sprecare inutilmente risorse è consigliato immettere valori uguali o inferiori a quelli impostati nel pannello di preview tramite "Select format". Si consiglia inoltre di mantenere il rapporto tra le dimensioni (largezza ed altezza) inalterato rispetto a quelle scelte per il formato di acquisizione per non visualizzare immagini distorte (allungate o strette).
Le caselle numeriche presenti nel gruppo "Main pic size" permettono di impostare la dimensione dell'immagine principale (default: "webcam.jpg") e delle immagini della galleria ingrandite.
Le caselle numeriche presenti nel gruppo "Thumbnail pic size" permettono di impostare la dimensione dell'immagine secondaria di dimensioni ridotte rispetto a quella principale (default: "webcam_small.jpg") utile, ad esempio per essere visualizzata nel frame del menu del dominio in modo da rendere il caricamento di tale immagine piu' veloce. Tale opzione puo' essere attivata o disattivata a seconda dell'esigenza.
Entrambe le immagini (principale e secondaria, se attivata) sono reperibili (per essere visualizzate da web) nella directory principale selezionata (default: miosito.it/webcam).
Il menu a tendina e la trackbar consentono di selezionare rispettivamente il metodo di ricampionamento in fase di ridimensionamento e la qualità di compressione del' immagine principale e secondaria. La scelta di un valore elevato di qualità (bassa compressione) produce immagini ben definite, in cui sono visibili (compatibilmente con dimensioni e qualità del dispositivo sorgente) anche i dettagli. Tuttavia producono files di dimensioni maggiori piu' onerosi e lenti da caricare e scaricare da web. Il valore di default è 95/100.
Per rendere poco nitide le immagini catturate, o se la connessione ftp è di banda limitata scegliere un valore di qualità piu' basso.
Attenzione: per rendere effettive le modifiche cliccare su "Apply".

La pagina diconfigurazione "Ftp connection" contiene i settaggi dei parametri di connessione FTP.
I parametri devono essere obbligatoriamente inseriti, altrimenti non sarà possibile stabilire la connessione col dominio desiderato.
I parametri di default si riferiscono a puro titolo indicativo ai domini "Aruba" (sicuramente i migliori.....a mio personale avviso)
I parametri "Host", "Username" e "Password" sono forniti da chi offre il servizio di hosting / housing del dominio. Gli altri parametri sono personalizzabili.
Attenzione: eventuali files aventi lo stesso nome di quelli indicati nelle caselle di testo vengono sovrascritti !!!
Se viene attivata la galleria di immagini (vedi in seguito) viene creata una directory "Gallery" nella directory scelta. Si consiglia di non utilizzare tale directory per inserire altri files che potrebbero essere sovrascritti (alcuni nomi dei files di immagini e pagine sono dinamici).
Utilizzate esclusivamente il carattere "/" (e non "\") per indicare una directory. Non utilizzate il carattere "/" finale (es: "miosito.it/webcam" è corretto, "miosito.it/webcam/" non corretto).
Il nome del file non puo' contenere i caratteri riservati : \ / : " * ? > <
Ricordate che in molti casi i nomi di files e cartelle sono case sensitive (distinguono tra maiuscole e minuscole).

Nella pagina "Ftp settings" sono presenti controlli che permettono di impostare l'intervallo che intercorre tra la fine di un'operazione di cattura e di caricamento via FTP e l'inizio di un'altra. Tale funzione è attiva solo se i tasto è di colore verde "enabled".
Attenzione: l'impostazione di eventi dicattura e upload troppo frequenti è spesso causa di "ban" dal server FTP che blocca la connessione qualora la rate richiesta dai client sia troppo elevata (considerata dannosa per il corretto funzionamento del servizio).
Per questo motivo si consiglia di mantenere un intervallo non inferiore a 5 minuti.

Tramite la pagina "Overlay" è possibile definire testo, carattere e posizione di testo e data sovra impressi nelle immagini catturate (anche in preview).
E' possibile definire il testo che risulterà impresso sopra l'immagine, la posizione di partenza e l'offset che consente di modificare i valori di default.
E' possibile definire anche il formato di visualizzazione della data e l'ora e, come per il testo, definirne anche la posizione e l'offset.
Il tipo ed il colore del carattere è definibile tramite la finestra di dialogo del font a cui si puo' accedere clicando sul tasto "Font".
L'overlay di testo e dell'ora / data è attivabile separatamente.

L'applicativo consente di generare e caricare in modo automatico una galleria di immagini consultabile da web.
Tale opzione puo' essere attivata o disattivata tramite il checkbox "Enable".
E' posibile definire il livello di compressione per le anteprime, il numero massimo di immagini consultabili e ogni quanto una nuova immagine della galleria deve essere generata. La casella numerica "Gallery every"..."grabs" indica ogni quante operazioni di cattura deve essere aggiunta una nuova immagine alla galleria.
Ad esempio, scegliendo un intervallo di cattura automatica di 5:00 minuti, e un valore di "Gallery every"..."grabs" pari a 2, sarà aggiunta una nuova immagine alla galleria ogni 10:00 minuti.
La checkbox "Keep all" consente di attivare o disattivare la cancellazione delle immagini dalla galleria, se il numero di immagini presenti supera quello selezionato.
Attenzione: si consiglia di non decrementare il valore se la capacità totale della galleria è stata raggiunta. In questo caso l'applicazione cancella in modo automatico le immagini in "eccesso" iniziando da quelle piu' vecchie.
Le caselle numeriche presenti nel gruppo "Thumbnails" consentono di selezionare le dimensioni delle anteprime.
Nel gruppo "Pages" sono presenti i controlli per impostare il numero di immagini per riga e colonna presenti nelle pagine di visualizzazione delle anteprime.

Nella pagina "Messages" sono mostrati gli ultimi messaggi, compresi quelli di errori e le informazioni utili.
L'ultimo messaggio è mostrato anche sulla barra di stato in modo che possa essere visibile piu' facilmente.

Uso dei templates

Al fine di rendere piu' flessibili e personalizzabili le pagine della galleria si utilizzano due differenti templates (modelli).
I templates sono files di tipo HTML editabili secondo le proprie preferenze (tramite blocco note o editor HTML specifici) che possono contenere qualsiasi codice HTML.
Le immagini (anteprime e immagini principali) vengono inserite in modo dinamico.
L'applicazione inserisce il codice HTML generato dinamicamente in prossimità del commento:

<!-- GalleryMain -->

<!-- GalleryPages -->

rispettivamente per i files di template conenenti le anteprime delle gallerie e delle pagine contenenti le immagini ingrandite.
Cliccando sulle immagini ingrandite la pagina in cui sono visualizzate viene chiusa.

I templates devono avere nome: maintemplate.htm e pagestemplate.htm e sono presenti nella directory locale (rispetto alla directory in cui è contenuto l'applicativo) "Gallery/Templates".

Utilizzo delle pagine generate

La pagina da in di partenza della galleria di immagini è (rispetto alla directory scelta per il dominio) "Gallery/Pages/index.htm".