INSTALL.txt voor Tux Paint
Tux Paint - Een tekenprogramma voor kinderen.
Copyright 2002, Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
27 Juni 2002 - 5 november 2002
(Nederlands: Geert <geert-csg@wanadoo.nl>, 20 november 2002)
Nodig:
------
Windows gebruikers:
-------------------
De Windows versie van Tux Paint wordt geleverd als een executable file.
Hierin zitten alle libraries (in ".DLL" vorm).
libSDL
------
Tux Paint benodigt de Simple DirectMedia Layer Library (libSDL),
een Open Source multimedia programming library beschikbaar onder de
GNU Lesser General Public License (LGPL).
Samen met libSDL heeft Tux Paint een aantal andere 'hulp' libraries nodig:
SDL_Image (voor grafische files), SDL_TTF (voor True Type Fonts
ondersteuning) en optioneel de SDL_Mixer (voor geluidseffecten).
Linux/Unix gebruikers:
----------------------
De SDL libraries zijn beschikbaar als source-code, of als RPM of als
Debian pakket voor de verschillende Linux distributies. Ze zijn als
download beschikbaar van:
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/ [OPTIONEEL]
Meestal zijn ze echter gewoon beschikbaar op uw Linux distributie
CD, of via pakket onderhoud managers als het Debian "apt-get").
NB: Installeer ook "-devel" versies van de pakketten.(Dus beide pakketten
"SDL-1.2.4.rpm" EN "SDL-1.2.4-devel.rpm")
Andere Libraries:
-----------------
Tux Paint maakt ook nog gebruik van een aantal andere LGPL libraries.
Onder Linux moeten deze geïnstalleerd worden. Ze zullen meestal al op uw
systeem aanwezig zijn of zijn beschikbaar op de CD van uw Linux distributie.
libPNG
------
Tux Paint gebruikt het PNG (Portable Network Graphics) formaat voor de
data files. SDL_image heeft hiervoor libPNG nodig.
http://www.libpng.org/pub/png/libpng.html
FreeType2
---------
Tux Paint gebruikt de TTF (True Type Font) fonts voor tekst.
SDL_ttf heeft hiervoor de FreeType2 library nodig.
http://www.freetype.org/
gettext
-------
Tux Paint gebruikt uw locale settings van uw systeem samen met de
"gettext" library om de verschillende talen te ondersteunen (bijvoorbeeld
Spaans). Hiervoor moet u de gettext library installeren.
http://www.gnu.org/software/gettext/
NetPBM Tools [OPTIONEEL]
------------------------
Onder Linux en Unix worden de NetPBM gereedschappen veel gebruikt om te
printen (Een PNG file wordt gegenereerd door TuxPaint en weer
geconverteerd naar een PostScript formaat door gebruik te maken van de
'pngtopnm' and 'pnmtops' NetPBM commando-regel gereedschappen.)
http://netpbm.sourceforge.net/
Compileren en Installatie:
--------------------------
Tux Paint wordt uitgegeven onder de GNU General Public License (GPL)
(zie "COPYING.txt" voor meer details), daarom is de 'source code' van het
programma bijgevoegd.
Windows gebruikers:
-------------------
Compileren:
-----------
Tux Paint wordt geleverd als een voor-gecompileerd pakket voor Windows.
[Eventuele informatie over het hercompileren voor Windows zal
in de toekomst hier verschijnen. Tot die tijd moet u het op eigen kracht
doen.]
Installeren:
------------
Dubbel-klik op het Tux Paint installatie programma (.EXE file) en
volg de instructies.
Eerst wordt u gevraagd om in te stemmen met de GPL licentie.
(Deze kunt u terugvinden als de General Public License (GPL), zie
hiervoor de "COPYING.txt".)
Het programma vraagt u of snelkoppelingen in het Windows Start Menu en op
de desktop naar Tux Paint wilt. Beide opties zijn standaard aangevinkt.
Vervolgens wordt u gevraagd op welke plaats u Tux Paint wilt installeren.
Indien er voldoende plaats aanwezig is zou de standaard map goed moeten
zijn. Is dit niet het geval, kiest u dan een andere plaats.
Na deze vraag hoeft u alleen nog maar op 'installeren' te klikken.
Tux Paint doet de rest!
Het veranderen van de eigenschappen van de snelkoppeling.
---------------------------------------------------------
Om de programma instellingen te veranderen klikt u met de rechter
muis-toets op de TuxPaint snelkoppeling en kiest u 'Eigenschappen'
uit het menu.
Controleer of de 'snelkoppeling' tab is geselecteerd en bekijk het doel
van de snelkoppeling. Hier staat bijvoorbeeld:
"C:\Program Files\TuxPaint\TuxPaint.exe"
U kunt nu commando-regel opties toevoegen, welke uitgevoerd worden
als u op het icoontje klikt.
Om bijvoorbeeld Tux Paint in de 'fullscreen' mode te laten starten,
met eenvoudige vormen ( geen roteer optie) en in het Nederlands voegt
u de volgende opties toe:
"C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang dutch
(Zie de "README.txt" voor een volledige lijst van commando-regel opties.)
Maakt u een fout of, nog erger, als het venster verdwijnt dan drukt u
Ctrl-Z of [ESC] om zaken ongedaan te maken. Het venster zal zich dan
sluiten zonder dat de veranderingen uitgevoerd werden. (Niet op de
"Apply" knop drukken!).
Bent u klaar dan klikt u op "OK."
Als er iets fout gaat
---------------------
Als u op het icoontje klikt om TuxPaint te starten en er gebeurt niets
dan zijn de commando-regel opties waarschijnlijk fout. Bekijk dan met een
eenvoudige tekstverwerker (Notepad o.i.d.) de file 'stderr.txt' in de
TuxPaint map.
Deze file bevat een omschrijving van wat er fout is gegaan. In de meeste
gevallen zal dit iets zijn in de stijl van een hoofdletter waar er geen
hoort, een letter vergeten, een streepje teveel of te weinig etc.
Linux/Unix Gebruikers:
----------------------
Compileren:
-----------
NB: Op dit moment ondersteunt Tux Paint niet autoconf/automake dus is er
geen "./configure" script. (Sorry!) Compileren zou echter eenvoudig
moeten zijn, vooropgesteld dat TuxPaint al de nodige libraries kan vinden.
Om het programma van de source-code te compileren typt u eenvoudig
het volgende commando:
$ make
Het geluid uitschakelen bij het compileren:
-------------------------------------------
Heeft u geen geluidskaart of wilt u het programma gebruiken zonder geluid
dan heeft het geen zin om de geluidsondersteuning te installeren.
De SDL_mixer hoeft dan ook niet aanwezig te zijn op uw systeem.
U kunt dan make als volgt uitvoeren:
$ make nosound
U krijgt foutmeldingen:
-----------------------
Krijgt u foutmeldingen tijdens het compileren controleer dan of alle
genoemde libraries op uw systeem aanwezig zijn. Gebruikt u
voor-gecompileerde pakketten zoals de RPM's bij RedHat en de DEBs bij
Debian installeer dan ook de corresponderende "-dev" of "-devel"
pakketten. Anders kunt u Tux Paint (en andere programma's) niet
compileren.
Installeren:
------------
Vooropgesteld dat er geen fouten zijn opgetreden bij het compileren, kunt
u nu Tux Paint installeren. Onder Linux moet dit gebeuren door de 'root'
gebruiker (superuser). U kunt naar "root" overschakelen door:
$ su te typen
Geef het "root" password en u bent ingelogd als hoofdgebruiker
(met een prompt die eruit ziet als "#"). Om het programma te installeren
typt u:
# make install
Bent u klaar dan kunt u de 'superuser' mode verlaten door:
# exit te typen.
NB: Standaard plaatst TuxPaint de "tuxpaint", executable in
"/usr/local/bin/". De data files (afbeeldingen, geluiden etc.)
komen in "/usr/local/share/tuxpaint/".
Waar gaan de bestanden naar toe
-------------------------------
U kunt met de 'PREFIX' variabele in de Makefile instellen waar de
bestanden naar toe gaan. "PREFIX" is de basis waar alle bestanden
naartoe gaan. Standaard ingesteld op "/usr/local".
Andere variabelen zijn:
BIN_PREFIX
Waar het bestand "tuxpaint" terecht komt.
(Standaard is "$(PREFIX)/bin" bijvoorbeeld: "/usr/local/bin")
DATA_PREFIX
Waar de data files (geluid, afbeeldingen, borstels, stempels etc.)
terecht komen en waar TuxPaint bij het opstarten zal zoeken.
(Standaard ingesteld op "$(PREFIX)/share/tuxpaint")
DOC_PREFIX
Waar de documentatie files geplaatst worden (de "docs" directory).
(Standaard "$(PREFIX)/share/doc/tuxpaint")
MAN_PREFIX
Waar de 'man pages' terecht komen. (De standaard is:
"$(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
Waar de iconen voor KDE en GNOME terecht komen.
LOCALE_PREFIX
Waar de vertaalde pagina's van Tux Paint naar toe gaan.
(Standaard ingesteld op "$(PREFIX)/share/locale/")
(Uiteindelijk komen deze bestanden in de locale's directory
(bijvoorbeeld, "es" voor Spaans), binnen de "LC_MESSAGES"
subdirectory.)
Tux Paint verwijderen:
----------------------
Windows
-------
Gebruik makend van de Uninstaller
---------------------------------
Als u de snelkoppeling in het Start Menu geïnstalleerd heeft dan kunt u
"Uninstall" kiezen in de Tuxpaint folder. Er opent zich een venster
waarin u om bevestiging gevraagd wordt. Weet u het zeker, klik dan op
de 'Uninstall' knop.
Wanneer de bestanden verwijderd zijn klikt u eenvoudig op de 'sluiten'
knop.
U kunt TuxPaint ook verwijderen in het de 'software' afdeling van het
configuratie scherm.
NB: Omdat de afbeeldingen gemaakt met Tux Paint opgeslagen worden in de
map 'userdata' wordt deze map niet verwijderd.
Linux
-----
In de source file directory van TuxPaint (de map waarin u Tux Paint
compileerde), kunt u de 'Makefile' gebruiken om Tux Paint te verwijderen.
Standaard kan dit alleen gebeuren door de "root" gebruiker ('superuser').
(Zie ook de installatieprocedure voor meer informatie.)
U schakelt over naar "root" door het volgende commando te typen:
$ su
Geef vervolgens het "root" password op. De prompt is een "#").
Om alle standaard bestanden te verwijderen typt u:
# make uninstall
Na deze actie wordt u weer gewone gebruiker door het commando:
# exit
