tuxpaint-pencil-sharpener/docs/fr_FR.UTF-8/html/INSTALL.html
2021-08-31 22:41:14 -07:00

948 lines
46 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>
Documentation sur l'installation de Tux Paint </title>
<meta http-equiv="Content-Type"
content="text/html; charset=utf-8">
</head>
<body bgcolor="#FFFFFF"
text="#000000"
link="#0000FF"
vlink="#FF0000"
alink="#FF00FF">
<center>
<h1>
<img src="../../html/images/tuxpaint-title.png"
width="205"
height="210"
alt="Tux Paint"><br>
version 0.9.27<br/>
Documentation sur l'installation </h1>
<p>
Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS.<br>
<a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a>
</p>
<p>
août 31, 2021 </p>
</center>
<hr size="2" noshade />
<table border="2"
cellspacing="0"
cellpadding="2"
summary="Table des matières">
<tr>
<th>
Table des matières </th>
</tr>
<tr>
<td>
<ul>
<li>
<a href="#requirements">Requirements</a>
<ul>
<li>
<a href="#req-libsdl">Simple DirectMedia Layer library (libSDL)</a>
</li>
<li>
<a href="#req-other-libs">Autres bibliothèques</a>
</li>
</ul>
</li>
<li>
<a href="#compiling">Compiling and Installation</a>
<ul>
<li>
<a href="#compiling-windows">Utilisateurs de Windows</a>
</li>
<li>
<a href="#compiling-linux">Utilisateurs de Linux/Unix</a>
</li>
<li>
<a href="#compiling-macos">Utilisateurs de macOS</a>
</li>
</ul>
</li>
<li>
<a href="#debugging">Debugging</a>
</li>
<li>
<a href="#uninstalling">Uninstalling Tux Paint</a>
<ul>
<li>
<a href="#uninstalling-windows">Windows</a>
</li>
<li>
<a href="#uninstalling-linux">Linux</a>
</li>
</ul>
</li>
</ul>
</td>
</tr>
</table>
<hr size="2" noshade />
<h2>
<a name="requirements" id="requirements">
Requirements </a>
</h2>
<blockquote>
<h3>
<a name="req-libsdl" id="req-libsdl">
Simple DirectMedia Layer library (libSDL) </a>
</h3>
<blockquote>
<p>
Tux Paint nécessite la bibliothèque de couches DirectMedia simple (libSDL), une bibliothèque de programmation multimédia Open Source disponible sous la Licence publique générale limitée GNU (LGPL). </p>
<p>
Avec libSDL, Tux Paint dépend d'un certain nombre d'autres bibliothèques SDL : SDL_Image (pour les fichiers graphiques), SDL_TTF et (en option) SDL_Pango (pour la prise en charge des polices True Type) et, éventuellement, SDL_Mixer (pour les effets sonores). </p>
<h4>Utilisateurs de Linux/Unix :</h4>
<blockquote>
<p>
Les bibliothèques SDL sont disponibles en tant que code source, ou en tant que paquets RPM ou Debian pour diverses distributions de Linux. Ils peuvent être téléchargés à partir de : </p>
<ul>
<li>libSDL: <a href="http://www.libsdl.org/">http://www.libsdl.org/</a></li>
<li>SDL_Image: <a href="http://www.libsdl.org/projects/SDL_image/">http://www.libsdl.org/projects/SDL_image/</a></li>
<li>SDL_TTF: <a href="http://www.libsdl.org/projects/SDL_ttf/">http://www.libsdl.org/projects/SDL_ttf/</a></li>
<li>SDL_Pango: <a href="http://sourceforge.net/projects/sdlpango/">http://sourceforge.net/projects/sdlpango/</a> (optionnel)</li>
<li>SDL_Mixer: <a href="http://www.libsdl.org/projects/SDL_mixer/">http://www.libsdl.org/projects/SDL_mixer/</a> (optionnel)</li>
</ul>
<p>
Elles sont aussi parmi les paquets inclus dans votre distribution (par ex. sur le media d'installation, ou via la maintenance de vos logiciels comme la commande <code>apt</code> de Debian). </p>
<p>
<b>Remarque ;</b>lors de l'installation à partir de packages, assurez-vous d'installer AUSSI les versions de développement des paquets (Par ex. installez les deux "<code>SDL-1.2.4.rpm</code>" <em>et</em> "<code>SDL-1.2.4-devel.rpm</code>".) </p>
</blockquote>
</blockquote>
<h3>
<a name="req-other-libs" id="req-other-libs">
Autres bibliothèques </a>
</h3>
<blockquote>
<p>
Tux Paint profite également d'un certain nombre d'autres bibliothèques gratuites LGPL. Sous Linux, tout comme SDL, ils devraient être soit déjà installées, soit facilement disponibles avec votre distribution Linux. </p>
<h4>libPNG</h4>
<blockquote>
<p>
Tux Paint utilise le format PNG (Portable Network Graphics) pour ses fichiers de données. SDL_image nécessitera l'installation de libPNG. </p>
<p>
<a href="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</a>
</p>
</blockquote>
<h4>gettext</h4>
<blockquote>
<p>
Tux Paint utilise les paramètres régionaux de votre système avec la bibliothèque "gettext" pour prendre en charge plusieurs langues (par exemple, l'espagnol). Vous aurez besoin d'installer la bibliothèque de gettext. </p>
<p>
<a href="http://www.gnu.org/software/gettext/">http://www.gnu.org/software/gettext/</a>
</p>
</blockquote>
<h4>libpaper (Linux/Unix uniquement)</h4>
<blockquote>
<p>
Depuis Tux Paint 0.9.17, Tux Paint peut déterminer le format de papier par défaut (par exemple, A4 ou Lettre), ou peut être invité à utiliser un format particulier, ceci grâce à libpaper. </p>
<p>
<a href="https://github.com/naota/libpaper">https://github.com/naota/libpaper</a>
</p>
</blockquote>
<h4>FriBiDi</h4>
<blockquote>
<p>
Les outils "Texte" et "Étiquette" de Tux Paint supportent les langues bidirectionnelles, grâce à la bibliothèque "FriBidi". </p>
<p>
<a href="http://fribidi.org/">http://fribidi.org/</a>
</p>
</blockquote>
<h4>Support des graphismes SVG</h4>
<blockquote>
<p>
À partir de Tux Paint 0.9.17, Tux Paint peut prendre en charge les images SVG (Scalable Vector Graphics) pour les tampons. Deux ensembles de bibliothèques sont pris en charge et le support SVG peut être complètement désactivé (via "<code>make SVG_LIB:=</code>=") </p>
<h5>librsvg-2 &amp; libCairo2 (nouvelles bibliothèques)</h5>
<ul>
<li>libRSVG 2: <a href="http://librsvg.sourceforge.net/">http://librsvg.sourceforge.net/</a></li>
<li>Cairo 2: <a href="http://www.cairographics.org/">http://www.cairographics.org/</a></li>
<li>Celles-ci dépendent aussi de : <ul>
<li>GdkPixbuf &amp; GLib: <a href="http://www.gtk.org/">http://www.gtk.org/</a></li>
<li>Pango: <a href="http://www.pango.org/">http://www.pango.org/</a></li>
</ul>
</li>
</ul>
<h5>Anciennes bibliothèques</h5>
<ul>
<li>libcairo1, libsvg1, &amp; libsvg-cairo1: <a href="http://www.cairographics.org/">http://www.cairographics.org/</a></li>
<li>Celles-ci dépendent aussi de : <ul>
<li>libxml2: <a href="https://gitlab.gnome.org/GNOME/libxml2">https://gitlab.gnome.org/GNOME/libxml2</a></li>
</ul>
</li>
</ul>
</blockquote>
<h4>Fonction d'exportation de GIF animés</h4>
<blockquote>
<p>
Pour prendre en compte l'exportation de GIF animés (diaporama), la bibliothèque "libimagequant" (issue du projet "pngquant" est nécessaire. </p>
<p>
<a href="https://github.com/ImageOptim/libimagequant">https://github.com/ImageOptim/libimagequant</a>
</p>
</blockquote>
<h4>Outils NetPBM (optionnel) Ne sont plus utilisés, par défaut</h4>
<blockquote>
<p>
Sous Linux et Unix, les anciennes versions de Tux Paint utilisaient les outils NetPBM comme aide à l'impression. (Un PNG est généré par TuxPaint et converti en PostScript en utilisant en ligne de commande les outils NetPBM <code>pngtopnm</code> et <code>pnmtops</code>.) </p>
<p>
<a href="http://netpbm.sourceforge.net/">http://netpbm.sourceforge.net/</a>
</p>
</blockquote>
</blockquote>
</blockquote>
<hr size="2" noshade />
<h2>
<a name="compiling" id="compiling">
Compiling and Installation </a>
</h2>
<blockquote>
<p>
Tux Paint est publié sous la licence publique générale GNU (GPL) (voir "COPYING.txt" pour plus de détails), et donc le 'code source' du programme est disponible gratuitement. </p>
<h3>
<a name="compiling-windows" id="compiling-windows">
Utilisateurs de Windows </a>
</h3>
<p style="font-size: small;">
<em>
octobre 25, 2020 Shin-ichi TOYAMA shin1@wmail.plala.or.jp &lt;<a href="mailto:shin1@wmail.plala.or.jp">shin1@wmail.plala.or.jp</a>&gt;
</em>
</p>
<blockquote>
<h4>Compiling Set-Up</h4>
<blockquote>
<p>
Depuis février 2005 (à partir de Tux Paint 0.9.15), le "<code>Makefile</code>" inclut la prise en charge de la construction sur un système Windows à l'aide de MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p>
Many tools and libraries are required to build Tux Paint. The package management system "<code>pacman</code>" helps you install them automatically solving complicated dependencies. </p>
<p>
Download the latest MSYS2 environment from <a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a> and install it where you'd like (the default is "<a href="https://sourceforge.net/projects/msys2/files/Base/">https://sourceforge.net/projects/msys2/files/Base/</a>") </p>
<p>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Entrée]</code></b> or <b><code>[Retour]</code></b> to accept the defaults for all questions):
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p>
This will update core system and the window will close automatically. Repeat the steps above one more time to finish the remaining update process. </p>
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
pacman -S base-devel msys2-devel git
</code>
</blockquote>
</p>
</blockquote>
<p>
<i>
Proceed to the next "<a href="#64bit">MinGW 64bit (x86_64) toolchains</a>" section, or skip to the "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section if you need only a 32bit build environment. </i>
</p>
<hr size="1" noshade width="75%" />
<h4>
<a name="64bit" id="64bit">
MinGW 64bit (x86_64) toolchains </a>
</h4>
<blockquote>
<p>
Within the MSYS2 shell, run the following command to install basic 64bit development tools: <blockquote>
<code>
pacman -S mingw-w64-x86_64-toolchain
</code>
</blockquote>
</p>
</blockquote>
<h4>
64bit (x86_64) dependency libraries for Tux Paint </h4>
<blockquote>
<p>
You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "<code>pacman</code>" except for SDL_Pango. </p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
<p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
<blockquote>
<code>
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}<br/>
$ pacman -S mingw-w64-x86_64-librsvg<br/>
$ pacman -S mingw-w64-x86_64-fribidi<br/>
$ pacman -S mingw-w64-x86_64-libimagequant<br/>
$ pacman -S mingw-w64-x86_64-fltk<br/>
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
</code>
</blockquote>
</p>
<p>
<strong>Note:</strong> Close the shell before proceeding to the remaining process. </p>
</blockquote>
<h4>
Install SDL_Pango and re-install SDL on the 64bit environment </h4>
<blockquote>
<p>
SDL_Pango should be installed manually. In addition, you have to re-install SDL from the source code or you will see unnecessary blank window opens when starting Tux Paint. </p>
<p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<h5>SDL_Pango</h5>
<blockquote>
<p>
At first, you have to prepare source tar-ball and a required patch in the same directory. </p>
<ul>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/>
$ cd SDL_Pango-0.1.2/<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</blockquote>
<h5>SDL</h5>
<blockquote>
<p>
Download <a href="http://www.libsdl.org/release/SDL-1.2.15.tar.gz">source tar-ball of SDL_1.2.15</a> from <a href="http://www.libsdl.org/">libsdl.org</a>. </p>
<p>
Re-install SDL as follows. <blockquote>
<code>
$ tar zxvf SDL-1.2.15.tar.gz<br/>
$ cd SDL-1.2.15<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</blockquote>
</blockquote>
<p>
<i>
Proceed to the next "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section, or skip to the "<a href="#imagemagick">ImageMagick</a>" section if you need only a 64bit build environment. </i>
</p>
<hr size="1" noshade width="75%" />
<h4>
<a name="32bit" id="32bit">
MinGW 32bit (i686) toolchains </a>
</h4>
<blockquote>
<p>
Within the MSYS2 shell, run the following command to install basic 32bit development tools: <blockquote>
<code>
pacman -S mingw-w64-i686-toolchain
</code>
</blockquote>
</p>
</blockquote>
<h4>
32bit (i686) dependency libraries for Tux Paint </h4>
<blockquote>
<p>
You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "<code>pacman</code>" except for SDL_Pango. </p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
<p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
<blockquote>
<code>
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}<br/>
$ pacman -S mingw-w64-i686-librsvg<br/>
$ pacman -S mingw-w64-i686-fribidi<br/>
$ pacman -S mingw-w64-i686-libimagequant<br/>
$ pacman -S mingw-w64-i686-fltk<br/>
$ pacman -S mingw-w64-i686-ntldd-git
</code>
</blockquote>
</p>
<p>
<strong>Note:</strong> Close the shell before proceeding to the remaining process. </p>
</blockquote>
<h4>
Install SDL_Pango and re-install SDL on the 32bit environment </h4>
<blockquote>
<p>
SDL_Pango should be installed manually. In addition, you have to re-install SDL from the source code or you will see unnecessary blank window opens when starting Tux Paint. </p>
<p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<h5>SDL_Pango</h5>
<blockquote>
<p>
At first, you have to prepare source tar-ball and a required patch in the same directory. </p>
<ul>
<li>
Download <a href="https://sourceforge.net/projects/sdlpango/files/SDL_Pango/0.1.2/SDL_Pango-0.1.2.tar.gz/download">source tar-ball of SDL_Pango-0.1.2</a> from <a href="https://sourceforge.net/projects/sdlpango/">SDL_Pango's page on Sourceforge.net</a>. </li>
<li>
Download <a href="http://johnnypops.co.uk/tuxpaint/SDL_Pango-configure-extra-api.patch">a patch file</a> from <a href="http://www.johnnypops.co.uk/tuxpaint/">John Popplewell's "Tux Paint - MinGW/MSYS build instructions" webpage</a>. (This adds some extra (required) functionality to SDL_Pango.) </li>
</ul>
<p>
Build and install SDL_Pango as follows. <blockquote>
<code>
$ tar zxvf SDL_Pango-0.1.2.tar.gz<br/>
$ cd SDL_Pango-0.1.2/<br/>
$ patch -p0 &lt; ../SDL_Pango-configure-extra-api.patch<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</blockquote>
<h5>SDL</h5>
<blockquote>
<p>
Download <a href="http://www.libsdl.org/release/SDL-1.2.15.tar.gz">source tar-ball of SDL_1.2.15</a> from <a href="http://www.libsdl.org/">libsdl.org</a>. </p>
<p>
Re-install SDL as follows. <blockquote>
<code>
$ tar zxvf SDL-1.2.15.tar.gz<br/>
$ cd SDL-1.2.15<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</blockquote>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>
<a name="imagemagick" id="imagemagick">ImageMagick</a>
</h4>
<blockquote>
<p>
<a href="https://imagemagick.org">ImageMagick</a> is a compilation of command line tools to create, edit, compose, or convert bitmap images supporting quite a large number of image formats. Tux Paint uses two functions ("convert" and "composite") in it to generate thumbnails for startar images and templates during the build process. </p>
<p>
Using official binary release available from "<a href="https://imagemagick.org/script/download.php#windowsand">Windows Binary Release</a>" is recommended, due to the commands installed with "<code>pacman</code>" on MinGW/MSYS not working as expected! </p>
<p>
Do not forget to enable "Install legacy utilities (e.g. convert)" while installing it, because Tux Paint's build process uses them. </p>
<p>
Add the path to the directory in which ImageMagick is installed at the top of your "PATH" environment variable. For example: <blockquote>
<code>
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
</code>
</blockquote>
</p>
<p>
You can make this permanent by adding the above to your the BASH shell configuration file, "<code>~/.bash_profile</code>". </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Tux Paint</h4>
<blockquote>
<p>
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries using MSYS2 32bit shell, respectively. </p>
<ul>
<li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" from the "Start Menu" to open the 64bit shell. </li>
<li>
Select "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" from the "Start Menu" to open the 32bit shell. </li>
</ul>
<p>
Compile Tux Paint with the following command: <blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
</p>
<p>
<strong>Note:</strong> At this point, you will want to build "Tux Paint Config." for Windows, so it can be included along with "Tux Paint", if you're making an official (or test) release. The build process will look for it in a directory named "<code>tuxpaint-config</code>" (with no version number, e.g., "<code>tuxpaint-config-X.Y.Z</code>"). See "Tux Paint Config."'s INSTALL.txt documentation for details. </p>
<p>
All the files needed for starting Tux Paint (and Tux Paint Config.) are collected in the directory for binary distribution "<code>bdist</code>" directory under "<code>win32</code>". You can start them by double-clicking their executable (<code>.exe</code>) files in the "<code>bdist</code>" directory. </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Building the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
<a href="https://jrsoftware.org/isinfo.php">Inno Setup</a> is used to build executable installer for Tux Paint. Therefore you have to install it in the first place. </p>
<p>
</p>
<p>
Then, you can easily build an executable installer by right-clicking on the "<code>tuxpaint.iss</code>" icon in the "<code>win32</code>" directory and selecting "Compile" on the list. It will run for a while, and eventually you will find a "<code>tuxpaint-<i>X.Y.Z</i>-win32-installer.exe</code>" file in the same directory. </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Running the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
Double-cliquez sur l'exécutable du programme d'installation de Tux Paint (fichier .EXE) et Suivez les instructions.
<p>
Tout d'abord, il vous sera demandé d'accepter la licence. (Il s'agit de la licence publique générale GNU (GPL), qui est également disponible en tant que "COPYING.txt".) </p>
<p>
Il vous sera ensuite demandé si vous souhaitez installer des raccourcis à Tux Paint dans votre menu Démarrer de Windows et sur votre bureau Windows.(Les deux options sont définies par défaut.) </p>
<p>
Puis, il vous sera demandé où vous souhaitez installer Tux Paint. La valeur par défaut devrait convenir, tant qu'il y a de l'espace disponible. Sinon, choisissez un autre emplacement. </p>
<p>
À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint ! </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Modification des paramètres à l'aide du raccourci :</h4>
<blockquote>
<p>
Pour modifier les paramètres du programme, cliquez avec le bouton droit sur le raccourci TuxPaint et sélectionnez «Propriétés» (en bas). </p>
<p>
Assurez-vous que l'onglet "Raccourci" est sélectionné dans la fenêtre qui apparaît et examinez le champ «Cible:». Vous devriez voir quelque chose comme ceci : </p>
<blockquote>
<code>
"C:\Program Files\TuxPaint\TuxPaint.exe"
</code>
</blockquote>
<p>
Vous pouvez maintenant ajouter des options de ligne de commande qui seront activées lorsque vous double-cliquez sur l'icône. </p>
<p>
Par exemple, pour faire fonctionner le jeu en mode plein écran, avec des formes simples (pas d'option de rotation) et en français, ajoutez les options (après 'TuxPaint.exe'), comme ceci : </p>
<blockquote>
<code>
"C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french
</code>
</blockquote>
<p>
(Voir «README.txt» pour une liste complète des options de ligne de commande disponibles.) </p>
<p>
Si vous faites une erreur ou que tout disparaît, utilisez <b><code>[Ctrl]</code></b> + <b><code>[Z]</code></b> pour annuler ou appuyez simplement sur la touche <b><code>[Esc]</code></b> et la boîte se fermera sans aucune modification (sauf si vous avez appuyé sur le bouton "Appliquer" !). </p>
<p>
Quand vous avez fini, appuyez sur "OK". </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Si quelque chose ne va pas :</h4>
<blockquote>
<p>
Si, lorsque vous double-cliquez sur le raccourci pour lancer le jeu, rien ne se passe, c'est probablement parce que certaines des options en lignes de commande sont erronées. Ouvrez un explorateur comme avant et recherchez un fichier appelé "<code>stderr.txt</code>" dans le dossier TuxPaint. </p>
<p>
Il contiendra une description de ce qui n'allait pas. Habituellement, ce sera simplement dû à une casse de caractère incorrecte (majuscule 'Z' à la place de 'z' minuscule) ou un '-' (tiret) manquant (en trop). </p>
</blockquote>
</blockquote>
<hr size="1" noshade />
<h3>
<a name="compiling-linux" id="compiling-linux">
Utilisateurs de Linux/Unix </a>
</h3>
<blockquote>
<h4>Compilation :</h4>
<blockquote>
<p>
<b>Remarque :</b>Tux Paint n'utilise pas <code>autoconf</code>/<code>automake</code>, dès lors il n'y a pas de script "<code>./configure</code>" à lancer. La compilation devrait aller cependant aller toute seule, en supposant que Tux Paint ait tout ce dont il a besoin. </p>
<p>
Pour compiler le programme à partir des sources, lancez simplement la commande suivante après une invite shell (par ex. "$") : </p>
<blockquote>
<code>
$ make
</code>
</blockquote>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>
Désactivation du support SVG (donc des dépendances Cairo, libSVG, et svg-cairo) </h4>
<blockquote>
<p>
Pour désactiver le support de SVG (par ex. si votre système n'a pas de bibliothèque Cairo, ou d'autres choses dont SVG est dépendan), vous pouvez exécuter "<code>make</code>" avec <code>SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG</code> :
<blockquote>
<code>
$ make SVG_LIB= SVG_CFLAGS=
</code>
</blockquote>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>
Désactivation du support Pango (donc des dépendances Pango, Cairo, etc ...) </h4>
<blockquote>
<p>
Avant la version 0.9.18, Tuxpaint utilisait la bibliothèque <code>libSDL_ttf</code> pour gérer les fichiers utilisant les fontes True Type. Depuis la 09.18 <code>libSDL_Pango</code> est utilisée, car il permet un meilleur support pour l'internationalisation. Cependant, si vous voulez désactiver l'utilisation de SDL_Pango, vous pouvez le faire en exécutant "<code>make</code>" avec "<code>SDL_PANGO_LIB=</code>" : </p>
<blockquote>
<code>
$ make SDL_PANGO_LIB=
</code>
</blockquote>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Désactiver le son lors de la compilation :</h4>
<blockquote>
Si vous n'avez pas de carte son ou si vous préférez créer le programme sans support sonore (et donc sans dépendance <code>SDL_mixer</code>), vous pouvez exécuter "<code>make</code>" avec "<code>SDL_MIXER_LIB=</code>" comme paramètre : </p>
<blockquote>
<code>
$ make SDL_MIXER_LIB=
</code>
</blockquote>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Autres options :</h4>
<blockquote>
<p>
Diverses autres options (par exemple, les dossiers d'installation) peuvent être remplacées; voir dans "<code>Makefile</code>" pour plus de détails. </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Si vous obtenez des erreurs :</h4>
<blockquote>
<p>
Si vous avez des erreurs lors de la compilation, assurez-vous d'avoir les bibliothèques adéquates installées (voir ci-dessus). Si vous utilisez les versions issues des paquets des bibliothèques (par exemple, les RPM sous RedHat ou les DEB sous Debian), assurez-vous d'avoir choisi également les packages "<code>-dev</code>" ou "<code>-devel</code>" correspondants, sinon vous ne pourrez pas compiler Tux Paint (et d'autres programmes) provenant des sources ! </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Installation :</h4>
<blockquote>
<p>
En supposant qu'aucune erreur fatale ne s'est produite, vous pouvez maintenant installer le programme afin qu'il puisse être exécuté par les utilisateurs du système. Par défaut, cela doit être effectué par l'utilisateur "root" ("superutilisateur"). Passer à "root" en tapant la commande : </p>
<blockquote>
<code>
$ su
</code>
</blockquote>
<p>
Entrez le mot de passe de "root" à l'invite. Vous devriez maintenant être "root" (avec une invite comme "#"). Pour installer le programme et ses fichiers de données, tapez : </p>
<blockquote>
<code>
# make install
</code>
</blockquote>
<p>
Pour finir, vous pouvez revenir sur votre compte utilisateur en sortant du compte superutilisateur : </p>
<blockquote>
<code>
# exit
</code>
</blockquote>
<p>
Autre manière : vous faites simplement utilisation de la commande "sudo" (par ex. sur Ubuntu) : </p>
<blockquote>
<code>
$ sudo make install
</code>
</blockquote>
<p>
<b>Remarque :</b>Par défaut, "<code>tuxpaint</code>, le programme exécutable, est placé en "<code>/usr/local/bin/</code>". Les données (images, sons, etc ...) sont dans "<code>/usr/local/share/tuxpaint/</code>". </p>
<h5>Changer où vont les fichiers</h5>
<blockquote>
<p>
Vous pouvez changer où iront les fichiers en définissant des variables pour "<code>Makefile</code>" sur la ligne de commande. "<code>DESTDIR</code>" est utilisé pour indiquer la sortie des résultats de la compilation. "<code>PREFIX</code>" est la base où tous les autres fichiers iront et est définie par défaut comme "<code>/usr/local</code>". </p>
<p>
Les autres variables sont : </p>
<dl>
<dt><code>BIN_PREFIX</code></dt>
<dd>
Où le binaire "<code>tuxpaint</code>" sera installé. (Par défaut "<code>$(PREFIX)/bin</code>", par ex. "<code>/usr/local/bin</code>") </dd>
<dt><code>DATA_PREFIX</code></dt>
<dd>
Où les fichiers de données (sons, graphiques, pinceaux, tampons, fontes) iront, et où Tux Paint ira les chercher pour tourner (Réglé à "<code>$(PREFIX)/share/tuxpaint</code>") </dd>
<dt><code>DOC_PREFIX</code></dt>
<dd>
Où sera mise la documentation (les répertoires "<code>docs</code>". 'Réglé à "<code>$(PREFIX)/share/doc/tuxpaint</code>") </dd>
<dt><code>MAN_PREFIX</code></dt>
<dd>
Où ira la page de manuel de Tuxpaint (Réglé à "<code>$(PREFIX)/share/man</code>") </dd>
<dt><code>ICON_PREFIX</code> &mdash; <code>$(PREFIX)/share/pixmaps</code></dt>
<dt><code>X11_ICON_PREFIX</code> &mdash; <code>$(PREFIX)/X11R6/include/X11/pixmaps</code></dt>
<dt><code>GNOME_PREFIX</code> &mdash; <code>$(PREFIX)/share/gnome/apps/Graphics</code></dt>
<dt><code>KDE_PREFIX</code> &mdash; <code>$(PREFIX)/share/applnk/Graphics</code></dt>
<dd>
Où iront les icônes et les lanceurs (pour GNOME et KDE) </dd>
<dt><code>LOCALE_PREFIX</code></dt>
<dd>
Où iront les fichiers de traduction, et où Tux Paint ira les chercher. (Réglé à "<code>$(PREFIX)/share/locale/</code>") (la destination finale de la traduction sera dans le répertoire de la locale (par ex "<code>es</code>" pour l'espagnol, dans le sous-répertoire "<code>LC_MESSAGES</code>"). </dd>
</dl>
<p>
<b>Remarque :</b> Cette liste est obsolète. Voir "<code>Makefile</code>" et "<code>Makefile-i18n</code>" pour une liste complète. </p>
</blockquote>
</blockquote>
</blockquote>
<hr size="1" noshade />
<h3>
<a name="compiling-macos" id="compiling-macos">
Utilisateurs de macOS </a>
</h3>
<p style="font-size: small;">
<em>
septembre 21, 2021 Mark K. Kim &lt;<a href="mailto:markuskimius@gmail.com">markuskimius@gmail.com</a>&gt;
</em>
</p>
<blockquote>
<p>
Tux Paint 0.9.22 and earlier required building Tux Paint from the Xcode IDE. Starting with 0.9.23, however, Tux Paint for macOS is built as though it were a Linux application. </p>
<h4>Prerequisites</h4>
<blockquote>
<p>
Although Tux Paint is built without the Xcode IDE, Xcode itself is still required to build Tux Paint. <a href="https://developer.apple.com/xcode/ide/">Download it from the App Store</a>, and launch it once to accept its license agreements. You may also need to install the Xcode command line tools using the command: <blockquote>
<code>
xcode-select --install
</code>
</blockquote>
</p>
<p>
Building Tux Paint also requires various libraries. We install them from MacPorts where possible, source code otherwise. Install MacPorts to the default <code>/opt/local</code> path according to the instructions found on their website: <a href="https://www.macports.org/">https://www.macports.org/</a> <ul>
<li><code>ImageMagick</code></li>
<li><code>cairo</code></li>
<li><code>fribidi</code></li>
<li><code>lbzip2</code></li>
<li><code>libimagequant</code><sup>*</sup></li>
<li><code>libpaper</code></li>
<li><code>libpng</code></li>
<li><code>librsvg</code></li>
<li><code>libsdl</code></li>
<li><code>libsdl_image</code></li>
<li><code>libsdl_mixer</code></li>
<li><code>libsdl_pango</code></li>
<li><code>libsdl_ttf</code></li>
<li><code>pkgconfig</code></li>
<li><code>zlib</code></li>
</ul>
... but you should install any package that is required by the latest version of Tux Paint.<br/>
<br/>
<sup>*</sup> Not available from MacPorts as of this writing, see below. </p>
<h5>libimagequant</h5>
<blockquote>
<p>
<code>libimagequant</code> is not available from MacPorts as of this writing. It can be installed from the source code as follows. It should be installed to <code>/opt/local</code> (same as MacPorts) for the library to be included in <code>TuxPaint.dmg</code>. <blockquote>
<code>
$ git clone https://github.com/ImageOptim/libimagequant.git<br/>
$ cd libimagequant<br/>
$ ./configure --prefix=/opt/local<br/>
$ make<br/>
$ sudo make install
</code>
</blockquote>
</p>
</blockquote>
<p>
<strong>WARNING:</strong> Having any UNIX-like toolset installed on your Mac besides MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle from being portable. Be sure Fink and Brew are not accessible from your build environment. </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>How to Build</h4>
<blockquote>
<p>
Simply, run: <blockquote>
<code>
% make<br/>
% make install
</code>
</blockquote>
... to create the <code>TuxPaint.app</code> application bundle that can be run in-place or
copied to <code>/Applications</code>. It also creates <code>TuxPaint.dmg</code> for distribution. </p>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Known Issues</h4>
<blockquote>
<ul>
<li>
A macOS binary built on a specific version of macOS only runs on that version of macOS or later. To ensure Tux Paint can run on the oldest version of macOS possible, build it on the oldest version of macOS available. As of this writing we know Tux Paint cannot be built to run on macOS 10.7 or earlier.<br/>
<br/>
See "Old Versions of macOS" below for best-effort instructions on how to obtain, install, and build Tux Paint on an old version of macOS. </li>
</ul>
</blockquote>
<hr size="1" noshade width="75%" />
<h4>Old Versions of macOS</h4>
<blockquote>
<p>
Some old versions of macOS can be downloaded from Apple's support page: <a href="https://support.apple.com/en-us/HT211683">https://support.apple.com/en-us/HT211683</a> </p>
<p>
macOS does allow dual booting of multiple versions of the OS, but it's safer and easier to install the old macOS onto a flash drive. Wherever you're installing it, the target drive's partitioniong scheme and partition type must match what the old macOS expects, so use the Disk Utility to partition and format the flash drive accordingly. </p>
<p>
As of this writing, the oldest version of macOS available on Apple's support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as the partition type instead of the newer APFS partition type. </p>
<p>
Upon launching the installer, if you get a popup about macOS being too old or new to be installed, a bootable installer can be created using the instructions found here: <a href="https://support.apple.com/en-mide/HT201372">https://support.apple.com/en-mide/HT201372</a> </p>
<p>
It has been found that macOS can be installed onto the bootable media itself, so you can make the flash drive into a bootable installer then install the old macOS onto the same flash drive. </p>
<p>
Once the old macOS is installed, you may find the Xcode on the App Store is too new to run on the version of the old macOS. Old versions of Xcode can be downloaded from Apple's Developer site in an area accessible with free registration: <a href="https://developer.apple.com/download/more/">https://developer.apple.com/download/more/</a> </p>
<p>
The list of macOS versions and the last version of Xcode compatible with them are laid out nicely on the Wikipedia page on Xcode: <a href="https://en.wikipedia.org/wiki/Xcode#Version_comparison_table">https://en.wikipedia.org/wiki/Xcode#Version_comparison_table</a> </p>
<p>
And because Xcode is being installed manually, you can skip the step to install the Xcode command line tools (do not run "<code>xcode-select --install</code>") but otherwise build Tux Paint using the same steps described in the earlier part of this document. </p>
</blockquote>
</blockquote>
</blockquote>
<hr size="2" noshade />
<h2>
<a name="debugging" id="debugging">
Debugging </a>
</h2>
<blockquote>
Le débogage (vers "STDOUT", par exemple le terminal, ou vers un fichier "<code>stdout.txt</code>", sous Windows) peut être activé en définissant "<code>DEBUG</code>" (et, si un mode verbeux est souhaité, "<code>VERBOSE</code>") <code># define</code> dans "<code>src/debug.h</code>. </blockquote>
<hr size="2" noshade />
<h2>
<a name="uninstalling" id="uninstalling">
Uninstalling Tux Paint </h2>
</h2>
<blockquote>
<h3>
<a name="uninstalling-windows" id="uninstalling-windows">
Windows </a>
</h3>
<blockquote>
<h4>Utilisation du désinstalleur</h4>
<blockquote>
<p>
Si vous avez installé les raccourcis du menu Démarrer (par défaut), accédez au dossier TuxPaint et sélectionnez "Désinstaller". Une boîte s'affichera qui confirme que vous êtes sur le point de désinstaller Tux Paint et, si vous en êtes certain et que vous souhaitez supprimer définitivement Tux Paint, cliquez sur le bouton 'Désinstaller'. </p>
<p>
Quand c'est fini, cliquez sur "Fermer". </p>
</blockquote>
<h4>En utilisant le panneau de configuration</h4>
<blockquote>
<p>
Il est également possible d'utiliser l'entrée "TuxPaint (supprimer uniquement)" dans la Section Ajout / Suppression de programmes du Panneau de configuration. </p>
</blockquote>
</blockquote>
<hr size="1" noshade />
<h3>
<a name="uninstalling-linux" id="uninstalling-linux">
Linux </a>
</h3>
<blockquote>
<p>
Dans le répertoire source de Tux Paint (où vous avez compilé Tux Paint), vous pouvez utiliser une cible "<code>make uninstall</code>" pour désinstaller Tux Paint. Par défaut, cela doit être fait par l'utilisateur "root" ("superutilisateur"), mais si vous avez installé Tux Paint à un autre endroit (par ex. en mettant "<code>PREFIX=...</code>" à "<code>make</code>" et "<code>make install</code>", vous ne pourrez pas, et il faudra fournier les mêmes réglages ici. (Voir les instructions d'installation ci-dessus pour plus d'informations.) </p>
</blockquote>
<blockquote>
</body>
</html>