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

Tweaks to w3m.sh to improve TXT version of docs

Browse source 
Make headers and description terms more apparent, by adding
some more regexps into the `sed` that the HTML is piped through
before being sent to `w3m`.
This commit is contained in:
Bill Kendrick 2024-10-14 17:08:31 -07:00
parent 3032afb85f
commit a62db7f9c2
1060 changed files with 10160 additions and 9743 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt
View file

@ -18,7 +18,7 @@
+----------------------------------------+
-------------------------------------------------------------------------------
About this 'How-To'
### About this 'How-To' ###
This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
@ -32,9 +32,9 @@ About this 'How-To'
-------------------------------------------------------------------------------
Image choice is crucial
### Image choice is crucial ###
License
## License ##
If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to
@ -55,7 +55,7 @@ Image choice is crucial
For personal use, any image you can legitimately modify and use for
your own personal use should be fine.
Image Size and Orientation
## Image Size and Orientation ##
You need an image that has a useful orientation. Perspective is an
enemy. Images that show an object from the corner are difficult to fit
@ -82,7 +82,7 @@ Image choice is crucial
-------------------------------------------------------------------------------
Prepare the image
### Prepare the image ###
First of all, be sure to avoid re-saving the image as a JPEG. This causes
quality loss. There is a special tool called jpegtran that lets you crop an
@ -119,7 +119,7 @@ Prepare the image
-------------------------------------------------------------------------------
Prepare the mask
### Prepare the mask ###
Get used to doing [Control]-click and [Alt]-click on the thumbnail images
in the layers dialog. You will need this to control what you are looking at
@ -178,7 +178,7 @@ Prepare the mask
-------------------------------------------------------------------------------
Replace the fringe and junk pixels
### Replace the fringe and junk pixels ###
Still viewing the mask, select by color. Choose black. Shrink the selection
by several pixels, being sure to NOT shrink from the edges of the mask (the
@ -240,7 +240,7 @@ Replace the fringe and junk pixels
-------------------------------------------------------------------------------
Save the image for Tux Paint
### Save the image for Tux Paint ###
It is very easy to ruin your hard work. Image editors can silently destroy
pixels in 0% opaque areas. The conditions under which this happens may vary
@ -251,7 +251,7 @@ Save the image for Tux Paint
save space (and hide your mistakes), you are almost certain to destroy all
the 0% opaque areas. So here is a better way...
A Safer Way to Save
## A Safer Way to Save ##
Drag the mask from the layers dialog to the unused portion of the
toolbar (right after the last drawing tool). This will create a new

38
docs/is_IS.UTF-8/ENVVARS.txt
View file

@ -12,9 +12,9 @@
Tux Paint understands a number of environment variables, either directly, or
indirectly by the libraries that it utilizes.
Storage-related environment variables
### Storage-related environment variables ###
HOME
→ HOME ←
Specifies the user's "home directory", which is used to locate numerous
other files or directories. In some cases, it is utilized as part of a
@ -30,8 +30,8 @@ HOME
+ The location of a user's private collection of data files — stamps,
brushes, etc. — (versus those available system wide)
XDG_CONFIG_HOME
→ XDG_CONFIG_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's configuration files. Specifically, where to find
@ -42,8 +42,8 @@ XDG_CONFIG_HOME
exports drawings and GIFs to "$HOME".
XDG_DATA_HOME
→ XDG_DATA_HOME ←
On Linux and other platforms where the X Desktop Group standards are used,
the location of the user's data directories. Specifically, where to find
@ -53,18 +53,18 @@ XDG_DATA_HOME
anywhere.
TEMP
→ TEMP ←
Specifies the location where temporary files may be created. Only used by
Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
Language-related environment variables
### Language-related environment variables ###
LANG
LANGUAGE
LC_ALL
LC_MESSAGES
→ LANG ←
→ LANGUAGE ←
→ LC_ALL ←
→ LC_MESSAGES ←
Specify the language Tux Paint should utilize in its user interface.
Overridden by the "--lang" and "--locale" command-line options or their
@ -73,24 +73,24 @@ LC_MESSAGES
and finally "LANG".
Display-related environment variables
### Display-related environment variables ###
The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
playing sounds, and receiving mouse, keyboard, and joystick input — and which
may be useful to users of Tux Paint.
SDL_VIDEO_ALLOW_SCREENSAVER
→ SDL_VIDEO_ALLOW_SCREENSAVER ←
Specifies whether Tux Paint should allow a screensaver to run. Can be set
to '1' (true) by Tux Paint itself by issuing the command-line option
"--allowscreensaver" or its configuration file counterpart.
SDL_VIDEO_WINDOW_POS
→ SDL_VIDEO_WINDOW_POS ←
Requests where to position Tux Paint's window, and can be used to specify
what display to place a fullscreen Tux Paint in a multi-monitor
@ -99,5 +99,5 @@ SDL_VIDEO_WINDOW_POS
(e.g. 200,100), or "center" (meaning "center").

171
docs/is_IS.UTF-8/EXTENDING.txt
View file

@ -44,11 +44,11 @@ changing, or removing files where Tux Paint looks for them.
Where Files Go
Standard Files
### Standard Files ###
Tux Paint looks for its various data files in its 'data' directory.
Linux and Unix
→ Linux and Unix ←
Where this directory goes depends on what value was set for "DATA_PREFIX"
when Tux Paint was built. See 'Install documentation' for details.
@ -62,8 +62,8 @@ Linux and Unix
/usr/share/tuxpaint/
Windows
→ Windows ←
Tux Paint looks for a directory called 'data' in the same directory as the
executable. This is the directory that the installer used when installing
@ -72,8 +72,8 @@ Windows
C:\Program Files\TuxPaint\data
macOS
→ macOS ←
Tux Paint stores its data files inside the "Tux Paint" application icon
(which is actually a special kind of folder on macOS & Mac OS X before it).
@ -106,14 +106,14 @@ macOS
Tux Paint.
Personal Files
### Personal Files ###
You can also create brushes, stamps, 'starters', templates, and fonts in your
own user account directory (folder) for Tux Paint to find.
Windows
→ Windows ←
Your personal Tux Paint folder is stored in your personal "Application
Data". For example, on newer Windows:
@ -121,8 +121,8 @@ Windows
C:\Users\username\AppData\Roaming\TuxPaint\
macOS
→ macOS ←
Your personal Tux Paint folder is stored in your personal
"Application Support" folder:
@ -130,8 +130,8 @@ macOS
/Users/username/Library/Application Support/TuxPaint/
Linux and Unix
→ Linux and Unix ←
Your personal Tux Paint files go into a 'hidden directory' found in your
account's home directory: "/home/username/.tuxpaint/".
@ -139,7 +139,7 @@ Linux and Unix
Don't forget the period (".") before the "tuxpaint"!
To add your own brushes, stamps, 'starters,' templates, and fonts, create
subdirectories under your personal Tux Paint directory named "brushes", "stamps
@ -160,7 +160,7 @@ partially-transparent!
Greyscale pixels in the brush PNG will be drawn using the currently-selected
color in Tux Paint. Color pixels will be tinted.
Brush Descriptive Text
### Brush Descriptive Text ###
Tux Paint will display descriptive text when a brush is selected. These are
placed in plain text files with the same name as the PNG, but with a ".txt"
@ -170,7 +170,7 @@ in the same directory.)
The first line of the text file will be used as the US English description of
the brush's image. It must be encoded in UTF-8.
Localization Support
→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@ -190,17 +190,17 @@ Localization Support
running in, the US English text is used.
Windows Users
→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
Brush Options
### Brush Options ###
Aside from a graphical shape, brushes can also be given other attributes. To do
this, you need to create a 'data file' for the brush.
@ -212,7 +212,7 @@ The file has the same name as the PNG image, but a ".dat" extension. (e.g.,
"brush.png"'s data file is the text file "brush.dat", found in the same
directory.)
Brush Spacing
→ Brush Spacing ←
As of Tux Paint version 0.9.16, you can now specify the spacing for brushes
(that is, how often they are drawn). By default, the spacing will be the
@ -223,8 +223,8 @@ Brush Spacing
often the brush is drawn.)
Animated Brushes
→ Animated Brushes ←
As of Tux Paint version 0.9.16, you may now create animated brushes. As the
brush is used, each frame of the animation is drawn.
@ -239,8 +239,8 @@ Animated Brushes
sequentially, also add a line containing "random" to the brush's data file.
Directional Brushes
→ Directional Brushes ←
As of Tux Paint version 0.9.16, you may now create directional brushes. As
the brush is used, different shapes are drawn, depending on the direction
@ -255,8 +255,8 @@ Directional Brushes
Add a line containing the word "directional" to the brush's data file.
Rotating Brushes
→ Rotating Brushes ←
As of Tux Paint version 0.9.27, you may now create rotating brushes. As the
brush is used, it is rotated 360 degrees, depending on the direction the
@ -265,8 +265,8 @@ Rotating Brushes
Add a line containing the word "rotate" to the brush's data file.
Chaotic Brushes
→ Chaotic Brushes ←
As of Tux Paint version 0.9.34, brushes can be configured to continuously
pick random directions as you draw with them.
@ -274,8 +274,8 @@ Chaotic Brushes
Add a line containing the word "chaotic" to the brush's data file.
Animated Directional, Rotating, or Chaotic Brushes
→ Animated Directional, Rotating, or Chaotic Brushes ←
You may mix both animated and either directional, rotating, or chaotic
features into one brush. Use both options desired ("frames=N" and "
@ -289,7 +289,7 @@ Animated Directional, Rotating, or Chaotic Brushes
the first frame, for example.)
Place the brush image PNGs (and any data text files) in the "brushes"
directory.
@ -305,7 +305,7 @@ subdirectories and sub-subdirectories there to organize the stamps. (For
example, you can have a "holidays" folder with "halloween" and "christmas"
sub-folders.)
Stamp Images
### Stamp Images ###
Rubber Stamps in Tux Paint can be made up of a number of separate files. The
one file that is required is, of course, the picture itself.
@ -334,7 +334,7 @@ the 'SVG documentation' in Tux Paint for more information and tips.
how to make PNG images which will scale perfectly when used as stamps in Tux
Paint.
Stamp Descriptive Text
### Stamp Descriptive Text ###
Tux Paint will display descriptive text when a stamp is selected. These are
placed in plain text files with the same name as the PNG or SVG, but with a
@ -344,7 +344,7 @@ placed in plain text files with the same name as the PNG or SVG, but with a
The first line of the text file will be used as the US English description of
the stamp's image. It must be encoded in UTF-8.
Localization Support
→ Localization Support ←
Additional lines can be added to the text file to provide translations of
the description, to be displayed when Tux Paint is running in a different
@ -364,17 +364,17 @@ Localization Support
running in, the US English text is used.
Windows Users
→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".txt" extension at the end of the
filename.
Stamp Sound Effects
### Stamp Sound Effects ###
Tux Paint can play a sound effect when a stamp is selected. For example, the
sound of a duck quaking when selecting a duck, or a brief piece of music when a
@ -383,7 +383,7 @@ musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis
"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same
directory.)
Localization Support
→ Localization Support ←
For sounds for different locales (e.g., if the sound is someone saying a
word, and you want translated versions of the word said), also create WAV
@ -400,12 +400,12 @@ Localization Support
the 'default' sound file. (e.g., "stamp.wav")
💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound',
below.
Stamp Descriptive Sound
### Stamp Descriptive Sound ###
Tux Paint can also play a descriptive sound when a stamp is selected. For
example, the sound of someone saying the word "duck" when selecting a duck, or
@ -414,7 +414,7 @@ the name of a musical instrument when one is chosen. Files may be in "WAVE
or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound
is the sound file "stamp_desc.ogg" in the same directory.)
Localization Support
→ Localization Support ←
For descriptive sounds for different locales, also create WAV or OGG files
with both "_desc" and the locale's label in the filename, in the form:
@ -430,9 +430,9 @@ Localization Support
load the 'default' sound file. (e.g., "stamp_desc.wav")
Stamp Options
### Stamp Options ###
Aside from a graphical shape, a textual description, a sound effect, and a
descriptive sound, stamps can also be given other attributes. To do this, you
@ -445,11 +445,11 @@ The file has the same name as the PNG or SVG image, but a ".dat" extension.
(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same
directory.)
Colored Stamps
→ Colored Stamps ←
Stamps can be made to be either "colorable" or "tintable."
Colorable
→ Colorable ←
"Colorable" stamps they work much like brushes - you pick the stamp to
get the shape, and then pick the color you want it to be. (Symbol
@ -461,8 +461,8 @@ Colored Stamps
Add a line containing the word "colorable" to the stamp's data file.
Tinted
→ Tinted ←
"Tinted" stamps are similar to "colorable" ones, except the details of
the original image are kept. (To put it technically, the original image
@ -472,14 +472,14 @@ Colored Stamps
Add a line containing the word "tintable" to the stamp's data file.
Tinting Options:
→ Tinting Options: ←
Depending on the contents of your stamp, you might want to have Tux
Paint use one of a number of methods when tinting it. Add one of the
following lines to the stamp's data file:
Normal tinter — "tinter=normal" (the default)
→ Normal tinter — "tinter=normal" (the default) ←
This is the normal tinting mode. First, the primary hue of the
stamp is determined. (For example, a picture of a flower with a
stem will have the petal color seen as the primary hue of the
@ -490,28 +490,28 @@ Colored Stamps
the image is tinted. Anything falling within 50% of the range
(e.g., ±27°) is altered to have the hue of the color chosen by the
user.
Narrow tinter — "tinter=narrow"
→ Narrow tinter — "tinter=narrow" ←
This like the "normal" option described above, but starts a
narrower hue range of ±6°. Anything found within 50% of the range
(e.g. ±9°) is tinted. If too much of your stamp is being tinted,
try this option.
'Any hue' tinter — "tinter=anyhue"
→ 'Any hue' tinter — "tinter=anyhue" ←
This remaps all hues in the stamp. It works similarly to the
"anyhue" and "narrow" options described above, but the hue range is
±180°.
Vector tinter — "tinter=vector"
→ Vector tinter — "tinter=vector" ←
This maps 'black through white' to 'black through destination'.
Unalterable Stamps
→ Unalterable Stamps ←
By default, a stamp can be flipped upside down, shown as a mirror image, or
both. This is done using the control buttons below the stamp selector, at
@ -528,8 +528,8 @@ Unalterable Stamps
nomirror" to the stamp's data file.
Initial Stamp Size
→ Initial Stamp Size ←
By default, Tux Paint assumes that your stamp is sized appropriately for
unscaled display on a 608x472 canvas. This was the original Tux Paint
@ -548,17 +548,17 @@ Initial Stamp Size
+ "scale 2.5"
+ "scale 2:5"
Windows Users
→ Windows Users ←
Use NotePad or WordPad to edit/create these files. Be sure to save them as
plain-text, and make sure they have a ".dat" extension at the end of the
filename.
Pre-Mirrored and Flipped Stamps
### Pre-Mirrored and Flipped Stamps ###
In some cases, you may wish to provide a pre-drawn version of a stamp's
mirror-image, flipped image, or even both. For example, imagine a picture of a
@ -598,7 +598,7 @@ When you use a 'starter' image, make modifications, and save it, the original
'starter' image is not overwritten. Additionally, as you edit your new picture,
the contents of the original 'starter' can affect it.
Coloring-Book Style Starters
### Coloring-Book Style Starters ###
The most basic kind of 'starter' is similar to a picture in a coloring book.
It's an outline of a shape which you can then color in and add details to. In
@ -612,7 +612,7 @@ SVG. If saving as a PNG, you may optionally render the image as
black-and-transparent, rather than black-and-white, but (as of Tux Paint
0.9.21) this is not required.
Scene-Style Starters
### Scene-Style Starters ###
Along with the 'coloring-book' style overlay, you can also provide a separate
background image as part of a 'starter' picture. The overlay acts the same: it
@ -651,7 +651,7 @@ allows it to continue to affect the drawing even after Tux Paint has been quit,
or another picture is loaded or a new image is created. (In other words, if you
base a drawing on a 'starter' image, it will always be affected by it.)
Starter Options
### Starter Options ###
Aside from an image, starters can also be given other attributes. To do this,
you need to create a 'data file' for the starter. (Note: Tux Paint prior to
@ -664,7 +664,7 @@ The file has the same name as the image, but a ".dat" extension. (e.g.,
"starter.png"'s data file is the text file "starter.dat", found in the same
directory.)
allowscale
→ allowscale ←
When a starter image is a different aspect ratio (width-to-height
proportions) than Tux Paint's canvas, by default it will be scaled to fit
@ -703,8 +703,8 @@ allowscale
+ The default behavior is to not allow cropping. This may be specified
explicitly with "allowscale=none".
background
→ background ←
This option allows you to specify how Tux Paint should fill the rest of the
canvas, when the starter does not fit in one or the other direction. By
@ -722,8 +722,8 @@ background
details.
gravity
→ gravity ←
This option allows you to specify how Tux Paint should position a starter,
when it is being cropped in one or the other direction. By default, Tux
@ -747,6 +747,7 @@ gravity
[ Landscape-shaped image of a horizon with the sun in the middle and a
building on the right. ]
Focusing on the center of a starter image stretched to fit the width of the
canvas.
@ -754,6 +755,7 @@ gravity
[ Portrait-shaped image of a horizon with the sun in the middle and the
left side of building on the right. ]
Focusing on the center of a starter image stretched to fit the height of
the canvas.
@ -761,12 +763,14 @@ gravity
[ Landscape-shaped image of the sky with the sun at the bottom and the top
of building on the right. ]
Focusing on the top of a starter image stretched to fit the width of the
canvas.
[ Landscape-shaped image of the ground with the sun at the top. ]
Focusing on the bottom of a starter image stretched to fit the width of the
canvas.
@ -774,13 +778,14 @@ gravity
[ Portrait-shaped image of a horizon with the sun on the left and a
building in the center. ]
Focusing on the right of a starter image stretched to fit the height of the
canvas.
💡 Note: Templates (described below) may also have options files, and currently
support all of the same options as starters.
@ -822,7 +827,7 @@ quit, or another picture is loaded or a new image is created. (In other words,
if you base a drawing on a 'template' image, it will always be affected by it.)
Template Options
### Template Options ###
Like 'Starters', a configuration file may be specified that defines how Tux
Paint should behave when applying 'template' images to the canvas when they do
@ -963,7 +968,7 @@ layouts).
We'll use the QWERTY keyboard as an example:
Layout overview file ("qwerty.layout")
### Layout overview file ("qwerty.layout") ###
This is a text file that specifies the other files used to describe the layout
and key mappings.
@ -981,7 +986,7 @@ seen in the example above.
The "keyboardlist" line describes which layouts to switch to, when the user
clicks the left and right buttons on the keyboard. (See below.)
Keyboard layout file ("qwerty.h_layout")
### Keyboard layout file ("qwerty.h_layout") ###
This describes how big the keyboard is (as a "width × height" grid), and lists
each key with its numeric keycode (see the "keymap" file, below), the width it
@ -1045,7 +1050,7 @@ described below.
* 1 — next layout (per the layout file's "keyboardlist" setting)
* 2 — previous layout (per the layout file's "keyboardlist" setting)
Keymap file ("us-intl-altgr-dead-keys.keymap")
### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
This file defines which numeric keycodes (seen in the keyboard layout files,
such as "qwerty.h_layout" described above) should be mapped to which actual
@ -1085,7 +1090,7 @@ keymap expressions" option, "-pke", to generate a keymap file.
keycode 62 = Shift_R NoSymbol Shift_R Shift_R
...
Composemap file ("en_US.UTF-8_Compose")
### Composemap file ("en_US.UTF-8_Compose") ###
This file describes single characters that can be composed by multiple inputs.
For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the
@ -1096,7 +1101,7 @@ composemap that comes with X.Org's X Window system. The current version from
the Xlib library has a web located page at https://www.x.org/releases/current/
doc/libX11/i18n/compose/en_US.UTF-8.html.
Keysym definitions file ("keysymdef.h")
### Keysym definitions file ("keysymdef.h") ###
This file (which is a C programming language header file) is also from the X
Window System. It defines the Unicode values of each keycap (e.g., "XK_equal"

148
docs/is_IS.UTF-8/FAQ.txt
View file

@ -21,15 +21,15 @@
+------------------------------+
-------------------------------------------------------------------------------
Drawing-related
### Drawing-related ###
Fonts I added to Tux Paint only show squares
→ Fonts I added to Tux Paint only show squares ←
The TrueType Font you're using might have the wrong encoding. If it's
'custom' encoded, for example, you can try running it through FontForge (
http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
(Email us if you need help with special fonts.)
The Rubber Stamp tool is greyed out!
→ The Rubber Stamp tool is greyed out! ←
This means that Tux Paint either couldn't find any stamp images, or was
asked not to load them.
@ -55,8 +55,8 @@ The Rubber Stamp tool is greyed out!
configuration file.
Stamp outlines are always rectangles
→ Stamp outlines are always rectangles ←
Tux Paint was built with low-quality (but faster) stamp outlines.
@ -68,13 +68,13 @@ Stamp outlines are always rectangles
in the "tuxpaint.c" file in the "src" directory.
-------------------------------------------------------------------------------
Interface Problems
### Interface Problems ###
Stamp thumbnails in the Stamp Selector look bad
→ 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 --verbose-version" from a command
@ -89,24 +89,24 @@ Stamp thumbnails in the Stamp Selector look bad
in the "tuxpaint.c" file in the "src" directory.
Pictures in the 'Open' dialog look bad
→ Pictures in the 'Open' dialog look bad ←
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
Stamp Selector look bad", above.
All of the text is in uppercase!
→ All of the text is in uppercase! ←
The "uppercase" option is on.
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.
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.
Tux Paint won't switch to my language
→ Tux Paint won't switch to my language ←
+ Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your "/etc/
@ -142,13 +142,13 @@ Tux Paint won't switch to my language
https://tuxpaint.org/download/fonts/
-------------------------------------------------------------------------------
Printing
### Printing ###
Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
→ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) ←
Tux Paint prints by creating a PostScript rendition of the picture and
sending it to an external command. By default, this command is the "lpr"
@ -167,8 +167,8 @@ Tux Paint won't print, gives an error, or prints garbage (Unix/Linux)
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.
@ -190,8 +190,8 @@ I get the message "You can't print yet!" when I go to print
allow unlimited printing. (You won't have to wait between prints.)
I simply can't print! The button is greyed out!
→ I simply can't print! The button is greyed out! ←
The "no print" option is on.
@ -212,41 +212,41 @@ I simply can't print! The button is greyed out!
is checked.
-------------------------------------------------------------------------------
Saving
### Saving ###
Where does Tux Paint save my drawings?
→ 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 your local
drive:
Windows Windows 7, Windows 8, Windows 10, Windows 11
→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
macOS
→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
Linux / Unix
→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
Haiku
→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/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.')
@ -271,8 +271,8 @@ Tux Paint always saves over my old picture
Also, see "Tux Paint always saves a new picture!", below.
Tux Paint always saves a new picture!
→ Tux Paint always saves a new picture! ←
The "never save over" option is enabled. (This disables the prompt that
would appear when you click 'Save.')
@ -297,13 +297,13 @@ Tux Paint always saves a new picture!
Also, see "Tux Paint always saves over my old picture!", above.
-------------------------------------------------------------------------------
Audio Problems
### Audio Problems ###
There's no sound!
→ There's no sound! ←
+ First, check the obvious:
o Are your speakers connected and turned on?
o Is the volume turned up on your speakers?
@ -363,8 +363,8 @@ There's no sound!
headers are available!
Tux Paint makes too much noise! Can I turn them off?
→ Tux Paint makes too much noise! Can I turn them off? ←
Yes, there are a number of ways to disable sounds in Tux Paint:
@ -380,9 +380,9 @@ Tux Paint makes too much noise! Can I turn them off?
o 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?
→ The stereo panning of sound effects is bothersome; can sound effects be
monophonic? ←
Run Tux Paint with the "no stereo" option:
@ -393,8 +393,8 @@ The stereo panning of sound effects is bothersome; can sound effects be
+ Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
"Video & Sound") is not checked.
The sound effects sound strange
→ The sound effects sound strange ←
This could have to do with how SDL and SDL_mixer were initialized. (The
buffer size chosen.)
@ -404,16 +404,17 @@ The sound effects sound strange
"tuxpaint --version" to verify), and so on.)
-------------------------------------------------------------------------------
Fullscreen Mode Problems
### 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
→ When I run Tux Paint full-screen, it has large borders around it ←
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
@ -440,8 +441,8 @@ When I run Tux Paint full-screen, it has large borders around it
xserver-xfree86" as root, for example.
Tux Paint keeps running in Full Screen mode - I want it windowed!
→ Tux Paint keeps running in Full Screen mode - I want it windowed! ←
The "fullscreen" option is set.
@ -464,20 +465,21 @@ Tux Paint keeps running in Full Screen mode - I want it windowed!
is not checked.
How do I access other applications when Tux Paint is running in Full Screen?
→ How do I access other applications when Tux Paint is running in Full Screen?
←
+ Windows and Linux users, try the [Alt] + [Tab] key combination to
switch between applications.
+ macOS users, switch to other applications using [Control] + [Left
Arrow], then back to Tux Paint using [Control] + [Right Arrow].
-------------------------------------------------------------------------------
Other Problems
### Other Problems ###
Tux Paint won't run
→ Tux Paint won't run ←
If Tux Paint aborts with the message: "You're already running a copy of Tux
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
@ -503,8 +505,8 @@ Tux Paint won't run
command-line, or "nolockfile=yes" to the configuration file.
Tux Paint launches very slowly
→ Tux Paint launches very slowly ←
The first time Tux Paint is launched (for a particular user), it may take a
minute or more to respond. The font system used by Tux Paint (FontConfig,
@ -526,8 +528,8 @@ Tux Paint launches very slowly
fontconfig\cache</cachedir>
I can't quit Tux Paint
→ I can't quit Tux Paint ←
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 exited via the
@ -543,8 +545,8 @@ I can't quit Tux Paint
combination on your keyboard to quit Tux Paint.)
I don't want "no quit" 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.
@ -563,8 +565,8 @@ I don't want "no quit" mode enabled!
Key" (under "Simplification") is not checked.
Tux Paint keeps writing weird messages to the screen / to a text file
→ Tux Paint keeps writing weird messages to the screen / to a text file ←
A few messages are normal, but if Tux Paint is being extremely verbose
(like listing the name of every rubber-stamp image it finds while loading
@ -578,8 +580,8 @@ Tux Paint keeps writing weird messages to the screen / to a text file
in the "tuxpaint.c" file in the "src" directory.
Tux Paint is using options I didn't specify!
→ Tux Paint is using options I didn't specify! ←
By default, Tux Paint first looks at configuration files for options.
@ -656,11 +658,11 @@ Tux Paint is using options I didn't specify!
--nosysconfig
-------------------------------------------------------------------------------
Help / Contact
### Help / Contact ###
Any questions you don't see answered? Please let us know! You can subscribe and
post to our "tuxpaint-users" mailing list:

172
docs/is_IS.UTF-8/INSTALL.txt
View file

@ -28,7 +28,7 @@
Requirements
Simple DirectMedia Layer library (libSDL)
### Simple DirectMedia Layer library (libSDL) ###
Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open
Source multimedia programming library available under the GNU Lesser General
@ -58,13 +58,13 @@ Debian's "apt").
development versions of the packages. (For example, install both
"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".)
Other Libraries
## Other Libraries ##
Tux Paint also takes advantage of a number of other free, LGPL'd libraries.
Under Linux, just like SDL, they should either already be installed, or are
readily available for installation as part of your Linux distribution.
libPNG
→ libPNG ←
Tux Paint uses PNG (Portable Network Graphics) format for its data files.
SDL_image will require libPNG be installed.
@ -72,8 +72,8 @@ libPNG
http://www.libpng.org/pub/png/libpng.html
gettext
→ gettext ←
Tux Paint uses your system's locale settings along with the "gettext"
library to support various languages (e.g., Spanish). You'll need the
@ -82,8 +82,8 @@ gettext
http://www.gnu.org/software/gettext/
libpaper (Linux/Unix only)
→ libpaper (Linux/Unix only) ←
As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper
size (e.g., A4 or Letter), or can be told to use a particular paper size,
@ -92,8 +92,8 @@ libpaper (Linux/Unix only)
https://github.com/naota/libpaper
FriBiDi
→ FriBiDi ←
Tux Paint's "Text" and also "Label" tools support bidirectional languages,
thanks to the "FriBiDi" library.
@ -101,31 +101,31 @@ FriBiDi
http://fribidi.org/
SVG graphics support
→ SVG graphics support ←
As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics)
images as stamps. Two sets of libraries are supported, and SVG support can
be completely disabled (via "make SVG_LIB:=")
librsvg-2 & libCairo2 (newer libraries)
→ librsvg-2 & libCairo2 (newer libraries) ←
o libRSVG 2: http://librsvg.sourceforge.net/
o Cairo 2: http://www.cairographics.org/
o These also depend on the following:
# GdkPixbuf & GLib: http://www.gtk.org/
# Pango: http://www.pango.org/
Older SVG libraries
→ Older SVG libraries ←
o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/
o These also depend on the following:
# libxml2: https://gitlab.gnome.org/GNOME/libxml2
Animated GIF Export feature
→ Animated GIF Export feature ←
To support export of animated GIFs (slideshows), the "libimagequant"
library (from the "pngquant2" project) is required.
@ -133,8 +133,8 @@ Animated GIF Export feature
https://github.com/ImageOptim/libimagequant
NetPBM Tools (optional) No longer used, by default
→ NetPBM Tools (optional) No longer used, by default ←
📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools
to assist with printing. (A PNG is generated by Tux Paint, and converted
@ -144,7 +144,7 @@ NetPBM Tools (optional) No longer used, by default
http://netpbm.sourceforge.net/
Compiling and Installation
@ -154,11 +154,11 @@ available freely.
-----------------------------------------------------------------------
Windows
### Windows ###
júlí 10, 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
Compiling Set-Up
## 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 (https://
@ -168,7 +168,7 @@ Many tools and libraries are required to build Tux Paint. The package
management system "pacman" helps you install them automatically solving
complicated dependencies.
MYSYS2
# MYSYS2 #
Download the latest MSYS2 environment from https://www.msys2.org/ and install
it where you'd like (the default is "C:\msys64")
@ -196,7 +196,7 @@ environment.
-----------------------------------------------------------
MinGW 64bit (x86_64) compiler and tools
# MinGW 64bit (x86_64) compiler and tools #
Within the MSYS2 shell, run the following command to install 64bit compiler and
basic development tools:
@ -207,7 +207,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
# 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -221,7 +221,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL2_Pango and libunibreak on the 64bit environment
# Install SDL2_Pango and libunibreak on the 64bit environment #
SDL2_Pango and libunibreak should be installed manually.
@ -253,7 +253,7 @@ ImageMagick" section if you need only a 64bit build environment.
-----------------------------------------------------------
MinGW 32bit (i686) compiler and tools
# MinGW 32bit (i686) compiler and tools #
Within the MSYS2 shell, run the following command to install 32bit compiler and
basic development tools:
@ -264,7 +264,7 @@ basic development tools:
Link Library (.dll) files they depends on. Tux Paint's packaging process for
binary distribution uses it to find required .dll files.
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
# 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config #
You can install tools and libraries required for compiling Tux Paint and Tux
Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
@ -278,7 +278,7 @@ installing it if you are only building "Tux Paint".
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL2_Pango and libunibreak on the 32bit environment
# Install SDL2_Pango and libunibreak on the 32bit environment #
SDL2_Pango and libunibreak should be installed manually.
@ -305,7 +305,7 @@ You can fetch the source code from the git repositry and compile it as follows.
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
ImageMagick
## 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
@ -327,7 +327,7 @@ your "PATH" environment variable. For example:
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
Tux Paint & Tux Paint Config.
## Tux Paint & Tux Paint Config. ##
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries
using "MSYS2 32bit" shell, respectively.
@ -337,7 +337,7 @@ using "MSYS2 32bit" shell, respectively.
* Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open
the 32bit shell.
Tux Paint Config.
# Tux Paint Config. #
"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
@ -365,7 +365,7 @@ Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
Tux Paint
# Tux Paint #
You can use either (a) a stable tar-ball release, or (b) the developing source
tree.
@ -393,7 +393,7 @@ 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.
Building the Tux Paint Windows Installer
## Building the Tux Paint Windows Installer ##
Inno Setup is used to build executable installer for Tux Paint. Therefore you
have to install it in the first place.
@ -415,7 +415,7 @@ Then, you can easily build an executable installer by right-clicking on the
list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z
-windows-<arch>-installer.exe" file in the same directory.
Running the Tux Paint Windows Installer
## Running the Tux Paint Windows Installer ##
Double-click the Tux Paint installer executable (.EXE file) and follow the
instructions.
@ -433,7 +433,7 @@ location.
At this point, you can click 'Install' to install Tux Paint!
Changing the Settings Using the Shortcut
## Changing the Settings Using the Shortcut ##
To change program settings, right-click on the TuxPaint shortcut and select
'Properties' (at the bottom).
@ -460,7 +460,7 @@ pushed the "Apply" button!).
When you have finished, click "OK."
If Something Goes Wrong
## If Something Goes Wrong ##
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
@ -474,9 +474,9 @@ incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing
-----------------------------------------------------------------------
Linux/Unix
### Linux/Unix ###
Compiling:
## Compiling: ##
💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure"
script to run. Compiling should be straight-forward though, assuming everything
@ -487,7 +487,8 @@ shell prompt (e.g., "$"):
$ make
Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
## Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies):
##
To disable SVG support (e.g., if your system is not currently supported by the
Cairo library or other SVG-related dependencies), you can run "make" with
@ -495,7 +496,7 @@ Cairo library or other SVG-related dependencies), you can run "make" with
$ make SVG_LIB= SVG_CFLAGS=
Disabling Sound at Compile-time
## Disabling Sound at Compile-time ##
If you don't have a sound card, or would prefer to build the program with no
sound support (and therefore without a the SDL_mixer dependency), you can run
@ -503,12 +504,12 @@ sound support (and therefore without a the SDL_mixer dependency), you can run
$ make SDL_MIXER_LIB=
Other options
## Other options ##
Various other options (e.g., installation paths) may be overridden; see them in
"Makefile" for further details.
If you get errors
## If you get errors ##
If you receive any errors during compile-time, make sure you have the
appropriate libraries installed (see above). If using packaged versions of the
@ -516,7 +517,7 @@ libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the
corresponding "-dev" or "-devel" packages as well, otherwise you won't be able
to compile Tux Paint (and other programs) from source!
Installng
## Installng ##
Assuming no fatal errors occured, you can now install the program so that it
can be run by users on the system. By default, this must be done by the "root"
@ -542,7 +543,7 @@ Ubuntu Linux):
local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/
share/tuxpaint/".
Changing Where Things Go
# Changing Where Things Go #
You can change where things will go by setting "Makefile"variables on the
command line. "DESTDIR" is used to place output in a staging area for package
@ -551,48 +552,48 @@ default, set to "/usr/local".
Other variables are:
BIN_PREFIX
→ BIN_PREFIX ←
Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by
default - e.g., "/usr/local/bin")
DATA_PREFIX
→ DATA_PREFIX ←
Where the data files (sound, graphics, brushes, stamps, fonts) will go, and
where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/
tuxpaint")
DOC_PREFIX
→ DOC_PREFIX ←
Where the documentation text files (the "docs" directory) will go. (Set to
"$(PREFIX)/share/doc/tuxpaint")
MAN_PREFIX
→ MAN_PREFIX ←
Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man")
ICON_PREFIX — $(PREFIX)/share/pixmaps
X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps
GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics
KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
→ ICON_PREFIX — $(PREFIX)/share/pixmaps ←
→ X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps ←
→ GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics ←
→ KDE_PREFIX — $(PREFIX)/share/applnk/Graphics ←
Where the icons and launchers (for GNOME and KDE) will go.
LOCALE_PREFIX
→ LOCALE_PREFIX ←
Where the translation files for Tux Paint will go, and where Tux Paint will
look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a
translation file will be under the locale's directory (e.g., "es" for
Spanish), within the "LC_MESSAGES" subdirectory.)
💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a
complete list.
-----------------------------------------------------------------------
macOS
### macOS ###
júní 5, 2022 Mark Kim <markuskimius@gmail.com>
Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were
a Linux application.
Prerequisites
## Prerequisites ##
Although Tux Paint is built without the Xcode IDE, Xcode itself is still
required to build Tux Paint. Download it from the App Store, and launch it once
@ -628,7 +629,7 @@ of Tux Paint.
^* Not available from MacPorts as of this writing, see below.
libimagequant
# libimagequant #
libimagequant is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@ -640,7 +641,7 @@ installed from the source code as follows. It should be installed to /opt/local
$ cargo build --release # Must use cargo from MacPorts
$ sudo make PREFIX=/opt/local install
sdl2_pango
# sdl2_pango #
sdl2_pango is not available from MacPorts as of this writing. It can be
installed from the source code as follows. It should be installed to /opt/local
@ -654,7 +655,7 @@ WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts
and Xcode, such as Fink or Brew, will prevent your app bundle from being
portable. Be sure Fink and Brew are not accessible from your build environment.
How to Build
## How to Build ##
Simply, run:
@ -668,7 +669,7 @@ TuxPaint.dmg'.
Additional steps are required when building a Unviersal Binary. See "Building a
Universal Binary" below.
Known Issues
## Known Issues ##
* A macOS binary built on a specific version of macOS only runs on that
version of macOS or later. To ensure Tux Paint can run on the oldest
@ -685,7 +686,7 @@ Known Issues
(from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for
the instructions.
Old Versions of macOS
## Old Versions of macOS ##
Some old versions of macOS can be downloaded from Apple's support page: https:/
/support.apple.com/en-us/HT211683
@ -725,7 +726,7 @@ the Xcode command line tools (do not run "xcode-select --install") but
otherwise build Tux Paint using the same steps described in the earlier part of
this document.
Recompiling MacPorts
## Recompiling MacPorts ##
To recompile MacPorts to be usable on older versions of macOS, set the
following options in /opt/local/etc/macports/macports.conf:
@ -749,7 +750,7 @@ they can only be built to run natively on the hardware on which they were
built. See "Building a Universal Binary" below for instructions on how to build
Tux Paint as a Universal Binary.
Building a Universal Binary
## Building a Universal Binary ##
To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU
and the Apple Silicon separately first. Then rename the app bundle for the
@ -763,7 +764,7 @@ two application bundles as below. The DMG file can be built afterwards:
-----------------------------------------------------------------------
Android
### Android ###
mars 29, 2023 Pere Pujal i Carabantes <perepujal@gmail.com> (Edited by Bill
Kendrick)
@ -772,7 +773,7 @@ As of March 2023, the Android build of Tux Paint is maintained in a separate
code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android.
Detailed instructions are there; this acts as an overview.
Prerequisites
## Prerequisites ##
You will need recent versions of:
@ -797,7 +798,7 @@ one another, and the script in the directory containing both.
Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint
&& ./mkzip_assets.sh
Building
## Building ##
The Gradle build generates some variants: PlayStore, debugPlayStore,
offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able
@ -826,36 +827,37 @@ the makebuildserver tool they provide, then, from the root of fdroiddata, run
-----------------------------------------------------------------------
Haiku
### Haiku ###
maí 7, 2023 Luc Schrijvers <begasus@gmail.com> (Edited by Bill Kendrick)
Prerequisites
## Prerequisites ##
Install the required develop packages in Terminal:
32-bit:
→ 32-bit: ←
pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel
libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl
libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel
libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel
sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel
64-bit:
→ 64-bit: ←
pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel
libimagequant_devel gettext_libintl libpaper_devel pango_devel
libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel
sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel
←
For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with
setarch x86
Building
## Building ##
make PREFIX=/boot/home/config/non-packaged
Tux Paint Stamps
## Tux Paint Stamps ##
make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/
@ -868,9 +870,9 @@ setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src
Uninstalling Tux Paint
Windows
### Windows ###
Using the Uninstaller
## Using the Uninstaller ##
If you installed the Start Menu shortcuts (the default), then go to the
TuxPaint folder and select "Uninstall". A box will be displayed that will
@ -879,19 +881,19 @@ you want to permanently remove Tux Paint, click on the 'Uninstall' button.
When it has finished, click on the close button.
Using the Control Panel
## Using the Control Panel ##
It is also possible to use the entry "TuxPaint (remove only)" in the Control
Panel Add/Remove programs section.
macOS
### macOS ###
Delete "TuxPaint.app" from the "/Applications" folder. Data files, including
the configuration files, stamps, and saved pictures, may be found in
"/Library/Application Support/TuxPaint/" (all users) and
"/Users/username/Library/Application Support/TuxPaint/" (individual users).
Linux
### Linux ###
Within the Tux Paint source directory (where you compiled Tux Paint), you can
use the "make uninstall" target to uninstall Tux Paint. By default, this must

690
docs/is_IS.UTF-8/MAGIC-API.txt
View file

File diff suppressed because it is too large Load diff

546
docs/is_IS.UTF-8/OPTIONS.txt
View file

File diff suppressed because it is too large Load diff

26
docs/is_IS.UTF-8/PNG.txt
View file

@ -26,12 +26,12 @@ library.)
Support for many colors allows photo-quality "rubber stamp" images to be used
in Tux Paint, and alpha transparency allows for high-quality brushes.
How To Make PNGs
### How To Make PNGs ###
The following is a very brief list of ways to create PNGs or convert existing
images into PNGs.
GIMP & Krita
→ GIMP & Krita ←
Excellent tools with which to create PNG images for use in Tux Paint are
GIMP and Krita, both high-quality Open Source interactive drawing and photo
@ -43,10 +43,10 @@ GIMP & Krita
/www.krita.org/, respectively.
→ Command-line Tools ←
Command-line Tools
NetPBM
→ NetPBM ←
The Portable Bitmap tools (collectively known as "NetPBM") is a
collection of Open Source command-line tools which convert to and from
@ -58,8 +58,8 @@ Command-line Tools
netpbm.sourceforge.net/.
cjpeg/djpeg
→ cjpeg/djpeg ←
The "cjpeg" and "djpeg" command-line programs convert between the
NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
@ -68,11 +68,11 @@ Command-line Tools
or to learn more, visit https://jpegclub.org/.
Proprietary Software for Windows
→ Proprietary Software for Windows ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Paint Shop Pro (Corel) — https://www.paintshoppro.com/
@ -80,13 +80,13 @@ Proprietary Software for Windows
+ PIXresizer (Bluefive software) — http://bluefive.pair.com/
pixresizer.htm
Macintosh Users
→ Macintosh Users ←
+ CorelDRAW (Corel) — http://www.corel.com/
+ GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html

346
docs/is_IS.UTF-8/README.txt
View file

@ -1,12 +1,12 @@
Tux Paint
version 0.9.34
A simple drawing program for children
## A simple drawing program for children ##
Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
https://tuxpaint.org/
október 12, 2024
október 14, 2024
+-------------------------------------------------+
| Table of Contents |
@ -44,7 +44,7 @@
I. About Tux Paint
A. What Is "Tux Paint"?
### A. What Is "Tux Paint"? ###
Tux Paint is a free drawing program designed for young children (kids ages 3
and up). It has a simple, easy-to-use interface, fun sound effects, and an
@ -52,43 +52,43 @@ encouraging cartoon mascot who helps guide children as they use the program. It
provides a blank canvas and a variety of drawing tools to help your child be
creative.
B. Objectives
### B. Objectives ###
Easy and Fun
→ Easy and Fun ←
Tux Paint is meant to be a simple drawing program for young children. It is
not meant as a general-purpose drawing tool. It is meant to be fun and easy
to use. Sound effects and a cartoon character help let the user know what's
going on, and keeps them entertained. There are also extra-large
cartoon-style mouse pointer shapes.
Extensibility
→ Extensibility ←
Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped
in and pulled out. For example, a teacher can drop in a collection of
animal shapes and ask their students to draw an ecosystem. Each shape can
have a sound which is played, and textual facts which are displayed, when
the child selects the shape.
Portability
→ Portability ←
Tux Paint is portable among various computer platforms: Windows, Macintosh,
Linux, etc. The interface looks the same among them all. Tux Paint runs
suitably well on older systems, and can be built to run better on slow
systems.
Simplicity
→ Simplicity ←
There is no direct access to the computer's underlying intricacies. The
current image is kept when the program quits, and reappears when it is
restarted. Saving images requires no need to create filenames or use the
keyboard. Opening an image is done by selecting it from a collection of
thumbnails. Access to other files on the computer is restricted.
Accessibility
→ Accessibility ←
Tux Paint offers a number of accessibility options, including increasing
the size of control buttons, changing the UI font, options to control the
cursor (mouse pointer) using the keyboard or other input devices (joystick,
gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks.
C. License
### C. License ###
Tux Paint is an Open Source project, Free Software released under the GNU
General Public License (GPL). It is free, and the 'source code' behind the
@ -97,62 +97,76 @@ parts of the program in their own GPL'd software.)
See COPYING.txt for the full text of the GPL license.
D. What's New in Tux Paint version 0.9.34?
### D. What's New in Tux Paint version 0.9.34? ###
"Eraser" Fill mode
→ "Eraser" Fill mode ←
A flood fill option that fills the canvas with the background color, or
template or starter background, upon which the drawing was based.
New brushes
→ New brushes ←
New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite",
"Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor
splotches".
New brush option
→ New brush option ←
Brushes may be given a "chaotic" setting, causing them to rotate
continuously while drawing with them.
New templates
→ New templates ←
"Clouds from an airplane" and "Lough Leane".
New Magic tool: Comic dots
→ New Magic tool: Comic dots ←
Draws a repeating dot pattern, simulating the "Ben Day process" used in
early comic books.
New Magic tool: Rotate
→ New Magic tool: Rotate ←
Rotates the drawing.
New Magic tool: Fractal
→ New Magic tool: Fractal ←
A set of tools that recursively repeat what you draw, scaling and/or
rotating it as they repeat.
New Magic tool: ASCII Typewriter
→ New Magic tool: ASCII Typewriter ←
Transform your picture into "ASCII art", typewriter-style.
New Magic tool: ASCII Computer
→ New Magic tool: ASCII Computer ←
Transform your picture into "ASCII art", computer-style.
New Magic tool: ASCII Color Computer
→ New Magic tool: ASCII Color Computer ←
Transform your picture into colored computer "ASCII art".
New Magic tool: Crescent
→ New Magic tool: Crescent ←
Draw one of various crescent shapes at a chosen angle.
New Magic tool: Spiral
→ New Magic tool: Spiral ←
Draw spirals.
New Magic tool: Spiral Square
→ New Magic tool: Spiral Square ←
Draw square spirals.
New Magic tool: Concentric Circle
→ New Magic tool: Concentric Circle ←
Draw concentric circles.
New Magic tool: Concentric Square
→ New Magic tool: Concentric Square ←
Draw concentric squares.
New Magic tool: Tessellation Pointy
→ New Magic tool: Tessellation Pointy ←
Draw repeating tessellation patterns with pointy-topped hexagons.
New Magic tool: Tessellation Flat
→ New Magic tool: Tessellation Flat ←
Draw repeating tessellation patterns with flat-topped hexagons.
Magic API Updates
→ Magic API Updates ←
Sound pause and resume functions added.
See CHANGES.txt for the complete list of changes.
II. Using Tux Paint
A. Launching Tux Paint
### A. Launching Tux Paint ###
1. Linux/Unix Users
## 1. Linux/Unix Users ##
Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus,
under 'Graphics.'
@ -163,7 +177,7 @@ Alternatively, you can run the following command at a shell prompt (e.g., "$"):
If any errors occur, they will be displayed on the terminal (to STDERR).
2. Windows Users
## 2. Windows Users ##
[Tux Paint Icon]
Tux Paint
@ -187,13 +201,14 @@ installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
3. macOS Users
## 3. macOS Users ##
Simply double-click the "Tux Paint" icon.
[Title screen]
B. Title Screen
### B. Title Screen ###
When Tux Paint first loads, a title/credits screen will appear.
@ -201,20 +216,22 @@ Once loading is complete, press a key or click or tap in the Tux Paint window
to continue. (Or, after about 5 seconds, the title screen will go away
automatically.)
C. Main Screen
### C. Main Screen ###
The main screen is divided into the following sections:
[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser,
New, Open, Save, Print, Quit]
Left Side: Toolbar
→ Left Side: Toolbar ←
The toolbar contains the drawing and editing controls.
[Canvas]
Middle: Drawing Canvas
→ Middle: Drawing Canvas ←
The largest part of the screen, in the center, is the drawing canvas. This
is, obviously, where you draw!
@ -225,9 +242,10 @@ Middle: Drawing Canvas
more details.
[Selectors - Brushes, Letters, Shapes, Stamps]
Right Side: Selector
→ Right Side: Selector ←
Depending on the current tool, the selector shows different things. e.g.,
when the Paint Brush or Line tool is selected, it shows the various brushes
@ -236,10 +254,11 @@ Right Side: Selector
various fonts.
[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue,
Purple, Brown, Grey]
Lower: Colors
→ Lower: Colors ←
When the active tool supports colors, a palette of colors choices will be
shown near the bottom of the screen. Click one to choose a color, and it
@ -295,23 +314,24 @@ Lower: Colors
documentation.
(Example tip: 'Pick a shape. Click to pick the center, drag, then let go
when it is the size you want. Move around to rotate it, and click to draw
it.')
Bottom: Help Area
→ Bottom: Help Area ←
At the very bottom of the screen, Tux, the Linux Penguin, provides tips and
other information while you use Tux Paint.
### D. Available Tools ###
D. Available Tools
## 1. Drawing Tools ##
1. Drawing Tools
a. "Paint" Tool (Brush)
a. "Paint" Tool (Brush) ←
The Paint Brush tool lets you draw freehand, using various brushes (chosen
in the Selector on the right) and colors (chosen in the Color palette
@ -353,8 +373,8 @@ a. "Paint" Tool (Brush)
the brush spacing controls. See the "Options" documentation.
b."Stamp" Tool (Rubber Stamps)
b."Stamp" Tool (Rubber Stamps) ←
The Stamp tool is like a set of rubber stamps or stickers. It lets you
paste pre-drawn or photographic images (like a picture of a horse, or a
@ -364,12 +384,12 @@ b."Stamp" Tool (Rubber Stamps)
showing where the stamp will be placed, and how big it will be. Click on
the canvas where you wish to place the stamp.
Stamp Categories
→ Stamp Categories ←
There can be numerous categories of stamps (e.g., animals, plants,
outer space, vehicles, people, etc.). Use the Left and Right arrows
near the bottom of the Selector to cycle through the collections.
Stamp Rotation
→ Stamp Rotation ←
Using the rotation toggle button near the bottom right, you can enable
a rotation step when placing stamps. Once you've placed the stamp,
@ -386,8 +406,8 @@ b."Stamp" Tool (Rubber Stamps)
0.9.29.
Stamp Controls
→ Stamp Controls ←
Prior to 'stamping' an image onto your drawing, various effects can
sometimes be applied (depending on the stamp):
@ -406,8 +426,8 @@ b."Stamp" Tool (Rubber Stamps)
Options" documentation.
Stamp Sounds
→ Stamp Sounds ←
Different stamps can have different sound effects and/or descriptive
(spoken) sounds. Buttons in the Help Area at the lower left (near Tux,
@ -415,11 +435,11 @@ b."Stamp" Tool (Rubber Stamps)
descriptive sounds for the currently-selected stamp.
c."Lines" Tool
c."Lines" Tool ←
This tool lets you draw straight lines using the various brushes and colors
you normally use with the Paint Brush.
@ -444,8 +464,8 @@ c."Lines" Tool
to learn more.
d."Shapes" Tool
d."Shapes" Tool ←
This tool lets you draw some simple filled, and un-filled shapes.
@ -453,15 +473,15 @@ d."Shapes" Tool
Use the options at the bottom right to choose the shape tool's behavior:
Shapes from center
→ Shapes from center ←
The shape will expand from where you initially clicked, and will be
centered around that position.
📜 This was Tux Paint's only behavior through version 0.9.24.)
Shapes from corner
→ Shapes from corner ←
The shape will extend with one corner starting from where you initially
clicked. This is the default method of most other traditional drawing
software.
@ -469,7 +489,7 @@ d."Shapes" Tool
📜 This option was added starting with Tux Paint version 0.9.25.
⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols"
option), the controls will not be presented, and the "shapes from center"
@ -487,7 +507,7 @@ d."Shapes" Tool
Let go of the mouse when you're done stretching.
Normal Shapes Mode
→ Normal Shapes Mode ←
Now you can move the mouse around the canvas to rotate the shape. The
angle your shape is rotated will be shown at the bottom, in degrees
@ -497,8 +517,8 @@ d."Shapes" Tool
color.
Simple Shapes Mode
→ Simple Shapes Mode ←
If the "simple shapes" option is enabled, the shape will be drawn on
the canvas when you let go of the mouse button. (There's no rotation
step.)
@ -507,11 +527,11 @@ d."Shapes" Tool
("simpleshapes") option.
e."Text" and "Label" Tools
e."Text" and "Label" Tools ←
Choose a font (from the 'Letters' available on the right) and a color (from
the color palette near the bottom). You may also apply a bold, and/or an
@ -532,7 +552,7 @@ e."Text" and "Label" Tools
causes the current line of text to move to that location (where you can
continue editing it).
"Text" versus "Label"
→ "Text" versus "Label" ←
The Text tool is the original text-entry tool in Tux Paint. Text
entered using this tool can't be modified or moved later, since it
@ -567,8 +587,8 @@ e."Text" and "Label" Tools
option).
International Character Input
→ International Character Input ←
Tux Paint allows inputting characters in different languages. Most
Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some
@ -594,8 +614,8 @@ e."Text" and "Label" Tools
trying to type.
On-screen Keyboard
→ On-screen Keyboard ←
An optional on-screen keyboard is available for the Text and Label
tools, which can provide a variety of layouts and character composition
@ -605,11 +625,11 @@ e."Text" and "Label" Tools
information.
f."Fill" Tool
f."Fill" Tool ←
The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a
color of your choice. Three fill options are offered:
@ -632,8 +652,8 @@ f."Fill" Tool
of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29.
g."Magic" Tool (Special Effects)
g."Magic" Tool (Special Effects) ←
The Magic tool is actually a set of special tools. Select one of the
'magic' effects from the selector on the right. Then, depending on the
@ -683,8 +703,8 @@ g."Magic" Tool (Special Effects)
one large list. See the "Options" documentation.
h."Eraser" Tool
h."Eraser" Tool ←
This tool works similarly to the Paint Brush. Wherever you click (or click
and drag), things you've added to your drawing will be erased, exposing the
@ -716,11 +736,11 @@ h."Eraser" Tool
currently-selected tool.
## 2. Other Controls ##
2. Other Controls
a."Undo" and "Redo" Commands
a."Undo" and "Redo" Commands ←
Clicking the "Undo" button will undo (revert) the last drawing action. You
can even undo more than once!
@ -736,8 +756,8 @@ a."Undo" and "Redo" Commands
⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo.
b."New" Command
b."New" Command ←
Clicking the 'New' button will start a new drawing. A dialog will appear
where you may choose to start a new picture using a solid background color,
@ -751,14 +771,14 @@ b."New" Command
⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a
new drawing.
Special Solid Background Color Choices
→ Special Solid Background Color Choices ←
Along with the preset solid colors, you can also choose colors using a
rainbow palette or a "color mixer". These operate identically to the
options found in the color palette shown below the canvas when drawing
a picture. See Main Screen > Lower: Colors > Special color options for
details.
'Starter' & Template Images
'Starter' & Template Images ←
o 'Starters' can behave like a page from a coloring book — a
black-and-white outline of a picture, which you can then color in,
and the black outline remains intact — or like a 3D photograph,
@ -788,8 +808,8 @@ b."New" Command
within Tux Paint, from the 'Open' dialog. See "Open", below.
Erasing Exported Template Images
→ Erasing Exported Template Images ←
If you've selected a Template in your personal templates folder, and it
was created from within Tux Paint (using the "Template" button in the
@ -805,14 +825,14 @@ b."New" Command
⚙ Note: The 'Erase' button may be disabled, via the "noerase" option.
⚙ Note: The solid colors can be placed at the end of the 'New' dialog
(below the Starters and Templates), via the "newcolorslast" option.
c."Open" Command
c."Open" Command ←
This shows you a list of all of the pictures you've saved. If there are
more than can fit on the screen, use the up and down arrows at the top and
@ -864,8 +884,8 @@ c."Open" Command
the 'Open' dialog.
d."Save" Command
d."Save" Command ←
This saves your current picture.
@ -885,8 +905,8 @@ d."Save" Command
⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save.
e."Print" Command
e."Print" Command ←
Click this button and your picture will be printed!
@ -895,7 +915,7 @@ e."Print" Command
this may not work if you're running Tux Paint in fullscreen mode. See
below.
Disabling Printing
→ Disabling Printing ←
The "noprint" option can be set, which will disable Tux Paint's 'Print'
button.
@ -903,8 +923,8 @@ e."Print" Command
⚙ See the "Options" documentation.
Restricting Printing
→ Restricting Printing ←
The "printdelay" option can be set, which will only allow occasional
printing — once every so many seconds, as configured by you.
@ -915,8 +935,8 @@ e."Print" Command
⚙ See the "Options" documentation.
Printing Commands
→ Printing Commands ←
(Linux and Unix only)
@ -942,8 +962,8 @@ e."Print" Command
⚙ See the "Options" documentation.
Printer Settings
→ Printer Settings ←
(Windows and macOS)
@ -965,8 +985,8 @@ e."Print" Command
⚙ See the "Options" documentation.
Printer Dialog Options
→ Printer Dialog Options ←
By default, Tux Paint only shows the printer dialog (or, on Linux/Unix,
runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the
@ -981,17 +1001,17 @@ e."Print" Command
⚙ See the "Options" documentation.
f."Slides" Command (under "Open")
f."Slides" Command (under "Open") ←
The 'Slides' button is available in the 'Open' dialog. It can be used to
play a simple animation within Tux Paint, or a slideshow of pictures. It
can also export an animated GIF based on the chosen images.
Chosing pictures
→ Chosing pictures ←
When you enter the 'Slides' section of Tux Paint, it displays a list of
your saved files, just like the 'Open' dialog.
@ -1005,8 +1025,8 @@ f."Slides" Command (under "Open")
list.
Set playback speed
→ Set playback speed ←
A sliding scale at the lower left of the screen (next to the 'Play'
button) can be used to adjust the speed of the slideshow or animated
@ -1019,8 +1039,8 @@ f."Slides" Command (under "Open")
does not apply to an exported animated GIF.)
Playback in Tux Paint
→ Playback in Tux Paint ←
To play a slideshow within Tux Paint, click the 'Play' button.
@ -1036,8 +1056,8 @@ f."Slides" Command (under "Open")
the slideshow and return to the slideshow image selection screen.
Exporting an animated GIF
→ Exporting an animated GIF ←
Click the 'GIF Export' button near the lower right to have Tux Paint
generate an animated GIF file based on the selected images.
@ -1051,14 +1071,14 @@ f."Slides" Command (under "Open")
return you to the 'Slideshow' dialog.
Click 'Back' in the slideshow image selection screen to return to the
'Open' dialog.
g."Quit" Command
g."Quit" Command ←
Clicking the 'Quit' button, closing the Tux Paint window, or pushing the
[Escape] key will quit Tux Paint.
@ -1085,8 +1105,8 @@ g."Quit" Command
⚙ See the "Options" documentation.
h.Sound Muting
h.Sound Muting ←
There is no on-screen control button at this time, but by using the [Alt] +
[S] keyboard sequence, sound effects can be disabled and re-enabled (muted
@ -1099,11 +1119,11 @@ h.Sound Muting
⚙ See the "Options" documentation.
### E. Controlling Tux Paint ###
E. Controlling Tux Paint
1. Using a Mouse or Trackball
## 1. Using a Mouse or Trackball ##
Tux Paint's main mode of operation is via any device that appears to your
operating system as a mouse, including standard mice, trackballs, and
@ -1119,7 +1139,7 @@ button(s), a pop-up dialog will eventually appear reminding them that only one
button is recognized Tux Paint. However, you may configure Tux Paint to accept
any button as input (see the Options documentation).
a. Scrolling
# a. Scrolling #
Many input devices offer a way to quickly scroll within applications — many
mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize
@ -1132,7 +1152,7 @@ Tux Paint will also automatically scroll if you click and hold the mouse down
on an scroll button — the "up" and "down" arrow buttons that appear above and
below scrolling lists.
b. Mouse Accessibility
# b. Mouse Accessibility #
Other devices that appear as a mouse can be used to control Tux Paint. For
example:
@ -1145,7 +1165,7 @@ Tux Paint offers a "sticky mouse click" accessibility setting, where a single
click begins a click-and-drag operation, and a subsequent click ends it. (See
the Options documentation.)
2. Using a Tablet or Touchscreen
## 2. Using a Tablet or Touchscreen ##
As noted above, Tux Paint recognizes any device that appears as a mouse. This
means drawing tablets and touchscreens may be used. However, these devices
@ -1157,7 +1177,7 @@ Some examples:
* Eraser tip
* Multi-touch gestures
3. Using a Joystick-like Device
## 3. Using a Joystick-like Device ##
Tux Paint may be configured to recognize input from any game controller that
appears to your operating system as a joystick. That even includes modern game
@ -1171,7 +1191,7 @@ to different Tux Paint controls (e.g., acting as the [Escape] key, switching to
the Paint tool, invoking Undo and Redo operations, etc.). See the Options
documentation for more details.
4. Using the Keyboard
## 4. Using the Keyboard ##
Tux Paint offers an option to allow the keyboard to be used to control the
mouse pointer. This includes motion and clicking, as well as shortcuts to
@ -1180,7 +1200,7 @@ documentation for more details.
III. Loading Other Pictures into Tux Paint
A. Overview
### A. Overview ###
Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So
what do you do if you want to load some other drawinng or even a photograph
@ -1190,29 +1210,29 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
Windows Windows 7, Windows 8, Windows 10, Windows 11
→ Windows Windows 7, Windows 8, Windows 10, Windows 11 ←
In the user's "AppData" folder:
e.g., "C:\Users\username\AppData\Roaming\TuxPaint\saved\"
macOS
→ macOS ←
In the user's "Application Support" folder:
e.g., "/Users/username/Library/Application Support/TuxPaint/saved/"
Linux / Unix
→ Linux / Unix ←
In the user's "home directory" folder:
e.g., "/home/username/.tuxpaint/saved/"
Haiku
→ Haiku ←
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
💡 Note: It is also from this folder that you can copy or open pictures drawn in
Tux Paint using other applications, though the 'Export' option from Tux Paint's
'Open' dialog can be used to copy them to a location that's easier and safer to
access.
B. Using the import script, "tuxpaint-import"
### B. Using the import script, "tuxpaint-import" ###
Linux and Unix users can use the "tuxpaint-import" shell script which gets
installed when you install Tux Paint. It uses some NetPBM tools to convert the
@ -1243,7 +1263,7 @@ following two lines are output from the program while it's working.
Now you can load Tux Paint, and a version of that original picture will be
available under the 'Open' dialog. Just double-click its icon!
C. Importing Pictures Manually
### C. Importing Pictures Manually ###
Windows, macOS, and Haiku users who wish to import arbitrary images into Tux
Paint must do so via a manual process.
@ -1261,7 +1281,7 @@ Paint's canvas size. This size depends on the size of the Tux Paint window, or
resolution at which Tux Paint is run, if in fullscreen. (Note: The default
resolution is 800x600.) See "Calculating Image Dimensions", below.
1. Naming the File
## 1. Naming the File ##
Save the picture in PNG format. It is highly recommended that you name the
filename using the current date and time, since that's the convention Tux Paint
@ -1280,7 +1300,7 @@ Example: "20210731110500.png", for July 31, 2021 at 11:05am.
Place this PNG file in your Tux Paint "saved" directory/folder. (See above.)
2. Calculating Image Dimensions
## 2. Calculating Image Dimensions ##
This part of the documentation needs to be rewritten, since the new
"buttonsize" option was added. For now, try drawing and saving an image within
@ -1293,7 +1313,7 @@ IV.Further Reading
Other documentation included with Tux Paint (found in the "docs" folder/
directory) includes:
Using Tux Paint:
→ Using Tux Paint: ←
+ OPTIONS.html
Detailed instructions on command-line and configuration-file options,
for those who don't want to use the Tux Paint Config. tool to manage
@ -1304,8 +1324,8 @@ Using Tux Paint:
Answers to, and solutions for, some common questions about, and
problems with, using Tux Paint.
How to extend Tux Paint:
→ How to extend Tux Paint: ←
+ EXTENDING.html
Detailed instructions on extending Tux Paint: creating brushes, stamps,
starters, and templates; adding fonts; and creating new on-screen
@ -1316,8 +1336,8 @@ How to extend Tux Paint:
+ SVG.html
Notes on creating SVG format vector images for use in Tux Paint.
Technical information:
→ Technical information: ←
+ INSTALL.html
Instructions for compiling and installing Tux Paint, when applicable.
+ SIGNALS.html
@ -1325,8 +1345,8 @@ Technical information:
+ MAGIC-API.html
Creating new Magic tools using Tux Paint's plugin API.
Development history and license:
→ Development history and license: ←
+ AUTHORS.txt
List of authors and contributors.
+ CHANGES.txt
@ -1334,7 +1354,7 @@ Development history and license:
+ COPYING.txt
Tux Paint's software license, the GNU General Public License (GPL)
V.How to Get Help

8
docs/is_IS.UTF-8/SIGNALS.txt
View file

@ -10,7 +10,7 @@
Tux Paint responds to the following signals (which can be sent to the program's
process via `kill` or `killall`, for example).
SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
→ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) ←
Tux Paint responds as if the "Quit" button were pressed, or the desktop
environment was told to close Tux Paint (e.g., by clicking a window close
@ -32,8 +32,8 @@ SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`)
the [Esc] was key pressed.
SIGUSR1 & SIGUSR2
→ SIGUSR1 & SIGUSR2 ←
Tux Paint responds by setting its auto-save option (as if it had been
launched with "--autosave"), as well as either the option to always save
@ -53,5 +53,5 @@ SIGUSR1 & SIGUSR2
completely.

6
docs/is_IS.UTF-8/SVG.txt
View file

@ -24,12 +24,12 @@ Inkscape, a high-quality Open Source interactive drawing program available for
Windows, macOS, and Linux. There are also other applications that can produce
SVGs, both free/open source, and commerical/proprietary.
Open Source
→ Open Source ←
+ Inkscape — http://www.inkscape.org/
+ Karbon — https://calligra.org/karbon/
Proprietary
→ Proprietary ←
+ CorelDRAW (Corel) — https://www.coreldraw.com/en/
+ Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
+ Boxy SVG — https://boxy-svg.com/

5
docs/is_IS.UTF-8/html/EXTENDING.html
View file

@ -871,6 +871,7 @@
alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
valign="middle" />
<span style="display: none;"><br/>&nbsp;</span>
<figcaption style="font-size: smaller;">
<p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
</figcaption>
@ -884,6 +885,7 @@
alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
valign="middle" />
<span style="display: none;"><br/>&nbsp;</span>
<figcaption style="font-size: smaller;">
<p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
</figcaption>
@ -897,6 +899,7 @@
alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
valign="middle" />
<span style="display: none;"><br/>&nbsp;</span>
<figcaption style="font-size: smaller;">
<p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
</figcaption>
@ -910,6 +913,7 @@
alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
title="Landscape-shaped image of the ground with the sun at the top."
valign="middle" />
<span style="display: none;"><br/>&nbsp;</span>
<figcaption style="font-size: smaller;">
<p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
</figcaption>
@ -923,6 +927,7 @@
alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
valign="middle" />
<span style="display: none;"><br/>&nbsp;</span>
<figcaption style="font-size: smaller;">
<p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
</figcaption>

49
docs/is_IS.UTF-8/html/README.html
View file

@ -102,7 +102,7 @@
</p>
<p>
október 12, 2024 </p>
október 14, 2024 </p>
</center>
</header>
<table border="2"
@ -232,13 +232,13 @@
<dd>A flood fill option that fills the canvas with the background color, or template or starter background, upon which the drawing was based.</dd>
<dt>New brushes</dt>
<dd>New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".</dt>
<dd>New brushes for the Paint and Lines tools: "Fluff (gradient)", "Graphite", "Paint splats", "Smoke", "Spines", "Water (still)", and "Watercolor splotches".</dd>
<dt>New brush option</dt>
<dd>Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.</dt>
<dd>Brushes may be given a "chaotic" setting, causing them to rotate continuously while drawing with them.</dd>
<dt>New templates</dt>
<dd>"Clouds from an airplane" and "Lough Leane".</dt>
<dd>"Clouds from an airplane" and "Lough Leane".</dd>
<dt>New Magic tool: Comic dots</dt>
<dd>Draws a repeating dot pattern, simulating the "Ben Day process" used in early comic books.</dd>
@ -250,37 +250,37 @@
<dd>A set of tools that recursively repeat what you draw, scaling and/or rotating it as they repeat.</dd>
<dt>New Magic tool: ASCII Typewriter</dt>
<dd>Transform your picture into "ASCII art", typewriter-style.</dt>
<dd>Transform your picture into "ASCII art", typewriter-style.</dd>
<dt>New Magic tool: ASCII Computer</dt>
<dd>Transform your picture into "ASCII art", computer-style.</dt>
<dd>Transform your picture into "ASCII art", computer-style.</dd>
<dt>New Magic tool: ASCII Color Computer</dt>
<dd>Transform your picture into colored computer "ASCII art".</dt>
<dd>Transform your picture into colored computer "ASCII art".</dd>
<dt>New Magic tool: Crescent</dt>
<dd>Draw one of various crescent shapes at a chosen angle.</dt>
<dd>Draw one of various crescent shapes at a chosen angle.</dd>
<dt>New Magic tool: Spiral</dt>
<dd>Draw spirals.</dt>
<dd>Draw spirals.</dd>
<dt>New Magic tool: Spiral Square</dt>
<dd>Draw square spirals.</dt>
<dd>Draw square spirals.</dd>
<dt>New Magic tool: Concentric Circle</dt>
<dd>Draw concentric circles.</dt>
<dd>Draw concentric circles.</dd>
<dt>New Magic tool: Concentric Square</dt>
<dd>Draw concentric squares.</dt>
<dd>Draw concentric squares.</dd>
<dt>New Magic tool: Tessellation Pointy</dt>
<dd>Draw repeating tessellation patterns with pointy-topped hexagons.</dt>
<dd>Draw repeating tessellation patterns with pointy-topped hexagons.</dd>
<dt>New Magic tool: Tessellation Flat</dt>
<dd>Draw repeating tessellation patterns with flat-topped hexagons.</dt>
<dd>Draw repeating tessellation patterns with flat-topped hexagons.</dd>
<dt>Magic API Updates</dt>
<dd>Sound pause and resume functions added.</dt>
<dd>Sound pause and resume functions added.</dd>
</dl>
<p>
@ -378,6 +378,7 @@
width="324"
height="254"
alt="[Title screen]">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<h2 id="using_title">
B. Title Screen </h2>
@ -412,6 +413,7 @@
height="254"
alt=
"[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<dt>
<strong>Left Side: Toolbar</strong>
@ -431,6 +433,7 @@
width="324"
height="254"
alt="[Canvas]">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<dt>
@ -455,6 +458,7 @@
height="254"
alt=
"[Selectors - Brushes, Letters, Shapes, Stamps]">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<dt>
@ -476,6 +480,7 @@
height="254"
alt=
"[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<dt>
@ -486,13 +491,14 @@
<p>
When the active tool supports colors, a palette of colors choices will be shown near the bottom of the screen. Click one to choose a color, and it will be used by the active tool. (For example, the "Paint" tool will use it as the color to draw with the chosen brush, and the "Fill" tool will use it as the color to use when flood-filling an area of the picture.) </p>
<div class="screenshot-right-after"></div>
<div class="screenshot-right-after">
<img src="../../html/images/colors_special.png"
width="105"
height="48"
alt=""
align="right">
</div>
<img src="../../html/images/colors_special.png"
width="105"
height="48"
alt=""
align="right">
<p id="special_color_options">
On the far right are three special color options: <ul>
<li>
@ -544,6 +550,7 @@
height="254"
alt=
"(Example tip: 'Pick a shape. Click to pick the center, drag, then let go when it is the size you want. Move around to rotate it, and click to draw it.')">
<span style="display: none;"><br/>&nbsp;</span>
</div>
<dt>

40
docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt
View file

@ -1,8 +1,8 @@
Tux Paint 0.9.34 Quickstart Guide
Tools (Drawing)
### Tools (Drawing) ###
🖌Paint
## 🖌Paint ##
* Choose a brush on the right.
* Some brushes are animated 🎞, some are directional ✲, some are both.
@ -10,7 +10,7 @@ Tools (Drawing)
* Choose a color (see "Colors").
* Click/tap and drag in the canvas to paint.
⌧Stamps
## ⌧Stamps ##
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right.
@ -27,12 +27,12 @@ Tools (Drawing)
* Some stamps play descriptive sounds; press the headphones 🎧 button to hear
it again.
⚟Lines
## ⚟Lines ##
* (See Paint)
* Click/tap and drag to draw a line.
⭓Shapes
## ⭓Shapes ##
* Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a corner
@ -40,7 +40,7 @@ Tools (Drawing)
* Click/tap to position, and drag to set the size of the shape.
* Drag to rotate it, and click/tap again to add it to the drawing.
🄰Text
## 🄰Text ##
* Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
@ -60,7 +60,7 @@ Tools (Drawing)
+ "AltGr" can be used to quickly access more characters.
+ Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
🅰Label
## 🅰Label ##
* (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them,
@ -74,7 +74,7 @@ Tools (Drawing)
* Or, use the 🖑 button near the lower right to "flatten" a label, applying it
to the canvas; it may no longer be edited with the Label tool.
🪣Fill
## 🪣Fill ##
* Choose a fill mode on the right.
* Choose a color (see "Colors").
@ -90,7 +90,7 @@ Tools (Drawing)
+ Shaped - Fills the area with a gradient that follows the contours of
the area being filled
🪄Magic
## 🪄Magic ##
* Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right.
@ -101,26 +101,26 @@ Tools (Drawing)
bottom right.
* Some magic tools allow you to choose their color.
🖓Undo
## 🖓Undo ##
* Use to undo the most recent changes (multiple undo available).
* Shortcut: [Control]+[Z]
🖒Redo
## 🖒Redo ##
* Use to redo the most recent undone change (multiple redo available).
* Shortcut: [Control]+[R]
◪Eraser
## ◪Eraser ##
* Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or starter
or template image).
* Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls)
### Tools (Controls) ###
🗏New
## 🗏New ##
* Choose a solid color, starter, or template image to start with.
+ Starters allow drawing "under" a picture (e.g., a coloring book
@ -131,7 +131,7 @@ Tools (Controls)
* Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Control]+[N]
🕮⮫Open
## 🕮⮫Open ##
* Choose a previously-saved drawing to open (or export or erase).
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
@ -150,7 +150,7 @@ Tools (Controls)
* Click/tap "🖻⮫🗏Template" to turn the drawing into a new template.
* Shortcut: [Control]+[O]
🕮⮪Save
## 🕮⮪Save ##
* Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite the
@ -158,19 +158,19 @@ Tools (Controls)
(a la "File→Save As...")
* Shortcut: [Control]+[S]
🖶Print
## 🖶Print ##
* Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
if available.
* Shortcut: [Control]+[P]
🗙Quit
## 🗙Quit ##
* Click/tap to quit Tux Paint.
* Shortcut: [Escape]
Colors
### Colors ###
* Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
and Stamps and Magic tools that support colors.
@ -194,7 +194,7 @@ Colors
+ Click/tap "🗑Clear" to start over with no mixed colors.
+ Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing:
### Shortcuts while drawing: ###
* [Control]+Click/tap - Quick pipette / color picker 💉 access
* [X]+Click/tap - Quick eraser ◪ access