notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Pulling in initial English from tuxpaint-docs

Browse source 
Documentation is now maintained in a separate source repository,
'tuxpaint-docs', which allows for easier and more consisten
translation of the documentation.  Pulling in initial version of
these docs, which contain a variety of minor updates (and also a
few which had previously only been available as plain TXT are now
available as HTML).

Pulling in the English stuff.
This commit is contained in:
Bill Kendrick 2021-02-05 00:40:17 -08:00
parent 9dd4dcf4aa
commit 72019b15d1
19 changed files with 3322 additions and 5810 deletions
Download patch file Download diff file Expand all files Collapse all files

254
docs/en/FAQ.txt
View file

@ -1,11 +1,10 @@
Tux Paint
version 0.9.26
Frequently Asked Questions
version 0.9.26 Frequently Asked Questions
Copyright (c) 2002-2020 by various contributors; see AUTHORS.txt
Copyright © 2002-2021 by various contributors; see AUTHORS.
http://www.tuxpaint.org/
September 14, 2002 - December 27, 2020
23 January 2021
----------------------------------------------------------------------
@ -24,12 +23,12 @@ Drawing-related
If you installed Tux Paint, but did not install the separate,
optional "Stamps" collection, quit Tux Paint and install it now.
It should be available from the same place you got the main
Tux Paint program. (Note: As of version 0.9.14, Tux Paint comes
with a small collection of example stamps.)
It should be available from the same place you got the main Tux
Paint program. (Note: As of version 0.9.14, Tux Paint comes with a
small collection of example stamps.)
If you don't want to install the default collection of stamps, you
can just create your own. See the EXTENDING TUX PAINT
can just create your own. See the "Extending Tux Paint"
documentation for more on creating PNG and SVG image files, TXT
text description files, Ogg Vorbis, MP3 or WAV sound files, and
DAT text data files that make up stamps.
@ -39,15 +38,15 @@ Drawing-related
(Either via a "--nostamps" option to Tux Paint's command line, or
"nostamps=yes" in the configuration file.)
If so, either change/remove the "nostamps" option, or you can
override it with "--stamps" on the command line or "nostamps=no"
or "stamps=yes" in a configuration file.
Either change/remove the "nostamps" option, or you can override it
with "--stamps" on the command line or either "nostamps=no" or
"stamps=yes" in a configuration file.
The Magic "Fill" Tool Looks Bad
The "Fill" Tool Looks Bad
Tux Paint is probably comparing exact pixel colors when filling.
This is faster, but looks worse. Run the command
"tuxpaint --version" from a command line, and you should see,
This is faster, but looks worse. Run the command "tuxpaint
--verbose-version" from a command line, and you should see,
amongst the other output: "Low Quality Flood Fill enabled".
To change this, you must rebuild Tux Paint from source. Be sure to
@ -61,8 +60,8 @@ Drawing-related
Tux Paint was built with low-quality (but faster) stamp outlines.
Rebuild Tux Paint from source. Be sure to remove or comment out
any line that says:
To change this, you must rebuild Tux Paint from source. Be sure to
remove or comment out any line that says:
#define LOW_QUALITY_STAMP_OUTLINE
@ -75,12 +74,13 @@ Interface Problems
Stamp thumbnails in the Stamp Selector look bad
Tux Paint was probably compiled with the faster, lower quality
thumbnail code enabled. Run the command: "tuxpaint --version" from
a command line. If, amongst the other output, you see the text:
"Low Quality Thumbnails enabled", then this is what's happening.
thumbnail code enabled. Run the command: "tuxpaint
--verbose-version" from a command line. If, amongst the other
output, you see the text: "Low Quality Thumbnails enabled", then
this is what's happening.
Rebuild Tux Paint from source. Be sure to remove or comment out
any line that says:
To change this, you must rebuild Tux Paint from source. Be sure to
remove or comment out any line that says:
#define LOW_QUALITY_THUMBNAILS
@ -93,13 +93,13 @@ Interface Problems
The color picker buttons are ugly squares, not pretty buttons!
Tux Paint was probably compiled with the nice looking color
selector buttons disabled. Run the command: "tuxpaint --version"
from a command line. If, amongst the other output, you see the
text: "Low Quality Color Selector enabled", then this is what's
happening.
selector buttons disabled. Run the command: "tuxpaint
--verbose-version" from a command line. If, amongst the other
output, you see the text: "Low Quality Color Selector enabled",
then this is what's happening.
Rebuild Tux Paint from source. Be sure to remove or comment out
any line that says:
To change this, you must rebuild Tux Paint from source. Be sure to
remove or comment out any line that says:
#define LOW_QUALITY_COLOR_SELECTOR
@ -109,26 +109,11 @@ Interface Problems
The "uppercase" option is on.
If you're running Tux Paint from a command-line, make sure you're
not giving it an "--uppercase" option.
Either change/remove the "uppercase" option, or you can override
it with "--mixedcase" on the command line or either "uppercase=no"
or "mixedcase=yes" in a configuration file.
If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--uppercase" is listed as a
command-line argument.
If "--uppercase" isn't being sent on the command line, check
Tux Paint's configuration file ("~/.tuxpaintrc" under Linux and
Unix, "tuxpaint.cfg" under Windows) for a line reading:
"uppercase=yes".
Either remove that line, or simply run Tux Paint with the
command-line argument: "--mixedcase", which will override the
uppercase setting.
Or use Tux Paint Config. and make sure "Show Uppercase Text Only"
(under "Languages") is not checked.
Tux Paint is in a different language!
Tux Paint is in a different language
Make sure your locale setting is correct. See "Tux Paint won't
switch to my language", below.
@ -136,13 +121,13 @@ Interface Problems
* Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your
"/etc/locale.gen" file. See the OPTIONS documentation for the
locales Tux Paint uses (especially when using the "--lang"
option).
"/etc/locale.gen" file. See the "Options Documentation" for
the locales Tux Paint uses (especially when using the
"--lang" option).
Note: Debian and derivative (e.g., Ubuntu) users can simply
run "dpkg-reconfigure locales" if the locales are managed by
"dpkg."
"dpkg".
* If you're using the "--lang" command-line option
@ -170,7 +155,7 @@ Interface Problems
The appropriate fonts for such locales can be downloaded from
the Tux Paint website:
http://www.tuxpaint,org/download/fonts/
http://www.tuxpaint.org/download/fonts/
----------------------------------------------------------------------
@ -186,20 +171,20 @@ Printing
the Common Unix Printing System, and do not have "cups-lpr"
installed), you will need to specify an appropriate command using
the "printcommand" option in Tux Paint's configuration file. (See
the OPTIONS documentation.)
the "Options Documentation".)
Note: Versions of Tux Paint prior to 0.9.15 used a different
default command for printing, "pngtopnm | pnmtops | lpr", as
Tux Paint output PNG format, rather than PostScript.
default command for printing, "pngtopnm | pnmtops | lpr", as Tux
Paint output PNG format, rather than PostScript.
If you had changed your "printcommand" option prior to Tux Paint
0.9.15, you will need to go back and alter it to accept
PostScript.
I get the message "You can't print yet!" when I go to print!
I get the message "You can't print yet!" when I go to print
The "print delay" option is on. You can only print once every
X seconds.
The "print delay" option is on. You can only print once every X
seconds.
If you're running Tux Paint from a command-line, make sure you're
not giving it a "--printdelay=..." option.
@ -209,22 +194,18 @@ Printing
command-line argument.
If a "--printdelay=..." option isn't being sent on the command
line, check Tux Paint's configuration file ("~/.tuxpaintrc" under
Linux and Unix, "tuxpaint.cfg" under Windows) for a line reading:
line, check Tux Paint's configuration file for a line reading:
"printdelay=...".
Either remove that line, set the delay value to 0 (no delay), or
decrease the delay to a value you prefer. (See the OPTIONS
documentation).
decrease the delay to a value you prefer. (See the "Options
Documentation".)
Or, you can simply run Tux Paint with the command-line argument:
"--printdelay=0", which will override the configuration file's
setting, and allow unlimited printing. (You won't have to wait
between prints.)
Or use Tux Paint Config. and make sure "Print Delay" (under
"Printing") is set to "0 seconds."
I simply can't print! The button is greyed out!
The "no print" option is on.
@ -233,12 +214,12 @@ Printing
not giving it a "--noprint" option.
If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noprint" is listed as an
argument.
properties of the icon to see if "--noprint" is listed as a
command-line argument.
If "--noprint" isn't on the command-line, check Tux Paint's
configuration file ("~/.tuxpaintrc" under Linux and Unix,
"tuxpaint.cfg" under Windows) for a line reading: "noprint=yes".
If a "--noprint" option isn't being sent on the command line,
check Tux Paint's configuration file for a line reading:
"noprint=yes".
Either remove that line, or simply run Tux Paint with the
command-line argument: "--print", which will override the
@ -254,7 +235,7 @@ Saving
Where does Tux Paint save my drawings?
Unless you asked Tux Paint to save into a specific location (using
the 'savedir' option), Tux Paint saves into a standard location on
the "savedir" option), Tux Paint saves into a standard location on
your local drive:
Windows Vista, Windows 8, Windows 10
@ -273,15 +254,15 @@ Saving
Support/TuxPaint/saved/
Linux / Unix
In the user's $HOME directory, under a ".tuxpaint"
subfolder:
In the user's home directory ("$HOME"), under a
".tuxpaint" subfolder:
e.g., /home/username/.tuxpaint/saved/
The images are stored as PNG bitmaps, which most modern programs
should be able to load (image editors, word processors, web
browsers, etc.)
Tux Paint always saves over my old picture!
Tux Paint always saves over my old picture
The "save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@ -290,12 +271,12 @@ Saving
not giving it a "--saveover" option.
If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveover" is listed as an
argument.
properties of the icon to see if "--saveover" is listed as a
command-line argument.
If "--saveover" isn't on the command-line, check Tux Paint's
configuration file ("~/.tuxpaintrc" under Linux and Unix,
"tuxpaint.cfg" under Windows) for a line reading: "saveover=yes".
If a "--saveover" option isn't being sent on the command line,
check Tux Paint's configuration file for a line reading:
"saveover=yes".
Either remove that line, or simply run Tux Paint with the
command-line argument: "--saveoverask", which will override the
@ -359,22 +340,25 @@ Audio Problems
program is "blocking" the sound device), then Tux Paint may
be running with a "no sound" option.
Make sure you're not running Tux Paint with the "--nosound"
option as a command-line argument. (See the OPTIONS
documentation for details.)
If you're running Tux Paint from a command-line, make sure
you're not giving it a "--nosound" option.
If it's not, then check the configuration file
("/etc/tuxpaint/tuxpaint.conf" and "~/.tuxpaintrc" under
Linux and Unix, and "tuxpaint.cfg" under Windows) for a line
reading: "nosound=yes".
If you're running Tux Paint by double-clicking an icon, check
the properties of the icon to see if "--nosound" is listed as
a command-line argument.
If a "--nosound" option isn't being sent on the command line,
check Tux Paint's configuration file for a line reading:
"nosound=yes".
Either remove that line, or simply run Tux Paint with the
command-line argument: "--sound", which will override the
configuration file's setting.
Alternatively, you can use Tux Paint Config. to change the
configuration file. Make sure "Enable Sound Effects" (under
"Video & Sound") is checked, then click "Apply".
Or, you can simply run Tux Paint with the command-line
argument: "Enable Sound Effects", which will override the
configuration file's setting, and allow unlimited printing.
(You won't have to wait between prints.)
* Were sounds temporarily disabled?
@ -389,7 +373,7 @@ Audio Problems
To test whether sound support was enabled when Tux Paint was
compiled, run Tux Paint from a command line, like so:
tuxpaint --version
tuxpaint --verbose-version
If, amongst the other information, you see "Sound disabled",
then the version of Tux Paint you're running has sound
@ -405,26 +389,28 @@ Audio Problems
* Press [Alt] + [S] while in Tux Paint to temporarily disable
sounds. (Press that key sequence again to re-enable sounds.)
* Run Tux Paint with the "no sound" option:
* Use Tux Paint Config to uncheck the "Enable Sound
Effects" option (under "Video & Sound").
* Edit Tux Paint's configuration file (see OPTIONS for
details) and add a line containing "nosound=yes".
* Run "tuxpaint --nosound" from the command line or
shortcut or desktop icon.
* Recompile Tux Paint with sound support disabled. (See
above and INSTALL.txt.)
* Edit Tux Paint's configuration file (see "Options
Documentation" for details) and add a line containing
"nosound=yes".
* Or use Tux Paint Config. and make sure "Enable Sound
Effects" (under "Video & Sound") is not checked.
* Alternatively, recompile Tux Paint with sound support
disabled. (See above, and the 'Install' documentation.
The stereo panning of sound effects is bothersome; can sound effects be
monophonic?
Run Tux Paint with the "no stereo" option:
* Use Tux Paint Config to uncheck the "Enable Stereo Sound"
option (under "Video & Sound").
* Edit Tux Paint's configuration file (see OPTIONS for details)
and add a line containing "nostereo=yes".
* Run "tuxpaint --nostereo" from the command line or shortcut
or desktop icon.
* Edit Tux Paint's configuration file (see "Options
Documentation" for details) and add a line containing
"nostereo=yes".
* Or use Tux Paint Config. and make sure "Enable Stereo
Effects" (under "Video & Sound") is not checked.
The sound effects sound strange
@ -432,15 +418,16 @@ Audio Problems
(The buffer size chosen.)
Please e-mail us with details about your computer system.
(Operating system and version, sound card, which version of
Tux Paint you're running (run "tuxpaint --version" to verify), and
so on.)
(Operating system and version, sound card, which version of Tux
Paint you're running (run "tuxpaint --version" to verify), and so
on.)
----------------------------------------------------------------------
Fullscreen Mode Problems
When I run Tux Paint full-screen and ALT-TAB out, the window turns black!
When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns
black!
This is apparently a bug in the SDL library. Sorry.
When I run Tux Paint full-screen, it has large borders around it
@ -448,8 +435,8 @@ Fullscreen Mode Problems
Linux users - Your X-Window server is probably not set with the
ability to switch to the desired resolution: 800×600. (or whatever
resolution you have Tux Paint set to run at.) (This is typically
done manually under the X-Window server by pressing
[Ctrl]-[Alt]-[KeyPad Plus] and -[KeyPad Minus].)
done manually under the X-Window server by pressing [Ctrl] + [Alt]
+ [Keypad Plus] and [Ctrl] + [Alt] + [Keypad Minus].)
For this to work, your monitor must support that resolution, and
you need to have it listed in your X server configuration.
@ -463,7 +450,7 @@ Fullscreen Mode Problems
Add "800x600" (or whatever resolution(s) you want) to the
appropriate "Modes" line. (e.g., in the "Display" subsection that
contains 24-bit color depth ("Depth 24"), which is what Tux Paint
tries to use.) e.g.:
tries to use.)
Modes "1280x1024" "1024x768" "800x600" "640x480"
@ -479,12 +466,11 @@ Fullscreen Mode Problems
not giving it a "--fullscreen" option.
If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--fullscreen" is listed as an
argument.
properties of the icon to see if "--fullscreen" is listed as a
command-line argument.
If "--fullscreen" isn't on the command-line, check Tux Paint's
configuration file ("~/.tuxpaintrc" under Linux and Unix,
"tuxpaint.cfg" under Windows) for a line reading:
If a "--fullscreen" option isn't being sent on the command line,
check Tux Paint's configuration file for a line reading:
"fullscreen=yes".
Either remove that line, or simply run Tux Paint with the
@ -505,8 +491,8 @@ Other Probelms
30 seconds. (On Unix/Linux, this message would appear in a
terminal console if you ran Tux Paint from a command-line. On
Windows, this message would appear in a file named "stdout.txt" in
the same folder where TuxPaint.exe resides (e.g., in
C:\Program Files\TuxPaint).
the same folder where TuxPaint.exe resides (e.g., in "C:\Program
Files\TuxPaint").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix,
"userdata\lockfile.dat" on Windows) is used to make sure Tux Paint
@ -521,38 +507,38 @@ Other Probelms
stored (e.g., on a shared network drive), then you'll need to
disable this feature.
To disable the lockfile, add the "--nolockfile" argument to
Tux Paint's command-line.
To disable the lockfile, add the "--nolockfile" argument to Tux
Paint's command-line, or "nolockfile=yes" to the configuration
file.
I can't quit Tux Paint
The "noquit" option is set. This disables the "Quit" button in
The "no quit" option is set. This disables the "Quit" button in
Tux Paint's toolbar (greying it out), and prevents Tux Paint from
being quit using the [Escape] key.
being exited via the [Escape] key.
If Tux Paint is not in fullscreen mode, simply click the window
close button on Tux Paint's title bar. (i.e., the "(x)" at the
upper right.)
close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper
right.)
If Tux Paint is in fullscreen mode, you will need to use the
[Shift] + [Control] + [Escape] sequence on the keyboard to quit
Tux Paint.
(Note: with or without "noquit" set, you can always use the [Alt]
(Note: with or without "no quit" set, you can always use the [Alt]
+ [F4] combination on your keyboard to quit Tux Paint.)
I don't want "noquit" mode enabled!
I don't want "no quit" mode enabled!
If you're running Tux Paint from a command-line, make sure you're
not giving it a "--noquit" option.
If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noquit" is listed as an
argument.
properties of the icon to see if "--noquit" is listed as a
command-line argument.
If "--noquit" isn't on the command-line, check Tux Paint's
configuration file ("~/.tuxpaintrc" under Linux and Unix,
"tuxpaint.cfg" under Windows) for a line reading: "noquit=yes".
If a "--noquit" option isn't being sent on the command line, check
Tux Paint's configuration file for a line reading: "noquit=yes".
Either remove that line, or simply run Tux Paint with the
command-line argument: "--quit", which will override the
@ -568,8 +554,8 @@ Other Probelms
finds while loading them), then it was probably compiled with
debugging output turned on.
Rebuild Tux Paint from source. Be sure to remove or comment out
any line that says:
To change this, you must rebuild Tux Paint from source. Be sure to
remove or comment out any line that says:
#define DEBUG
@ -600,23 +586,23 @@ Other Probelms
tuxpaint.cfg
Then, any options sent as command-line arguments are used.
Finally, any options sent as command-line arguments are used.
This means that if anything is set in a configuration file that
you don't want set, you'll need to either change the config. file
(if you can), or override the option on the command-line.
For example, if "/etc/tuxpaint/tuxpaint.conf" includes an option
to disable sound:
For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf"
includes this option to disable sound...
nosound=yes
You can reenable sound by either adding this option to your own
".tuxpainrc" file:
...then you can reenable sound by either adding this option to
your own ".tuxpaintrc" file:
sound=yes
Or by using this command-line argument:
...or by using this command-line argument:
--sound