INSTALL.it.txt di Tux Paint Tux Paint - Un semplice programma di disegno per bambini. Copyright 2005 by Bill Kendrick bill@newbreedsoftware.com http://www.newbreedsoftware.com/tuxpaint/ 27 luglio 2002 - 26 febbraio 2005 Requisiti di sistema: --------------------- Utenti Windows: --------------- La versione di Tux Paint per Widows viene distribuita in formato compatto precompilata e comprensiva di tutte le librerie necessarie al funzionamento (come ".DLL"), quindi non sono necessari download aggiuntivi. libSDL ------ Tux Paint richiede la Simple DirectMedia Layer Library (libSDL), una libreria multimediale open source distribuita sotto licenza GNU Lesser General Public License (LGPL). Oltre a questa, Tux Paint dipende anche da altre librerie: SDL_Image (per i file grafici), SDL_TTF (per il supporto dei caratteri True Type Font) e, opzionalmente, SDL_Mixer (per gli effetti sonori). Utenti GNU/Linux e Unix: ------------------------ Le librerie SDL sono disponibili come codice sorgente, o come RMP o pacchetti Debian per diverse distribuzioni GNU Linux. Di solito sono incluse nei paccheti disponibili all'interno delle distribuzioni (ad esempio nei CD di installazione, o via internet sui siti di riferimento della distribuzione). Nondimeno, possono essere scaricate da: libSDL: http://www.libsdl.org/ SDL_Image: http://www.libsdl.org/projects/SDL_image/ SDL_TTF: http://www.libsdl.org/projects/SDL_ttf/ SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/ [OPTIONAL] NOTA: Mentre si installano i pacchetti delle librerie, accertarsi di installare ANCHE la versione "-devel" (ad esempio installare sia "SDL-1.2.4.rpm" sia "SDL-1.2.4-devel.rpm"). Altre librerie: --------------- Tux Paint richiede anche altre librerie libere, sotto licenza LGPL. Su GNU Linux, come con le SDL, dovrebbero gia` essere installate, o comunque essere facilmente reperibili come parte integrante della distribuzione in uso. libPNG ------ Tux Paint usa il formato PNG (Portable Network Graphics) per i file grafici. SDL_image necessita della presenza di libPNG. http://www.libpng.org/pub/png/libpng.html FreeType2 --------- Tux Paint usa i caratteri TTF (True Type Font) per disegnare il testo; SDL_ttf necessita della presenza di FreeType2. http://www.freetype.org/ gettext ------- Tux Paint segue le impostazioni di localizzazione del sistema con la libreria "gettext" per supportare vari ringuaggi (per esempio, Spagnolo e Italiano). Per funzionare il programma necessita della presenza di "gettext". http://www.gnu.org/software/gettext/ NetPBM Tools [OPTIONAL] ------------------------ Sotto GNU Linux/Unix, per stampare vengono usate le "NetPBM tools" (Tux Paint genera file PNG e li converte in PostScript usando gli strumenti "pngtopnm" e "pnmtops" di NetPBM). http://netpbm.sourceforge.net/ Compilare e installare: ----------------------- Tux Paint viene distribuito sotto la GNU General Public License (GPL) (si veda COPYING.it.txt per maggiori dettagli), e di conseguenza il codice sorgente del programma e` disponibile per tutti. Utenti Windows: -------------- Compilare: ---------- Tux Paint e` distribuito in forma pre-compilata per Windows, quindi non e` necessario effettuare la compilazione su questo sistema. Nel febbraio 2005 (a partire da Tux Paint 0.9.15) nel Makefile e` stato incluso il supporto per la compilazione su un sistema Windows utilizzando MingGW/MSYS. Dopo aver compilato e installato tutte le dipendenze, usare questi comandi in MSYS per compilare, installare ed eseguire: export set CPATH=/usr/local/include export set LIBRARY_PATH=/usr/local/bin:/usr/local/lib make win32 make install-win32 tuxpaint Installare: ----------- Fare doppio click sul file di installazione di Tux Paint (".EXE") e seguire le istruzioni. Per prima cosa, verra` chiesto di accettare la licenza (si tratta della GNU General Public License (GPL), disponibile anche nel file "COPYING.it.txt"). Verra` data la possibilita` di scegliere se inserire collegamenti a Tux Paint nel menu` Start e/o sul desktop (entrambe le opzioni sono selezionate, come impostazione predefinita). Dopodiche` verra` chiesto dove installare Tux Paint. La cartella predefinita dovrebbe andare bene, a patto che sul disco ci sia spazio sufficiente. In caso contrario, comunque secondo preferenza, si puo` scegliere un'altra posizione. A questo punto, si puo` fare click su "Install" per installare Tux Paint! Cambiare le impostazioni usando i collegamenti: ----------------------------------------------- Per cambiare le impostazioni del programma, basta fare click col tasto destro del mouse sul collegamento a Tux Paint e selezionare "Proprieta`". Accertarsi di aver selezionato il tab "Collegamento" e esaminare il campo "Percorso". Dovrebbe contenere qualcosa di simile a: "C:\Program Files\TuxPaint\TuxPaint.exe" E` possibile aggiungere parametri di riga di comando che verranno attivati al doppio click sul collegamento. Ad esempio, per far partire il programma in modalita` "a tutto schermo", con l'opzione "forme semplici" (senza rotazione), e in Francese, basta aggiungere i rispettivi parametri, come segue: "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french (Per un elenco completo dei parametri da riga di comando si veda il file "README.it.txt") In caso di errori o se tutta la riga scomparisse, basta usare [CTRL+z] per annullare o [ESC] per chiudere il box senza che le modifiche vengano salvate (a meno che si sia gia` fatto click sul tasto "Applica"!). Al termine dell'impostazione, fare click su "OK." Se qualcosa va storto --------------------- Se, facendo click sul collegamento per far partire il programma, non accade nulla, probabimente qualcuno degli argomenti di riga di comando e` sbagliato. Si apra in "Esplora Risorse" la cartella principale di Tux Paint e si cerchi il file "stderr.txt". Tale file contiene la descrizione di cosa non ha funzionato nel programma. Solitamente sara` qualcosa come una maiuscola al posto di una minuscola, oppure un "-" di troppo (o di meno). Utenti GNU/Linux e Unix: ------------------------ Compilare: ---------- Nota: attualmente Tux Paint non usa autoconf/automake, quindi non e` disponibile alcuno script di configurazione. La compilazione dovrebbe comunque andare a buon fine senza problemi, assumendo che tutte le librerie necessarie a Tux Paint siano gia` installate. Per compilare il programma da una shell usare il comando: $ make Disabilitare il suono durante la compilazione: ---------------------------------------------- Nel caso non sia disponibile una scheda sonora, o si preferisca non rendere disponibile il suono nel programma (non c'e` bisogno di installare SDL_Mixer, quindi), si puo` usare questo comando: $ make nosound In caso di errori: ------------------ Se si ricevono errori durante la compilazione, accertarsi di aver installato tutte le librerie necessarie (vedi sopra). Se si usano librerie preinstallate, accertarsi anche che siano installati i corrispondenti pacchetti "-dev" o "-devel", in caso contrario non sara` possibile compilare Tux Paint (e altri programmi). Installare: ----------- Se non si sono verificati errori, ora e` possibile installare il programma in modo tale che possa essere usato dagli utenti del sistema. L'installazione deve essere fatta da "root" (l'utente com privilegi di amministratore), quindi va usato il comando: $ su Inserite la password di "root". Il prompt dovrebbe diventare "#". Per installare il programma, usare il comando: # make install Infine, tornare all'utente normale: # exit NOTA: La cartella predefinita dove viene inserito "tuxpaint", il file eseguibile del programma, e` "/usr/local/bin/". Per gli altri file (immagini, suoni, lingue diverse...) la cartella e` "/usr/local/share/tuxpaint/". Cambiare le cartelle di destinazione ------------------------------------ E` possibile cambiare le cartelle dove verranno posizionati i file di Tux Paint durante l'installazione. Per farlo, bisogna usare la variabile "PREFIX" nel makefile: si tratta della base della cartella dove vengono inseriti i file, ed inizialmente e` settata a "/usr/local". Altre variabili sono: BIN_PREFIX La cartella dove viene installato il file "tuxpaint". (Inizialmente e` "$(PREFIX)/bin" - es., "/usr/local/bin") DATA_PREFIX La cartella degli altri file (suoni, grafica, lingue...). (Inizialmente e` "$(PREFIX)/share/tuxpaint") DOC_PREFIX La cartella dove vengono inseriti i file di documentazione (Inizialmente e` "$(PREFIX)/share/doc/tuxpaint") MAN_PREFIX La cartella dove viene inserita la pagina man di Tux Paint. (Inizialmente e` "$(PREFIX)/share/man") ICON_PREFIX $(PREFIX)/share/pixmaps X11_ICON_PREFIX $(PREFIX)/X11R6/include/X11/pixmaps GNOME_PREFIX $(PREFIX)/share/gnome/apps/Graphics KDE_PREFIX $(PREFIX)/share/applnk/Graphics Dove vengono inserite le icone e i collegamenti. LOCALE_PREFIX La cartella dei file di traduzione per le diverse lingue. (Inizialmente e` "$(PREFIX)/share/locale/"; la locazione finale di un file di traduzione sara` all'interno della cartella relativa alla nazione, nella sottocartella chiamata "LC_MESSAGES". Ad esempio: "usr/local/share/locale/it/LC_MESSAGES/tuxpaint.mo") Disinstallare Tux Paint: ------------------------ Utenti Windows -------------- Usare l'Uninstaller ------------------- Se avete installato la voce di menu` di Tux Paint all'interno del menu` Start, vi troverete il collegamento chiamato "Uninstall". Per procedere alla disinstallazione, darne la conferma facendo click su "Uninstall". Al termine dell'operazione, fare click sul pulsante "Close". Per disinstallare e` anche possibile usare la voce "TuxPaint (remove only)" nel menu` di "Installazione Applicazioni" del "Pannello di Controllo". NOTA: all'interno della cartella "userdata" vengono salvati i disegni dell'utente: questa cartella NON viene cancellata durante la disinstallazione del programma. Utenti GNU/Linux e Unix: ------------------------ All'interno della cartella che contiene il codice sorgente di Tux Paint (quella dove avete compilato il programma), e` possibile usare il "makefile" per disinstallare Tux Paint. Per farlo serve essere "root" (utente con privilegi di amministratore) (Per altre informazioni, si veda la sezione precedente di installazione). Per diventare "root" usare il comando: $ su Inserire la password di "root". Il prompt dovrebbe diventare "#". Per disinstallare Tux Paint, usare il comando: # make uninstall Infine, tornare all'utente normale: # exit