Merging win32/buildwin.html contents into INSTALL

This commit is contained in:
Bill Kendrick 2021-08-31 00:44:55 -07:00
parent 0bcad18c4b
commit 06e03d77e6
24 changed files with 2476 additions and 613 deletions

View file

@ -8,7 +8,7 @@ http://www.tuxpaint.org/
$Id$
2021.August.30 (0.9.27)
2021.August.31 (0.9.27)
* Documentation updates
---------------------
* Ensured Tux Paint's built-in help ("tuxpaint --help"),
@ -32,6 +32,10 @@ $Id$
("Options Documentation", "FAQ", "Installation Documentation",
and "Advanced Stamps 'How-To'").
* Moved Windows compilation instructions into main
"Installation Documentation".
2021.June.28 (0.9.26)
* New Features
------------

View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/
August 30, 2021
August 31, 2021
----------------------------------------------------------------------
@ -143,47 +143,237 @@ Compiling and Installation
Windows Users
Compiling:
Compiling Set-Up
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile"
includes support for building on a Windows system using MinGW/MSYS
(http://www.mingw.org/).
(https://sourceforge.net/projects/msys2/).
After configuring the environment and building and installing all
the dependencies, use these commands, in MSYS, to build, install and
run:
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Prior to version 0.9.20:
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
$ make win32
$ make install-win32
$ tuxpaint
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Enter] or
[Return] to accept the defaults for all questions):
Version 0.9.20 and beyond:
pacman -Syu
$ make
$ make install
$ tuxpaint
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Use the following command to build a version suitable for
redistribution with the installer or in a zip-file:
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
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.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
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.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick 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.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Or if building for Win9x/ME:
Note: 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 "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
$ BDIST_WIN9X=1 make bdist-win32
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Before any of the above will work, you need to configure the
environment and build or install the libraries that Tux Paint
depends upon. John Popplewell put together some instructions for
doing that here:
Building the Tux Paint Windows Installer:
http://www.johnnypops.co.uk/tuxpaint/
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Read the relevant notes if building for Win9X/ME.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Running the Installer:
Running the Tux Paint Windows Installer:
Double-click the Tux Paint installer executable (.EXE file) and
follow the instructions.

View file

@ -6,7 +6,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/
August 8, 2021
August 31, 2021
----------------------------------------------------------------------

View file

@ -26,7 +26,7 @@
</p>
<p>
August 30, 2021 </p>
August 31, 2021 </p>
</center>
<hr size="2" noshade />
@ -234,59 +234,292 @@
Windows Users </a>
</h3>
<blockquote>
<h4>Compiling:</h4>
<h4>Compiling Set-Up</h4>
<blockquote>
<p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="http://www.mingw.org/">http://www.mingw.org/</a>). </p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p>
After configuring the environment and building and installing all the dependencies, use these commands, in MSYS, to build, install and run: </p>
<h5>Prior to version 0.9.20:</h5>
<blockquote>
<code>
$ make win32<br/>
$ make install-win32<br/>
$ tuxpaint
</code>
</blockquote>
<h5>Version 0.9.20 and beyond:</h5>
<blockquote>
<code>
$ make<br/>
$ make install<br/>
$ tuxpaint
</code>
</blockquote>
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>
Use the following command to build a version suitable for redistribution with the installer or in a zip-file: </p>
<blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
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>
Or if building for Win9x/ME: </p>
<blockquote>
<code>
$ BDIST_WIN9X=1 make bdist-win32
</code>
</blockquote>
<p>
Before any of the above will work, you need to configure the environment and build or install the libraries that Tux Paint depends upon. John Popplewell put together some instructions for doing that here: </p>
<p>
<a href="http://www.johnnypops.co.uk/tuxpaint/">http://www.johnnypops.co.uk/tuxpaint/</a>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions):
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p>
Read the relevant notes if building for Win9X/ME. </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>
<h4>Running the Installer:</h4>
<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>
<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>
<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>
<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>
<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>
<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>
<h4>Running the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
Double-click the Tux Paint installer executable (.EXE file) and follow the instructions.

View file

@ -28,7 +28,7 @@
</p>
<p>
August 8, 2021 </p>
August 31, 2021 </p>
</center>
<hr size="2"
@ -605,7 +605,7 @@
Choose a font (from the 'Letters' available on the right) and a color (from the color palette near the bottom). Click on the screen and a cursor will appear. Type text and it will show up on the screen. </p>
<p>
Press <strong><code>[Enter]</code></strong> or <strong><code>[Return]</code></strong> and the text will be drawn onto the picture and the cursor will move down one line. </p>
Press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> and the text will be drawn onto the picture and the cursor will move down one line. </p>
<p>
Alternatively, press <strong><code>[Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.) </p>

View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/
agosto 30, 2021
agosto 31, 2021
----------------------------------------------------------------------
@ -143,47 +143,237 @@ Compiling and Installation
Windows Users
Compiling:
Compiling Set-Up
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile"
includes support for building on a Windows system using MinGW/MSYS
(http://www.mingw.org/).
(https://sourceforge.net/projects/msys2/).
After configuring the environment and building and installing all
the dependencies, use these commands, in MSYS, to build, install and
run:
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Prior to version 0.9.20:
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
$ make win32
$ make install-win32
$ tuxpaint
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Enter] or
[Return] to accept the defaults for all questions):
Version 0.9.20 and beyond:
pacman -Syu
$ make
$ make install
$ tuxpaint
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Use the following command to build a version suitable for
redistribution with the installer or in a zip-file:
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
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.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
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.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick 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.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Or if building for Win9x/ME:
Note: 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 "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
$ BDIST_WIN9X=1 make bdist-win32
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Before any of the above will work, you need to configure the
environment and build or install the libraries that Tux Paint
depends upon. John Popplewell put together some instructions for
doing that here:
Building the Tux Paint Windows Installer:
http://www.johnnypops.co.uk/tuxpaint/
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Read the relevant notes if building for Win9X/ME.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Running the Installer:
Running the Tux Paint Windows Installer:
Double-click the Tux Paint installer executable (.EXE file) and
follow the instructions.

View file

@ -6,7 +6,7 @@
Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/
agosto 8, 2021
agosto 31, 2021
----------------------------------------------------------------------

View file

@ -26,7 +26,7 @@
</p>
<p>
agosto 30, 2021 </p>
agosto 31, 2021 </p>
</center>
<hr size="2" noshade />
@ -234,59 +234,292 @@
Windows Users </a>
</h3>
<blockquote>
<h4>Compiling:</h4>
<h4>Compiling Set-Up</h4>
<blockquote>
<p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="http://www.mingw.org/">http://www.mingw.org/</a>). </p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p>
After configuring the environment and building and installing all the dependencies, use these commands, in MSYS, to build, install and run: </p>
<h5>Prior to version 0.9.20:</h5>
<blockquote>
<code>
$ make win32<br/>
$ make install-win32<br/>
$ tuxpaint
</code>
</blockquote>
<h5>Version 0.9.20 and beyond:</h5>
<blockquote>
<code>
$ make<br/>
$ make install<br/>
$ tuxpaint
</code>
</blockquote>
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>
Use the following command to build a version suitable for redistribution with the installer or in a zip-file: </p>
<blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
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>
Or if building for Win9x/ME: </p>
<blockquote>
<code>
$ BDIST_WIN9X=1 make bdist-win32
</code>
</blockquote>
<p>
Before any of the above will work, you need to configure the environment and build or install the libraries that Tux Paint depends upon. John Popplewell put together some instructions for doing that here: </p>
<p>
<a href="http://www.johnnypops.co.uk/tuxpaint/">http://www.johnnypops.co.uk/tuxpaint/</a>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions):
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p>
Read the relevant notes if building for Win9X/ME. </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>
<h4>Running the Installer:</h4>
<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>
<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>
<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>
<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>
<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>
<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>
<h4>Running the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
Double-click the Tux Paint installer executable (.EXE file) and follow the instructions.

View file

@ -28,7 +28,7 @@
</p>
<p>
agosto 8, 2021 </p>
agosto 31, 2021 </p>
</center>
<hr size="2"
@ -605,7 +605,7 @@
Choose a font (from the 'Letters' available on the right) and a color (from the color palette near the bottom). Click on the screen and a cursor will appear. Type text and it will show up on the screen. </p>
<p>
Press <strong><code>[Enter]</code></strong> or <strong><code>[Return]</code></strong> and the text will be drawn onto the picture and the cursor will move down one line. </p>
Press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> and the text will be drawn onto the picture and the cursor will move down one line. </p>
<p>
Alternatively, press <strong><code>[Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.) </p>

View file

@ -5,7 +5,7 @@
Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS.
http://www.tuxpaint.org/
août 30, 2021
août 31, 2021
----------------------------------------------------------------------
@ -146,47 +146,237 @@ Compiling and Installation
Utilisateurs de Windows
Compilation :
Compiling Set-Up
Depuis février 2005 (à partir de Tux Paint 0.9.15), le "Makefile"
inclut la prise en charge de la construction sur un système Windows
à l'aide de MinGW/MSYS (http://www.mingw.org/).
à l'aide de MinGW/MSYS (https://sourceforge.net/projects/msys2/).
Après avoir configuré l'environnement et construit et installé tous
les dépendances, utilisez ces commandes, dans MSYS, pour créer,
installer et exécuter :
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Avant la version 0.9.20 :
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
$ make win32
$ make install-win32
$ tuxpaint
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Entrée] or
[Retour] to accept the defaults for all questions):
Version 0.9.20 et au-delà :
pacman -Syu
$ make
$ make install
$ tuxpaint
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Utilisez la commande suivante pour construire une version adaptée à
la redistribution avec l'installateur ou bien un fichier zip :
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
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.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
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.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick 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.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Ou bien si vous compilez pour Win9x/ME :
Note: 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 "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
$ BDIST_WIN9X=1 make bdist-win32
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Avant de mettre en oeuvre les opérations ci-dessus, vous devez
configurer l'environnement et compilez ou installez les
bibliothèques nécessaires pour Tux Paint. John Popplewell a
rassemblé quelques instructions ici pour y parvenir :
Building the Tux Paint Windows Installer:
http://www.johnnypops.co.uk/tuxpaint/
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Lisez les notes pertinentes si vous construisez pour Win9X / ME.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Installateur :
Running the Tux Paint Windows Installer:
Double-cliquez sur l'exécutable du programme d'installation de Tux
Paint (fichier .EXE) et Suivez les instructions.

View file

@ -6,7 +6,7 @@
Copyright &copie; 2002-2021 par divers contributeurs; voir AUTHORS.
http://www.tuxpaint.org/
août 8, 2021
août 31, 2021
----------------------------------------------------------------------
@ -367,8 +367,9 @@ Outils disponibles
bas). Cliquez sur l'écran et un curseur apparaîtra. Tapez un
texte et il apparaîtra à l'écran.
Appuyez sur [Enter] ou [Return] et le texte sera inclus dans
l'image et le curseur se déplacera d'une ligne vers le bas.
Appuyez sur [Entrée] ou [Retour] et le texte sera inclus
dans l'image et le curseur se déplacera d'une ligne vers le
bas.
Sinon, appuyez sur [Tab] et le texte sera inclus dans
l'image, mais le curseur se déplacera vers la droite du

View file

@ -26,7 +26,7 @@
</p>
<p>
août 30, 2021 </p>
août 31, 2021 </p>
</center>
<hr size="2" noshade />
@ -234,59 +234,292 @@
Utilisateurs de Windows </a>
</h3>
<blockquote>
<h4>Compilation :</h4>
<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="http://www.mingw.org/">http://www.mingw.org/</a>). </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>
Après avoir configuré l'environnement et construit et installé tous les dépendances, utilisez ces commandes, dans MSYS, pour créer, installer et exécuter : </p>
<h5>Avant la version 0.9.20 :</h5>
<blockquote>
<code>
$ make win32<br/>
$ make install-win32<br/>
$ tuxpaint
</code>
</blockquote>
<h5>Version 0.9.20 et au-delà :</h5>
<blockquote>
<code>
$ make<br/>
$ make install<br/>
$ tuxpaint
</code>
</blockquote>
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>
Utilisez la commande suivante pour construire une version adaptée à la redistribution avec l'installateur ou bien un fichier zip : </p>
<blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
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>
Ou bien si vous compilez pour Win9x/ME : </p>
<blockquote>
<code>
$ BDIST_WIN9X=1 make bdist-win32
</code>
</blockquote>
<p>
Avant de mettre en oeuvre les opérations ci-dessus, vous devez configurer l'environnement et compilez ou installez les bibliothèques nécessaires pour Tux Paint. John Popplewell a rassemblé quelques instructions ici pour y parvenir : </p>
<p>
<a href="http://www.johnnypops.co.uk/tuxpaint/">http://www.johnnypops.co.uk/tuxpaint/</a>
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>
Lisez les notes pertinentes si vous construisez pour Win9X / ME. </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>
<h4>Installateur :</h4>
<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>
<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>
<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>
<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>
<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>
<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>
<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.

View file

@ -28,7 +28,7 @@
</p>
<p>
août 8, 2021 </p>
août 31, 2021 </p>
</center>
<hr size="2"
@ -605,7 +605,7 @@
Choisissez une police (parmi les «Lettres» disponibles sur la droite) et une couleur (dans la palette de couleurs en bas). Cliquez sur l'écran et un curseur apparaîtra. Tapez un texte et il apparaîtra à l'écran. </p>
<p>
Appuyez sur <strong><code>[Enter]</code></strong> ou <strong><code>[Return]</code></strong> et le texte sera inclus dans l'image et le curseur se déplacera d'une ligne vers le bas. </p>
Appuyez sur <b><code>[Entrée]</code></b> ou <b><code>[Retour]</code></b> et le texte sera inclus dans l'image et le curseur se déplacera d'une ligne vers le bas. </p>
<p>
Sinon, appuyez sur <strong><code>[Tab]</code></strong> et le texte sera inclus dans l'image, mais le curseur se déplacera vers la droite du texte, plutôt que vers le bas d'une ligne et vers la gauche. (Cela peut être utile pour créer une ligne de texte avec des couleurs, des polices, des styles et des tailles variés.) </p>

View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES).
http://www.tuxpaint.org/
30 de Agosto de 2021
31 de Agosto de 2021
----------------------------------------------------------------------
@ -147,46 +147,237 @@ Compiling and Installation
Usuarios de Windows
Compilación:
Compiling Set-Up
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o
«Makefile» inclúe compatibilidade para construír nun sistema Windows
usando MinGW/MSYS (http://www.mingw.org/).
usando MinGW/MSYS (https://sourceforge.net/projects/msys2/).
Após configurar o contorno e construír e instalar todas as
dependencias, use estas ordes en MSYS para construír, instalar e
executar:
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Antes da versión 0.9.20:
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
$ make win32
$ make install-win32
$ tuxpaint
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Intro] or
[Retorno] to accept the defaults for all questions):
Versión 0.9.20 e posteriores:
pacman -Syu
$ make
$ make install
$ tuxpaint
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Use a seguinte orde para crear unha versión axeitada para a
redistribución co instalador ou nun ficheiro zip:
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
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.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
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.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick 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.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Ou se está a construír para Win9x/ME:
Note: 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 "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
$ BDIST_WIN9X=1 make bdist-win32
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Antes de que calquera dos anteriores funcione, cómpre configurar o
contorno e construír ou instalar as bibliotecas das que depende Tux
Paint. John Popplewell xuntou aquí algunhas instrucións para facelo:
Building the Tux Paint Windows Installer:
http://www.johnnypops.co.uk/tuxpaint/
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Lea as notas pertinentes se está a construír para Win9X/ME.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Executar o instalador:
Running the Tux Paint Windows Installer:
Faga dobre clic no executábel do instalador de Tux Paint (ficheiro
.EXE) e siga as instrucións.

View file

@ -6,7 +6,7 @@
Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES).
http://www.tuxpaint.org/
8 de Agosto de 2021
31 de Agosto de 2021
----------------------------------------------------------------------
@ -348,8 +348,8 @@ Ferramentas dispoñíbeis
inferior). prema na pantalla e aparecerá un cursor. Escriba
un texto e aparecerá na pantalla.
Prema [Enter] ou [Return] e o texto será debuxado na imaxe e
o cursor moverase cara abaixo unha liña.
Prema [Intro] ou [Retorno] e o texto será debuxado na imaxe
e o cursor moverase cara abaixo unha liña.
Como alternativa, prema [Tab] e o texto será debuxado na
imaxe, mais o cursor moverase á dereita do texto, no canto

View file

@ -26,7 +26,7 @@
</p>
<p>
30 de Agosto de 2021 </p>
31 de Agosto de 2021 </p>
</center>
<hr size="2" noshade />
@ -234,59 +234,292 @@
Usuarios de Windows </a>
</h3>
<blockquote>
<h4>Compilación:</h4>
<h4>Compiling Set-Up</h4>
<blockquote>
<p>
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «<code>Makefile</code>» inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS (<a href="http://www.mingw.org/">http://www.mingw.org/</a>). </p>
A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «<code>Makefile</code>» inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p>
Após configurar o contorno e construír e instalar todas as dependencias, use estas ordes en MSYS para construír, instalar e executar: </p>
<h5>Antes da versión 0.9.20:</h5>
<blockquote>
<code>
$ make win32<br/>
$ make install-win32<br/>
$ tuxpaint
</code>
</blockquote>
<h5>Versión 0.9.20 e posteriores:</h5>
<blockquote>
<code>
$ make<br/>
$ make install<br/>
$ tuxpaint
</code>
</blockquote>
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>
Use a seguinte orde para crear unha versión axeitada para a redistribución co instalador ou nun ficheiro zip: </p>
<blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
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>
Ou se está a construír para Win9x/ME: </p>
<blockquote>
<code>
$ BDIST_WIN9X=1 make bdist-win32
</code>
</blockquote>
<p>
Antes de que calquera dos anteriores funcione, cómpre configurar o contorno e construír ou instalar as bibliotecas das que depende Tux Paint. John Popplewell xuntou aquí algunhas instrucións para facelo: </p>
<p>
<a href="http://www.johnnypops.co.uk/tuxpaint/">http://www.johnnypops.co.uk/tuxpaint/</a>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Intro]</code></b> or <b><code>[Retorno]</code></b> to accept the defaults for all questions):
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p>
Lea as notas pertinentes se está a construír para Win9X/ME. </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>
<h4>Executar o instalador:</h4>
<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>
<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>
<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>
<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>
<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>
<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>
<h4>Running the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
Faga dobre clic no executábel do instalador de Tux Paint (ficheiro .EXE) e siga as instrucións.

View file

@ -28,7 +28,7 @@
</p>
<p>
8 de Agosto de 2021 </p>
31 de Agosto de 2021 </p>
</center>
<hr size="2"
@ -605,7 +605,7 @@
Escolla un tipo de letra (entre as «Letras» dispoñíbeis á dereita) e unha cor (na paleta de cores preto da parte inferior). prema na pantalla e aparecerá un cursor. Escriba un texto e aparecerá na pantalla. </p>
<p>
Prema <strong><code>[Enter]</code></strong> ou <strong><code>[Return]</code></strong> e o texto será debuxado na imaxe e o cursor moverase cara abaixo unha liña. </p>
Prema <b><code>[Intro]</code></b> ou <b><code>[Retorno]</code></b> e o texto será debuxado na imaxe e o cursor moverase cara abaixo unha liña. </p>
<p>
Como alternativa, prema <strong><code>[Tab]</code></strong> e o texto será debuxado na imaxe, mais o cursor moverase á dereita do texto, no canto de baixar unha liña e á esquerda. (Isto pode ser útil para crear unha liña de texto con cores, tipos de letra, estilos e tamaños mesturados.) </p>

View file

@ -5,7 +5,7 @@
Copyright © 2002-2021 by various contributors; "AUTHORS" 参照.
http://www.tuxpaint.org/
2021年8月30
2021年8月31
----------------------------------------------------------------------
@ -143,47 +143,237 @@ Compiling and Installation
Windows のユーザー
Compiling:
Compiling Set-Up
As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile"
includes support for building on a Windows system using MinGW/MSYS
(http://www.mingw.org/).
(https://sourceforge.net/projects/msys2/).
After configuring the environment and building and installing all
the dependencies, use these commands, in MSYS, to build, install and
run:
Many tools and libraries are required to build Tux Paint. The
package management system "pacman" helps you install them
automatically solving complicated dependencies.
Prior to version 0.9.20:
Download the latest MSYS2 environment from
https://sourceforge.net/projects/msys2/files/Base/ and install it
where you'd like (the default is
"https://sourceforge.net/projects/msys2/files/Base/")
$ make win32
$ make install-win32
$ tuxpaint
Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
"MSYS2 MSYS" and execute following command (press [Enter] or
[Return] to accept the defaults for all questions):
Version 0.9.20 and beyond:
pacman -Syu
$ make
$ make install
$ tuxpaint
This will update core system and the window will close
automatically. Repeat the steps above one more time to finish the
remaining update process.
Use the following command to build a version suitable for
redistribution with the installer or in a zip-file:
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
to the "MinGW 32bit (i686) toolchains" section if you need only a
32bit build environment.
MinGW 64bit (x86_64) toolchains
Within the MSYS2 shell, run the following command to install basic
64bit development tools:
pacman -S mingw-w64-x86_64-toolchain
64bit (x86_64) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 64bit environment
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.
This time, use the MinGW "64bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
to the "ImageMagick" section if you need only a 64bit build
environment.
MinGW 32bit (i686) toolchains
Within the MSYS2 shell, run the following command to install basic
32bit development tools:
pacman -S mingw-w64-i686-toolchain
32bit (i686) dependency libraries for Tux Paint
You can install tools and libraries required for compiling Tux Paint
on MSYS2/MINGW using "pacman" except for SDL_Pango.
"ntldd" is a small tool which examine windows executable files to
list Dynamic Link Library (.dll) files they depends on. Tux Paint's
packaging process for binary distribution uses it to find required
.dll files.
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
You can skip installing it if you are only building "Tux Paint".
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango and re-install SDL on the 32bit environment
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.
This time, use the MinGW "32bit" shell. Open the shell from the
"Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"
SDL_Pango
At first, you have to prepare source tar-ball and a required patch
in the same directory.
* Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
page on Sourceforge.net.
* Download a patch file from John Popplewell's "Tux Paint -
MinGW/MSYS build instructions" webpage. (This adds some extra
(required) functionality to SDL_Pango.)
Build and install SDL_Pango as follows.
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
SDL
Download source tar-ball of SDL_1.2.15 from libsdl.org.
Re-install SDL as follows.
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick 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.
Using official binary release available from "Windows Binary
Release" is recommended, due to the commands installed with "pacman"
on MinGW/MSYS not working as expected!
Do not forget to enable "Install legacy utilities (e.g. convert)"
while installing it, because Tux Paint's build process uses them.
Add the path to the directory in which ImageMagick is installed at
the top of your "PATH" environment variable. For example:
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH
You can make this permanent by adding the above to your the BASH
shell configuration file, "~/.bash_profile".
Tux Paint
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
binaries using MSYS2 32bit shell, respectively.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
Menu" to open the 64bit shell.
* Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
Menu" to open the 32bit shell.
Compile Tux Paint with the following command:
$ make bdist-win32
Or if building for Win9x/ME:
Note: 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 "tuxpaint-config" (with no version
number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
INSTALL.txt documentation for details.
$ BDIST_WIN9X=1 make bdist-win32
All the files needed for starting Tux Paint (and Tux Paint Config.)
are collected in the directory for binary distribution "bdist"
directory under "win32". You can start them by double-clicking their
executable (.exe) files in the "bdist" directory.
Before any of the above will work, you need to configure the
environment and build or install the libraries that Tux Paint
depends upon. John Popplewell put together some instructions for
doing that here:
Building the Tux Paint Windows Installer:
http://www.johnnypops.co.uk/tuxpaint/
Inno Setup is used to build executable installer for Tux Paint.
Therefore you have to install it in the first place.
Read the relevant notes if building for Win9X/ME.
Then, you can easily build an executable installer by right-clicking
on the "tuxpaint.iss" icon in the "win32" directory and selecting
"Compile" on the list. It will run for a while, and eventually you
will find a "tuxpaint-X.Y.Z-win32-installer.exe" file in the same
directory.
Running the Installer:
Running the Tux Paint Windows Installer:
Double-click the Tux Paint installer executable (.EXE file) and
follow the instructions.

View file

@ -6,7 +6,7 @@
Copyright © 2002-2021 by various contributors; "AUTHORS" 参照.
http://www.tuxpaint.org/
2021年8月 8
2021年8月31
----------------------------------------------------------------------

View file

@ -26,7 +26,7 @@
</p>
<p>
2021年8月30</p>
2021年8月31</p>
</center>
<hr size="2" noshade />
@ -234,59 +234,292 @@
Windows のユーザー </a>
</h3>
<blockquote>
<h4>Compiling:</h4>
<h4>Compiling Set-Up</h4>
<blockquote>
<p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="http://www.mingw.org/">http://www.mingw.org/</a>). </p>
As of February 2005 (starting with Tux Paint 0.9.15), the "<code>Makefile</code>" includes support for building on a Windows system using MinGW/MSYS (<a href="https://sourceforge.net/projects/msys2/">https://sourceforge.net/projects/msys2/</a>). </p>
<p>
After configuring the environment and building and installing all the dependencies, use these commands, in MSYS, to build, install and run: </p>
<h5>Prior to version 0.9.20:</h5>
<blockquote>
<code>
$ make win32<br/>
$ make install-win32<br/>
$ tuxpaint
</code>
</blockquote>
<h5>Version 0.9.20 and beyond:</h5>
<blockquote>
<code>
$ make<br/>
$ make install<br/>
$ tuxpaint
</code>
</blockquote>
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>
Use the following command to build a version suitable for redistribution with the installer or in a zip-file: </p>
<blockquote>
<code>
$ make bdist-win32
</code>
</blockquote>
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>
Or if building for Win9x/ME: </p>
<blockquote>
<code>
$ BDIST_WIN9X=1 make bdist-win32
</code>
</blockquote>
<p>
Before any of the above will work, you need to configure the environment and build or install the libraries that Tux Paint depends upon. John Popplewell put together some instructions for doing that here: </p>
<p>
<a href="http://www.johnnypops.co.uk/tuxpaint/">http://www.johnnypops.co.uk/tuxpaint/</a>
Open the MSYS2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command (press <b><code>[Enter]</code></b> or <b><code>[Return]</code></b> to accept the defaults for all questions):
<blockquote>
<code>
pacman -Syu
</code>
</blockquote>
</p>
<p>
Read the relevant notes if building for Win9X/ME. </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>
<h4>Running the Installer:</h4>
<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>
<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>
<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>
<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>
<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>
<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>
<h4>Running the Tux Paint Windows Installer:</h4>
<blockquote>
<p>
Double-click the Tux Paint installer executable (.EXE file) and follow the instructions.

View file

@ -28,7 +28,7 @@
</p>
<p>
2021年8月 8</p>
2021年8月31</p>
</center>
<hr size="2"
@ -605,7 +605,7 @@
まず、右側のセレクタからフォントを、下部のパレットから色を選択します。画面をクリックするとカーソルが表示され、文字を入力することができます。 </p>
<p>
<strong><code>[Enter]</code></strong>キー、または<strong><code>[Return]</code></strong>キーを押すと文字が描画され、カーソルが次の行に下がります。 </p>
<b><code>[Enter]</code></b>キー、または<b><code>[Return]</code></b>キーを押すと文字が描画され、カーソルが次の行に下がります。 </p>
<p>
また、<strong><code>[Tab]</code></strong>キーを押すと、文字が描画された後、カーソルは、次の行ではなく、右側に移動します。これは、1行の中で異なったフォント、字体、フォントサイズ、色などを混在させたい場合に便利な方法です。 </p>

1
win32/README.txt Normal file
View file

@ -0,0 +1 @@
See INSTALL.txt or INSTALL.html, in "../docs"

View file

@ -1,257 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<HTML LANG="en">
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<TITLE>Compiling Tux Paint using MinGW/MSYS2</TITLE>
<META HTTP-EQUIV="CONTENT-STYLE-TYPE" CONTENT="text/css">
<style type="text/css">
<!--
div.level1 {margin: 0em 2em 0em 2em;}
div.level2 {margin: 0em 0em 0em 2em;}
div.level3 {margin: 0em 0em 0em 2em;}
div.level4 {margin: 0em 0em 0em 2em;}
div.level5 {margin: 0em 0em 0em 2em;}
div.footer {text-align: right; margin: 0em 0em 2em 0em;}
A:Link,A:Visited,A:Active{color:#4169E1;}
A:Hover{background-color:pink;color:navy;}
pre{overflow-x: auto; color: #aa0000;background-color:#e0ffff;line-height:1.5em;margin:0.5em 0em 0.5em 0em;padding:1em;}
hr {margin: 2em 0em 1em 0em;}
-->
</style>
</HEAD>
<BODY>
<div class="level1">
<H1>Compiling Tux Paint using MinGW/MSYS2</H1>
<p>This document provides how to compile <a href="http://www.tuxpaint.org/">Tux Paint</a> with MinGW/MSYS2 on Microsoft Windows.</p>
<HR>
<H2>MinGW/MSYS2 toolchains and required libraries</H2>
<p>So many tools and libraries are required to build Tux Paint. The package management system "pacman" helps you install them automatically solving complicated dependencies.</p>
<div class="level2">
<hr>
<h3>MSYS2</h3>
<p>First of all, you have to install latest MSYS2 as follows.</p>
<UL>
<LI>Download the installer "msys2-x86_64-xxxxxxxx.exe from <a href="https://sourceforge.net/projects/msys2/">Sourceforge.net</a></LI>
<LI>Install MSYS2 into your favorite directory (default to "C:\msys64")</LI>
</UL>
<p>Open the msys2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and execute following command.</p>
<pre>
$ pacman -Syu
# (press &lt;ENTER&gt; for all inquiry)
</pre>
<p>This will update core system and the window will close automatically.</p>
<p>Open the msys2 shell again and execute following command to finish remaining updating process.</p>
<pre>
$ pacman -Syu
# (press &lt;ENTER&gt; for all inquiry)
</pre>
<p>Install basic development tools as follows.
<pre>
$ pacman -S base-devel msys2-devel git
# (press &lt;ENTER&gt; for all inquiry)
</pre>
<p>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.</p>
<hr>
<H3><a name=64bit>MinGW 64bit (x86_64) toolchains</a></H3>
<p>Open the msys2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and install basic 64bit development tools as follows.</p>
<pre>
$ pacman -S mingw-w64-x86_64-toolchain
# (press &lt;ENTER&gt; for all inquiry)
</pre>
<H3>64bit (x86_64) dependency libraries for Tux Paint</a></H3>
<p>You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "pacman" except for SDL_Pango.</p>
<p>"ntldd" is a small tool which examine windows executable files to list dynamic link library (.dll) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required .dll files.</p>
<pre>
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-x86_64-librsvg
$ pacman -S mingw-w64-x86_64-fribidi
$ pacman -S mingw-w64-x86_64-libimagequant
$ pacman -S mingw-w64-x86_64-fltk
$ pacman -S mingw64/mingw-w64-x86_64-ntldd-git
</pre>
<p>Close the shell before proceeding to the remaining process.</p>
<H3>Install SDL_Pango and re-install SDL on the 64bit environment.</H3>
<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" -> "MSYS2 64bit -> "MSYS2 MinGW 64-bit"</p>
<div class="level3">
<H4>SDL_Pango</H4>
<p>At first, you have to prepare source tar-ball and a patch required 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</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> which adds some extra (required) functionality to SDL_Pango from <a href="http://www.johnnypops.co.uk/tuxpaint/">"Tux Paint - MinGW/MSYS build instructions"</a>.
</UL>
<p>Build and install SDL_Pango as follows.</p>
<pre>
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
</pre>
<H4>SDL</H4>
<p>Download <a href="http://www.libsdl.org/release/SDL-1.2.15.tar.gz">source tar-ball</a> from "<a href="http://www.libsdl.org/">libsdl.org</a>" and re-install SDL as follows.
<pre>
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw64 && make && make install
</pre>
</div>
<p>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.</p>
<hr>
<H3><a name=32bit>MinGW 32bit (i686) toolchains</a></H3>
<p>Open the msys2 shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MSYS" and install basic 32bit development tools as follows.</p>
<pre>
$ pacman -S mingw-w64-i686-toolchain
# (press &lt;ENTER&gt; for all inquiry)
</pre>
<H3>32bit (i686) dependency libraries for Tux Paint</a></H3>
<p>You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "pacman" except for SDL_Pango.</p>
<p>"ntldd" is a small tool which examin windows executable files to list dynamic link library (.dll) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required .dll files.</p>
<pre>
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf}
$ pacman -S mingw-w64-i686-librsvg
$ pacman -S mingw-w64-i686-fribidi
$ pacman -S mingw-w64-i686-libimagequant
$ pacman -S mingw-w64-i686-fltk
$ pacman -S mingw-w64-i686-ntldd-git
</pre>
<p>Close the shell before proceeding to the remaining process.</p>
<H3>Install SDL_Pango and re-install SDL on the 32bit environment.</H3>
<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" -> "MSYS2 64bit -> "MSYS2 MinGW 32-bit"</p>
<div class="level3">
<H4>SDL_Pango</H4>
<p>At first, you have to prepare source tar-ball and a patch required 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</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> which adds some extra (required) functionality to SDL_Pango from <a href="http://www.johnnypops.co.uk/tuxpaint/">"Tux Paint - MinGW/MSYS build instructions"</a>.
</UL>
<p>Build and install SDL_Pango as follows.</p>
<pre>
$ tar zxvf SDL_Pango-0.1.2.tar.gz
$ cd SDL_Pango-0.1.2/
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
</pre>
<H4>SDL</H4>
<p>Download <a href="http://www.libsdl.org/release/SDL-1.2.15.tar.gz">source tar-ball</a> from "<a href="http://www.libsdl.org/">libsdl.org</a>" and re-install SDL as follows.
<pre>
$ tar zxvf SDL-1.2.15.tar.gz
$ cd SDL-1.2.15
$ ./configure --prefix=/mingw32 && make && make install
</pre>
</div>
<p>Proceed to the next <a href="#imagemagick">ImageMagick</a> section.</p>
</div>
<HR>
<H2><a name="imagemagick">ImageMagick</a></H2>
<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 in 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 because its commands installed using "pacman" on MinGW/MSYS do not work 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 the "PATH" environment variable. For example;</p>
<pre>
$ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH</pre>
<p>You make it default by describing above in the bash configuration file "~/.bash_profile".</p>
<HR>
<H2><a name="tuxpaint">Tux Paint</a></H2>
<p>You are able to compile 64bit binaries using MSYS2 64bit shell and 32bit binaries using 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>
<div class="level2">
<hr>
<h3>Tux Paint Config</h3>
<p>"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's behavior. You have to build this component before compiling Tux Paint if you want to have it included in your package.</p>
<p>You can use any of [a] <u>stable tar-ball release</u> or [b] <u>developing source tree</u>.<p>
<div class="level3">
<p>[a] Using stable tar-ball release.</p>
<div class="level4">
<UL>
<LI>Download <a href="http://sourceforge.net/projects/tuxpaint/files/tuxpaint-config/0.0.16/tuxpaint-config-0.0.16.tar.gz/download">source tar-ball</a> from <a href="http://sourceforge.net/projects/tuxpaint/">Tux Paint's page on Sourceforge.net</a>.</LI>
</UL>
<p>Expand the tar-ball and change the directory name so that the final packaging process can find related files.</p>
<pre>
$ tar zxvf tuxpaint-config-0.0.16.tar.gz
$ mv tuxpaint-config-0.0.16 tuxpaint-config
</pre>
</div>
<p>[b] Using developing source tree</p>
<div class="level4">
<p>Fetch the developing source tree from git repository.</p>
<pre>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config tuxpaint-config
</pre>
</div>
</div>
<p>Now you can build tuxpaint-config as follows.</p>
<pre>
$ cd tuxpaint-config
$ make win32
</pre>
<hr>
<h3>Tux Paint</h3>
<p>You can use any of [a] <u>stable tar-ball release</u> or [b] <u>developing source tree</u>.<p>
<div class="level3">
<p>[a] Using stable tar-ball release.</p>
<div class="level4">
<UL>
<LI>Download <a href="http://sourceforge.net/projects/tuxpaint/files/tuxpaint/0.9.25/tuxpaint-0.9.25.tar.gz/download">source tar-ball</a> from <a href="http://sourceforge.net/projects/tuxpaint/">Tux Paint's page on Sourceforge.net</a>.</LI>
</UL>
<p>Expand the tar-ball and enter to the top of the source tree.</p>
<pre>
$ tar zxvf tuxpaint-0.9.25.tar.gz
$ cd tuxpaint-0.9.25
</pre>
</div>
<p>[b] Using developing source tree</p>
<div class="level4">
<p>Fetch the developing source tree from git repository and enter to the top of the source tree.</p>
<pre>
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint
$ cd tuxpaint
</pre>
</div>
</div>
<p>Now you can build Tux Paint as follows.</p>
<pre>
$ make bdist-win32
</pre>
<p>All the files needed for starting Tux Paint and Tux Paint Config are collected in the directory for binary distribution "bdist" directory under "win32". You can start them by double-clicking .exe files in the "bdist" directory.</p>
<hr>
<h3>Tux Paint installer</h3>
<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>Inno Setup officially supports translations for only about 20 languages. However, one of the great points of Tux Paint is it supports so many languages. Therefore, the set up script "tuxpaint.iss" to build the installer is written to use much more translations including unofficial one which are available on "<a href="https://jrsoftware.org/files/istrans/">Inno Setup Translations</a>". You have to download translation files (.isl) required and put them in "Languages" directory under the directory in which Inno Setup is installed.</p>
<p>Then, you can easily build an executable installer just as follows.</p>
<UL>
<LI>Right-click on the "tuxpaint.iss" icon in the "win32" directory and select "Compile" on the list.</LI>
</UL>
<p>It takes for a while and you will find tuxpaint-x.x.xx-win32-installer.exe in the same directory.</p>
</div>
<hr>
<div class="footer">
Oct. 25, 2020<br>
Shin-ichi TOYAMA shin1@wmail.plala.or.jp
</div>
</div>
</BODY>
</HTML>

View file

@ -1,2 +0,0 @@
#define OpenCandy 1
#include "tuxpaint.iss"