Progetto di Elaborazione delle Immagini

1.0

Note generali sul progetto

Il seguente progetto e` stato realizzato per il corso di Elaborazione delle Immagini, presso l'Universita` degli Studi di Padova, da Andrea Burattin.

Realizzazione del progetto

Il progetto e` stato realizzato con il linguaggio C++, per elevare al massimo l'efficenza in fase di esecuzione. E` stato realizzato su piattaforma Linux, per in compilatore C++ della famiglia GCC (G++), tuttavia non e` stata inclusa alcuna direttiva dipendente dal sistema operativo o dal compilatore. Dovrebbe quindi essere possibile compilare ed eseguire correttamente il progetto su qualsiasi piattaforma, semplicemente inserendo il nome corretto del compilatore all'interno del file Makefile.

Norme di realizzazione

Il codice e` stato scritte inserendo due tipologie di commenti: commenti destinati a comparire nella documentazione generata, e commenti interni. Tutti i commenti destinati alla documentazione esterna, ad eccezione di questo che si sta leggendo, sono stati scritti in lingua inglese; viceversa, i commenti interni sono stati scritti in italiano per semplificarne la lettura e la realizzazione.

Formati di immagini supportati

Il progetto, sia in input che in output supporta i seguenti formati:

• RAW: da intendersi come un semplice dump binario dell'immagine;
• TGA: Truevision TGA, formato facilmente visualizzabile da molti viewer;
• SCI: Simply Compressed Image, ovvero il formato definito appositamente per questo progetto, che contiene l'immagine compressa e tutte le informazioni necessarie per la sua ricostruzione (altezza, larghezza, dimensione del blocco e fattore di compressione).

Esempio di esecuzione del programma

Il programma puo` essere compilato dalla linea di comando tramite l'applicazione make. Ecco un esempio di output dato dalla compilazione:

$ make
[CC] obj/main
[CC] obj/image
[CC] obj/exceptions
[CC] obj/generalException
[CC] obj/utils
[CC] obj/dct
[CC] obj/pixel
[CC] obj/quantization
[CC] obj/compression
[LD] progetto
$ 

Per generare questa documentazione, invece, si deve aggiungere il parametro documentation al comando precedente:

$ make documentation 
Cleaning old doc dir...
Building new documentation...
Done!
$ 

Un esempio di invocazione destinata alla compressione di una immagine di tipo RAW e` il seguente:

$ ./progetto -it raw -bpp 3 -w 400 -h 300 -q 90 -bs 8 img/F1-400x300RGB.raw output.sci
Caricamento del file in corso... completato!
Si sta per comprimere l'immagine, ecco un riassunto dei parametri:
(si ricorda che, se non sono stati specificati, verranno usati i valori di 
default: 8 per la dimensione del blocco e 85
per il fattore di compressione)

 - dimensione del blocco: 8
 - qualita` finale: 90

Compressione in corso... completata!
$ 

Questo comando legge l'immagine img/F1-400x300RGB.raw e la comprime, salvandone l'output in output.sci. Per una descrizione approfondita di tutti i parametri dell'applicazione si puo` usare:

$ ./progetto --help