Regen main docs' TXT via w3m!

This commit is contained in:
Bill Kendrick 2023-07-16 10:49:44 -07:00
parent 82ee0dda75
commit 0ceb9224c4
72 changed files with 38988 additions and 37180 deletions

View file

@ -6,8 +6,7 @@
June 4, 2022 June 4, 2022
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+----------------------------------------+ +----------------------------------------+
| Table of Contents | | Table of Contents |
|----------------------------------------| |----------------------------------------|
@ -17,26 +16,22 @@
| * Replace the fringe and junk pixels | | * Replace the fringe and junk pixels |
| * Save the image for Tux Paint | | * Save the image for Tux Paint |
+----------------------------------------+ +----------------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
About this 'How-To' About this 'How-To'
This 'How-To' assumes that you want to make an excellent Tux Paint This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
photograph). There are easier and faster methods that produce lower There are easier and faster methods that produce lower quality.
quality.
This 'How-To' assumes you are dealing with normal opaque objects. This 'How-To' assumes you are dealing with normal opaque objects. Dealing
Dealing with semi-transparent objects (fire, moving fan blade, kid's with semi-transparent objects (fire, moving fan blade, kid's balloon) or
balloon) or light-giving objects (fire, lightbulb, sun) is best done light-giving objects (fire, lightbulb, sun) is best done with custom
with custom software. Images with perfect solid-color backgrounds are software. Images with perfect solid-color backgrounds are also best done
also best done with custom software, but are not troublesome to do as with custom software, but are not troublesome to do as follows.
follows.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Image choice is crucial Image choice is crucial
@ -44,9 +39,9 @@ Image choice is crucial
If you wish to submit artwork to the Tux Paint developers for If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to consideration for inclusion in the official project, or if you wish to
release your own copy of Tux Paint, bundled with your own graphics, release your own copy of Tux Paint, bundled with your own graphics, you
you need an image that is compatible with the GNU General Public need an image that is compatible with the GNU General Public License
License used by Tux Paint. used by Tux Paint.
Images produced by the US government are Public Domain, but be aware Images produced by the US government are Public Domain, but be aware
that the US government sometimes uses other images on the web. Google that the US government sometimes uses other images on the web. Google
@ -71,10 +66,10 @@ Image choice is crucial
Rotating an image can make it blurry, especially if you only rotate by Rotating an image can make it blurry, especially if you only rotate by
a few degrees. Images that don't need rotation are best, images that a few degrees. Images that don't need rotation are best, images that
need lots of rotation (30 to 60 degrees) are next best, and images need lots of rotation (30 to 60 degrees) are next best, and images that
that need just a few degrees are worst. Rotation will also make an need just a few degrees are worst. Rotation will also make an image
image darker because most image editing software is very bad about darker because most image editing software is very bad about gamma
gamma handling. (Rotation is only legitimate for gamma=1.0 images.) handling. (Rotation is only legitimate for gamma=1.0 images.)
Very large images are more forgiving of mistakes, and thus easier to Very large images are more forgiving of mistakes, and thus easier to
work with. Choose an image with an object that is over 1000 pixels work with. Choose an image with an object that is over 1000 pixels
@ -83,31 +78,31 @@ Image choice is crucial
Be sure that the image is not too grainy, dim, or washed out. Be sure that the image is not too grainy, dim, or washed out.
Pay attention to feet and wheels. If they are buried in something, you Pay attention to feet and wheels. If they are buried in something, you
will need to draw new ones. If only one is buried, you might be able will need to draw new ones. If only one is buried, you might be able to
to copy the other one as a replacement. copy the other one as a replacement.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the image Prepare the image
First of all, be sure to avoid re-saving the image as a JPEG. This First of all, be sure to avoid re-saving the image as a JPEG. This causes
causes quality loss. There is a special tool called jpegtran that lets quality loss. There is a special tool called jpegtran that lets you crop an
you crop an image without the normal quality loss. image without the normal quality loss.
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
Bring that image up in your image editor. If you didn't crop it yet, you Bring that image up in your image editor. If you didn't crop it yet, you
may find that your image editor is very slow. Rotate and crop the image may find that your image editor is very slow. Rotate and crop the image as
as needed. Save the image — choose whatever native format supports needed. Save the image — choose whatever native format supports layers,
layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop
Photoshop users should choose "PSD", for example. users should choose "PSD", for example.
If you have rotated or cropped the image in your image editor, flatten If you have rotated or cropped the image in your image editor, flatten it
it now. You need to have just one RGB layer without mask or alpha. now. You need to have just one RGB layer without mask or alpha.
Open the layers dialog box. Replicate the one layer several times. From Open the layers dialog box. Replicate the one layer several times. From top
top to bottom you will need something like this: to bottom you will need something like this:
1. unmodified image (write-protect this if you can) 1. unmodified image (write-protect this if you can)
2. an image you will modify — the "work in progress" layer 2. an image you will modify — the "work in progress" layer
@ -115,152 +110,147 @@ Prepare the image
4. solid magenta (write-protect this if you can) 4. solid magenta (write-protect this if you can)
5. unmodified image (write-protect this if you can) 5. unmodified image (write-protect this if you can)
Give the work in progress (WIP) layer a rough initial mask. You might Give the work in progress (WIP) layer a rough initial mask. You might start
start with a selection, or by using the grayscale value of the WIP with a selection, or by using the grayscale value of the WIP layer. You
layer. You might invert the mask. might invert the mask.
Warning: once you have the mask, you may not rotate or scale the image Warning: once you have the mask, you may not rotate or scale the image
normally. This would cause data loss. You will be given special scaling normally. This would cause data loss. You will be given special scaling
instructions later. instructions later.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the mask Prepare the mask
Get used to doing [Control]-click and [Alt]-click on the thumbnail Get used to doing [Control]-click and [Alt]-click on the thumbnail images
images in the layers dialog. You will need this to control what you are in the layers dialog. You will need this to control what you are looking at
looking at and what you are editing. Sometimes you will be editing and what you are editing. Sometimes you will be editing things you can't
things you can't see. For example, you might edit the mask of the WIP see. For example, you might edit the mask of the WIP layer while looking at
layer while looking at the unmodified image. Pay attention so you don't the unmodified image. Pay attention so you don't screw up. Always verify
screw up. Always verify that you are editing the right thing. that you are editing the right thing.
Set an unmodified image as what you will view (the top one is easiest). Set an unmodified image as what you will view (the top one is easiest). Set
Set the WIP mask as what you will edit. At some point, perhaps not the WIP mask as what you will edit. At some point, perhaps not immediately,
immediately, you should magnify the image to about 400% (each pixel of you should magnify the image to about 400% (each pixel of the image is seen
the image is seen and edited as a 4x4 block of pixels on your screen). and edited as a 4x4 block of pixels on your screen).
Select parts of the image that need to be 100% opaque or 0% opaque. If Select parts of the image that need to be 100% opaque or 0% opaque. If you
you can select the object or background somewhat accurately by color, do can select the object or background somewhat accurately by color, do so. As
so. As needed to avoid selecting any pixels that should be partially needed to avoid selecting any pixels that should be partially opaque
opaque (generally at the edge of the object) you should grow, shrink, (generally at the edge of the object) you should grow, shrink, and invert
and invert the selection. the selection.
Fill the 100% opaque areas with white, and the 0% opaque areas with Fill the 100% opaque areas with white, and the 0% opaque areas with black.
black. This is most easily done by drag-and-drop from the This is most easily done by drag-and-drop from the foreground/background
foreground/background color indicator. You should not see anything color indicator. You should not see anything happen, because you are
happen, because you are viewing the unmodified image layer while editing viewing the unmodified image layer while editing the mask of the WIP layer.
the mask of the WIP layer. Large changes might be noticable in the Large changes might be noticable in the thumbnail.
thumbnail.
Now you must be zoomed in. Now you must be zoomed in.
Check your work. Hide the top unmodified image layer. Display just the Check your work. Hide the top unmodified image layer. Display just the
mask, which should be a white object on a black background (probably mask, which should be a white object on a black background (probably with
with unedited grey at the edge). Now display the WIP layer normally, so unedited grey at the edge). Now display the WIP layer normally, so that the
that the mask is active. This should show your object over top of the mask is active. This should show your object over top of the next highest
next highest enabled layer, which should be green or magenta as needed enabled layer, which should be green or magenta as needed for maximum
for maximum contrast. You might wish to flip back and forth between contrast. You might wish to flip back and forth between those backgrounds
those backgrounds by repeatedly clicking to enable/disable the green by repeatedly clicking to enable/disable the green layer. Fix any obvious
layer. Fix any obvious and easy problems by editing the mask while and easy problems by editing the mask while viewing the mask.
viewing the mask.
Go back to viewing the top unmodified layer while editing the WIP mask. Go back to viewing the top unmodified layer while editing the WIP mask. Set
Set your drawing tool the paintbrush. For the brush, choose a small your drawing tool the paintbrush. For the brush, choose a small fuzzy
fuzzy circle. The 5x5 size is good for most uses. circle. The 5x5 size is good for most uses.
With a steady hand, trace around the image. Use black around the With a steady hand, trace around the image. Use black around the outside,
outside, and white around the inside. Avoid making more than one pass and white around the inside. Avoid making more than one pass without
without switching colors (and thus sides). switching colors (and thus sides).
Flip views a bit, checking to see that the mask is working well. When Flip views a bit, checking to see that the mask is working well. When the
the WIP layer is composited over the green or magenta, you should see a WIP layer is composited over the green or magenta, you should see a tiny
tiny bit of the original background as an ugly fringe around the edge. bit of the original background as an ugly fringe around the edge. If this
If this fringe is missing, then you made the object mask too small. The fringe is missing, then you made the object mask too small. The fringe
fringe consists of pixels that are neither 100% object nor 0% object. consists of pixels that are neither 100% object nor 0% object. For them,
For them, the mask should be neither 100% nor 0%. The fringe gets the mask should be neither 100% nor 0%. The fringe gets removed soon.
removed soon.
View and edit the mask. Select by color, choosing either black or white. View and edit the mask. Select by color, choosing either black or white.
Most likely you will see unselected specks that are not quite the Most likely you will see unselected specks that are not quite the expected
expected color. Invert the selection, then paint these away using the color. Invert the selection, then paint these away using the pencil tool.
pencil tool. Do this operation for both white and black. Do this operation for both white and black.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Replace the fringe and junk pixels Replace the fringe and junk pixels
Still viewing the mask, select by color. Choose black. Shrink the Still viewing the mask, select by color. Choose black. Shrink the selection
selection by several pixels, being sure to NOT shrink from the edges of by several pixels, being sure to NOT shrink from the edges of the mask (the
the mask (the shrink helps you avoid and recover from mistakes). shrink helps you avoid and recover from mistakes).
Now disable the mask. View and edit the unmasked WIP layer. Using the Now disable the mask. View and edit the unmasked WIP layer. Using the color
color picker tool, choose a color that is average for the object. picker tool, choose a color that is average for the object. Drag-and-drop
Drag-and-drop this color into the selection, thus removing most of the this color into the selection, thus removing most of the non-object pixels.
non-object pixels.
This solid color will compress well and will help prevent ugly color This solid color will compress well and will help prevent ugly color
fringes when Tux Paint scales the image down. If the edge of the object fringes when Tux Paint scales the image down. If the edge of the object has
has multiple colors that are very different, you should split up your multiple colors that are very different, you should split up your selection
selection so that you can color the nearby background to be similar. so that you can color the nearby background to be similar.
Now you will paint away the existing edge fringe. Be sure that you are Now you will paint away the existing edge fringe. Be sure that you are
editing and viewing the WIP image. Frequent layer visibility changes editing and viewing the WIP image. Frequent layer visibility changes will
will help you to see what you are doing. You are likely to use all of: help you to see what you are doing. You are likely to use all of:
* composited over green (mask enabled) + composited over green (mask enabled)
* composited over magenta (mask enabled) + composited over magenta (mask enabled)
* original (the top or bottom layer) + original (the top or bottom layer)
* composited over the original (mask enabled) + composited over the original (mask enabled)
* raw WIP layer (mask disabled) + raw WIP layer (mask disabled)
To reduce accidents, you may wish to select only those pixels that are To reduce accidents, you may wish to select only those pixels that are not
not grey in the mask. (Select by color from the mask, choose black, add grey in the mask. (Select by color from the mask, choose black, add mode,
mode, choose white, invert. Alternately: Select all, select by color choose white, invert. Alternately: Select all, select by color from the
from the mask, subtract mode, choose black, choose white.) If you do mask, subtract mode, choose black, choose white.) If you do this, you'll
this, you'll probably want to expand the selection a bit and/or hide the probably want to expand the selection a bit and/or hide the "crawling ants"
"crawling ants" line that marks the selection. line that marks the selection.
Use the clone tool and the brush tool. Vary the opacity as needed. Use Use the clone tool and the brush tool. Vary the opacity as needed. Use
small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is
generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy
brushes with about 70% opacity.) Unusual drawing modes can be helpful brushes with about 70% opacity.) Unusual drawing modes can be helpful with
with semi-transparent objects. semi-transparent objects.
The goal is to remove the edge fringe, both inside and outside of the The goal is to remove the edge fringe, both inside and outside of the
object. The inside fringe, visible when the object is composited over object. The inside fringe, visible when the object is composited over
magenta or green, must be removed for obvious reasons. The outside magenta or green, must be removed for obvious reasons. The outside fringe
fringe must also be removed because it will become visible when the must also be removed because it will become visible when the image is
image is scaled down. As an example, consider a 2x2 region of pixels at scaled down. As an example, consider a 2x2 region of pixels at the edge of
the edge of a sharp-edged object. The left half is black and 0% opaque. a sharp-edged object. The left half is black and 0% opaque. The right half
The right half is white and 100% opaque. That is, we have a white object is white and 100% opaque. That is, we have a white object on a black
on a black background. When Tux Paint scales this to 50% (a 1x1 pixel background. When Tux Paint scales this to 50% (a 1x1 pixel area), the
area), the result will be a grey 50% opaque pixel. The correct result result will be a grey 50% opaque pixel. The correct result would be a white
would be a white 50% opaque pixel. To get this result, we would paint 50% opaque pixel. To get this result, we would paint away the black pixels.
away the black pixels. They matter, despite being 0% opaque. They matter, despite being 0% opaque.
Tux Paint can scale images down by a very large factor, so it is Tux Paint can scale images down by a very large factor, so it is important
important to extend the edge of your object outward by a great deal. to extend the edge of your object outward by a great deal. Right at the
Right at the edge of your object, you should be very accurate about edge of your object, you should be very accurate about this. As you go
this. As you go outward away from the object, you can get a bit sloppy. outward away from the object, you can get a bit sloppy. It is reasonable to
It is reasonable to paint outward by a dozen pixels or more. The farther paint outward by a dozen pixels or more. The farther you go, the more Tux
you go, the more Tux Paint can scale down without creating ugly color Paint can scale down without creating ugly color fringes. For areas that
fringes. For areas that are more than a few pixels away from the object are more than a few pixels away from the object edge, you should use the
edge, you should use the pencil tool (or sloppy select with pencil tool (or sloppy select with drag-and-drop color) to ensure that the
drag-and-drop color) to ensure that the result will compress well. result will compress well.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
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 It is very easy to ruin your hard work. Image editors can silently destroy
destroy pixels in 0% opaque areas. The conditions under which this pixels in 0% opaque areas. The conditions under which this happens may vary
happens may vary from version to version. If you are very trusting, you from version to version. If you are very trusting, you can try saving your
can try saving your image directly as a PNG. Be sure to read it back in image directly as a PNG. Be sure to read it back in again to verify that
again to verify that the 0% opaque areas didn't turn black or white, the 0% opaque areas didn't turn black or white, which would create fringes
which would create fringes when Tux Paint scales the image down. If you when Tux Paint scales the image down. If you need to scale your image to
need to scale your image to save space (and hide your mistakes), you are save space (and hide your mistakes), you are almost certain to destroy all
almost certain to destroy all the 0% opaque areas. So here is a better the 0% opaque areas. So here is a better way...
way...
A Safer Way to Save A Safer Way to Save
@ -271,17 +261,17 @@ Save the image for Tux Paint
with an image that is about 700 to 1500 pixels across, and end up with with an image that is about 700 to 1500 pixels across, and end up with
one that is 300 to 400. one that is 300 to 400.
Save the mask image as a NetPBM portable greymap (".pgm") file. (If Save the mask image as a NetPBM portable greymap (".pgm") file. (If you
you are using an old release of The GIMP, you might need to convert are using an old release of The GIMP, you might need to convert the
the image to greyscale before you can save it.) Choose the more image to greyscale before you can save it.) Choose the more compact
compact "RAW PGM" format. (The second character of the file should be "RAW PGM" format. (The second character of the file should be the ASCII
the ASCII digit "5", hex byte 0x35.) digit "5", hex byte 0x35.)
You may close the mask image. You may close the mask image.
Going back to the multi-layer image, now select the WIP layer. As you Going back to the multi-layer image, now select the WIP layer. As you
did with the mask, drag this from the layers dialog to the toolbar. did with the mask, drag this from the layers dialog to the toolbar. You
You should get a single-layer image of your WIP data. If the mask came should get a single-layer image of your WIP data. If the mask came
along too, get rid of it. You should be seeing the object and the along too, get rid of it. You should be seeing the object and the
painted-away surroundings, without any mask thumbnail in the layers painted-away surroundings, without any mask thumbnail in the layers
dialog. If you scaled the mask, then scale this image in exactly the dialog. If you scaled the mask, then scale this image in exactly the
@ -289,8 +279,9 @@ Save the image for Tux Paint
(Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second (Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second
byte of the file should be the ASCII digit "6", hex byte 0x36.) byte of the file should be the ASCII digit "6", hex byte 0x36.)
Now you need to merge the two files into one. Do that with the Now you need to merge the two files into one. Do that with the pnmtopng
pnmtopng command, like this: command, like this:
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,91 +7,97 @@
May 5, 2023 May 5, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, Tux Paint understands a number of environment variables, either directly, or
or indirectly by the libraries that it utilizes. 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 Specifies the user's "home directory", which is used to locate numerous
numerous other files or directories. In some cases, it is utilized other files or directories. In some cases, it is utilized as part of a
as part of a fall-back location, when other environment variables fall-back location, when other environment variables (elsewhere in this
(elsewhere in this documentation) are not set. Sometimes, the documentation) are not set. Sometimes, the location to use can be
location to use can be overridden by options provided on the overridden by options provided on the command-line or via Tux Paint's
command-line or via Tux Paint's configuration file. See the configuration file. See the "OPTIONS" documentation for details.
"OPTIONS" documentation for details.
A few examples of where "$HOME" is used include: A few examples of where "$HOME" is used include:
* The location of Tux Paint's configuration file + The location of Tux Paint's configuration file
* The basis of where Tux Paint saves and loads users' drawings + The basis of where Tux Paint saves and loads users' drawings
* The location of a user's private collection of data files — + The location of a user's private collection of data files — stamps,
stamps, brushes, etc. — (versus those available system wide) brushes, etc. — (versus those available system wide)
XDG_CONFIG_HOME XDG_CONFIG_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's configuration files. the location of the user's configuration files. Specifically, where to find
Specifically, where to find "user-dirs.dirs", where the "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used
"XDG_PICTURES_DIR" might be defined. It is used for exporting for exporting drawings and animated GIFs. Generally it's set to something
drawings and animated GIFs. Generally it's set to something like like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory
"$HOME/Pictures/". If not specified, Tux Paint checks in the "$HOME/.config/". If the configuration cannot be found, Tux Paint simply
directory "$HOME/.config/". If the configuration cannot be found, exports drawings and GIFs to "$HOME".
Tux Paint simply exports drawings and GIFs to "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's data directories. the location of the user's data directories. Specifically, where to find
Specifically, where to find the "Trash" directory. It is used when the "Trash" directory. It is used when deleting images from Tux Paint's
deleting images from Tux Paint's "Open" dialog. If not set, the "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is
location "$HOME/.local/share/Trash/" is used, if available. If used, if available. If not, images are simply deleted, rather than moved
not, images are simply deleted, rather than moved anywhere. anywhere.
TEMP TEMP
Specifies the location where temporary files may be created. Only Specifies the location where temporary files may be created. Only used by
used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
not set.
Language-related environment variables Language-related environment variables
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Specify the language Tux Paint should utilize in its user Specify the language Tux Paint should utilize in its user interface.
interface. Overridde by the "--lang" and "--locale" command-line Overridde by the "--lang" and "--locale" command-line options or their
options or their configuration file counterparts. The "LANGUAGE" configuration file counterparts. The "LANGUAGE" environment variable is
environment variable is used, if set. If not, "LC_ALL" is used as used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES",
a fallback. Then "LC_MESSAGES", and finally "LANG". and finally "LANG".
Display-related environment variables Display-related environment variables
The following are a few of the environment variables supported by Simple The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
graphics, playing sounds, and receiving mouse, keyboard, and joystick playing sounds, and receiving mouse, keyboard, and joystick input — and which
input — and which may be useful to users of Tux Paint. 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 Specifies whether Tux Paint should allow a screensaver to run. Can be set
be set to '1' (true) by Tux Paint itself by issuing the to '1' (true) by Tux Paint itself by issuing the command-line option
command-line option "--allowscreensaver" or its configuration file "--allowscreensaver" or its configuration file counterpart.
counterpart.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

View file

@ -6,8 +6,7 @@
July 13, 2023 July 13, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+------------------------------+ +------------------------------+
| Table of Contents | | Table of Contents |
|------------------------------| |------------------------------|
@ -20,549 +19,549 @@
| * Other Problems | | * Other Problems |
| * Help / Contact | | * Help / Contact |
+------------------------------+ +------------------------------+
-------------------------------------------------------------------------------
----------------------------------------------------------------------
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 The TrueType Font you're using might have the wrong encoding. If it's
it's 'custom' encoded, for example, you can try running it through 'custom' encoded, for example, you can try running it through FontForge (
FontForge (http://fontforge.sourceforge.net/) to convert it to an http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
ISO-8859 format. (Email us if you need help with special fonts.) (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, This means that Tux Paint either couldn't find any stamp images, or was
or was asked not to load them. asked not to load them.
If you installed Tux Paint, but did not install the separate, If you installed Tux Paint, but did not install the separate, optional
optional "Stamps" collection, quit Tux Paint and install it now. "Stamps" collection, quit Tux Paint and install it now. It should be
It should be available from the same place you got the main Tux available from the same place you got the main Tux Paint program. (Note: As
Paint program. (Note: As of version 0.9.14, Tux Paint comes with a of version 0.9.14, Tux Paint comes with a small collection of example
small collection of example stamps.) stamps.)
If you don't want to install the default collection of stamps, you If you don't want to install the default collection of stamps, you can just
can just create your own. See the "Extending Tux Paint" create your own. See the "Extending Tux Paint" documentation for more on
documentation for more on creating PNG and SVG image files, TXT creating PNG and SVG image files, TXT text description files, Ogg Vorbis,
text description files, Ogg Vorbis, MP3 or WAV sound files, and MP3 or WAV sound files, and DAT text data files that make up stamps.
DAT text data files that make up stamps.
Finally, if you installed stamps, and think they should be loading, check
to see that the "nostamps" option isn't being set. (Either via a
"--nostamps" option to Tux Paint's command line, or "nostamps=yes" in the
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.
Finally, if you installed stamps, and think they should be
loading, check to see that the "nostamps" option isn't being set.
(Either via a "--nostamps" option to Tux Paint's command line, or
"nostamps=yes" in the 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.
Stamp outlines are always rectangles Stamp outlines are always rectangles
Tux Paint was built with low-quality (but faster) stamp outlines. Tux Paint was built with low-quality (but faster) stamp outlines.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_STAMP_OUTLINE #define LOW_QUALITY_STAMP_OUTLINE
in the "tuxpaint.c" file in the "src" directory. 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 Tux Paint was probably compiled with the faster, lower quality thumbnail
thumbnail code enabled. Run the command: "tuxpaint code enabled. Run the command: "tuxpaint --verbose-version" from a command
--verbose-version" from a command line. If, amongst the other line. If, amongst the other output, you see the text: "Low Quality
output, you see the text: "Low Quality Thumbnails enabled", then Thumbnails enabled", then this is what's happening.
this is what's happening.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_THUMBNAILS #define LOW_QUALITY_THUMBNAILS
in the "tuxpaint.c" file in the "src" directory. 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 "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
thumbnails in the Stamp Selector look bad", above. Stamp Selector look bad", above.
All of the text is in uppercase! All of the text is in uppercase!
The "uppercase" option is on. The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override Either change/remove the "uppercase" option, or you can override it with
it with "--mixedcase" on the command line or either "uppercase=no" "--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
or "mixedcase=yes" in a configuration file. 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 Make sure your locale setting is correct. See "Tux Paint won't switch to my
switch to my language", below. 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 + Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your Make sure the locale you want is available. Check your "/etc/
"/etc/locale.gen" file. See the "Options Documentation" for locale.gen" file. See the "Options Documentation" for the locales Tux
the locales Tux Paint uses (especially when using the Paint uses (especially when using the "--lang" option).
"--lang" option).
Note: Debian and derivative (e.g., Ubuntu) users can simply Note: Debian and derivative (e.g., Ubuntu) users can simply run
run "dpkg-reconfigure locales" if the locales are managed by "dpkg-reconfigure locales" if the locales are managed by "dpkg".
"dpkg".
* If you're using the "--lang" command-line option + If you're using the "--lang" command-line option
Try using the "--locale" command-line option, or your Try using the "--locale" command-line option, or your operating
operating system's locale settings (e.g., the "$LANG" system's locale settings (e.g., the "$LANG" environment variable), and
environment variable), and please e-mail us regarding your please e-mail us regarding your trouble.
trouble.
* If you're using the "--locale" command-line option + If you're using the "--locale" command-line option
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* If you're trying to use your Operating System's locale + If you're trying to use your Operating System's locale
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* Make sure you have the necessary font + Make sure you have the necessary font
Some translations require their own font. Chinese and Korean, Some translations require their own font. Chinese and Korean, for
for example, need Chinese and Korean TrueType Fonts installed example, need Chinese and Korean TrueType Fonts installed and placed in
and placed in the proper location, respectively. the proper location, respectively.
The appropriate fonts for such locales can be downloaded from The appropriate fonts for such locales can be downloaded from the Tux
the Tux Paint website: Paint website:
https://tuxpaint.org/download/fonts/ 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 Tux Paint prints by creating a PostScript rendition of the picture and
and sending it to an external command. By default, this command is sending it to an external command. By default, this command is the "lpr"
the "lpr" printing tool. printing tool.
If that program is not available (for example, you're using CUPS, If that program is not available (for example, you're using CUPS, the
the Common Unix Printing System, and do not have "cups-lpr" Common Unix Printing System, and do not have "cups-lpr" installed), you
installed), you will need to specify an appropriate command using will need to specify an appropriate command using the "printcommand" option
the "printcommand" option in Tux Paint's configuration file. (See 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.
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.
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.
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 The "print delay" option is on. You can only print once every X seconds.
seconds.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--printdelay=..." option. giving it a "--printdelay=..." option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--printdelay=..." is listed as a properties of the icon to see if "--printdelay=..." is listed as a
command-line argument. command-line argument.
If a "--printdelay=..." option isn't being sent on the command If a "--printdelay=..." option isn't being sent on the command line, check
line, check Tux Paint's configuration file for a line reading: Tux Paint's configuration file for a line reading: "printdelay=...".
"printdelay=...".
Either remove that line, set the delay value to 0 (no delay), or Either remove that line, set the delay value to 0 (no delay), or decrease
decrease the delay to a value you prefer. (See the "Options the delay to a value you prefer. (See the "Options Documentation".)
Documentation".)
Or, you can simply run Tux Paint with the command-line argument: Or, you can simply run Tux Paint with the command-line argument:
"--printdelay=0", which will override the configuration file's "--printdelay=0", which will override the configuration file's setting, and
setting, and allow unlimited printing. (You won't have to wait allow unlimited printing. (You won't have to wait between prints.)
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. The "no print" option is on.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noprint" option. giving it a "--noprint" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noprint" is listed as a properties of the icon to see if "--noprint" is listed as a command-line
command-line argument. argument.
If a "--noprint" option isn't being sent on the command line, If a "--noprint" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "noprint=yes".
"noprint=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--print", which will override the argument: "--print", which will override the configuration file's setting.
configuration file's setting.
Or use Tux Paint Config. and make sure "Allow Printing" (under Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing")
"Printing") is checked. 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 Unless you asked Tux Paint to save into a specific location (using the
the "savedir" option), Tux Paint saves into a standard location on "savedir" option), Tux Paint saves into a standard location on your local
your local drive: drive:
Windows Vista, Windows 8, Windows 10, Windows 11 Windows Vista, Windows 8, Windows 10, Windows 11
In the user's "AppData" folder: In the user's "AppData" folder:
e.g., e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved
C:\Users\Username\AppData\Roaming\TuxPaint\saved
macOS macOS
In the user's "Application Support" folder: In the user's "Application Support" folder:
e.g., /Users/Username/Library/Applicaton e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/
Support/TuxPaint/saved/
Linux / Unix Linux / Unix
In the user's home directory ("$HOME"), under a In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder:
".tuxpaint" subfolder:
e.g., /home/username/.tuxpaint/saved/ 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 The images are stored as PNG bitmaps, which most modern programs should be
browsers, etc.) 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 The "save over" option is enabled. (This disables the prompt that would
would appear when you click 'Save.') appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveover" option. giving it a "--saveover" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveover" is listed as a properties of the icon to see if "--saveover" is listed as a command-line
command-line argument. argument.
If a "--saveover" option isn't being sent on the command line, If a "--saveover" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=yes".
"saveover=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves a new picture!", below. 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 The "never save over" option is enabled. (This disables the prompt that
that would appear when you click 'Save.') would appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveovernew" option. giving it a "--saveovernew" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveovernew" is listed as a properties of the icon to see if "--saveovernew" is listed as a
command-line argument. command-line argument.
If a "--saveovernew" option isn't being sent on the command line, If a "--saveovernew" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=new".
"saveover=new".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves over my old picture!", above. 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: + First, check the obvious:
* Are your speakers connected and turned on? o Are your speakers connected and turned on?
* Is the volume turned up on your speakers? o Is the volume turned up on your speakers?
* Is the volume turned up in your Operating System's o Is the volume turned up in your Operating System's "mixer?"
"mixer?" o Are you certain you're using a computer with a sound card?
* Are you certain you're using a computer with a sound o Are any other programs running that use sound? (They may be
card? 'blocking' Tux Paint from accessing your sound device)
* Are any other programs running that use sound? (They may o (Unix/Linux) Are you using a sound system, such as aRts, ESD or
be 'blocking' Tux Paint from accessing your sound GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment
device) variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER=
* (Unix/Linux) Are you using a sound system, such as aRts, arts"). Or, run Tux Paint through the system's rerouter (e.g., run
ESD or GStreamer? If so, try setting the "artsdsp tuxpaint" or "esddsp tuxpaint", instead of simply
"SDL_AUDIODRIVER" environment variable before running "tuxpaint").
Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run + Is sound disabled in Tux Paint?
Tux Paint through the system's rerouter (e.g., run
"artsdsp tuxpaint" or "esddsp tuxpaint", instead of
simply "tuxpaint").
* Is sound disabled in Tux Paint?
If sound seems to work otherwise (and you're sure no other If sound seems to work otherwise (and you're sure no other program is
program is "blocking" the sound device), then Tux Paint may "blocking" the sound device), then Tux Paint may be running with a "no
be running with a "no sound" option. sound" option.
If you're running Tux Paint from a command-line, make sure If you're running Tux Paint from a command-line, make sure you're not
you're not giving it a "--nosound" option. giving it a "--nosound" option.
If you're running Tux Paint by double-clicking an icon, check If you're running Tux Paint by double-clicking an icon, check the
the properties of the icon to see if "--nosound" is listed as properties of the icon to see if "--nosound" is listed as a
a command-line argument. command-line argument.
If a "--nosound" option isn't being sent on the command line, If a "--nosound" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "nosound=yes".
"nosound=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--sound", which will override the argument: "--sound", which will override the configuration file's
configuration file's setting. setting.
Or, you can simply run Tux Paint with the command-line Or, you can simply run Tux Paint with the command-line argument:
argument: "Enable Sound Effects", which will override the "Enable Sound Effects", which will override the configuration file's
configuration file's setting, and allow unlimited printing. setting, and allow unlimited printing. (You won't have to wait between
(You won't have to wait between prints.) prints.)
* Were sounds temporarily disabled? + Were sounds temporarily disabled?
Even if sounds are enabled in Tux Paint, it is possible to Even if sounds are enabled in Tux Paint, it is possible to disable and
disable and re-enable them temporarily using the [Alt] + [S] re-enable them temporarily using the [Alt] + [S] key sequence. Try
key sequence. Try pressing those keys to see if sounds begin pressing those keys to see if sounds begin working again.
working again.
* Was Tux Paint built without sound support? + Was Tux Paint built without sound support?
Tux Paint may have been compiled with sound support disabled. Tux Paint may have been compiled with sound support disabled. To test
To test whether sound support was enabled when Tux Paint was whether sound support was enabled when Tux Paint was compiled, run Tux
compiled, run Tux Paint from a command line, like so: Paint from a command line, like so:
tuxpaint --verbose-version tuxpaint --verbose-version
If, amongst the other information, you see "Sound disabled", If, amongst the other information, you see "Sound disabled", then the
then the version of Tux Paint you're running has sound version of Tux Paint you're running has sound disabled. Recompile Tux
disabled. Recompile Tux Paint, and be sure NOT to build the Paint, and be sure NOT to build the "nosound" target. (i.e., don't run
"nosound" target. (i.e., don't run "make nosound") Be sure "make nosound") Be sure the SDL_mixer library and its development
the SDL_mixer library and its development headers are headers are available!
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: Yes, there are a number of ways to disable sounds in Tux Paint:
* Press [Alt] + [S] while in Tux Paint to temporarily disable + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds.
sounds. (Press that key sequence again to re-enable sounds.) (Press that key sequence again to re-enable sounds.)
* Run Tux Paint with the "no sound" option: + Run Tux Paint with the "no sound" option:
* Run "tuxpaint --nosound" from the command line or o Run "tuxpaint --nosound" from the command line or shortcut or
shortcut or desktop icon. desktop icon.
* Edit Tux Paint's configuration file (see "Options o Edit Tux Paint's configuration file (see "Options Documentation"
Documentation" for details) and add a line containing for details) and add a line containing "nosound=yes".
"nosound=yes". o Or use Tux Paint Config. and make sure "Enable Sound Effects"
* Or use Tux Paint Config. and make sure "Enable Sound (under "Video & Sound") is not checked.
Effects" (under "Video & Sound") is not checked. o Alternatively, recompile Tux Paint with sound support disabled.
* Alternatively, recompile Tux Paint with sound support (See above, and the 'Install' documentation.
disabled. (See above, and the 'Install' documentation.
The stereo panning of sound effects is bothersome; can sound effects be The stereo panning of sound effects is bothersome; can sound effects be
monophonic? monophonic?
Run Tux Paint with the "no stereo" option: Run Tux Paint with the "no stereo" option:
* Run "tuxpaint --nostereo" from the command line or shortcut + Run "tuxpaint --nostereo" from the command line or shortcut or desktop
or desktop icon. icon.
* Edit Tux Paint's configuration file (see "Options + Edit Tux Paint's configuration file (see "Options Documentation" for
Documentation" for details) and add a line containing details) and add a line containing "nostereo=yes".
"nostereo=yes". + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
* Or use Tux Paint Config. and make sure "Enable Stereo "Video & Sound") is not checked.
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. This could have to do with how SDL and SDL_mixer were initialized. (The
(The buffer size chosen.) buffer size chosen.)
Please e-mail us with details about your computer system. Please e-mail us with details about your computer system. (Operating system
(Operating system and version, sound card, which version of Tux and version, sound card, which version of Tux Paint you're running (run
Paint you're running (run "tuxpaint --version" to verify), and so "tuxpaint --version" to verify), and so on.)
on.)
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Fullscreen Mode Problems Fullscreen Mode Problems
When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
black!
This is apparently a bug in the SDL library. Sorry. 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 Linux users - Your X-Window server is probably not set with the ability to
ability to switch to the desired resolution: 800×600. (or whatever switch to the desired resolution: 800×600. (or whatever resolution you have
resolution you have Tux Paint set to run at.) (This is typically Tux Paint set to run at.) (This is typically done manually under the
done manually under the X-Window server by pressing [Control] + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and
[Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus [Control] + [Alt] + [Keypad Minus (-)].)
(-)].)
For this to work, your monitor must support that resolution, and For this to work, your monitor must support that resolution, and you need
you need to have it listed in your X server configuration. to have it listed in your X server configuration.
Check the "Display" subsection of the "Screen" section of your Check the "Display" subsection of the "Screen" section of your XFree86 or
XFree86 or X.org configuration file (typically X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/
"/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x,
version of XFree86 you're using; 3.x or 4.x, respectively, or respectively, or "/etc/X11/xorg.conf" for X.org).
"/etc/X11/xorg.conf" for X.org).
Add "800x600" (or whatever resolution(s) you want) to the Add "800x600" (or whatever resolution(s) you want) to the appropriate
appropriate "Modes" line. (e.g., in the "Display" subsection that "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color
contains 24-bit color depth ("Depth 24"), which is what Tux Paint depth ("Depth 24"), which is what Tux Paint tries to use.)
tries to use.)
Modes "1280x1024" "1024x768" "800x600" "640x480" Modes "1280x1024" "1024x768" "800x600" "640x480"
Note that some Linux distributions have tools that can make these Note that some Linux distributions have tools that can make these changes
changes for you. Debian users can run the command for you. Debian users can run the command "dpkg-reconfigure
"dpkg-reconfigure xserver-xfree86" as root, for example. 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. The "fullscreen" option is set.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--fullscreen" option. giving it a "--fullscreen" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--fullscreen" is listed as a properties of the icon to see if "--fullscreen" is listed as a command-line
command-line argument. argument.
If a "--fullscreen" option isn't being sent on the command line, If a "--fullscreen" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "fullscreen=yes".
"fullscreen=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--windowed", which will override the argument: "--windowed", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Fullscreen" (under "Video Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound")
& Sound") is not checked. is not checked.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
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 If Tux Paint aborts with the message: "You're already running a copy of Tux
copy of Tux Paint!", this means it has been launched in the last Paint!", this means it has been launched in the last 30 seconds. (On Unix/
30 seconds. (On Unix/Linux, this message would appear in a Linux, this message would appear in a terminal console if you ran Tux Paint
terminal console if you ran Tux Paint from a command-line. On from a command-line. On Windows, this message would appear in a file named
Windows, this message would appear in a file named "stdout.txt" in "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\
the same folder where TuxPaint.exe resides (e.g., in "C:\Program Program Files\TuxPaint").
Files\TuxPaint").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\
"userdata\lockfile.dat" on Windows) is used to make sure Tux Paint lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many
isn't run too many times at once (e.g., due to a child impatiently times at once (e.g., due to a child impatiently clicking its icon more than
clicking its icon more than once). once).
Even if the lockfile exists, it contains the 'time' Tux Paint was Even if the lockfile exists, it contains the 'time' Tux Paint was last run.
last run. If it's been more than 30 seconds, Tux Paint should run If it's been more than 30 seconds, Tux Paint should run fine, and simply
fine, and simply update the lockfile with the current time. update the lockfile with the current time.
If multiple users are sharing the directory where this file is 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, or "nolockfile=yes" to the configuration file.
If multiple users are sharing the directory where this file is
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, or "nolockfile=yes" to the configuration
file.
I can't quit Tux Paint I can't quit Tux Paint
The "no quit" option is set. This disables the "Quit" button in The "no quit" option is set. This disables the "Quit" button in Tux Paint's
Tux Paint's toolbar (greying it out), and prevents Tux Paint from toolbar (greying it out), and prevents Tux Paint from being exited via the
being exited via the [Escape] key. [Escape] key.
If Tux Paint is not in fullscreen mode, simply click the window If Tux Paint is not in fullscreen mode, simply click the window close
close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.)
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 "no quit" set, you can always use the [Alt] + [F4]
combination on your keyboard to quit Tux Paint.)
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 "no quit" set, you can always use the [Alt]
+ [F4] 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 If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noquit" option. giving it a "--noquit" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noquit" is listed as a properties of the icon to see if "--noquit" is listed as a command-line
command-line argument. argument.
If a "--noquit" option isn't being sent on the command line, check If a "--noquit" option isn't being sent on the command line, check Tux
Tux Paint's configuration file for a line reading: "noquit=yes". 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 configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape]
Key" (under "Simplification") is not checked.
Either remove that line, or simply run Tux Paint with the
command-line argument: "--quit", which will override the
configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and
[Escape] 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 A few messages are normal, but if Tux Paint is being extremely verbose
verbose (like listing the name of every rubber-stamp image it (like listing the name of every rubber-stamp image it finds while loading
finds while loading them), then it was probably compiled with them), then it was probably compiled with debugging output turned on.
debugging output turned on.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define DEBUG #define DEBUG
in the "tuxpaint.c" file in the "src" directory. 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 By default, Tux Paint first looks at configuration files for options.
options.
* Windows + Windows
Under Windows, Tux Paint first examines the configuration Under Windows, Tux Paint first examines the configuration file:
file:
tuxpaint.cfg tuxpaint.cfg
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* macOS + macOS
* Unix and Linux + Unix and Linux
Under Unix and Linux, it first examines the system-wide Under Unix and Linux, it first examines the system-wide configuration
configuration file, located here: file, located here:
/etc/tuxpaint/tuxpaint.conf /etc/tuxpaint/tuxpaint.conf
@ -572,19 +571,19 @@ Other Problems
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* Haiku + Haiku
This means that if anything is set in a configuration file that This means that if anything is set in a configuration file that you don't
you don't want set, you'll need to either change the config. file want set, you'll need to either change the config. file (if you can), or
(if you can), or override the option on the command-line. override the option on the command-line.
For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes
includes this option to disable sound... this option to disable sound...
nosound=yes nosound=yes
...then you can reenable sound by either adding this option to ...then you can reenable sound by either adding this option to your own
your own ".tuxpaintrc" file: ".tuxpaintrc" file:
sound=yes sound=yes
@ -592,24 +591,27 @@ Other Problems
--sound --sound
Linux and Unix users can also disable the system-wide Linux and Unix users can also disable the system-wide configuration file by
configuration file by including the following command-line including the following command-line argument:
argument:
--nosysconfig --nosysconfig
Tux Paint will then only look at "~/.tuxpaintrc" and command-line Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments
arguments to determine what options should be set. to determine what options should be set.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Help / Contact Help / Contact
Any questions you don't see answered? Please let us know! You can Any questions you don't see answered? Please let us know! You can subscribe and
subscribe and post to our "tuxpaint-users" mailing list: post to our "tuxpaint-users" mailing list:
https://tuxpaint.org/lists/ https://tuxpaint.org/lists/
Or, contact lead developer Bill Kendrick directly: Or, contact lead developer Bill Kendrick directly:
bill@newbreedsoftware.com bill@newbreedsoftware.com

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -10,79 +10,83 @@
About PNGs About PNGs
PNG is the Portable Network Graphic format. It is an open standard, not PNG is the Portable Network Graphic format. It is an open standard, not
burdened by patents (like GIFs). It is a highly compressed format (though burdened by patents (like GIFs). It is a highly compressed format (though not
not "lossy" like JPEGs - lossiness allows files to be much smaller, but "lossy" like JPEGs - lossiness allows files to be much smaller, but introduces
introduces 'mistakes' in the image when saved), and supports 24-bit color 'mistakes' in the image when saved), and supports 24-bit color (16.7 million
(16.7 million colors) as well as a full "alpha channel" - that is, each colors) as well as a full "alpha channel" - that is, each pixel can have a
pixel can have a varying degree of transparency. varying degree of transparency.
For more information, visit: http://www.libpng.org/ For more information, visit: http://www.libpng.org/
These features (openness, losslessness, compression, transparency/alpha) These features (openness, losslessness, compression, transparency/alpha) make
make it the best choice for Tux Paint. (Tux Paint's support for the PNG it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes
format comes from the Open Source SDL_Image library, which in turn gets it from the Open Source SDL_Image library, which in turn gets it from the libPNG
from the libPNG library.) library.)
Support for many colors allows photo-quality "rubber stamp" images to be Support for many colors allows photo-quality "rubber stamp" images to be used
used in Tux Paint, and alpha transparency allows for high-quality brushes. 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 The following is a very brief list of ways to create PNGs or convert existing
existing images into PNGs. images into PNGs.
GIMP & Krita GIMP & Krita
Excellent tools with which to create PNG images for use in Tux Excellent tools with which to create PNG images for use in Tux Paint are
Paint are GIMP and Krita, both high-quality Open Source GIMP and Krita, both high-quality Open Source interactive drawing and photo
interactive drawing and photo editing programs. editing programs.
It is likely that one or both are already installed on your system. If not,
they should be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://www.gimp.org/ and http:/
/www.krita.org/, respectively.
It is likely that one or both are already installed on your
system. If not, they should be readily available from your Linux
distribution's software repository. If not, or to learn more,
visit http://www.gimp.org/ and http://www.krita.org/,
respectively.
Command-line Tools Command-line Tools
NetPBM NetPBM
The Portable Bitmap tools (collectively known as The Portable Bitmap tools (collectively known as "NetPBM") is a
"NetPBM") is a collection of Open Source command-line collection of Open Source command-line tools which convert to and from
tools which convert to and from various formats, various formats, including GIF, TIFF, BMP, PNG, and many more.
including GIF, TIFF, BMP, PNG, and many more.
It is possible that it's already installed on your system. If not, they
it be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://
netpbm.sourceforge.net/.
It is possible that it's already installed on your
system. If not, they it be readily available from
your Linux distribution's software repository. If
not, or to learn more, visit
http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
The "cjpeg" and "djpeg" command-line programs convert The "cjpeg" and "djpeg" command-line programs convert between the
between the NetPBM Portable Any Map (PNM) format and NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
JPEGs. It is possible that it's already installed on it's already installed on your system. If not, they it be readily
your system. If not, they it be readily available available from your Linux distribution's software repository. If not,
from your Linux distribution's software repository. or to learn more, visit https://jpegclub.org/.
If not, or to learn more, visit
https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Macintosh Users Macintosh Users
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -7,47 +7,51 @@
June 4, 2022 June 4, 2022
Tux Paint responds to the following signals (which can be sent to the Tux Paint responds to the following signals (which can be sent to the program's
program's process via `kill` or `killall`, for example). 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 Tux Paint responds as if the "Quit" button were pressed, or the desktop
desktop environment was told to close Tux Paint (e.g., by clicking environment was told to close Tux Paint (e.g., by clicking a window close
a window close button, or pressing [Alt] + [F4] on most systems). button, or pressing [Alt] + [F4] on most systems).
From the main interface, Tux Paint will prompt whether or not you From the main interface, Tux Paint will prompt whether or not you wish to
wish to quit, and (unless overridden by the auto-save option, e.g. quit, and (unless overridden by the auto-save option, e.g. "--autosave") if
"--autosave") if you'd like to save the current drawing (if you'd like to save the current drawing (if unsaved), and if so, and it's a
unsaved), and if so, and it's a modified version of an existing modified version of an existing drawing (unless overridden by the options
drawing (unless overridden by the options to save over old images, to save over old images, or always save new images; e.g. "--saveover" and
or always save new images; e.g. "--saveover" and "--saveovernew", "--saveovernew", respectively), whether or not to overwrite the existing
respectively), whether or not to overwrite the existing drawing, drawing, or save to a new file.
or save to a new file.
Example: killall tuxpaint Example: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint responds by setting its auto-save option (as if it had Tux Paint responds by setting its auto-save option (as if it had been
been launched with "--autosave"), as well as either the option to launched with "--autosave"), as well as either the option to always save
always save new images (as if launched with "--saveovernew") in new images (as if launched with "--saveovernew") in the case of receiving a
the case of receiving a SIGUSR1 signal, or to always save over the SIGUSR1 signal, or to always save over the existing image (as if launched
existing image (as if launched with "--saveover") in the case of with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends
receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, itself a SIGTERM signal, in an attempt to quit. (See above.)
in an attempt to quit. (See above.)
So, from the main interface, Tux Paint should quit almost So, from the main interface, Tux Paint should quit almost immediately, with
immediately, with no questions asked. no questions asked.
Example: killall -s SIGUSR1 tuxpaint Example: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -10,27 +10,28 @@
About SVGs About SVGs
SVG (Scalable Vector Graphics) is an open standard used to describe SVG (Scalable Vector Graphics) is an open standard used to describe
two-dimensional vector graphics. It is great for diagrams and shapes, two-dimensional vector graphics. It is great for diagrams and shapes, while
while PNGs are better for photographs. SVG files are a bit like PNGs are better for photographs. SVG files are a bit like instructions on how
instructions on how to make an image. This means that they can be resized to make an image. This means that they can be resized without looking pixelated
without looking pixelated or blocky. or blocky.
For more information, visit: https://www.w3.org/Graphics/SVG/ For more information, visit: https://www.w3.org/Graphics/SVG/
How to make SVGs How to make SVGs
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -14,18 +14,18 @@ Tools (Drawing)
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right. * Choose a stamp on the right.
* Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the
the bottom right. bottom right.
* Some stamps allow you to choose their color (see "Colors"). * Some stamps allow you to choose their color (see "Colors").
* Change stamp size with the bars 📶 at the bottom right. * Change stamp size with the bars 📶 at the bottom right.
* Rotation ⟳ may be enabled, if desired. * Rotation ⟳ may be enabled, if desired.
* Click/tap in the canvas to place a stamp. * Click/tap in the canvas to place a stamp.
* If rotation is enabled, drag to rotate it, and click/tap again to + If rotation is enabled, drag to rotate it, and click/tap again to add
add it to the drawing. it to the drawing.
* Some stamps play sound effects; press the speaker 🕪 button to hear it * Some stamps play sound effects; press the speaker 🕪 button to hear it
again. again.
* Some stamps play descriptive sounds; press the headphones 🎧 button to * Some stamps play descriptive sounds; press the headphones 🎧 button to hear
hear it again. it again.
⚟Lines ⚟Lines
@ -35,71 +35,68 @@ Tools (Drawing)
⭓Shapes ⭓Shapes
* Choose a shape on the right. * Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a * Select whether you want to extend the shape from the center ⧈, or a corner
corner ◰, using controls at the bottom right. ◰, using controls at the bottom right.
* Click/tap to position, and drag to set the size of the shape. * 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. * Drag to rotate it, and click/tap again to add it to the drawing.
🄰Text 🄰Text
* Choose a font on the right. * Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
controls near the bottom right. near the bottom right.
* Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom
right. right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap the canvas to position an insertion cursor. * Click/tap the canvas to position an insertion cursor.
* Enter text via your keyboard or the on-screen keyboard. * Enter text via your keyboard or the on-screen keyboard.
* Click/tap the canvas again if you wish to reposition the text. * Click/tap the canvas again if you wish to reposition the text.
* Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing * Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing and
and begin entering more text one line down. begin entering more text one line down.
* Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and
continue entering more text immediately to the right. continue entering more text immediately to the right.
* Using the on-screen keyboard: * Using the on-screen keyboard:
* "Cmp" can be used to compose characters, e.g. Cmp ' a results in + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á.
á. + "AltGr" can be used to quickly access more characters.
* "AltGr" can be used to quickly access more characters. + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
* Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs.
"ABC")
🅰Label 🅰Label
* (See Text) * (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them, * Labels float 'above' the drawing; you cannot paint or stamp over them,
apply Magic effects, etc. apply Magic effects, etc.
* Labels may be edited, repositioned, and styled after they've been * Labels may be edited, repositioned, and styled after they've been added to
added to the drawing. the drawing.
* Click/tap the ☝ button near the lower right to choose a label. * Click/tap the ☝ button near the lower right to choose a label. Click/tap
Click/tap the label you wish to modify, then click/tap somewhere else the label you wish to modify, then click/tap somewhere else in the canvas
in the canvas to reposition, or change the font/style, change color, to reposition, or change the font/style, change color, and/or type to edit
and/or type to edit the text. the text.
* Or, use the 🖑 button near the lower right to "flatten" a label, * Or, use the 🖑 button near the lower right to "flatten" a label, applying it
applying it to the canvas; it may no longer be edited with the Label to the canvas; it may no longer be edited with the Label tool.
tool.
🪣Fill 🪣Fill
* Choose a fill mode on the right. * Choose a fill mode on the right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap (and drag, with Brush and Linear modes) to fill an area of * Click/tap (and drag, with Brush and Linear modes) to fill an area of the
the picture with a color. picture with a color.
* Solid - Flood-fills an area with a solid color + Solid - Flood-fills an area with a solid color
* Brush - Paints with a solid color, without drawing outside the + Brush - Paints with a solid color, without drawing outside the chosen
chosen area area
* Linear - Fills the area with a linear gradient (drag to choose + Linear - Fills the area with a linear gradient (drag to choose angle
angle and gradient) and gradient)
* Radial - Fills the area with a radial gradient, centered where + Radial - Fills the area with a radial gradient, centered where you
you clicked/tapped clicked/tapped
* Shaped - Fills the area with a gradient that follows the contours + Shaped - Fills the area with a gradient that follows the contours of
of the area being filled the area being filled
🪄Magic 🪄Magic
* Choose a magic tool on the right. * Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Some magic tools draw or apply effects via click/tap and drag 〰🪄, some * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some
affect the entire drawing 🖻🪄, and some offer both options; use the affect the entire drawing 🖻🪄, and some offer both options; use the controls
controls at the bottom right. at the bottom right.
* Some magic tools offer various sizes; change it with the bars 📶 at the * Some magic tools offer various sizes; change it with the bars 📶 at the
bottom right. bottom right.
* Some magic tools allow you to choose their color. * Some magic tools allow you to choose their color.
@ -117,8 +114,8 @@ Tools (Drawing)
◪Eraser ◪Eraser
* Choose the size and shape of the eraser on the right. * Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or * Click/tap and drag to erase parts of the picture (solid color, or starter
starter or template image). or template image).
* Shortcut: [X] and click/tap in the drawing (not always available) * Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls) Tools (Controls)
@ -126,11 +123,10 @@ Tools (Controls)
🗏New 🗏New
* Choose a solid color, starter, or template image to start with. * Choose a solid color, starter, or template image to start with.
* Starters allow drawing "under" a picture (e.g., a coloring book + Starters allow drawing "under" a picture (e.g., a coloring book
outline), sometimes with a background layer, too. outline), sometimes with a background layer, too.
* Templates are pictures to start with (background only). + Templates are pictures to start with (background only).
* Eraser tool ◪ reveals the solid color, or starter/template + Eraser tool ◪ reveals the solid color, or starter/template background.
background.
* Click/tap "🕮⮫Open" to begin a new drawing. * Click/tap "🕮⮫Open" to begin a new drawing.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Ctrl]+[N] * Shortcut: [Ctrl]+[N]
@ -141,32 +137,31 @@ Tools (Controls)
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
* Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures"
folder. folder.
* Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin.
Bin.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Click/tap "📽Slides" to switch to slideshow mode: * Click/tap "📽Slides" to switch to slideshow mode:
* Click/tap two or more of your previously-saved drawings, in the + Click/tap two or more of your previously-saved drawings, in the order
order you want them shown. Numbers will appear on them. you want them shown. Numbers will appear on them.
* Choose the playback speed using the bars 📶 near the lower left. + Choose the playback speed using the bars 📶 near the lower left.
* Click/tap "⯈Play" to watch the slideshow/animation. + Click/tap "⯈Play" to watch the slideshow/animation.
* Or, click/tap "🎞GIF Export" to save an animated GIF of the + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to
animation to your system's "Pictures" folder. your system's "Pictures" folder.
* Click/tap "⤺Back" to return to the Open dialog. + Click/tap "⤺Back" to return to the Open dialog.
* Shortcut: [Ctrl]+[O] * Shortcut: [Ctrl]+[O]
🕮⮪Save 🕮⮪Save
* Click/tap to save your drawing. * Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite * If you've saved previously, you'll be prompted whether to overwrite the
the previously-saved drawing (a la "File→Save") or create a new saved previously-saved drawing (a la "File→Save") or create a new saved drawing
drawing (a la "File→Save As...") (a la "File→Save As...")
* Shortcut: [Ctrl]+[S] * Shortcut: [Ctrl]+[S]
🖶Print 🖶Print
* Click/tap to print your drawing. * Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
dialog, if available. if available.
* Shortcut: [Ctrl]+[P] * Shortcut: [Ctrl]+[P]
🗙Quit 🗙Quit
@ -176,28 +171,27 @@ Tools (Controls)
Colors Colors
* Click/tap to choose a color to use with the Paint, Lines, and Shapes * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
tools, and Stamps and Magic tools that support colors. and Stamps and Magic tools that support colors.
* Use the pipette / color picker 💉 button to choose a color from a pixel * Use the pipette / color picker 💉 button to choose a color from a pixel in
in your current drawing. your current drawing.
* Shortcut: When colors are available, press [Ctrl] and click/tap + Shortcut: When colors are available, press [Ctrl] and click/tap in your
in your drawing, to quickly pick a color from your drawing. drawing, to quickly pick a color from your drawing.
* Click/tap the rainbow 🌈 button to choose a arbitrary color. * Click/tap the rainbow 🌈 button to choose a arbitrary color.
* Click/tap in the rainbow square to pick a color (hue and + Click/tap in the rainbow square to pick a color (hue and saturation).
saturation). + Click/tap in the grey gradient bar to adjust brightness (value).
* Click/tap in the grey gradient bar to adjust brightness (value). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Click/tap "⤺Back" to abort and dismiss the palette.
* Click/tap "⤺Back" to abort and dismiss the palette. + You may grab the currently-chosen built-in color (if any), the color in
* You may grab the currently-chosen built-in color (if any), the the pipette / color picker, or the color in the color mixer, by
color in the pipette / color picker, or the color in the color clicking one of the colored arrow ⇫ buttons.
mixer, by clicking one of the colored arrow ⇫ buttons. * Click/tap the paint palette 🎨 button to create a color by mixing primary
* Click/tap the paint palette 🎨 button to create a color by mixing colors: red, yellow, and blue, and white (tint), grey (tone), and black
primary colors: red, yellow, and blue, and white (tint), grey (tone), (shade).
and black (shade). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Color mixing offers its own 🖓Undo and 🖒Redo options.
* Color mixing offers its own 🖓Undo and 🖒Redo options. + Click/tap "🗑Clear" to start over with no mixed colors.
* Click/tap "🗑Clear" to start over with no mixed colors. + Click/tap "⤺Back" to abort and dismiss the color mixer.
* Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing: Shortcuts while drawing:
@ -213,3 +207,4 @@ Shortcuts while drawing:
* [Esc] - ⤺Back or 🗙Quit * [Esc] - ⤺Back or 🗙Quit
Last updated: May 9, 2023 Last updated: May 9, 2023

View file

@ -6,8 +6,7 @@
junio 4, 2022 junio 4, 2022
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+----------------------------------------+ +----------------------------------------+
| Table of Contents | | Table of Contents |
|----------------------------------------| |----------------------------------------|
@ -17,26 +16,22 @@
| * Replace the fringe and junk pixels | | * Replace the fringe and junk pixels |
| * Save the image for Tux Paint | | * Save the image for Tux Paint |
+----------------------------------------+ +----------------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
About this 'How-To' About this 'How-To'
This 'How-To' assumes that you want to make an excellent Tux Paint This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
photograph). There are easier and faster methods that produce lower There are easier and faster methods that produce lower quality.
quality.
This 'How-To' assumes you are dealing with normal opaque objects. This 'How-To' assumes you are dealing with normal opaque objects. Dealing
Dealing with semi-transparent objects (fire, moving fan blade, kid's with semi-transparent objects (fire, moving fan blade, kid's balloon) or
balloon) or light-giving objects (fire, lightbulb, sun) is best done light-giving objects (fire, lightbulb, sun) is best done with custom
with custom software. Images with perfect solid-color backgrounds are software. Images with perfect solid-color backgrounds are also best done
also best done with custom software, but are not troublesome to do as with custom software, but are not troublesome to do as follows.
follows.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Image choice is crucial Image choice is crucial
@ -44,9 +39,9 @@ Image choice is crucial
If you wish to submit artwork to the Tux Paint developers for If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to consideration for inclusion in the official project, or if you wish to
release your own copy of Tux Paint, bundled with your own graphics, release your own copy of Tux Paint, bundled with your own graphics, you
you need an image that is compatible with the GNU General Public need an image that is compatible with the GNU General Public License
License used by Tux Paint. used by Tux Paint.
Images produced by the US government are Public Domain, but be aware Images produced by the US government are Public Domain, but be aware
that the US government sometimes uses other images on the web. Google that the US government sometimes uses other images on the web. Google
@ -71,10 +66,10 @@ Image choice is crucial
Rotating an image can make it blurry, especially if you only rotate by Rotating an image can make it blurry, especially if you only rotate by
a few degrees. Images that don't need rotation are best, images that a few degrees. Images that don't need rotation are best, images that
need lots of rotation (30 to 60 degrees) are next best, and images need lots of rotation (30 to 60 degrees) are next best, and images that
that need just a few degrees are worst. Rotation will also make an need just a few degrees are worst. Rotation will also make an image
image darker because most image editing software is very bad about darker because most image editing software is very bad about gamma
gamma handling. (Rotation is only legitimate for gamma=1.0 images.) handling. (Rotation is only legitimate for gamma=1.0 images.)
Very large images are more forgiving of mistakes, and thus easier to Very large images are more forgiving of mistakes, and thus easier to
work with. Choose an image with an object that is over 1000 pixels work with. Choose an image with an object that is over 1000 pixels
@ -83,31 +78,31 @@ Image choice is crucial
Be sure that the image is not too grainy, dim, or washed out. Be sure that the image is not too grainy, dim, or washed out.
Pay attention to feet and wheels. If they are buried in something, you Pay attention to feet and wheels. If they are buried in something, you
will need to draw new ones. If only one is buried, you might be able will need to draw new ones. If only one is buried, you might be able to
to copy the other one as a replacement. copy the other one as a replacement.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the image Prepare the image
First of all, be sure to avoid re-saving the image as a JPEG. This First of all, be sure to avoid re-saving the image as a JPEG. This causes
causes quality loss. There is a special tool called jpegtran that lets quality loss. There is a special tool called jpegtran that lets you crop an
you crop an image without the normal quality loss. image without the normal quality loss.
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
Bring that image up in your image editor. If you didn't crop it yet, you Bring that image up in your image editor. If you didn't crop it yet, you
may find that your image editor is very slow. Rotate and crop the image may find that your image editor is very slow. Rotate and crop the image as
as needed. Save the image — choose whatever native format supports needed. Save the image — choose whatever native format supports layers,
layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop
Photoshop users should choose "PSD", for example. users should choose "PSD", for example.
If you have rotated or cropped the image in your image editor, flatten If you have rotated or cropped the image in your image editor, flatten it
it now. You need to have just one RGB layer without mask or alpha. now. You need to have just one RGB layer without mask or alpha.
Open the layers dialog box. Replicate the one layer several times. From Open the layers dialog box. Replicate the one layer several times. From top
top to bottom you will need something like this: to bottom you will need something like this:
1. unmodified image (write-protect this if you can) 1. unmodified image (write-protect this if you can)
2. an image you will modify — the "work in progress" layer 2. an image you will modify — the "work in progress" layer
@ -115,152 +110,147 @@ Prepare the image
4. solid magenta (write-protect this if you can) 4. solid magenta (write-protect this if you can)
5. unmodified image (write-protect this if you can) 5. unmodified image (write-protect this if you can)
Give the work in progress (WIP) layer a rough initial mask. You might Give the work in progress (WIP) layer a rough initial mask. You might start
start with a selection, or by using the grayscale value of the WIP with a selection, or by using the grayscale value of the WIP layer. You
layer. You might invert the mask. might invert the mask.
Warning: once you have the mask, you may not rotate or scale the image Warning: once you have the mask, you may not rotate or scale the image
normally. This would cause data loss. You will be given special scaling normally. This would cause data loss. You will be given special scaling
instructions later. instructions later.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the mask Prepare the mask
Get used to doing [Control]-click and [Alt]-click on the thumbnail Get used to doing [Control]-click and [Alt]-click on the thumbnail images
images in the layers dialog. You will need this to control what you are in the layers dialog. You will need this to control what you are looking at
looking at and what you are editing. Sometimes you will be editing and what you are editing. Sometimes you will be editing things you can't
things you can't see. For example, you might edit the mask of the WIP see. For example, you might edit the mask of the WIP layer while looking at
layer while looking at the unmodified image. Pay attention so you don't the unmodified image. Pay attention so you don't screw up. Always verify
screw up. Always verify that you are editing the right thing. that you are editing the right thing.
Set an unmodified image as what you will view (the top one is easiest). Set an unmodified image as what you will view (the top one is easiest). Set
Set the WIP mask as what you will edit. At some point, perhaps not the WIP mask as what you will edit. At some point, perhaps not immediately,
immediately, you should magnify the image to about 400% (each pixel of you should magnify the image to about 400% (each pixel of the image is seen
the image is seen and edited as a 4x4 block of pixels on your screen). and edited as a 4x4 block of pixels on your screen).
Select parts of the image that need to be 100% opaque or 0% opaque. If Select parts of the image that need to be 100% opaque or 0% opaque. If you
you can select the object or background somewhat accurately by color, do can select the object or background somewhat accurately by color, do so. As
so. As needed to avoid selecting any pixels that should be partially needed to avoid selecting any pixels that should be partially opaque
opaque (generally at the edge of the object) you should grow, shrink, (generally at the edge of the object) you should grow, shrink, and invert
and invert the selection. the selection.
Fill the 100% opaque areas with white, and the 0% opaque areas with Fill the 100% opaque areas with white, and the 0% opaque areas with black.
black. This is most easily done by drag-and-drop from the This is most easily done by drag-and-drop from the foreground/background
foreground/background color indicator. You should not see anything color indicator. You should not see anything happen, because you are
happen, because you are viewing the unmodified image layer while editing viewing the unmodified image layer while editing the mask of the WIP layer.
the mask of the WIP layer. Large changes might be noticable in the Large changes might be noticable in the thumbnail.
thumbnail.
Now you must be zoomed in. Now you must be zoomed in.
Check your work. Hide the top unmodified image layer. Display just the Check your work. Hide the top unmodified image layer. Display just the
mask, which should be a white object on a black background (probably mask, which should be a white object on a black background (probably with
with unedited grey at the edge). Now display the WIP layer normally, so unedited grey at the edge). Now display the WIP layer normally, so that the
that the mask is active. This should show your object over top of the mask is active. This should show your object over top of the next highest
next highest enabled layer, which should be green or magenta as needed enabled layer, which should be green or magenta as needed for maximum
for maximum contrast. You might wish to flip back and forth between contrast. You might wish to flip back and forth between those backgrounds
those backgrounds by repeatedly clicking to enable/disable the green by repeatedly clicking to enable/disable the green layer. Fix any obvious
layer. Fix any obvious and easy problems by editing the mask while and easy problems by editing the mask while viewing the mask.
viewing the mask.
Go back to viewing the top unmodified layer while editing the WIP mask. Go back to viewing the top unmodified layer while editing the WIP mask. Set
Set your drawing tool the paintbrush. For the brush, choose a small your drawing tool the paintbrush. For the brush, choose a small fuzzy
fuzzy circle. The 5x5 size is good for most uses. circle. The 5x5 size is good for most uses.
With a steady hand, trace around the image. Use black around the With a steady hand, trace around the image. Use black around the outside,
outside, and white around the inside. Avoid making more than one pass and white around the inside. Avoid making more than one pass without
without switching colors (and thus sides). switching colors (and thus sides).
Flip views a bit, checking to see that the mask is working well. When Flip views a bit, checking to see that the mask is working well. When the
the WIP layer is composited over the green or magenta, you should see a WIP layer is composited over the green or magenta, you should see a tiny
tiny bit of the original background as an ugly fringe around the edge. bit of the original background as an ugly fringe around the edge. If this
If this fringe is missing, then you made the object mask too small. The fringe is missing, then you made the object mask too small. The fringe
fringe consists of pixels that are neither 100% object nor 0% object. consists of pixels that are neither 100% object nor 0% object. For them,
For them, the mask should be neither 100% nor 0%. The fringe gets the mask should be neither 100% nor 0%. The fringe gets removed soon.
removed soon.
View and edit the mask. Select by color, choosing either black or white. View and edit the mask. Select by color, choosing either black or white.
Most likely you will see unselected specks that are not quite the Most likely you will see unselected specks that are not quite the expected
expected color. Invert the selection, then paint these away using the color. Invert the selection, then paint these away using the pencil tool.
pencil tool. Do this operation for both white and black. Do this operation for both white and black.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Replace the fringe and junk pixels Replace the fringe and junk pixels
Still viewing the mask, select by color. Choose black. Shrink the Still viewing the mask, select by color. Choose black. Shrink the selection
selection by several pixels, being sure to NOT shrink from the edges of by several pixels, being sure to NOT shrink from the edges of the mask (the
the mask (the shrink helps you avoid and recover from mistakes). shrink helps you avoid and recover from mistakes).
Now disable the mask. View and edit the unmasked WIP layer. Using the Now disable the mask. View and edit the unmasked WIP layer. Using the color
color picker tool, choose a color that is average for the object. picker tool, choose a color that is average for the object. Drag-and-drop
Drag-and-drop this color into the selection, thus removing most of the this color into the selection, thus removing most of the non-object pixels.
non-object pixels.
This solid color will compress well and will help prevent ugly color This solid color will compress well and will help prevent ugly color
fringes when Tux Paint scales the image down. If the edge of the object fringes when Tux Paint scales the image down. If the edge of the object has
has multiple colors that are very different, you should split up your multiple colors that are very different, you should split up your selection
selection so that you can color the nearby background to be similar. so that you can color the nearby background to be similar.
Now you will paint away the existing edge fringe. Be sure that you are Now you will paint away the existing edge fringe. Be sure that you are
editing and viewing the WIP image. Frequent layer visibility changes editing and viewing the WIP image. Frequent layer visibility changes will
will help you to see what you are doing. You are likely to use all of: help you to see what you are doing. You are likely to use all of:
* composited over green (mask enabled) + composited over green (mask enabled)
* composited over magenta (mask enabled) + composited over magenta (mask enabled)
* original (the top or bottom layer) + original (the top or bottom layer)
* composited over the original (mask enabled) + composited over the original (mask enabled)
* raw WIP layer (mask disabled) + raw WIP layer (mask disabled)
To reduce accidents, you may wish to select only those pixels that are To reduce accidents, you may wish to select only those pixels that are not
not grey in the mask. (Select by color from the mask, choose black, add grey in the mask. (Select by color from the mask, choose black, add mode,
mode, choose white, invert. Alternately: Select all, select by color choose white, invert. Alternately: Select all, select by color from the
from the mask, subtract mode, choose black, choose white.) If you do mask, subtract mode, choose black, choose white.) If you do this, you'll
this, you'll probably want to expand the selection a bit and/or hide the probably want to expand the selection a bit and/or hide the "crawling ants"
"crawling ants" line that marks the selection. line that marks the selection.
Use the clone tool and the brush tool. Vary the opacity as needed. Use Use the clone tool and the brush tool. Vary the opacity as needed. Use
small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is
generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy
brushes with about 70% opacity.) Unusual drawing modes can be helpful brushes with about 70% opacity.) Unusual drawing modes can be helpful with
with semi-transparent objects. semi-transparent objects.
The goal is to remove the edge fringe, both inside and outside of the The goal is to remove the edge fringe, both inside and outside of the
object. The inside fringe, visible when the object is composited over object. The inside fringe, visible when the object is composited over
magenta or green, must be removed for obvious reasons. The outside magenta or green, must be removed for obvious reasons. The outside fringe
fringe must also be removed because it will become visible when the must also be removed because it will become visible when the image is
image is scaled down. As an example, consider a 2x2 region of pixels at scaled down. As an example, consider a 2x2 region of pixels at the edge of
the edge of a sharp-edged object. The left half is black and 0% opaque. a sharp-edged object. The left half is black and 0% opaque. The right half
The right half is white and 100% opaque. That is, we have a white object is white and 100% opaque. That is, we have a white object on a black
on a black background. When Tux Paint scales this to 50% (a 1x1 pixel background. When Tux Paint scales this to 50% (a 1x1 pixel area), the
area), the result will be a grey 50% opaque pixel. The correct result result will be a grey 50% opaque pixel. The correct result would be a white
would be a white 50% opaque pixel. To get this result, we would paint 50% opaque pixel. To get this result, we would paint away the black pixels.
away the black pixels. They matter, despite being 0% opaque. They matter, despite being 0% opaque.
Tux Paint can scale images down by a very large factor, so it is Tux Paint can scale images down by a very large factor, so it is important
important to extend the edge of your object outward by a great deal. to extend the edge of your object outward by a great deal. Right at the
Right at the edge of your object, you should be very accurate about edge of your object, you should be very accurate about this. As you go
this. As you go outward away from the object, you can get a bit sloppy. outward away from the object, you can get a bit sloppy. It is reasonable to
It is reasonable to paint outward by a dozen pixels or more. The farther paint outward by a dozen pixels or more. The farther you go, the more Tux
you go, the more Tux Paint can scale down without creating ugly color Paint can scale down without creating ugly color fringes. For areas that
fringes. For areas that are more than a few pixels away from the object are more than a few pixels away from the object edge, you should use the
edge, you should use the pencil tool (or sloppy select with pencil tool (or sloppy select with drag-and-drop color) to ensure that the
drag-and-drop color) to ensure that the result will compress well. result will compress well.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
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 It is very easy to ruin your hard work. Image editors can silently destroy
destroy pixels in 0% opaque areas. The conditions under which this pixels in 0% opaque areas. The conditions under which this happens may vary
happens may vary from version to version. If you are very trusting, you from version to version. If you are very trusting, you can try saving your
can try saving your image directly as a PNG. Be sure to read it back in image directly as a PNG. Be sure to read it back in again to verify that
again to verify that the 0% opaque areas didn't turn black or white, the 0% opaque areas didn't turn black or white, which would create fringes
which would create fringes when Tux Paint scales the image down. If you when Tux Paint scales the image down. If you need to scale your image to
need to scale your image to save space (and hide your mistakes), you are save space (and hide your mistakes), you are almost certain to destroy all
almost certain to destroy all the 0% opaque areas. So here is a better the 0% opaque areas. So here is a better way...
way...
A Safer Way to Save A Safer Way to Save
@ -271,17 +261,17 @@ Save the image for Tux Paint
with an image that is about 700 to 1500 pixels across, and end up with with an image that is about 700 to 1500 pixels across, and end up with
one that is 300 to 400. one that is 300 to 400.
Save the mask image as a NetPBM portable greymap (".pgm") file. (If Save the mask image as a NetPBM portable greymap (".pgm") file. (If you
you are using an old release of The GIMP, you might need to convert are using an old release of The GIMP, you might need to convert the
the image to greyscale before you can save it.) Choose the more image to greyscale before you can save it.) Choose the more compact
compact "RAW PGM" format. (The second character of the file should be "RAW PGM" format. (The second character of the file should be the ASCII
the ASCII digit "5", hex byte 0x35.) digit "5", hex byte 0x35.)
You may close the mask image. You may close the mask image.
Going back to the multi-layer image, now select the WIP layer. As you Going back to the multi-layer image, now select the WIP layer. As you
did with the mask, drag this from the layers dialog to the toolbar. did with the mask, drag this from the layers dialog to the toolbar. You
You should get a single-layer image of your WIP data. If the mask came should get a single-layer image of your WIP data. If the mask came
along too, get rid of it. You should be seeing the object and the along too, get rid of it. You should be seeing the object and the
painted-away surroundings, without any mask thumbnail in the layers painted-away surroundings, without any mask thumbnail in the layers
dialog. If you scaled the mask, then scale this image in exactly the dialog. If you scaled the mask, then scale this image in exactly the
@ -289,8 +279,9 @@ Save the image for Tux Paint
(Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second (Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second
byte of the file should be the ASCII digit "6", hex byte 0x36.) byte of the file should be the ASCII digit "6", hex byte 0x36.)
Now you need to merge the two files into one. Do that with the Now you need to merge the two files into one. Do that with the pnmtopng
pnmtopng command, like this: command, like this:
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,91 +7,97 @@
mayo 5, 2023 mayo 5, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, Tux Paint understands a number of environment variables, either directly, or
or indirectly by the libraries that it utilizes. 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 Specifies the user's "home directory", which is used to locate numerous
numerous other files or directories. In some cases, it is utilized other files or directories. In some cases, it is utilized as part of a
as part of a fall-back location, when other environment variables fall-back location, when other environment variables (elsewhere in this
(elsewhere in this documentation) are not set. Sometimes, the documentation) are not set. Sometimes, the location to use can be
location to use can be overridden by options provided on the overridden by options provided on the command-line or via Tux Paint's
command-line or via Tux Paint's configuration file. See the configuration file. See the "OPTIONS" documentation for details.
"OPTIONS" documentation for details.
A few examples of where "$HOME" is used include: A few examples of where "$HOME" is used include:
* The location of Tux Paint's configuration file + The location of Tux Paint's configuration file
* The basis of where Tux Paint saves and loads users' drawings + The basis of where Tux Paint saves and loads users' drawings
* The location of a user's private collection of data files — + The location of a user's private collection of data files — stamps,
stamps, brushes, etc. — (versus those available system wide) brushes, etc. — (versus those available system wide)
XDG_CONFIG_HOME XDG_CONFIG_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's configuration files. the location of the user's configuration files. Specifically, where to find
Specifically, where to find "user-dirs.dirs", where the "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used
"XDG_PICTURES_DIR" might be defined. It is used for exporting for exporting drawings and animated GIFs. Generally it's set to something
drawings and animated GIFs. Generally it's set to something like like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory
"$HOME/Pictures/". If not specified, Tux Paint checks in the "$HOME/.config/". If the configuration cannot be found, Tux Paint simply
directory "$HOME/.config/". If the configuration cannot be found, exports drawings and GIFs to "$HOME".
Tux Paint simply exports drawings and GIFs to "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's data directories. the location of the user's data directories. Specifically, where to find
Specifically, where to find the "Trash" directory. It is used when the "Trash" directory. It is used when deleting images from Tux Paint's
deleting images from Tux Paint's "Open" dialog. If not set, the "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is
location "$HOME/.local/share/Trash/" is used, if available. If used, if available. If not, images are simply deleted, rather than moved
not, images are simply deleted, rather than moved anywhere. anywhere.
TEMP TEMP
Specifies the location where temporary files may be created. Only Specifies the location where temporary files may be created. Only used by
used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
not set.
Language-related environment variables Language-related environment variables
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Specify the language Tux Paint should utilize in its user Specify the language Tux Paint should utilize in its user interface.
interface. Overridde by the "--lang" and "--locale" command-line Overridde by the "--lang" and "--locale" command-line options or their
options or their configuration file counterparts. The "LANGUAGE" configuration file counterparts. The "LANGUAGE" environment variable is
environment variable is used, if set. If not, "LC_ALL" is used as used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES",
a fallback. Then "LC_MESSAGES", and finally "LANG". and finally "LANG".
Display-related environment variables Display-related environment variables
The following are a few of the environment variables supported by Simple The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
graphics, playing sounds, and receiving mouse, keyboard, and joystick playing sounds, and receiving mouse, keyboard, and joystick input — and which
input — and which may be useful to users of Tux Paint. 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 Specifies whether Tux Paint should allow a screensaver to run. Can be set
be set to '1' (true) by Tux Paint itself by issuing the to '1' (true) by Tux Paint itself by issuing the command-line option
command-line option "--allowscreensaver" or its configuration file "--allowscreensaver" or its configuration file counterpart.
counterpart.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

View file

@ -6,8 +6,7 @@
julio 13, 2023 julio 13, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+------------------------------+ +------------------------------+
| Table of Contents | | Table of Contents |
|------------------------------| |------------------------------|
@ -20,549 +19,549 @@
| * Other Problems | | * Other Problems |
| * Help / Contact | | * Help / Contact |
+------------------------------+ +------------------------------+
-------------------------------------------------------------------------------
----------------------------------------------------------------------
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 The TrueType Font you're using might have the wrong encoding. If it's
it's 'custom' encoded, for example, you can try running it through 'custom' encoded, for example, you can try running it through FontForge (
FontForge (http://fontforge.sourceforge.net/) to convert it to an http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
ISO-8859 format. (Email us if you need help with special fonts.) (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, This means that Tux Paint either couldn't find any stamp images, or was
or was asked not to load them. asked not to load them.
If you installed Tux Paint, but did not install the separate, If you installed Tux Paint, but did not install the separate, optional
optional "Stamps" collection, quit Tux Paint and install it now. "Stamps" collection, quit Tux Paint and install it now. It should be
It should be available from the same place you got the main Tux available from the same place you got the main Tux Paint program. (Note: As
Paint program. (Note: As of version 0.9.14, Tux Paint comes with a of version 0.9.14, Tux Paint comes with a small collection of example
small collection of example stamps.) stamps.)
If you don't want to install the default collection of stamps, you If you don't want to install the default collection of stamps, you can just
can just create your own. See the "Extending Tux Paint" create your own. See the "Extending Tux Paint" documentation for more on
documentation for more on creating PNG and SVG image files, TXT creating PNG and SVG image files, TXT text description files, Ogg Vorbis,
text description files, Ogg Vorbis, MP3 or WAV sound files, and MP3 or WAV sound files, and DAT text data files that make up stamps.
DAT text data files that make up stamps.
Finally, if you installed stamps, and think they should be loading, check
to see that the "nostamps" option isn't being set. (Either via a
"--nostamps" option to Tux Paint's command line, or "nostamps=yes" in the
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.
Finally, if you installed stamps, and think they should be
loading, check to see that the "nostamps" option isn't being set.
(Either via a "--nostamps" option to Tux Paint's command line, or
"nostamps=yes" in the 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.
Stamp outlines are always rectangles Stamp outlines are always rectangles
Tux Paint was built with low-quality (but faster) stamp outlines. Tux Paint was built with low-quality (but faster) stamp outlines.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_STAMP_OUTLINE #define LOW_QUALITY_STAMP_OUTLINE
in the "tuxpaint.c" file in the "src" directory. 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 Tux Paint was probably compiled with the faster, lower quality thumbnail
thumbnail code enabled. Run the command: "tuxpaint code enabled. Run the command: "tuxpaint --verbose-version" from a command
--verbose-version" from a command line. If, amongst the other line. If, amongst the other output, you see the text: "Low Quality
output, you see the text: "Low Quality Thumbnails enabled", then Thumbnails enabled", then this is what's happening.
this is what's happening.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_THUMBNAILS #define LOW_QUALITY_THUMBNAILS
in the "tuxpaint.c" file in the "src" directory. 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 "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
thumbnails in the Stamp Selector look bad", above. Stamp Selector look bad", above.
All of the text is in uppercase! All of the text is in uppercase!
The "uppercase" option is on. The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override Either change/remove the "uppercase" option, or you can override it with
it with "--mixedcase" on the command line or either "uppercase=no" "--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
or "mixedcase=yes" in a configuration file. 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 Make sure your locale setting is correct. See "Tux Paint won't switch to my
switch to my language", below. 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 + Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your Make sure the locale you want is available. Check your "/etc/
"/etc/locale.gen" file. See the "Options Documentation" for locale.gen" file. See the "Options Documentation" for the locales Tux
the locales Tux Paint uses (especially when using the Paint uses (especially when using the "--lang" option).
"--lang" option).
Note: Debian and derivative (e.g., Ubuntu) users can simply Note: Debian and derivative (e.g., Ubuntu) users can simply run
run "dpkg-reconfigure locales" if the locales are managed by "dpkg-reconfigure locales" if the locales are managed by "dpkg".
"dpkg".
* If you're using the "--lang" command-line option + If you're using the "--lang" command-line option
Try using the "--locale" command-line option, or your Try using the "--locale" command-line option, or your operating
operating system's locale settings (e.g., the "$LANG" system's locale settings (e.g., the "$LANG" environment variable), and
environment variable), and please e-mail us regarding your please e-mail us regarding your trouble.
trouble.
* If you're using the "--locale" command-line option + If you're using the "--locale" command-line option
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* If you're trying to use your Operating System's locale + If you're trying to use your Operating System's locale
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* Make sure you have the necessary font + Make sure you have the necessary font
Some translations require their own font. Chinese and Korean, Some translations require their own font. Chinese and Korean, for
for example, need Chinese and Korean TrueType Fonts installed example, need Chinese and Korean TrueType Fonts installed and placed in
and placed in the proper location, respectively. the proper location, respectively.
The appropriate fonts for such locales can be downloaded from The appropriate fonts for such locales can be downloaded from the Tux
the Tux Paint website: Paint website:
https://tuxpaint.org/download/fonts/ 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 Tux Paint prints by creating a PostScript rendition of the picture and
and sending it to an external command. By default, this command is sending it to an external command. By default, this command is the "lpr"
the "lpr" printing tool. printing tool.
If that program is not available (for example, you're using CUPS, If that program is not available (for example, you're using CUPS, the
the Common Unix Printing System, and do not have "cups-lpr" Common Unix Printing System, and do not have "cups-lpr" installed), you
installed), you will need to specify an appropriate command using will need to specify an appropriate command using the "printcommand" option
the "printcommand" option in Tux Paint's configuration file. (See 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.
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.
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.
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 The "print delay" option is on. You can only print once every X seconds.
seconds.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--printdelay=..." option. giving it a "--printdelay=..." option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--printdelay=..." is listed as a properties of the icon to see if "--printdelay=..." is listed as a
command-line argument. command-line argument.
If a "--printdelay=..." option isn't being sent on the command If a "--printdelay=..." option isn't being sent on the command line, check
line, check Tux Paint's configuration file for a line reading: Tux Paint's configuration file for a line reading: "printdelay=...".
"printdelay=...".
Either remove that line, set the delay value to 0 (no delay), or Either remove that line, set the delay value to 0 (no delay), or decrease
decrease the delay to a value you prefer. (See the "Options the delay to a value you prefer. (See the "Options Documentation".)
Documentation".)
Or, you can simply run Tux Paint with the command-line argument: Or, you can simply run Tux Paint with the command-line argument:
"--printdelay=0", which will override the configuration file's "--printdelay=0", which will override the configuration file's setting, and
setting, and allow unlimited printing. (You won't have to wait allow unlimited printing. (You won't have to wait between prints.)
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. The "no print" option is on.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noprint" option. giving it a "--noprint" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noprint" is listed as a properties of the icon to see if "--noprint" is listed as a command-line
command-line argument. argument.
If a "--noprint" option isn't being sent on the command line, If a "--noprint" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "noprint=yes".
"noprint=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--print", which will override the argument: "--print", which will override the configuration file's setting.
configuration file's setting.
Or use Tux Paint Config. and make sure "Allow Printing" (under Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing")
"Printing") is checked. 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 Unless you asked Tux Paint to save into a specific location (using the
the "savedir" option), Tux Paint saves into a standard location on "savedir" option), Tux Paint saves into a standard location on your local
your local drive: drive:
Windows Vista, Windows 8, Windows 10, Windows 11 Windows Vista, Windows 8, Windows 10, Windows 11
In the user's "AppData" folder: In the user's "AppData" folder:
e.g., e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved
C:\Users\Username\AppData\Roaming\TuxPaint\saved
macOS macOS
In the user's "Application Support" folder: In the user's "Application Support" folder:
e.g., /Users/Username/Library/Applicaton e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/
Support/TuxPaint/saved/
Linux / Unix Linux / Unix
In the user's home directory ("$HOME"), under a In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder:
".tuxpaint" subfolder:
e.g., /home/username/.tuxpaint/saved/ 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 The images are stored as PNG bitmaps, which most modern programs should be
browsers, etc.) 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 The "save over" option is enabled. (This disables the prompt that would
would appear when you click 'Save.') appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveover" option. giving it a "--saveover" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveover" is listed as a properties of the icon to see if "--saveover" is listed as a command-line
command-line argument. argument.
If a "--saveover" option isn't being sent on the command line, If a "--saveover" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=yes".
"saveover=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves a new picture!", below. 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 The "never save over" option is enabled. (This disables the prompt that
that would appear when you click 'Save.') would appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveovernew" option. giving it a "--saveovernew" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveovernew" is listed as a properties of the icon to see if "--saveovernew" is listed as a
command-line argument. command-line argument.
If a "--saveovernew" option isn't being sent on the command line, If a "--saveovernew" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=new".
"saveover=new".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves over my old picture!", above. 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: + First, check the obvious:
* Are your speakers connected and turned on? o Are your speakers connected and turned on?
* Is the volume turned up on your speakers? o Is the volume turned up on your speakers?
* Is the volume turned up in your Operating System's o Is the volume turned up in your Operating System's "mixer?"
"mixer?" o Are you certain you're using a computer with a sound card?
* Are you certain you're using a computer with a sound o Are any other programs running that use sound? (They may be
card? 'blocking' Tux Paint from accessing your sound device)
* Are any other programs running that use sound? (They may o (Unix/Linux) Are you using a sound system, such as aRts, ESD or
be 'blocking' Tux Paint from accessing your sound GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment
device) variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER=
* (Unix/Linux) Are you using a sound system, such as aRts, arts"). Or, run Tux Paint through the system's rerouter (e.g., run
ESD or GStreamer? If so, try setting the "artsdsp tuxpaint" or "esddsp tuxpaint", instead of simply
"SDL_AUDIODRIVER" environment variable before running "tuxpaint").
Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run + Is sound disabled in Tux Paint?
Tux Paint through the system's rerouter (e.g., run
"artsdsp tuxpaint" or "esddsp tuxpaint", instead of
simply "tuxpaint").
* Is sound disabled in Tux Paint?
If sound seems to work otherwise (and you're sure no other If sound seems to work otherwise (and you're sure no other program is
program is "blocking" the sound device), then Tux Paint may "blocking" the sound device), then Tux Paint may be running with a "no
be running with a "no sound" option. sound" option.
If you're running Tux Paint from a command-line, make sure If you're running Tux Paint from a command-line, make sure you're not
you're not giving it a "--nosound" option. giving it a "--nosound" option.
If you're running Tux Paint by double-clicking an icon, check If you're running Tux Paint by double-clicking an icon, check the
the properties of the icon to see if "--nosound" is listed as properties of the icon to see if "--nosound" is listed as a
a command-line argument. command-line argument.
If a "--nosound" option isn't being sent on the command line, If a "--nosound" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "nosound=yes".
"nosound=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--sound", which will override the argument: "--sound", which will override the configuration file's
configuration file's setting. setting.
Or, you can simply run Tux Paint with the command-line Or, you can simply run Tux Paint with the command-line argument:
argument: "Enable Sound Effects", which will override the "Enable Sound Effects", which will override the configuration file's
configuration file's setting, and allow unlimited printing. setting, and allow unlimited printing. (You won't have to wait between
(You won't have to wait between prints.) prints.)
* Were sounds temporarily disabled? + Were sounds temporarily disabled?
Even if sounds are enabled in Tux Paint, it is possible to Even if sounds are enabled in Tux Paint, it is possible to disable and
disable and re-enable them temporarily using the [Alt] + [S] re-enable them temporarily using the [Alt] + [S] key sequence. Try
key sequence. Try pressing those keys to see if sounds begin pressing those keys to see if sounds begin working again.
working again.
* Was Tux Paint built without sound support? + Was Tux Paint built without sound support?
Tux Paint may have been compiled with sound support disabled. Tux Paint may have been compiled with sound support disabled. To test
To test whether sound support was enabled when Tux Paint was whether sound support was enabled when Tux Paint was compiled, run Tux
compiled, run Tux Paint from a command line, like so: Paint from a command line, like so:
tuxpaint --verbose-version tuxpaint --verbose-version
If, amongst the other information, you see "Sound disabled", If, amongst the other information, you see "Sound disabled", then the
then the version of Tux Paint you're running has sound version of Tux Paint you're running has sound disabled. Recompile Tux
disabled. Recompile Tux Paint, and be sure NOT to build the Paint, and be sure NOT to build the "nosound" target. (i.e., don't run
"nosound" target. (i.e., don't run "make nosound") Be sure "make nosound") Be sure the SDL_mixer library and its development
the SDL_mixer library and its development headers are headers are available!
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: Yes, there are a number of ways to disable sounds in Tux Paint:
* Press [Alt] + [S] while in Tux Paint to temporarily disable + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds.
sounds. (Press that key sequence again to re-enable sounds.) (Press that key sequence again to re-enable sounds.)
* Run Tux Paint with the "no sound" option: + Run Tux Paint with the "no sound" option:
* Run "tuxpaint --nosound" from the command line or o Run "tuxpaint --nosound" from the command line or shortcut or
shortcut or desktop icon. desktop icon.
* Edit Tux Paint's configuration file (see "Options o Edit Tux Paint's configuration file (see "Options Documentation"
Documentation" for details) and add a line containing for details) and add a line containing "nosound=yes".
"nosound=yes". o Or use Tux Paint Config. and make sure "Enable Sound Effects"
* Or use Tux Paint Config. and make sure "Enable Sound (under "Video & Sound") is not checked.
Effects" (under "Video & Sound") is not checked. o Alternatively, recompile Tux Paint with sound support disabled.
* Alternatively, recompile Tux Paint with sound support (See above, and the 'Install' documentation.
disabled. (See above, and the 'Install' documentation.
The stereo panning of sound effects is bothersome; can sound effects be The stereo panning of sound effects is bothersome; can sound effects be
monophonic? monophonic?
Run Tux Paint with the "no stereo" option: Run Tux Paint with the "no stereo" option:
* Run "tuxpaint --nostereo" from the command line or shortcut + Run "tuxpaint --nostereo" from the command line or shortcut or desktop
or desktop icon. icon.
* Edit Tux Paint's configuration file (see "Options + Edit Tux Paint's configuration file (see "Options Documentation" for
Documentation" for details) and add a line containing details) and add a line containing "nostereo=yes".
"nostereo=yes". + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
* Or use Tux Paint Config. and make sure "Enable Stereo "Video & Sound") is not checked.
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. This could have to do with how SDL and SDL_mixer were initialized. (The
(The buffer size chosen.) buffer size chosen.)
Please e-mail us with details about your computer system. Please e-mail us with details about your computer system. (Operating system
(Operating system and version, sound card, which version of Tux and version, sound card, which version of Tux Paint you're running (run
Paint you're running (run "tuxpaint --version" to verify), and so "tuxpaint --version" to verify), and so on.)
on.)
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Fullscreen Mode Problems Fullscreen Mode Problems
When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
black!
This is apparently a bug in the SDL library. Sorry. 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 Linux users - Your X-Window server is probably not set with the ability to
ability to switch to the desired resolution: 800×600. (or whatever switch to the desired resolution: 800×600. (or whatever resolution you have
resolution you have Tux Paint set to run at.) (This is typically Tux Paint set to run at.) (This is typically done manually under the
done manually under the X-Window server by pressing [Control] + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and
[Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus [Control] + [Alt] + [Keypad Minus (-)].)
(-)].)
For this to work, your monitor must support that resolution, and For this to work, your monitor must support that resolution, and you need
you need to have it listed in your X server configuration. to have it listed in your X server configuration.
Check the "Display" subsection of the "Screen" section of your Check the "Display" subsection of the "Screen" section of your XFree86 or
XFree86 or X.org configuration file (typically X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/
"/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x,
version of XFree86 you're using; 3.x or 4.x, respectively, or respectively, or "/etc/X11/xorg.conf" for X.org).
"/etc/X11/xorg.conf" for X.org).
Add "800x600" (or whatever resolution(s) you want) to the Add "800x600" (or whatever resolution(s) you want) to the appropriate
appropriate "Modes" line. (e.g., in the "Display" subsection that "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color
contains 24-bit color depth ("Depth 24"), which is what Tux Paint depth ("Depth 24"), which is what Tux Paint tries to use.)
tries to use.)
Modes "1280x1024" "1024x768" "800x600" "640x480" Modes "1280x1024" "1024x768" "800x600" "640x480"
Note that some Linux distributions have tools that can make these Note that some Linux distributions have tools that can make these changes
changes for you. Debian users can run the command for you. Debian users can run the command "dpkg-reconfigure
"dpkg-reconfigure xserver-xfree86" as root, for example. 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. The "fullscreen" option is set.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--fullscreen" option. giving it a "--fullscreen" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--fullscreen" is listed as a properties of the icon to see if "--fullscreen" is listed as a command-line
command-line argument. argument.
If a "--fullscreen" option isn't being sent on the command line, If a "--fullscreen" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "fullscreen=yes".
"fullscreen=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--windowed", which will override the argument: "--windowed", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Fullscreen" (under "Video Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound")
& Sound") is not checked. is not checked.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
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 If Tux Paint aborts with the message: "You're already running a copy of Tux
copy of Tux Paint!", this means it has been launched in the last Paint!", this means it has been launched in the last 30 seconds. (On Unix/
30 seconds. (On Unix/Linux, this message would appear in a Linux, this message would appear in a terminal console if you ran Tux Paint
terminal console if you ran Tux Paint from a command-line. On from a command-line. On Windows, this message would appear in a file named
Windows, this message would appear in a file named "stdout.txt" in "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\
the same folder where TuxPaint.exe resides (e.g., in "C:\Program Program Files\TuxPaint").
Files\TuxPaint").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\
"userdata\lockfile.dat" on Windows) is used to make sure Tux Paint lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many
isn't run too many times at once (e.g., due to a child impatiently times at once (e.g., due to a child impatiently clicking its icon more than
clicking its icon more than once). once).
Even if the lockfile exists, it contains the 'time' Tux Paint was Even if the lockfile exists, it contains the 'time' Tux Paint was last run.
last run. If it's been more than 30 seconds, Tux Paint should run If it's been more than 30 seconds, Tux Paint should run fine, and simply
fine, and simply update the lockfile with the current time. update the lockfile with the current time.
If multiple users are sharing the directory where this file is 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, or "nolockfile=yes" to the configuration file.
If multiple users are sharing the directory where this file is
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, or "nolockfile=yes" to the configuration
file.
I can't quit Tux Paint I can't quit Tux Paint
The "no quit" option is set. This disables the "Quit" button in The "no quit" option is set. This disables the "Quit" button in Tux Paint's
Tux Paint's toolbar (greying it out), and prevents Tux Paint from toolbar (greying it out), and prevents Tux Paint from being exited via the
being exited via the [Escape] key. [Escape] key.
If Tux Paint is not in fullscreen mode, simply click the window If Tux Paint is not in fullscreen mode, simply click the window close
close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.)
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 "no quit" set, you can always use the [Alt] + [F4]
combination on your keyboard to quit Tux Paint.)
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 "no quit" set, you can always use the [Alt]
+ [F4] 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 If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noquit" option. giving it a "--noquit" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noquit" is listed as a properties of the icon to see if "--noquit" is listed as a command-line
command-line argument. argument.
If a "--noquit" option isn't being sent on the command line, check If a "--noquit" option isn't being sent on the command line, check Tux
Tux Paint's configuration file for a line reading: "noquit=yes". 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 configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape]
Key" (under "Simplification") is not checked.
Either remove that line, or simply run Tux Paint with the
command-line argument: "--quit", which will override the
configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and
[Escape] 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 A few messages are normal, but if Tux Paint is being extremely verbose
verbose (like listing the name of every rubber-stamp image it (like listing the name of every rubber-stamp image it finds while loading
finds while loading them), then it was probably compiled with them), then it was probably compiled with debugging output turned on.
debugging output turned on.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define DEBUG #define DEBUG
in the "tuxpaint.c" file in the "src" directory. 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 By default, Tux Paint first looks at configuration files for options.
options.
* Windows + Windows
Under Windows, Tux Paint first examines the configuration Under Windows, Tux Paint first examines the configuration file:
file:
tuxpaint.cfg tuxpaint.cfg
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* macOS + macOS
* Unix and Linux + Unix and Linux
Under Unix and Linux, it first examines the system-wide Under Unix and Linux, it first examines the system-wide configuration
configuration file, located here: file, located here:
/etc/tuxpaint/tuxpaint.conf /etc/tuxpaint/tuxpaint.conf
@ -572,19 +571,19 @@ Other Problems
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* Haiku + Haiku
This means that if anything is set in a configuration file that This means that if anything is set in a configuration file that you don't
you don't want set, you'll need to either change the config. file want set, you'll need to either change the config. file (if you can), or
(if you can), or override the option on the command-line. override the option on the command-line.
For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes
includes this option to disable sound... this option to disable sound...
nosound=yes nosound=yes
...then you can reenable sound by either adding this option to ...then you can reenable sound by either adding this option to your own
your own ".tuxpaintrc" file: ".tuxpaintrc" file:
sound=yes sound=yes
@ -592,24 +591,27 @@ Other Problems
--sound --sound
Linux and Unix users can also disable the system-wide Linux and Unix users can also disable the system-wide configuration file by
configuration file by including the following command-line including the following command-line argument:
argument:
--nosysconfig --nosysconfig
Tux Paint will then only look at "~/.tuxpaintrc" and command-line Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments
arguments to determine what options should be set. to determine what options should be set.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Help / Contact Help / Contact
Any questions you don't see answered? Please let us know! You can Any questions you don't see answered? Please let us know! You can subscribe and
subscribe and post to our "tuxpaint-users" mailing list: post to our "tuxpaint-users" mailing list:
https://tuxpaint.org/lists/ https://tuxpaint.org/lists/
Or, contact lead developer Bill Kendrick directly: Or, contact lead developer Bill Kendrick directly:
bill@newbreedsoftware.com bill@newbreedsoftware.com

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -10,79 +10,83 @@
About PNGs About PNGs
PNG is the Portable Network Graphic format. It is an open standard, not PNG is the Portable Network Graphic format. It is an open standard, not
burdened by patents (like GIFs). It is a highly compressed format (though burdened by patents (like GIFs). It is a highly compressed format (though not
not "lossy" like JPEGs - lossiness allows files to be much smaller, but "lossy" like JPEGs - lossiness allows files to be much smaller, but introduces
introduces 'mistakes' in the image when saved), and supports 24-bit color 'mistakes' in the image when saved), and supports 24-bit color (16.7 million
(16.7 million colors) as well as a full "alpha channel" - that is, each colors) as well as a full "alpha channel" - that is, each pixel can have a
pixel can have a varying degree of transparency. varying degree of transparency.
For more information, visit: http://www.libpng.org/ For more information, visit: http://www.libpng.org/
These features (openness, losslessness, compression, transparency/alpha) These features (openness, losslessness, compression, transparency/alpha) make
make it the best choice for Tux Paint. (Tux Paint's support for the PNG it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes
format comes from the Open Source SDL_Image library, which in turn gets it from the Open Source SDL_Image library, which in turn gets it from the libPNG
from the libPNG library.) library.)
Support for many colors allows photo-quality "rubber stamp" images to be Support for many colors allows photo-quality "rubber stamp" images to be used
used in Tux Paint, and alpha transparency allows for high-quality brushes. 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 The following is a very brief list of ways to create PNGs or convert existing
existing images into PNGs. images into PNGs.
GIMP & Krita GIMP & Krita
Excellent tools with which to create PNG images for use in Tux Excellent tools with which to create PNG images for use in Tux Paint are
Paint are GIMP and Krita, both high-quality Open Source GIMP and Krita, both high-quality Open Source interactive drawing and photo
interactive drawing and photo editing programs. editing programs.
It is likely that one or both are already installed on your system. If not,
they should be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://www.gimp.org/ and http:/
/www.krita.org/, respectively.
It is likely that one or both are already installed on your
system. If not, they should be readily available from your Linux
distribution's software repository. If not, or to learn more,
visit http://www.gimp.org/ and http://www.krita.org/,
respectively.
Command-line Tools Command-line Tools
NetPBM NetPBM
The Portable Bitmap tools (collectively known as The Portable Bitmap tools (collectively known as "NetPBM") is a
"NetPBM") is a collection of Open Source command-line collection of Open Source command-line tools which convert to and from
tools which convert to and from various formats, various formats, including GIF, TIFF, BMP, PNG, and many more.
including GIF, TIFF, BMP, PNG, and many more.
It is possible that it's already installed on your system. If not, they
it be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://
netpbm.sourceforge.net/.
It is possible that it's already installed on your
system. If not, they it be readily available from
your Linux distribution's software repository. If
not, or to learn more, visit
http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
The "cjpeg" and "djpeg" command-line programs convert The "cjpeg" and "djpeg" command-line programs convert between the
between the NetPBM Portable Any Map (PNM) format and NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
JPEGs. It is possible that it's already installed on it's already installed on your system. If not, they it be readily
your system. If not, they it be readily available available from your Linux distribution's software repository. If not,
from your Linux distribution's software repository. or to learn more, visit https://jpegclub.org/.
If not, or to learn more, visit
https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Macintosh Users Macintosh Users
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -7,47 +7,51 @@
junio 4, 2022 junio 4, 2022
Tux Paint responds to the following signals (which can be sent to the Tux Paint responds to the following signals (which can be sent to the program's
program's process via `kill` or `killall`, for example). 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 Tux Paint responds as if the "Quit" button were pressed, or the desktop
desktop environment was told to close Tux Paint (e.g., by clicking environment was told to close Tux Paint (e.g., by clicking a window close
a window close button, or pressing [Alt] + [F4] on most systems). button, or pressing [Alt] + [F4] on most systems).
From the main interface, Tux Paint will prompt whether or not you From the main interface, Tux Paint will prompt whether or not you wish to
wish to quit, and (unless overridden by the auto-save option, e.g. quit, and (unless overridden by the auto-save option, e.g. "--autosave") if
"--autosave") if you'd like to save the current drawing (if you'd like to save the current drawing (if unsaved), and if so, and it's a
unsaved), and if so, and it's a modified version of an existing modified version of an existing drawing (unless overridden by the options
drawing (unless overridden by the options to save over old images, to save over old images, or always save new images; e.g. "--saveover" and
or always save new images; e.g. "--saveover" and "--saveovernew", "--saveovernew", respectively), whether or not to overwrite the existing
respectively), whether or not to overwrite the existing drawing, drawing, or save to a new file.
or save to a new file.
Example: killall tuxpaint Example: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint responds by setting its auto-save option (as if it had Tux Paint responds by setting its auto-save option (as if it had been
been launched with "--autosave"), as well as either the option to launched with "--autosave"), as well as either the option to always save
always save new images (as if launched with "--saveovernew") in new images (as if launched with "--saveovernew") in the case of receiving a
the case of receiving a SIGUSR1 signal, or to always save over the SIGUSR1 signal, or to always save over the existing image (as if launched
existing image (as if launched with "--saveover") in the case of with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends
receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, itself a SIGTERM signal, in an attempt to quit. (See above.)
in an attempt to quit. (See above.)
So, from the main interface, Tux Paint should quit almost So, from the main interface, Tux Paint should quit almost immediately, with
immediately, with no questions asked. no questions asked.
Example: killall -s SIGUSR1 tuxpaint Example: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -10,27 +10,28 @@
About SVGs About SVGs
SVG (Scalable Vector Graphics) is an open standard used to describe SVG (Scalable Vector Graphics) is an open standard used to describe
two-dimensional vector graphics. It is great for diagrams and shapes, two-dimensional vector graphics. It is great for diagrams and shapes, while
while PNGs are better for photographs. SVG files are a bit like PNGs are better for photographs. SVG files are a bit like instructions on how
instructions on how to make an image. This means that they can be resized to make an image. This means that they can be resized without looking pixelated
without looking pixelated or blocky. or blocky.
For more information, visit: https://www.w3.org/Graphics/SVG/ For more information, visit: https://www.w3.org/Graphics/SVG/
How to make SVGs How to make SVGs
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -14,18 +14,18 @@ Tools (Drawing)
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right. * Choose a stamp on the right.
* Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the
the bottom right. bottom right.
* Some stamps allow you to choose their color (see "Colors"). * Some stamps allow you to choose their color (see "Colors").
* Change stamp size with the bars 📶 at the bottom right. * Change stamp size with the bars 📶 at the bottom right.
* Rotation ⟳ may be enabled, if desired. * Rotation ⟳ may be enabled, if desired.
* Click/tap in the canvas to place a stamp. * Click/tap in the canvas to place a stamp.
* If rotation is enabled, drag to rotate it, and click/tap again to + If rotation is enabled, drag to rotate it, and click/tap again to add
add it to the drawing. it to the drawing.
* Some stamps play sound effects; press the speaker 🕪 button to hear it * Some stamps play sound effects; press the speaker 🕪 button to hear it
again. again.
* Some stamps play descriptive sounds; press the headphones 🎧 button to * Some stamps play descriptive sounds; press the headphones 🎧 button to hear
hear it again. it again.
⚟Lines ⚟Lines
@ -35,71 +35,68 @@ Tools (Drawing)
⭓Shapes ⭓Shapes
* Choose a shape on the right. * Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a * Select whether you want to extend the shape from the center ⧈, or a corner
corner ◰, using controls at the bottom right. ◰, using controls at the bottom right.
* Click/tap to position, and drag to set the size of the shape. * 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. * Drag to rotate it, and click/tap again to add it to the drawing.
🄰Text 🄰Text
* Choose a font on the right. * Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
controls near the bottom right. near the bottom right.
* Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom
right. right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap the canvas to position an insertion cursor. * Click/tap the canvas to position an insertion cursor.
* Enter text via your keyboard or the on-screen keyboard. * Enter text via your keyboard or the on-screen keyboard.
* Click/tap the canvas again if you wish to reposition the text. * Click/tap the canvas again if you wish to reposition the text.
* Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing * Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing and
and begin entering more text one line down. begin entering more text one line down.
* Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and
continue entering more text immediately to the right. continue entering more text immediately to the right.
* Using the on-screen keyboard: * Using the on-screen keyboard:
* "Cmp" can be used to compose characters, e.g. Cmp ' a results in + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á.
á. + "AltGr" can be used to quickly access more characters.
* "AltGr" can be used to quickly access more characters. + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
* Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs.
"ABC")
🅰Label 🅰Label
* (See Text) * (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them, * Labels float 'above' the drawing; you cannot paint or stamp over them,
apply Magic effects, etc. apply Magic effects, etc.
* Labels may be edited, repositioned, and styled after they've been * Labels may be edited, repositioned, and styled after they've been added to
added to the drawing. the drawing.
* Click/tap the ☝ button near the lower right to choose a label. * Click/tap the ☝ button near the lower right to choose a label. Click/tap
Click/tap the label you wish to modify, then click/tap somewhere else the label you wish to modify, then click/tap somewhere else in the canvas
in the canvas to reposition, or change the font/style, change color, to reposition, or change the font/style, change color, and/or type to edit
and/or type to edit the text. the text.
* Or, use the 🖑 button near the lower right to "flatten" a label, * Or, use the 🖑 button near the lower right to "flatten" a label, applying it
applying it to the canvas; it may no longer be edited with the Label to the canvas; it may no longer be edited with the Label tool.
tool.
🪣Fill 🪣Fill
* Choose a fill mode on the right. * Choose a fill mode on the right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap (and drag, with Brush and Linear modes) to fill an area of * Click/tap (and drag, with Brush and Linear modes) to fill an area of the
the picture with a color. picture with a color.
* Solid - Flood-fills an area with a solid color + Solid - Flood-fills an area with a solid color
* Brush - Paints with a solid color, without drawing outside the + Brush - Paints with a solid color, without drawing outside the chosen
chosen area area
* Linear - Fills the area with a linear gradient (drag to choose + Linear - Fills the area with a linear gradient (drag to choose angle
angle and gradient) and gradient)
* Radial - Fills the area with a radial gradient, centered where + Radial - Fills the area with a radial gradient, centered where you
you clicked/tapped clicked/tapped
* Shaped - Fills the area with a gradient that follows the contours + Shaped - Fills the area with a gradient that follows the contours of
of the area being filled the area being filled
🪄Magic 🪄Magic
* Choose a magic tool on the right. * Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Some magic tools draw or apply effects via click/tap and drag 〰🪄, some * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some
affect the entire drawing 🖻🪄, and some offer both options; use the affect the entire drawing 🖻🪄, and some offer both options; use the controls
controls at the bottom right. at the bottom right.
* Some magic tools offer various sizes; change it with the bars 📶 at the * Some magic tools offer various sizes; change it with the bars 📶 at the
bottom right. bottom right.
* Some magic tools allow you to choose their color. * Some magic tools allow you to choose their color.
@ -117,8 +114,8 @@ Tools (Drawing)
◪Eraser ◪Eraser
* Choose the size and shape of the eraser on the right. * Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or * Click/tap and drag to erase parts of the picture (solid color, or starter
starter or template image). or template image).
* Shortcut: [X] and click/tap in the drawing (not always available) * Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls) Tools (Controls)
@ -126,11 +123,10 @@ Tools (Controls)
🗏New 🗏New
* Choose a solid color, starter, or template image to start with. * Choose a solid color, starter, or template image to start with.
* Starters allow drawing "under" a picture (e.g., a coloring book + Starters allow drawing "under" a picture (e.g., a coloring book
outline), sometimes with a background layer, too. outline), sometimes with a background layer, too.
* Templates are pictures to start with (background only). + Templates are pictures to start with (background only).
* Eraser tool ◪ reveals the solid color, or starter/template + Eraser tool ◪ reveals the solid color, or starter/template background.
background.
* Click/tap "🕮⮫Open" to begin a new drawing. * Click/tap "🕮⮫Open" to begin a new drawing.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Ctrl]+[N] * Shortcut: [Ctrl]+[N]
@ -141,32 +137,31 @@ Tools (Controls)
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
* Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures"
folder. folder.
* Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin.
Bin.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Click/tap "📽Slides" to switch to slideshow mode: * Click/tap "📽Slides" to switch to slideshow mode:
* Click/tap two or more of your previously-saved drawings, in the + Click/tap two or more of your previously-saved drawings, in the order
order you want them shown. Numbers will appear on them. you want them shown. Numbers will appear on them.
* Choose the playback speed using the bars 📶 near the lower left. + Choose the playback speed using the bars 📶 near the lower left.
* Click/tap "⯈Play" to watch the slideshow/animation. + Click/tap "⯈Play" to watch the slideshow/animation.
* Or, click/tap "🎞GIF Export" to save an animated GIF of the + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to
animation to your system's "Pictures" folder. your system's "Pictures" folder.
* Click/tap "⤺Back" to return to the Open dialog. + Click/tap "⤺Back" to return to the Open dialog.
* Shortcut: [Ctrl]+[O] * Shortcut: [Ctrl]+[O]
🕮⮪Save 🕮⮪Save
* Click/tap to save your drawing. * Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite * If you've saved previously, you'll be prompted whether to overwrite the
the previously-saved drawing (a la "File→Save") or create a new saved previously-saved drawing (a la "File→Save") or create a new saved drawing
drawing (a la "File→Save As...") (a la "File→Save As...")
* Shortcut: [Ctrl]+[S] * Shortcut: [Ctrl]+[S]
🖶Print 🖶Print
* Click/tap to print your drawing. * Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
dialog, if available. if available.
* Shortcut: [Ctrl]+[P] * Shortcut: [Ctrl]+[P]
🗙Quit 🗙Quit
@ -176,28 +171,27 @@ Tools (Controls)
Colors Colors
* Click/tap to choose a color to use with the Paint, Lines, and Shapes * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
tools, and Stamps and Magic tools that support colors. and Stamps and Magic tools that support colors.
* Use the pipette / color picker 💉 button to choose a color from a pixel * Use the pipette / color picker 💉 button to choose a color from a pixel in
in your current drawing. your current drawing.
* Shortcut: When colors are available, press [Ctrl] and click/tap + Shortcut: When colors are available, press [Ctrl] and click/tap in your
in your drawing, to quickly pick a color from your drawing. drawing, to quickly pick a color from your drawing.
* Click/tap the rainbow 🌈 button to choose a arbitrary color. * Click/tap the rainbow 🌈 button to choose a arbitrary color.
* Click/tap in the rainbow square to pick a color (hue and + Click/tap in the rainbow square to pick a color (hue and saturation).
saturation). + Click/tap in the grey gradient bar to adjust brightness (value).
* Click/tap in the grey gradient bar to adjust brightness (value). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Click/tap "⤺Back" to abort and dismiss the palette.
* Click/tap "⤺Back" to abort and dismiss the palette. + You may grab the currently-chosen built-in color (if any), the color in
* You may grab the currently-chosen built-in color (if any), the the pipette / color picker, or the color in the color mixer, by
color in the pipette / color picker, or the color in the color clicking one of the colored arrow ⇫ buttons.
mixer, by clicking one of the colored arrow ⇫ buttons. * Click/tap the paint palette 🎨 button to create a color by mixing primary
* Click/tap the paint palette 🎨 button to create a color by mixing colors: red, yellow, and blue, and white (tint), grey (tone), and black
primary colors: red, yellow, and blue, and white (tint), grey (tone), (shade).
and black (shade). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Color mixing offers its own 🖓Undo and 🖒Redo options.
* Color mixing offers its own 🖓Undo and 🖒Redo options. + Click/tap "🗑Clear" to start over with no mixed colors.
* Click/tap "🗑Clear" to start over with no mixed colors. + Click/tap "⤺Back" to abort and dismiss the color mixer.
* Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing: Shortcuts while drawing:
@ -213,3 +207,4 @@ Shortcuts while drawing:
* [Esc] - ⤺Back or 🗙Quit * [Esc] - ⤺Back or 🗙Quit
Last updated: mayo 9, 2023 Last updated: mayo 9, 2023

View file

@ -6,8 +6,7 @@
juin 4, 2022 juin 4, 2022
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+----------------------------------------------------+ +----------------------------------------------------+
| Table des matières | | Table des matières |
|----------------------------------------------------| |----------------------------------------------------|
@ -17,26 +16,24 @@
| * Remplacer la frange et les pixels indésirables | | * Remplacer la frange et les pixels indésirables |
| * Sauvegarder l'image pour Tux Paint | | * Sauvegarder l'image pour Tux Paint |
+----------------------------------------------------+ +----------------------------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
À propos de ce 'guide pratique' À propos de ce 'guide pratique'
Ce 'guide pratique' suppose que vous vouliez créer un excellent tampon Ce 'guide pratique' suppose que vous vouliez créer un excellent tampon pour
pour Tux Paint, au format bitmap PNG, à partir d'une image JPEG (par ex. Tux Paint, au format bitmap PNG, à partir d'une image JPEG (par ex. une
une photographie digitale). Il existe des méthodes plus faciles et plus photographie digitale). Il existe des méthodes plus faciles et plus rapides
rapides donnant de moins bons résultats. donnant de moins bons résultats.
Ce 'guide pratique' suppose que vous travaillez avec des objets Ce 'guide pratique' suppose que vous travaillez avec des objets normalement
normalement opaques. Pour des objets semi-transparents (flamme, hélice opaques. Pour des objets semi-transparents (flamme, hélice de ventilateur
de ventilateur en mouvement) ou des objets luminescents (feu, ampoule, en mouvement) ou des objets luminescents (feu, ampoule, soleil) mieux vaut
soleil) mieux vaut travailler avec un logiciel adapté. Des images avec travailler avec un logiciel adapté. Des images avec de parfaits
de parfaits arrière-plans de couleur unie sont mieux réalisées avec un arrière-plans de couleur unie sont mieux réalisées avec un logiciel adapté,
logiciel adapté, mais ne posent pas de problèmes avec ce qui suit. mais ne posent pas de problèmes avec ce qui suit.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Le choix de l'image est crucial Le choix de l'image est crucial
@ -55,10 +52,10 @@ Le choix de l'image est crucial
conviendront. (Note : les sites *.mil peuvent avoir aussi des contenus conviendront. (Note : les sites *.mil peuvent avoir aussi des contenus
non-militaires !) non-militaires !)
Vos propres images peuvent être placées dans le domaine public, ou Vos propres images peuvent être placées dans le domaine public, ou sous
sous une licence adéquate, telle que Google image en y faisant une licence adéquate, telle que Google image en y faisant référence.
référence. (Demandez à un avocat si vous pensez que vous avez besoin (Demandez à un avocat si vous pensez que vous avez besoin d'un avis
d'un avis faisant autorité). faisant autorité).
Pour un usage personnel, toute image que vous pouvez légalement Pour un usage personnel, toute image que vous pouvez légalement
modifier et utiliser pour vous-même devrait convenir. modifier et utiliser pour vous-même devrait convenir.
@ -67,10 +64,10 @@ Le choix de l'image est crucial
Vous aurez besoin d'une image ayant une bonne orientation. La Vous aurez besoin d'une image ayant une bonne orientation. La
perspective est notre ennemie. Les images montrant un objet à partir perspective est notre ennemie. Les images montrant un objet à partir
d'un coin sont difficiles à intégrer pour obtenir un dessin correct. d'un coin sont difficiles à intégrer pour obtenir un dessin correct. En
En règle générale, les photos prises au téléobjectif sont les règle générale, les photos prises au téléobjectif sont les meilleures.
meilleures. L'idéal, impossible à tenir, serait que deux roues d'une L'idéal, impossible à tenir, serait que deux roues d'une même voiture
même voiture soient cachées derrière les deux autres. soient cachées derrière les deux autres.
Effectuer une rotation sur une image peut la rendre floue, surtout si Effectuer une rotation sur une image peut la rendre floue, surtout si
vous ne la pivotez que de quelques degrés. Les meilleures images sont vous ne la pivotez que de quelques degrés. Les meilleures images sont
@ -86,37 +83,34 @@ Le choix de l'image est crucial
de plus de 1 000 pixels si possible. Vous pourrez ainsi la réduire et de plus de 1 000 pixels si possible. Vous pourrez ainsi la réduire et
cacher vos erreurs. cacher vos erreurs.
Vérifiez bien que l'image ne soit pas trop granuleuse, pâle ou Vérifiez bien que l'image ne soit pas trop granuleuse, pâle ou délavée.
délavée.
Faites attention aux pieds et aux roues. Si elles sont camouflées par Faites attention aux pieds et aux roues. Si elles sont camouflées par
quelque chose, vous devrez en dessiner de nouvelles. Si une seule est quelque chose, vous devrez en dessiner de nouvelles. Si une seule est
camouflée, vous devriez pouvoir effectuer un copié-collé pour le camouflée, vous devriez pouvoir effectuer un copié-collé pour le
remplacement. remplacement.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Préparez l'image Préparez l'image
Tout d'abord, ne re-sauvegardez pas une image au format JPEG. Cela Tout d'abord, ne re-sauvegardez pas une image au format JPEG. Cela induit
induit une perte de qualité. Il existe un outil spécial appelé jpegtran une perte de qualité. Il existe un outil spécial appelé jpegtran qui vous
qui vous permet de découper une image sans la perte de qualité permet de découper une image sans la perte de qualité habituelle.
habituelle.
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
Importez votre image dans votre éditeur d'image. Si vous n'avez pas Importez votre image dans votre éditeur d'image. Si vous n'avez pas encore
encore recadré votre image, vous pouvez trouver que votre éditeur est recadré votre image, vous pouvez trouver que votre éditeur est très lent.
très lent. Faites une rotation et recadrer l'image comme vous voulez. Faites une rotation et recadrer l'image comme vous voulez. Sauvegardez
Sauvegardez l'image -- choisissez tout format supportant les calques, l'image -- choisissez tout format supportant les calques, les masques,
les masques, alpha, etc... Les utilisateurs de GIMP choisiront le format alpha, etc... Les utilisateurs de GIMP choisiront le format XCF, et les
XCF, et les utilisateurs de Adobe Photoshop choisiront PSD, à titre utilisateurs de Adobe Photoshop choisiront PSD, à titre d'exemple.
d'exemple.
Si vous avez effectué une rotation et un recadrage de votre image, Si vous avez effectué une rotation et un recadrage de votre image,
applatissez-la. Vous n'avez besoin que d'un seul calque RGB sans masque applatissez-la. Vous n'avez besoin que d'un seul calque RGB sans masque ou
ou canal alpha. canal alpha.
Ouvrez la boîte de dialogue qui concerne les calques. Reproduisez une Ouvrez la boîte de dialogue qui concerne les calques. Reproduisez une
couche plusieurs fois. Du haut jusqu'en bas vous aurez besoin de quelque couche plusieurs fois. Du haut jusqu'en bas vous aurez besoin de quelque
@ -128,63 +122,61 @@ Préparez l'image
4. magenta uni (si possible protégé en écriture) 4. magenta uni (si possible protégé en écriture)
5. image non-modifiée (protégez la en écriture, si possible) 5. image non-modifiée (protégez la en écriture, si possible)
Donnez au calque 'travail en cours' (WIP) un masque initial Donnez au calque 'travail en cours' (WIP) un masque initial approximatif.
approximatif. Vous pouvez démarrer avec une sélection, ou en utilisant Vous pouvez démarrer avec une sélection, ou en utilisant la valeur de
la valeur de niveaux de gris du calque WIP. Vous pouvez inverser le niveaux de gris du calque WIP. Vous pouvez inverser le masque.
masque.
Attention : une fois que avez le masque, vous ne pourrez plus tourner ou Attention : une fois que avez le masque, vous ne pourrez plus tourner ou
modifier la taille de l'image normalement. Cela entraînerait des pertes modifier la taille de l'image normalement. Cela entraînerait des pertes de
de données. On vous donnera plus tard des instructions pour la mise à données. On vous donnera plus tard des instructions pour la mise à
l'échelle. l'échelle.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Préparez le masque Préparez le masque
Prenez l'habitude de faire un [Control]-clic et un [Alt]-clic sur les Prenez l'habitude de faire un [Control]-clic et un [Alt]-clic sur les
images-vignettes dans la boîte de dialogue des calques. Vous devez le images-vignettes dans la boîte de dialogue des calques. Vous devez le faire
faire pour vérifier ce que vous voyez et ce que vous éditez. Parfois pour vérifier ce que vous voyez et ce que vous éditez. Parfois vous
vous éditerez des choses que vous ne pouvez pas voir. Par exemple, vous éditerez des choses que vous ne pouvez pas voir. Par exemple, vous pouvez
pouvez éditer le masque du masque WIP, tout en regardant l'image non éditer le masque du masque WIP, tout en regardant l'image non modifiée.
modifiée. Faites attention à ne pas vous tromper. Vérifiez toujours que Faites attention à ne pas vous tromper. Vérifiez toujours que vous éditez
vous éditez ce qu'il faut. ce qu'il faut.
Définissez une image non-modifiée comme étant celle que vous voulez Définissez une image non-modifiée comme étant celle que vous voulez
afficher (celle du haut est la plus facile). Définissez le masque WIP afficher (celle du haut est la plus facile). Définissez le masque WIP comme
comme étant ce que vous allez éditer. À un moment donné, vous devriez étant ce que vous allez éditer. À un moment donné, vous devriez agrandir
agrandir l'image à environ 400 % (chaque pixel de l'image est vu et l'image à environ 400 % (chaque pixel de l'image est vu et représenté par
représenté par un bloc de 4x4 pixels sur votre écran. un bloc de 4x4 pixels sur votre écran.
Sélectionnez les parties de l'image devant être 100 % opaques, ou bien 0 Sélectionnez les parties de l'image devant être 100 % opaques, ou bien 0 %
% opaques.Si vous pouvez sélectionner l'objet ou l'arrière-plan avec une opaques.Si vous pouvez sélectionner l'objet ou l'arrière-plan avec une
bonne précision, faites le. Si nécessaire, pour éviter de sélectionner bonne précision, faites le. Si nécessaire, pour éviter de sélectionner des
des pixels devant être partiellement opaques (en général sur les bords pixels devant être partiellement opaques (en général sur les bords de
de l'objet), vous devriez agrandir, réduire et inverser la sélection. l'objet), vous devriez agrandir, réduire et inverser la sélection.
Remplissez les zones 100 % opaques avec du blanc, et les 0 % opaques Remplissez les zones 100 % opaques avec du blanc, et les 0 % opaques avec
avec du noir. On le fait facilement en glissant-déposant depuis du noir. On le fait facilement en glissant-déposant depuis l'indicateur de
l'indicateur de couleur de premier plan. Vous ne devriez rien voir se couleur de premier plan. Vous ne devriez rien voir se produire, car vous
produire, car vous voyez le calque de l'image non modifiée quand vous voyez le calque de l'image non modifiée quand vous éditez le masque du
éditez le masque du calque WIP. Les changements importants peuvent être calque WIP. Les changements importants peuvent être vus sur la vignette.
vus sur la vignette.
Maintenant vous devez zoomer. Maintenant vous devez zoomer.
Vérifiez votre travail. Cachez le calque supérieur d'image non-modifiée. Vérifiez votre travail. Cachez le calque supérieur d'image non-modifiée.
N'affichez que le masque, qui devrait être un objet blanc sur un fond N'affichez que le masque, qui devrait être un objet blanc sur un fond noir
noir (probablement avec du gris non édité sur les bords). Maintenant (probablement avec du gris non édité sur les bords). Maintenant affichez le
affichez le calque WIP normalement, pour que le masque soit actif. Cela calque WIP normalement, pour que le masque soit actif. Cela devrait montrer
devrait montrer votre objet par dessus le prochain calque activé le plus votre objet par dessus le prochain calque activé le plus élevé, et qui
élevé, et qui devrait être vert ou magenta, suivant le cas, pour avoir devrait être vert ou magenta, suivant le cas, pour avoir un contraste
un contraste maximum. Vous pourriez basculer entre ces arrière-plans en maximum. Vous pourriez basculer entre ces arrière-plans en cliquant
cliquant plusieurs fois pour activer/désactiver le calque vert. Corrigez plusieurs fois pour activer/désactiver le calque vert. Corrigez tous les
tous les problèmes évidents et faciles en éditant le masque. problèmes évidents et faciles en éditant le masque.
Revenez à l'affichage du calque supérieur non modifié lors de l'édition Revenez à l'affichage du calque supérieur non modifié lors de l'édition du
du masque WIP. Ajustez le pinceau dans l'outil de dessin. Pour la masque WIP. Ajustez le pinceau dans l'outil de dessin. Pour la brosse,
brosse, choisissez un petit cercle flou. Une taille de 5x5 convient dans choisissez un petit cercle flou. Une taille de 5x5 convient dans la plupart
la plupart des cas. des cas.
Avec une main sûre, tracez autour de l'image. Utilisez du noir à Avec une main sûre, tracez autour de l'image. Utilisez du noir à
l'extérieur et du blanc à l'intérieur. Évitez de faire plus d'un passage l'extérieur et du blanc à l'intérieur. Évitez de faire plus d'un passage
@ -192,19 +184,19 @@ Préparez le masque
Inversez un peu les vues, pour vérifier que le masque fonctionne Inversez un peu les vues, pour vérifier que le masque fonctionne
bien.Lorsque le calque WIP est fait de vert ou de magenta, vous devriez bien.Lorsque le calque WIP est fait de vert ou de magenta, vous devriez
voir un tout petit peu de l'arrière-plan initial ressemblant à une voir un tout petit peu de l'arrière-plan initial ressemblant à une vilaine
vilaine frange près du bord. Si la frange est absente, c'est que le frange près du bord. Si la frange est absente, c'est que le masque d'objet
masque d'objet est trop petit. La frange est constituée de pixels qui ne est trop petit. La frange est constituée de pixels qui ne sont ni à un
sont ni à un objet à 100 % ni un objet à 0 %. Pour eux, le masque ne objet à 100 % ni un objet à 0 %. Pour eux, le masque ne devrait être ni à
devrait être ni à 100 % ni à 0 %. La frange disparaîtra bientôt. 100 % ni à 0 %. La frange disparaîtra bientôt.
Affichez et modifiez le masque. Sélectionnez par couleur, en choisissant Affichez et modifiez le masque. Sélectionnez par couleur, en choisissant le
le noir ou le blanc. Vous verrez sûrement des tâches non sélectionnées noir ou le blanc. Vous verrez sûrement des tâches non sélectionnées qui ne
qui ne sont pas tout à fait à la couleur attendue. Inversez la sont pas tout à fait à la couleur attendue. Inversez la sélection, et
sélection, et coloriez les avec l'outil crayon. Faites ces opérations coloriez les avec l'outil crayon. Faites ces opérations pour le blanc et le
pour le blanc et le noir. noir.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Remplacer la frange et les pixels indésirables Remplacer la frange et les pixels indésirables
@ -215,89 +207,87 @@ Remplacer la frange et les pixels indésirables
Désactivez maintenant le masque. Affichez et modifiez la couche WIP non Désactivez maintenant le masque. Affichez et modifiez la couche WIP non
masquée. À l'aide de l'outil de sélection de couleur, choisissez une masquée. À l'aide de l'outil de sélection de couleur, choisissez une
couleur moyenne pour l'objet. Faites glisser et déposez cette couleur couleur moyenne pour l'objet. Faites glisser et déposez cette couleur dans
dans la sélection, supprimant ainsi la plupart des pixels non-objets. la sélection, supprimant ainsi la plupart des pixels non-objets.
Cette couleur unie se compressera bien et aidera à éviter les franges de Cette couleur unie se compressera bien et aidera à éviter les franges de
couleur laides lorsque Tux Paint redimensionnera l'image. Si le bord de couleur laides lorsque Tux Paint redimensionnera l'image. Si le bord de
l'objet a plusieurs couleurs très différentes, vous devriez diviser l'objet a plusieurs couleurs très différentes, vous devriez diviser votre
votre sélection afin de pouvoir colorer l'arrière-plan voisin d'une sélection afin de pouvoir colorer l'arrière-plan voisin d'une teinte
teinte similaire. similaire.
Vous allez maintenant peindre la frange de bord existante. Assurez-vous Vous allez maintenant peindre la frange de bord existante. Assurez-vous que
que vous modifiez et visualisez l'image WIP. En changeant fréquemment de vous modifiez et visualisez l'image WIP. En changeant fréquemment de
calque, vous verrez mieux à voir ce que vous faites. Vous êtes calque, vous verrez mieux à voir ce que vous faites. Vous êtes susceptible
susceptible d'utiliser tous ceux-ci : d'utiliser tous ceux-ci :
* composite sur vert (masque activé) + composite sur vert (masque activé)
* composite sur magenta (masque activé) + composite sur magenta (masque activé)
* original (calque supérieur ou inférieur) + original (calque supérieur ou inférieur)
* composite sur l'original (masque activé) + composite sur l'original (masque activé)
* calque WIP brut (masque désactivé + calque WIP brut (masque désactivé
Pour réduire les accidents, vous souhaiterez peut-être sélectionner Pour réduire les accidents, vous souhaiterez peut-être sélectionner
uniquement les pixels qui ne sont pas gris dans le masque. (Sélectionnez uniquement les pixels qui ne sont pas gris dans le masque. (Sélectionnez
par couleur dans le masque, choisissez le noir, ajoutez le mode, par couleur dans le masque, choisissez le noir, ajoutez le mode, choisissez
choisissez le blanc, inversez. Ou bien : sélectionnez tout, sélectionnez le blanc, inversez. Ou bien : sélectionnez tout, sélectionnez par couleur
par couleur dans le masque, soustrayez le mode, choisissez le noir, dans le masque, soustrayez le mode, choisissez le noir, choisissez le
choisissez le blanc.) Si vous faites cela, vous voudrez probablement blanc.) Si vous faites cela, vous voudrez probablement élargir un peu la
élargir un peu la sélection et / ou masquer la ligne "fourmis rampantes" sélection et / ou masquer la ligne "fourmis rampantes" qui marque la
qui marque la sélection. sélection.
Use the clone tool and the brush tool. Vary the opacity as needed. Use Use the clone tool and the brush tool. Vary the opacity as needed. Use
small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is
generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy
brushes with about 70% opacity.) Unusual drawing modes can be helpful brushes with about 70% opacity.) Unusual drawing modes can be helpful with
with semi-transparent objects. semi-transparent objects.
Le but est de supprimer la frange de bord, à la fois à l'intérieur et à Le but est de supprimer la frange de bord, à la fois à l'intérieur et à
l'extérieur de l'objet. La frange intérieure, visible lorsque l'objet l'extérieur de l'objet. La frange intérieure, visible lorsque l'objet est
est composé de magenta ou de vert, doit être supprimée pour des raisons composé de magenta ou de vert, doit être supprimée pour des raisons
évidentes. La frange extérieure doit également être supprimée car elle évidentes. La frange extérieure doit également être supprimée car elle
deviendra visible lorsque l'image sera réduite. À titre d'exemple, deviendra visible lorsque l'image sera réduite. À titre d'exemple,
considérons une région avec 2x2 de pixels au bord d'un objet aux arêtes considérons une région avec 2x2 de pixels au bord d'un objet aux arêtes
vives. La moitié gauche est noire et opaque à 0%. La moitié droite est vives. La moitié gauche est noire et opaque à 0%. La moitié droite est
blanche et 100% opaque. Autrement dit, nous avons un objet blanc sur blanche et 100% opaque. Autrement dit, nous avons un objet blanc sur fond
fond noir. Lorsque Tux Paint redimensionne cela à 50% (une zone de 1 x 1 noir. Lorsque Tux Paint redimensionne cela à 50% (une zone de 1 x 1 pixel),
pixel), le résultat sera un pixel opaque gris à 50%. Le résultat correct le résultat sera un pixel opaque gris à 50%. Le résultat correct devrait
devrait être un pixel blanc opaque à 50%. Pour obtenir ce résultat, nous être un pixel blanc opaque à 50%. Pour obtenir ce résultat, nous devrions
devrions peindre les pixels noirs. Ils comptent, bien qu'ils soient à 0 peindre les pixels noirs. Ils comptent, bien qu'ils soient à 0 % d'opacité.
% d'opacité.
Tux Paint peut réduire considérablement la taille des images, il est Tux Paint peut réduire considérablement la taille des images, il est donc
donc important d'étendre considérablement le bord de votre objet vers important d'étendre considérablement le bord de votre objet vers
l'extérieur. Juste au bord de votre objet, vous devez être très précis l'extérieur. Juste au bord de votre objet, vous devez être très précis sur
sur ce point. Lorsque vous vous éloignez de l'objet, cela risque de ce point. Lorsque vous vous éloignez de l'objet, cela risque de faire
faire négligé. Il est raisonnable de peindre vers l'extérieur sur une négligé. Il est raisonnable de peindre vers l'extérieur sur une douzaine de
douzaine de pixels ou plus. Plus vous irez loin, plus Tux Paint pourra pixels ou plus. Plus vous irez loin, plus Tux Paint pourra réduire la
réduire la taille sans créer de franges avec des couleurs moches. Pour taille sans créer de franges avec des couleurs moches. Pour les zones
les zones situées à plus de quelques pixels du bord, vous devez utiliser situées à plus de quelques pixels du bord, vous devez utiliser l'outil
l'outil Crayon (ou une vague sélection avec une couleur en Crayon (ou une vague sélection avec une couleur en glisser-déposer) pour
glisser-déposer) pour vous assurer que le résultat se compressera bien. vous assurer que le résultat se compressera bien.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Sauvegarder l'image pour Tux Paint Sauvegarder l'image pour Tux Paint
It is very easy to ruin your hard work. Image editors can silently It is very easy to ruin your hard work. Image editors can silently destroy
destroy pixels in 0% opaque areas. The conditions under which this pixels in 0% opaque areas. The conditions under which this happens may vary
happens may vary from version to version. If you are very trusting, you from version to version. If you are very trusting, you can try saving your
can try saving your image directly as a PNG. Be sure to read it back in image directly as a PNG. Be sure to read it back in again to verify that
again to verify that the 0% opaque areas didn't turn black or white, the 0% opaque areas didn't turn black or white, which would create fringes
which would create fringes when Tux Paint scales the image down. If you when Tux Paint scales the image down. If you need to scale your image to
need to scale your image to save space (and hide your mistakes), you are save space (and hide your mistakes), you are almost certain to destroy all
almost certain to destroy all the 0% opaque areas. So here is a better the 0% opaque areas. So here is a better way...
way...
Une façon sûre pour sauvegarder Une façon sûre pour sauvegarder
Faites glisser le masque de la boîte de dialogue des calques vers la Faites glisser le masque de la boîte de dialogue des calques vers la
partie inutilisée de la barre d'outils (juste après le dernier outil partie inutilisée de la barre d'outils (juste après le dernier outil de
de dessin). Cela créera une nouvelle image composée d'un calque dessin). Cela créera une nouvelle image composée d'un calque contenant
contenant les données du masque. Mettez-le à l'échelle comme vous le les données du masque. Mettez-le à l'échelle comme vous le souhaitez,
souhaitez, en vous souvenant des paramètres que vous utilisez. en vous souvenant des paramètres que vous utilisez. Souvent, vous
Souvent, vous devriez commencer par une image d'environ 700 à 1500 devriez commencer par une image d'environ 700 à 1500 pixels de diamètre
pixels de diamètre et finir par une image de 300 à 400. et finir par une image de 300 à 400.
Enregistrez l'image de masque en tant que fichier portable NetPBM Enregistrez l'image de masque en tant que fichier portable NetPBM
(".pgm"). (Si vous utilisez une ancienne version de The GIMP, vous (".pgm"). (Si vous utilisez une ancienne version de The GIMP, vous
@ -325,3 +315,4 @@ Sauvegarder l'image pour Tux Paint
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,101 +7,104 @@
mai 5, 2023 mai 5, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint interprète plusieurs variables d'environnement, soit Tux Paint interprète plusieurs variables d'environnement, soit directement,
directement, soit indirectement par le biais des bibliothèques qu'il soit indirectement par le biais des bibliothèques qu'il utilise.
utilise.
Variables d'environnement relatives au stockage Variables d'environnement relatives au stockage
HOME HOME
Spécifie le répertoire personnel de l'utilisateur, qui sert à Spécifie le répertoire personnel de l'utilisateur, qui sert à accueillir de
accueillir de nombreux autres fichiers ou répertoires. Dans nombreux autres fichiers ou répertoires. Dans quelques cas, il sert de
quelques cas, il sert de solution de repli, quand d'autres solution de repli, quand d'autres variables d'environnement (autre part
variables d'environnement (autre part dans cette documentation) dans cette documentation) n'ont pas été positionnées. Parfois, l'endroit à
n'ont pas été positionnées. Parfois, l'endroit à utiliser peut utiliser peut être changer par des options fournies en ligne de commande ou
être changer par des options fournies en ligne de commande ou via via le fichier de configuration de Tux Paint. Voir le document "OPTIONS"
le fichier de configuration de Tux Paint. Voir le document pour les détails.
"OPTIONS" pour les détails.
Quelques exemples où "$HOME" est utilisé incluent : Quelques exemples où "$HOME" est utilisé incluent :
* L'emplacement du fichier de configuration de Tux Paint + L'emplacement du fichier de configuration de Tux Paint
* La base où Tux Paint sauvegarde et lit les dessins des + La base où Tux Paint sauvegarde et lit les dessins des utilisateurs
utilisateurs + L'endroit où se situent les fichiers privés d'un utilisateur (—
* L'endroit où se situent les fichiers privés d'un utilisateur tampons, pinceaux, etc, —) (par opposition aux fichiers accessibles à
(— tampons, pinceaux, etc, —) (par opposition aux fichiers tout le monde)
accessibles à tout le monde)
XDG_CONFIG_HOME XDG_CONFIG_HOME
Sur Linux et d'autres plateformes où les standards du XDG (X Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group)
Desktop Group) sont appliqués, c'est l'endroit où se trouvent les sont appliqués, c'est l'endroit où se trouvent les fichiers de
fichiers de configuration de l'utilisateur. Plus précisément, configuration de l'utilisateur. Plus précisément, c'est où trouver
c'est où trouver "user-dirs.dirs", où le "XDG_PICTURES_DIR" "user-dirs.dirs", où le "XDG_PICTURES_DIR" devrait être défini. Il est
devrait être défini. Il est utilisé pour exporter les dessins et utilisé pour exporter les dessins et GIF animés. En général, il est égal à
GIF animés. En général, il est égal à quelque chose comme quelque chose comme "$HOME/Pictures/". S'il n'est pas spécifié, Tux Paint
"$HOME/Pictures/". S'il n'est pas spécifié, Tux Paint vérifie le vérifie le répertoire "$HOME/.config/". Si la configuration ne peut être
répertoire "$HOME/.config/". Si la configuration ne peut être trouvée, Tux Paint exporte simplement les dessins et GIF animés vers
trouvée, Tux Paint exporte simplement les dessins et GIF animés "$HOME".
vers "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
Sur Linux et d'autres plateformes où les standards du XDG (X Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group)
Desktop Group) sont appliqués, c'est l'endroit où se trouvent les sont appliqués, c'est l'endroit où se trouvent les fichiers de données de
fichiers de données de l'utilisateur. Plus précisément, c'est où l'utilisateur. Plus précisément, c'est où trouver le répertoire "Trash". Il
trouver le répertoire "Trash". Il est utilisé quand on supprime est utilisé quand on supprime des images à partir de la boîte de dialogue
des images à partir de la boîte de dialogue "Ouvrir". Si ce n'est "Ouvrir". Si ce n'est pas défini, le répertoire "$HOME/.local/share/Trash/"
pas défini, le répertoire "$HOME/.local/share/Trash/" est utilisé, est utilisé, s'il existe. Sinon, les images sont simplement supprimées,
s'il existe. Sinon, les images sont simplement supprimées, plutôt plutôt que déplacées quelque part.
que déplacées quelque part.
TEMP TEMP
Spécifie l'endroit où les fichiers temporaires peuvent être créés. Spécifie l'endroit où les fichiers temporaires peuvent être créés. Tux
Tux Paint l'utilise seulement sous Microsoft Windows. Utilise Paint l'utilise seulement sous Microsoft Windows. Utilise "userdata" si non
"userdata" si non spécifié. spécifié.
Variables d'environnement relatives aux langues Variables d'environnement relatives aux langues
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Spécifie la langue utilisée par Tux Paint sur l'interface Spécifie la langue utilisée par Tux Paint sur l'interface utilisateur.
utilisateur. Remplacé par les options en ligne de commande Remplacé par les options en ligne de commande "--lang" et --locale, ou bien
"--lang" et --locale, ou bien leurs équivalents dans le fichier de leurs équivalents dans le fichier de configuration. La variable
configuration. La variable d'environnement "LANGUAGE" est utilisée d'environnement "LANGUAGE" est utilisée (si elle est activée. Sinon,
(si elle est activée. Sinon, "LC_ALL' est utilisé comme solution "LC_ALL' est utilisé comme solution de repli. Puis "LC_MESSAGES" et enfin
de repli. Puis "LC_MESSAGES" et enfin "LANG". "LANG".
Variables d'environnement en rapport avec l'affichage Variables d'environnement en rapport avec l'affichage
Ce qui suit donne quelques variables d'environnement supportées par Simple Ce qui suit donne quelques variables d'environnement supportées par Simple
DirectMedia Layer (libSDL) — que Tux Paint utilise pour l'affichage des DirectMedia Layer (libSDL) — que Tux Paint utilise pour l'affichage des
dessins, pour jouer des sons et traiter les saisies de la souris, du dessins, pour jouer des sons et traiter les saisies de la souris, du clavier et
clavier et du joystick — et qui peuvent être utiles aux utilisateurs de du joystick — et qui peuvent être utiles aux utilisateurs de Tux Paint.
Tux Paint.
SDL_VIDEO_ALLOW_SCREENSAVER SDL_VIDEO_ALLOW_SCREENSAVER
Spécifie si Tux Paint autorise l'utilisation d'un économiseur Spécifie si Tux Paint autorise l'utilisation d'un économiseur d'écran. Peut
d'écran. Peut être mis à '1' (vrai) par Tux Paint lui-même avec être mis à '1' (vrai) par Tux Paint lui-même avec l'option en ligne de
l'option en ligne de commande "--allowscreensaver" ou dans son commande "--allowscreensaver" ou dans son fichier de configuration.
fichier de configuration.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -11,19 +11,18 @@
PNG veut dire Portable Network Portable (format graphique portable pour PNG veut dire Portable Network Portable (format graphique portable pour
réseau). C'est un standard ouvert, qui n'est pas sous le poids des brevets réseau). C'est un standard ouvert, qui n'est pas sous le poids des brevets
(comme les GIF). C'est un format hautement compressé (mais pas "avec (comme les GIF). C'est un format hautement compressé (mais pas "avec perte"
perte" comme les JPEG - la perte permet aux fichiers d'être plus petit, comme les JPEG - la perte permet aux fichiers d'être plus petit, mais introduit
mais introduit des "erreurs" dans l'image lors de l'enregistrement), et des "erreurs" dans l'image lors de l'enregistrement), et prend en charge la
prend en charge la couleur 24 bits (16,7 millions de couleurs) ainsi qu'un couleur 24 bits (16,7 millions de couleurs) ainsi qu'un "canal alpha",
"canal alpha", c'est-à-dire que chaque pixel peut avoir un degré variable c'est-à-dire que chaque pixel peut avoir un degré variable de transparence.
de transparence.
Pour plus d'informations, voir : http://www.libpng.org/ Pour plus d'informations, voir : http://www.libpng.org/
Ces fonctionnalités (format ouvert, pas de perte, compression, Ces fonctionnalités (format ouvert, pas de perte, compression, transparence/
transparence/alpha) en font le meileur choix pour Tux Paint (La prise en alpha) en font le meileur choix pour Tux Paint (La prise en charge du format
charge du format PNG par Tux Paint vient de la bibliothèque Open Source PNG par Tux Paint vient de la bibliothèque Open Source SDL_Image, qui à son
SDL_Image, qui à son tour l'a obtenue de la bibliothèque libPNG.) tour l'a obtenue de la bibliothèque libPNG.)
La prise en charge de nombreuses couleurs permet aux images "tampons de La prise en charge de nombreuses couleurs permet aux images "tampons de
caoutchouc" de qualité photo d'être utilisable dans Tux Paint, et la caoutchouc" de qualité photo d'être utilisable dans Tux Paint, et la
@ -36,58 +35,62 @@ Comment créer des PNG
GIMP & Krita GIMP & Krita
D'excellents outils pour créer des images PNG utilisables dans Tux D'excellents outils pour créer des images PNG utilisables dans Tux Paint
Paint sont Gimp et Krita, tous deux programmes interactifs de sont Gimp et Krita, tous deux programmes interactifs de dessin et d'édition
dessin et d'édition de photos Open Source et de grande qualité. de photos Open Source et de grande qualité.
Un des deux, ou les deux, sont probablement déjà installés sur votre
système Linux. Sinon, ils sont certainement disponibles depuis le site de
téléchargement de votre distribution. Sinon, ou pour en apprendre plus,
visitez respectivement http://www.gimp.org/ et http://www.krita.org/.
Un des deux, ou les deux, sont probablement déjà installés sur
votre système Linux. Sinon, ils sont certainement disponibles
depuis le site de téléchargement de votre distribution. Sinon, ou
pour en apprendre plus, visitez respectivement
http://www.gimp.org/ et http://www.krita.org/.
Outils en ligne de commande Outils en ligne de commande
NetPBM NetPBM
Les outils Bitmap portables (appelés généralement Les outils Bitmap portables (appelés généralement «NetPBM») sont une
«NetPBM») sont une collection d'outils de ligne de collection d'outils de ligne de commande Open Source qui convertissent
commande Open Source qui convertissent vers et depuis vers et depuis différents formats tels que GIF, TIFF, BMP, PNG et
différents formats tels que GIF, TIFF, BMP, PNG et
beaucoup d'autres. beaucoup d'autres.
Ils sont probablement déjà installés sur votre Ils sont probablement déjà installés sur votre système. Sinon, ils sont
système. Sinon, ils sont certainement disponibles certainement disponibles depuis le site de téléchargement de votre
depuis le site de téléchargement de votre distribution Linux. Sinon, ou pour en apprendre plus, visitez http://
distribution Linux. Sinon, ou pour en apprendre plus, netpbm.sourceforge.net/.
visitez http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
Les programmes en ligne de commande "cjpeg" et Les programmes en ligne de commande "cjpeg" et "djpeg" font la
"djpeg" font la conversion entre le format PNM conversion entre le format PNM (Portable Any Map) de NetPBM et les
(Portable Any Map) de NetPBM et les JPEG. Ils sont JPEG. Ils sont probablement déjà installés sur votre système. Sinon,
probablement déjà installés sur votre système. Sinon, ils sont certainement disponibles depuis le site de téléchargement de
ils sont certainement disponibles depuis le site de votre distribution Linux. Sinon, ou pour en apprendre plus, visitez
téléchargement de votre distribution Linux. Sinon, ou
pour en apprendre plus, visitez
https://jpegclub.org/. https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Utilisateurs de Macintosh Utilisateurs de Macintosh
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -7,50 +7,53 @@
juin 4, 2022 juin 4, 2022
Tux Paint répond aux signaux suivants (qui peuvent être envoyé au Tux Paint répond aux signaux suivants (qui peuvent être envoyé au processus du
processus du programme via `kill` ou`killall`, par exemple). programme via `kill` ou`killall`, par exemple).
SIGTERM (également, [Control] + [C] depuis un terminal exécutant SIGTERM (également, [Control] + [C] depuis un terminal exécutant 'tuxpaint')
'tuxpaint')
Tux Paint répond comme si le bouton "Quitter" était enfoncé, ou Tux Paint répond comme si le bouton "Quitter" était enfoncé, ou
l'environnement de bureau a été invité à fermer Tux Paint (par l'environnement de bureau a été invité à fermer Tux Paint (par exemple, en
exemple, en cliquant sur un bouton de fermeture de fenêtre, ou en cliquant sur un bouton de fermeture de fenêtre, ou en appuyant sur [Alt] +
appuyant sur [Alt] + [F4] sur la plupart des systèmes). [F4] sur la plupart des systèmes).
Depuis l'interface principale, Tux Paint vous demandera si vous Depuis l'interface principale, Tux Paint vous demandera si vous souhaitez
souhaitez quitter ou non, et (sauf si remplacé par l'option quitter ou non, et (sauf si remplacé par l'option autosave, par ex.
autosave, par ex. "--autosave") si vous souhaitez enregistrer le "--autosave") si vous souhaitez enregistrer le dessin courant (s'il n'est
dessin courant (s'il n'est pas enregistré), et si c'est le cas, et pas enregistré), et si c'est le cas, et c'est une version modifiée d'un
c'est une version modifiée d'un dessin existant (sauf si remplacé dessin existant (sauf si remplacé par les options pour écraser les images
par les options pour écraser les images anciennes, ou bien anciennes, ou bien sauvegarder avec un nouveau nom (par ex. "--saveover" ou
sauvegarder avec un nouveau nom (par ex. "--saveover" ou
"--saveovernew") vers un nouveau fichier. "--saveovernew") vers un nouveau fichier.
Exemple: killall tuxpaint Exemple: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint répond en définissant son option "autosave" (comme si Tux Paint répond en définissant son option "autosave" (comme si cela avait
cela avait été lancé avec "--autosave"), aussi bien que l'option été lancé avec "--autosave"), aussi bien que l'option pour toujours
pour toujours sauvegarder de nouvelles images (comme si c'était sauvegarder de nouvelles images (comme si c'était lancé avec
lancé avec "--saveovernew"), dans le cas de la réception d'un "--saveovernew"), dans le cas de la réception d'un signal SIGUSR1, ou bien
signal SIGUSR1, ou bien d'écraser les images existantes (comme si d'écraser les images existantes (comme si cela avait lancé avec
cela avait lancé avec "--saveover") dans le cas où on recevait "--saveover") dans le cas où on recevait SIGUSR2. Alors Tux Paint envoie à
SIGUSR2. Alors Tux Paint envoie à lui-même le signal SIGTERM, pour lui-même le signal SIGTERM, pour une tentative de quitter (Voir ci-dessus.)
une tentative de quitter (Voir ci-dessus.)
Ainsi, à partir de l'interface principale, Tux Paint devrait se Ainsi, à partir de l'interface principale, Tux Paint devrait se fermer
fermer presque immédiatement, sans poser de questions. presque immédiatement, sans poser de questions.
Exemple: killall -s SIGUSR1 tuxpaint Exemple: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -9,29 +9,30 @@
À propos de SVG À propos de SVG
SVG (Scalable Vector Graphics) est un standard ouvert utilisé pour décrire SVG (Scalable Vector Graphics) est un standard ouvert utilisé pour décrire des
des graphiques vectoriels en deux dimensions. C'est parfait pour les graphiques vectoriels en deux dimensions. C'est parfait pour les diagrammes et
diagrammes et les formes, tandis que les PNG sont meilleurs pour les les formes, tandis que les PNG sont meilleurs pour les photographies. Les
photographies. Les fichiers SVG sont un peu comme des instructions sur la fichiers SVG sont un peu comme des instructions sur la façon de créer une
façon de créer une image. Cela signifie qu'ils peuvent être redimensionnés image. Cela signifie qu'ils peuvent être redimensionnés sans paraître pixélisés
sans paraître pixélisés ou avec des blocs. ou avec des blocs.
Pour plus d'informations, voir : https://www.w3.org/Graphics/SVG/ Pour plus d'informations, voir : https://www.w3.org/Graphics/SVG/
Comment fabriquer des SVG Comment fabriquer des SVG
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -14,18 +14,18 @@ Tools (Drawing)
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right. * Choose a stamp on the right.
* Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the
the bottom right. bottom right.
* Some stamps allow you to choose their color (see "Colors"). * Some stamps allow you to choose their color (see "Colors").
* Change stamp size with the bars 📶 at the bottom right. * Change stamp size with the bars 📶 at the bottom right.
* Rotation ⟳ may be enabled, if desired. * Rotation ⟳ may be enabled, if desired.
* Click/tap in the canvas to place a stamp. * Click/tap in the canvas to place a stamp.
* If rotation is enabled, drag to rotate it, and click/tap again to + If rotation is enabled, drag to rotate it, and click/tap again to add
add it to the drawing. it to the drawing.
* Some stamps play sound effects; press the speaker 🕪 button to hear it * Some stamps play sound effects; press the speaker 🕪 button to hear it
again. again.
* Some stamps play descriptive sounds; press the headphones 🎧 button to * Some stamps play descriptive sounds; press the headphones 🎧 button to hear
hear it again. it again.
⚟Lignes ⚟Lignes
@ -35,71 +35,68 @@ Tools (Drawing)
⭓Formes ⭓Formes
* Choose a shape on the right. * Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a * Select whether you want to extend the shape from the center ⧈, or a corner
corner ◰, using controls at the bottom right. ◰, using controls at the bottom right.
* Click/tap to position, and drag to set the size of the shape. * 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. * Drag to rotate it, and click/tap again to add it to the drawing.
🄰Texte 🄰Texte
* Choose a font on the right. * Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
controls near the bottom right. near the bottom right.
* Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom
right. right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap the canvas to position an insertion cursor. * Click/tap the canvas to position an insertion cursor.
* Enter text via your keyboard or the on-screen keyboard. * Enter text via your keyboard or the on-screen keyboard.
* Click/tap the canvas again if you wish to reposition the text. * Click/tap the canvas again if you wish to reposition the text.
* Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing * Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing and
and begin entering more text one line down. begin entering more text one line down.
* Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and
continue entering more text immediately to the right. continue entering more text immediately to the right.
* Using the on-screen keyboard: * Using the on-screen keyboard:
* "Cmp" can be used to compose characters, e.g. Cmp ' a results in + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á.
á. + "AltGr" can be used to quickly access more characters.
* "AltGr" can be used to quickly access more characters. + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
* Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs.
"ABC")
🅰Étiquette 🅰Étiquette
* (See Text) * (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them, * Labels float 'above' the drawing; you cannot paint or stamp over them,
apply Magic effects, etc. apply Magic effects, etc.
* Labels may be edited, repositioned, and styled after they've been * Labels may be edited, repositioned, and styled after they've been added to
added to the drawing. the drawing.
* Click/tap the ☝ button near the lower right to choose a label. * Click/tap the ☝ button near the lower right to choose a label. Click/tap
Click/tap the label you wish to modify, then click/tap somewhere else the label you wish to modify, then click/tap somewhere else in the canvas
in the canvas to reposition, or change the font/style, change color, to reposition, or change the font/style, change color, and/or type to edit
and/or type to edit the text. the text.
* Or, use the 🖑 button near the lower right to "flatten" a label, * Or, use the 🖑 button near the lower right to "flatten" a label, applying it
applying it to the canvas; it may no longer be edited with the Label to the canvas; it may no longer be edited with the Label tool.
tool.
🪣Fill 🪣Fill
* Choose a fill mode on the right. * Choose a fill mode on the right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap (and drag, with Brush and Linear modes) to fill an area of * Click/tap (and drag, with Brush and Linear modes) to fill an area of the
the picture with a color. picture with a color.
* Solid - Flood-fills an area with a solid color + Solid - Flood-fills an area with a solid color
* Brush - Paints with a solid color, without drawing outside the + Brush - Paints with a solid color, without drawing outside the chosen
chosen area area
* Linear - Fills the area with a linear gradient (drag to choose + Linear - Fills the area with a linear gradient (drag to choose angle
angle and gradient) and gradient)
* Radial - Fills the area with a radial gradient, centered where + Radial - Fills the area with a radial gradient, centered where you
you clicked/tapped clicked/tapped
* Shaped - Fills the area with a gradient that follows the contours + Shaped - Fills the area with a gradient that follows the contours of
of the area being filled the area being filled
🪄Magie 🪄Magie
* Choose a magic tool on the right. * Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Some magic tools draw or apply effects via click/tap and drag 〰🪄, some * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some
affect the entire drawing 🖻🪄, and some offer both options; use the affect the entire drawing 🖻🪄, and some offer both options; use the controls
controls at the bottom right. at the bottom right.
* Some magic tools offer various sizes; change it with the bars 📶 at the * Some magic tools offer various sizes; change it with the bars 📶 at the
bottom right. bottom right.
* Some magic tools allow you to choose their color. * Some magic tools allow you to choose their color.
@ -117,8 +114,8 @@ Tools (Drawing)
◪Gomme ◪Gomme
* Choose the size and shape of the eraser on the right. * Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or * Click/tap and drag to erase parts of the picture (solid color, or starter
starter or template image). or template image).
* Shortcut: [X] and click/tap in the drawing (not always available) * Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls) Tools (Controls)
@ -126,11 +123,10 @@ Tools (Controls)
🗏Nouveau 🗏Nouveau
* Choose a solid color, starter, or template image to start with. * Choose a solid color, starter, or template image to start with.
* Starters allow drawing "under" a picture (e.g., a coloring book + Starters allow drawing "under" a picture (e.g., a coloring book
outline), sometimes with a background layer, too. outline), sometimes with a background layer, too.
* Templates are pictures to start with (background only). + Templates are pictures to start with (background only).
* Eraser tool ◪ reveals the solid color, or starter/template + Eraser tool ◪ reveals the solid color, or starter/template background.
background.
* Click/tap "🕮⮫Open" to begin a new drawing. * Click/tap "🕮⮫Open" to begin a new drawing.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Ctrl]+[N] * Shortcut: [Ctrl]+[N]
@ -141,32 +137,31 @@ Tools (Controls)
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
* Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures"
folder. folder.
* Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin.
Bin.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Click/tap "📽Slides" to switch to slideshow mode: * Click/tap "📽Slides" to switch to slideshow mode:
* Click/tap two or more of your previously-saved drawings, in the + Click/tap two or more of your previously-saved drawings, in the order
order you want them shown. Numbers will appear on them. you want them shown. Numbers will appear on them.
* Choose the playback speed using the bars 📶 near the lower left. + Choose the playback speed using the bars 📶 near the lower left.
* Click/tap "⯈Play" to watch the slideshow/animation. + Click/tap "⯈Play" to watch the slideshow/animation.
* Or, click/tap "🎞GIF Export" to save an animated GIF of the + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to
animation to your system's "Pictures" folder. your system's "Pictures" folder.
* Click/tap "⤺Back" to return to the Open dialog. + Click/tap "⤺Back" to return to the Open dialog.
* Shortcut: [Ctrl]+[O] * Shortcut: [Ctrl]+[O]
🕮⮪Sauvegarder 🕮⮪Sauvegarder
* Click/tap to save your drawing. * Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite * If you've saved previously, you'll be prompted whether to overwrite the
the previously-saved drawing (a la "File→Save") or create a new saved previously-saved drawing (a la "File→Save") or create a new saved drawing
drawing (a la "File→Save As...") (a la "File→Save As...")
* Shortcut: [Ctrl]+[S] * Shortcut: [Ctrl]+[S]
🖶Print 🖶Print
* Click/tap to print your drawing. * Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
dialog, if available. if available.
* Shortcut: [Ctrl]+[P] * Shortcut: [Ctrl]+[P]
🗙Quit 🗙Quit
@ -176,28 +171,27 @@ Tools (Controls)
Colors Colors
* Click/tap to choose a color to use with the Paint, Lines, and Shapes * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
tools, and Stamps and Magic tools that support colors. and Stamps and Magic tools that support colors.
* Use the pipette / color picker 💉 button to choose a color from a pixel * Use the pipette / color picker 💉 button to choose a color from a pixel in
in your current drawing. your current drawing.
* Shortcut: When colors are available, press [Ctrl] and click/tap + Shortcut: When colors are available, press [Ctrl] and click/tap in your
in your drawing, to quickly pick a color from your drawing. drawing, to quickly pick a color from your drawing.
* Click/tap the rainbow 🌈 button to choose a arbitrary color. * Click/tap the rainbow 🌈 button to choose a arbitrary color.
* Click/tap in the rainbow square to pick a color (hue and + Click/tap in the rainbow square to pick a color (hue and saturation).
saturation). + Click/tap in the grey gradient bar to adjust brightness (value).
* Click/tap in the grey gradient bar to adjust brightness (value). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Click/tap "⤺Back" to abort and dismiss the palette.
* Click/tap "⤺Back" to abort and dismiss the palette. + You may grab the currently-chosen built-in color (if any), the color in
* You may grab the currently-chosen built-in color (if any), the the pipette / color picker, or the color in the color mixer, by
color in the pipette / color picker, or the color in the color clicking one of the colored arrow ⇫ buttons.
mixer, by clicking one of the colored arrow ⇫ buttons. * Click/tap the paint palette 🎨 button to create a color by mixing primary
* Click/tap the paint palette 🎨 button to create a color by mixing colors: red, yellow, and blue, and white (tint), grey (tone), and black
primary colors: red, yellow, and blue, and white (tint), grey (tone), (shade).
and black (shade). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Color mixing offers its own 🖓Undo and 🖒Redo options.
* Color mixing offers its own 🖓Undo and 🖒Redo options. + Click/tap "🗑Clear" to start over with no mixed colors.
* Click/tap "🗑Clear" to start over with no mixed colors. + Click/tap "⤺Back" to abort and dismiss the color mixer.
* Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing: Shortcuts while drawing:
@ -213,3 +207,4 @@ Shortcuts while drawing:
* [Esc] - ⤺Back or 🗙Quit * [Esc] - ⤺Back or 🗙Quit
Last updated: mai 9, 2023 Last updated: mai 9, 2023

View file

@ -6,8 +6,7 @@
4 de Xuño de 2022 4 de Xuño de 2022
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+-------------------------------------------+ +-------------------------------------------+
| Índice | | Índice |
|-------------------------------------------| |-------------------------------------------|
@ -17,26 +16,24 @@
| * Substituír a franxa e os píxeles lixo | | * Substituír a franxa e os píxeles lixo |
| * Gardar a imaxe para Tux Paint | | * Gardar a imaxe para Tux Paint |
+-------------------------------------------+ +-------------------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
Sobre este «Como facelo» Sobre este «Como facelo»
Este «Como facelo» supón que quere facer un excelente selo de Tux Paint, Este «Como facelo» supón que quere facer un excelente selo de Tux Paint, en
en formato PNG con mapa de bits, a partir dunha imaxe JPEG (p. ex.: unha formato PNG con mapa de bits, a partir dunha imaxe JPEG (p. ex.: unha
fotografía dixital). Hai métodos máis sinxelos e rápidos que producen fotografía dixital). Hai métodos máis sinxelos e rápidos que producen unha
unha calidade inferior. calidade inferior.
Este «Como facelo» supón que está a tratar con obxectos opacos normais. Este «Como facelo» supón que está a tratar con obxectos opacos normais. O
O tratamento de obxectos semitransparentes (lume, ventilador en tratamento de obxectos semitransparentes (lume, ventilador en movemento,
movemento, globo infantil) ou obxectos que dan luz (lume, bombilla, sol) globo infantil) ou obxectos que dan luz (lume, bombilla, sol) faise mellor
faise mellor cun software personalizado. As imaxes con fondos de cor cun software personalizado. As imaxes con fondos de cor sólida perfectos
sólida perfectos tamén se fan mellor con software personalizado, pero tamén se fan mellor con software personalizado, pero non son difíciles de
non son difíciles de facer do seguinte xeito. facer do seguinte xeito.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
A elección da imaxe é crucial A elección da imaxe é crucial
@ -44,9 +41,9 @@ A elección da imaxe é crucial
Se quere enviar ilustracións aos desenvolvedores de Tux Paint para a Se quere enviar ilustracións aos desenvolvedores de Tux Paint para a
súa inclusión no proxecto oficial, ou se quere publicar a súa propia súa inclusión no proxecto oficial, ou se quere publicar a súa propia
copia de Tux Paint, xunto cos seus propios gráficos, precisa unha copia de Tux Paint, xunto cos seus propios gráficos, precisa unha imaxe
imaxe que sexa compatíbel coa Licenza Pública Xeral GNU empregada por que sexa compatíbel coa Licenza Pública Xeral GNU empregada por Tux
Tux Paint. Paint.
As imaxes producidas polo goberno dos Estados Unidos son de dominio As imaxes producidas polo goberno dos Estados Unidos son de dominio
público, pero teña en conta que o goberno dos Estados Unidos ás veces público, pero teña en conta que o goberno dos Estados Unidos ás veces
@ -73,48 +70,45 @@ A elección da imaxe é crucial
Rotar unha imaxe pode facela borrosa, especialmente se só rota uns Rotar unha imaxe pode facela borrosa, especialmente se só rota uns
graos. As imaxes que non precisan rotación son as mellores, as imaxes graos. As imaxes que non precisan rotación son as mellores, as imaxes
que precisan moita rotación (30 a 60 graos) son as seguintes mellores que precisan moita rotación (30 a 60 graos) son as seguintes mellores e
e as que precisan uns poucos graos as peores. A rotación tamén fará as que precisan uns poucos graos as peores. A rotación tamén fará que a
que a imaxe sexa máis escura porque a maioría do software de edición imaxe sexa máis escura porque a maioría do software de edición de
de imaxes é moi malo na manipulación da gamma. (A rotación só é imaxes é moi malo na manipulación da gamma. (A rotación só é lexítima
lexítima para imaxes gamma = 1,0.) para imaxes gamma = 1,0.)
As imaxes moi grandes son máis indulxentes cos erros e, polo tanto, As imaxes moi grandes son máis indulxentes cos erros e, polo tanto, son
son máis doadas de traballar. Escolla unha imaxe cun obxecto de máis máis doadas de traballar. Escolla unha imaxe cun obxecto de máis de
de 1000 píxeles se pode. Pode reducilo máis tarde para agochar os seus 1000 píxeles se pode. Pode reducilo máis tarde para agochar os seus
erros. erros.
Asegúrese de que a imaxe non está demasiado granulada, tenue ou Asegúrese de que a imaxe non está demasiado granulada, tenue ou lavada.
lavada.
Preste atención aos pés e ás rodas. Se están enterrados en algo, terá Preste atención aos pés e ás rodas. Se están enterrados en algo, terá
que debuxar outros novos. Se só un está enterrado, pode que poida que debuxar outros novos. Se só un está enterrado, pode que poida
copiar o outro como substituto. copiar o outro como substituto.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Preparar a imaxe Preparar a imaxe
Primeiro de todo, asegúrese de evitar gardar de novo a imaxe como JPEG. Primeiro de todo, asegúrese de evitar gardar de novo a imaxe como JPEG.
Isto provoca unha perda de calidade. Hai unha ferramenta especial Isto provoca unha perda de calidade. Hai unha ferramenta especial chamada
chamada jpegtran que permite recortar unha imaxe sen perder a calidade jpegtran que permite recortar unha imaxe sen perder a calidade normal.
normal.
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
Cargue esa imaxe para o seu editor de imaxes. Se aínda non a cortou, Cargue esa imaxe para o seu editor de imaxes. Se aínda non a cortou, pode
pode que o seu editor de imaxes sexa moi lento. Rote e recorte a imaxe que o seu editor de imaxes sexa moi lento. Rote e recorte a imaxe segundo
segundo sexa necesario. Garde a imaxe, escolla o formato nativo que sexa necesario. Garde a imaxe, escolla o formato nativo que admita capas,
admita capas, máscaras, alfa, etc. Os usuarios de GIMP deberían escoller máscaras, alfa, etc. Os usuarios de GIMP deberían escoller «XCF» e os
«XCF» e os usuarios de Adobe Photoshop debería escoller «PSD», por usuarios de Adobe Photoshop debería escoller «PSD», por exemplo.
exemplo.
Se rotou ou recortou a imaxe no seu editor de imaxes, aplánea agora. Se rotou ou recortou a imaxe no seu editor de imaxes, aplánea agora. Debe
Debe ter só unha capa RGB sen máscara nin alfa. ter só unha capa RGB sen máscara nin alfa.
Abra o cadro de diálogo de capas. Replique a capa varias veces. De Abra o cadro de diálogo de capas. Replique a capa varias veces. De arriba
arriba abaixo necesitará algo así: abaixo necesitará algo así:
1. imaxe sen modificar (protexa isto contra escritura se pode) 1. imaxe sen modificar (protexa isto contra escritura se pode)
2. unha imaxe que modificar: a capa de «traballo en ptoceso» 2. unha imaxe que modificar: a capa de «traballo en ptoceso»
@ -122,76 +116,76 @@ Preparar a imaxe
4. maxenta sólido (protexa isto contra escritura se pode) 4. maxenta sólido (protexa isto contra escritura se pode)
5. imaxe sen modificar (protexa isto contra escritura se pode) 5. imaxe sen modificar (protexa isto contra escritura se pode)
Delle á capa Traballo en proceso (WIP — «work in progress» ) unha Delle á capa Traballo en proceso (WIP — «work in progress» ) unha máscara
máscara inicial aproximada. Pode comezar cunha selección ou empregando o inicial aproximada. Pode comezar cunha selección ou empregando o valor de
valor de escala de grises da capa WIP. Pode inverter a máscara. escala de grises da capa WIP. Pode inverter a máscara.
Advertencia: unha vez que teña a máscara, non pode rotar nin escalar a Advertencia: unha vez que teña a máscara, non pode rotar nin escalar a
imaxe normalmente. Isto provocaría a perda de datos. Máis adiante se lle imaxe normalmente. Isto provocaría a perda de datos. Máis adiante se lle
darán instrucións especiais de escalado. darán instrucións especiais de escalado.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Preparar a máscara Preparar a máscara
Acostúmese a facer [Control]-premer e [Alt]-premer nas imaxes en Acostúmese a facer [Control]-premer e [Alt]-premer nas imaxes en miniatura
miniatura no diálogo de capas. Necesitará isto para controlar o que está no diálogo de capas. Necesitará isto para controlar o que está a ver e o
a ver e o que está a editar. Ás veces estará editando cousas que non que está a editar. Ás veces estará editando cousas que non pode ver. Por
pode ver. Por exemplo, pode editar a máscara da capa WIP mentres mira a exemplo, pode editar a máscara da capa WIP mentres mira a imaxe sen
imaxe sen modificar. Preste atención para non meter a pata. Verifica modificar. Preste atención para non meter a pata. Verifica sempre que está
sempre que está a editar o correcto. a editar o correcto.
Estabeleza unha imaxe sen modificar como a que vai ver (a superior é a Estabeleza unha imaxe sen modificar como a que vai ver (a superior é a máis
máis doada). Estabeleza a máscara WIP como o que vai editar. Nalgún doada). Estabeleza a máscara WIP como o que vai editar. Nalgún momento,
momento, quizais non de inmediato, debería aumentar a imaxe ata quizais non de inmediato, debería aumentar a imaxe ata aproximadamente o
aproximadamente o 400% (cada píxel da imaxe vese e edítase como un 400% (cada píxel da imaxe vese e edítase como un bloque de píxeles 4x4 na
bloque de píxeles 4x4 na súa pantalla). súa pantalla).
Seleccione partes da imaxe que deben ser 100% opacas ou 0% opacas. Se Seleccione partes da imaxe que deben ser 100% opacas ou 0% opacas. Se pode
pode seleccionar o obxecto ou o fondo con certa precisión por cor, seleccionar o obxecto ou o fondo con certa precisión por cor, fágao. Se é
fágao. Se é necesario para evitar seleccionar píxeles que deben ser necesario para evitar seleccionar píxeles que deben ser parcialmente opacos
parcialmente opacos (xeralmente no bordo do obxecto), debe aumentar, (xeralmente no bordo do obxecto), debe aumentar, diminuír e inverter a
diminuír e inverter a selección. selección.
Encha as áreas 100% opacas con branco e as áreas 0% opacas con negro. Encha as áreas 100% opacas con branco e as áreas 0% opacas con negro. Isto
Isto faise máis facilmente arrastrando e soltando dende o indicador de faise máis facilmente arrastrando e soltando dende o indicador de cor de
cor de primeiro plano/fondo. Non debería ver ocorrer nada porque está a primeiro plano/fondo. Non debería ver ocorrer nada porque está a ver a capa
ver a capa de imaxe sen modificar mentres edita a máscara da capa WIP. É de imaxe sen modificar mentres edita a máscara da capa WIP. É posíbel que
posíbel que se poidan notar grandes cambios na miniatura. se poidan notar grandes cambios na miniatura.
Agora debe ampliala. Agora debe ampliala.
Comprobe o seu traballo. Agoche a capa superior da imaxe sen modificar. Comprobe o seu traballo. Agoche a capa superior da imaxe sen modificar.
Amose só a máscara, que debería ser un obxecto branco sobre un fondo Amose só a máscara, que debería ser un obxecto branco sobre un fondo negro
negro (probabelmente cun gris sen editar no bordo). Agora amose (probabelmente cun gris sen editar no bordo). Agora amose normalmente a
normalmente a capa WIP para que a máscara estea activa. Isto debería capa WIP para que a máscara estea activa. Isto debería amosar o seu obxecto
amosar o seu obxecto sobre a seguinte capa máis alta activada, que sobre a seguinte capa máis alta activada, que debería ser verde ou maxenta
debería ser verde ou maxenta segundo sexa necesario para obter o máximo segundo sexa necesario para obter o máximo contraste. Quizais queira
contraste. Quizais queira alternar entre eses fondos premendo varias alternar entre eses fondos premendo varias veces para activar/desactivar a
veces para activar/desactivar a capa verde. Corrixa os problemas obvios capa verde. Corrixa os problemas obvios e sinxelos editando a máscara
e sinxelos editando a máscara mentres a ve. mentres a ve.
Volva ver a capa superior sen modificar mentres edita a máscara WIP. Volva ver a capa superior sen modificar mentres edita a máscara WIP.
Estabeleza a súa ferramenta de debuxo co pincel. Para o pincel, escolla Estabeleza a súa ferramenta de debuxo co pincel. Para o pincel, escolla un
un pequeno círculo difuso. O tamaño 5x5 é bo para a maioría dos usos. pequeno círculo difuso. O tamaño 5x5 é bo para a maioría dos usos.
Con man firme, faga un trazo arredor da imaxe. Use negro polo exterior e Con man firme, faga un trazo arredor da imaxe. Use negro polo exterior e
branco polo interior. Evite facer máis dun pase sen cambiar de cor (e, branco polo interior. Evite facer máis dun pase sen cambiar de cor (e, polo
polo tanto, de lado). tanto, de lado).
Vire un pouco as vistas, comprobando que a máscara funciona ben. Cando a Vire un pouco as vistas, comprobando que a máscara funciona ben. Cando a
capa WIP se compón sobre o verde ou o maxenta, debería ver un pouco do capa WIP se compón sobre o verde ou o maxenta, debería ver un pouco do
fondo orixinal como unha franxa fea ao redor do bordo. Se falta esta fondo orixinal como unha franxa fea ao redor do bordo. Se falta esta
franxa, fixo a máscara de obxectos demasiado pequena. A franxa consta de franxa, fixo a máscara de obxectos demasiado pequena. A franxa consta de
píxeles que non son nin 100% obxecto nin 0% obxecto. Para eles, a píxeles que non son nin 100% obxecto nin 0% obxecto. Para eles, a máscara
máscara non debería ser nin do 100% nin do 0%. A franxa retirase pronto. non debería ser nin do 100% nin do 0%. A franxa retirase pronto.
Ver e editar a máscara. Seleccione por cor, escollendo negro ou branco. Ver e editar a máscara. Seleccione por cor, escollendo negro ou branco. O
O máis probábel é que vexa pintas non seleccionadas que non son da cor máis probábel é que vexa pintas non seleccionadas que non son da cor
agardada. Inverta a selección e logo pínteas coa ferramenta de lapis. agardada. Inverta a selección e logo pínteas coa ferramenta de lapis. Faga
Faga esta operación tanto para branco como para negro. esta operación tanto para branco como para negro.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Substituír a franxa e os píxeles lixo Substituír a franxa e os píxeles lixo
@ -201,75 +195,72 @@ Substituír a franxa e os píxeles lixo
Agora desactive a máscara. Vexa e edite a capa WIP sen máscara. Usando a Agora desactive a máscara. Vexa e edite a capa WIP sen máscara. Usando a
ferramenta de selección de cores, escolla unha cor termo medio para o ferramenta de selección de cores, escolla unha cor termo medio para o
obxecto. Arrastre e solte esta cor na selección, eliminando así a obxecto. Arrastre e solte esta cor na selección, eliminando así a maioría
maioría dos píxeles que non son do obxecto. dos píxeles que non son do obxecto.
Esta cor sólida comprimirase ben e axudará a evitar franxas de cor feas Esta cor sólida comprimirase ben e axudará a evitar franxas de cor feas
cando Tux Paint reduza a imaxe. Se o bordo do obxecto ten varias cores cando Tux Paint reduza a imaxe. Se o bordo do obxecto ten varias cores moi
moi diferentes, debe dividir a selección para que poida colorar o fondo diferentes, debe dividir a selección para que poida colorar o fondo próximo
próximo para que sexa semellante. para que sexa semellante.
Agora pintará a franxa de bordo existente. Asegúrese de que está Agora pintará a franxa de bordo existente. Asegúrese de que está editando e
editando e vendo a imaxe WIP. Os cambios frecuentes na visibilidade das vendo a imaxe WIP. Os cambios frecuentes na visibilidade das capas
capas axudaranlle a ver o que fai. É probábel que empregue todos os: axudaranlle a ver o que fai. É probábel que empregue todos os:
* composto sobre verde (máscara activada) + composto sobre verde (máscara activada)
* composto sobre maxenta (máscara activada) + composto sobre maxenta (máscara activada)
* orixinal (a capa superior ou inferior) + orixinal (a capa superior ou inferior)
* composto sobre o orixinal (máscara activada) + composto sobre o orixinal (máscara activada)
* capa WIP en bruto (máscara desactivada) + capa WIP en bruto (máscara desactivada)
Para reducir os accidentes, pode que queira seleccionar só os píxeles Para reducir os accidentes, pode que queira seleccionar só os píxeles que
que non estean grises na máscara. (Seleccione por cor na máscara, non estean grises na máscara. (Seleccione por cor na máscara, escolla
escolla negro, engada o modo, escolla o branco, inverter. negro, engada o modo, escolla o branco, inverter. Alternativamente:
Alternativamente: seleccione todo, seleccione por cor da máscara, modo seleccione todo, seleccione por cor da máscara, modo de subtracción,
de subtracción, escolla o negro, escolla o branco.) Se fai isto, escolla o negro, escolla o branco.) Se fai isto, probabelmente queira
probabelmente queira expandir un pouco a selección e/ou agochar a expandir un pouco a selección e/ou agochar a ringleira de «formigas» que
ringleira de «formigas» que marca a selección. marca a selección.
Use a ferramenta de clonación e a de pincel. Varíe a opacidade segundo Use a ferramenta de clonación e a de pincel. Varíe a opacidade segundo sexa
sexa necesario. Empregue principalmente pinceis redondos pequenos, necesario. Empregue principalmente pinceis redondos pequenos, quizais 3x3
quizais 3x3 ou 5x5, difusos ou non. (Xeralmente é bo emparellar pinceis ou 5x5, difusos ou non. (Xeralmente é bo emparellar pinceis difusos cun
difusos cun 100% de opacidade e pinceis non difusos cun 70% de 100% de opacidade e pinceis non difusos cun 70% de opacidade.) Os modos de
opacidade.) Os modos de debuxo pouco comúns poden ser útiles con debuxo pouco comúns poden ser útiles con obxectos semitransparentes.
obxectos semitransparentes.
O obxectivo é eliminar a franxa do bordo, tanto dentro como fóra do O obxectivo é eliminar a franxa do bordo, tanto dentro como fóra do
obxecto. A franxa interior, visíbel cando o obxecto está composto sobre obxecto. A franxa interior, visíbel cando o obxecto está composto sobre
maxenta ou verde, debe eliminarse por razóns obvias. Tamén hai que maxenta ou verde, debe eliminarse por razóns obvias. Tamén hai que eliminar
eliminar a franxa exterior porque se fará visíbel cando a imaxe se a franxa exterior porque se fará visíbel cando a imaxe se reduza. Como
reduza. Como exemplo, considere unha rexión de 2x2 de píxeles no bordo exemplo, considere unha rexión de 2x2 de píxeles no bordo dun obxecto de
dun obxecto de bordos afiados. A metade esquerda é negra e 0% opaca. A bordos afiados. A metade esquerda é negra e 0% opaca. A metade dereita é
metade dereita é branca e 100% opaca. É dicir, temos un obxecto branco branca e 100% opaca. É dicir, temos un obxecto branco sobre fondo negro.
sobre fondo negro. Cando Tux Paint escala este ao 50% (unha área de 1x1 Cando Tux Paint escala este ao 50% (unha área de 1x1 píxeles), o resultado
píxeles), o resultado será un píxel gris opaco do 50%. O resultado será un píxel gris opaco do 50%. O resultado correcto sería un píxel branco
correcto sería un píxel branco ao 50% opaco. Para obter este resultado, ao 50% opaco. Para obter este resultado, pintaríamos os píxeles negros.
pintaríamos os píxeles negros. Estes iImportan, a pesar de ser 0% Estes iImportan, a pesar de ser 0% opacos.
opacos.
Tux Paint pode reducir a escala das imaxes nun factor moi grande, polo Tux Paint pode reducir a escala das imaxes nun factor moi grande, polo que
que é importante estender moito o bordo do obxecto cara a fóra. Xusto no é importante estender moito o bordo do obxecto cara a fóra. Xusto no bordo
bordo do obxecto, debe ser moi preciso respecto diso. A medida que se do obxecto, debe ser moi preciso respecto diso. A medida que se afasta do
afasta do o, pode ser un pouco desleixado. É razoábel pintar cara a fóra o, pode ser un pouco desleixado. É razoábel pintar cara a fóra unha ducia
unha ducia de píxeles ou máis. Canto máis lonxe vaia, máis pode Tux de píxeles ou máis. Canto máis lonxe vaia, máis pode Tux Paint reducir sen
Paint reducir sen crear franxas de cor feas. Para as áreas que están a crear franxas de cor feas. Para as áreas que están a máis duns poucos
máis duns poucos píxeles de distancia do bordo do obxecto, debería píxeles de distancia do bordo do obxecto, debería empregar a ferramenta de
empregar a ferramenta de lapis (ou seleccionar arrastrar e soltar cor) lapis (ou seleccionar arrastrar e soltar cor) para garantir que o resultado
para garantir que o resultado se comprime ben. se comprime ben.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Gardar a imaxe para Tux Paint Gardar a imaxe para Tux Paint
É moi doado esnaquizar un traballo arreo. Os editores de imaxes poden É moi doado esnaquizar un traballo arreo. Os editores de imaxes poden
esnaquizar silenciosamente píxeles en áreas 0% opacas. As condicións nas esnaquizar silenciosamente píxeles en áreas 0% opacas. As condicións nas
que isto ocorre poden variar dunha versión a outra. Se confía moito, que isto ocorre poden variar dunha versión a outra. Se confía moito, pode
pode tentar gardar a súa imaxe directamente como PNG. Asegúrese de vela tentar gardar a súa imaxe directamente como PNG. Asegúrese de vela de novo
de novo para verificar que as áreas 0% opacas non se volveron negras ou para verificar que as áreas 0% opacas non se volveron negras ou brancas, o
brancas, o que crearía franxas cando Tux Paint reduza a imaxe. Se que crearía franxas cando Tux Paint reduza a imaxe. Se precisa escalar a
precisa escalar a súa imaxe para aforrar espazo (e agochar os seus súa imaxe para aforrar espazo (e agochar os seus erros), é case seguro que
erros), é case seguro que destruirá todas as áreas 0% opacas. Velaquí destruirá todas as áreas 0% opacas. Velaquí unha mellor forma...
unha mellor forma...
Un xeito máis seguro de gardar Un xeito máis seguro de gardar
@ -292,16 +283,17 @@ Gardar a imaxe para Tux Paint
Volvendo á imaxe multicapa, agora seleccione a capa WIP. Como fixo coa Volvendo á imaxe multicapa, agora seleccione a capa WIP. Como fixo coa
máscara, arrastre isto dende o diálogo de capas ata a barra de máscara, arrastre isto dende o diálogo de capas ata a barra de
ferramentas. Debería obter unha imaxe dunha soa capa dos seus datos ferramentas. Debería obter unha imaxe dunha soa capa dos seus datos
WIP. Se tamén apareceu a máscara, desfágase dela. Debería ver o WIP. Se tamén apareceu a máscara, desfágase dela. Debería ver o obxecto
obxecto e o contorno pintado sen ningunha miniatura de máscara no e o contorno pintado sen ningunha miniatura de máscara no diálogo de
diálogo de capas. Se escalou a máscara, entón escale esta imaxe capas. Se escalou a máscara, entón escale esta imaxe exactamente do
exactamente do mesmo xeito. Garde esta imaxe como un ficheiro de mesmo xeito. Garde esta imaxe como un ficheiro de pixmap portátil
pixmap portátil NetPBM («.ppm»). (Nota: .ppm, non .pgm.) (Se escolle o NetPBM («.ppm»). (Nota: .ppm, non .pgm.) (Se escolle o formato RAW PPM,
formato RAW PPM, o segundo byte do ficheiro debería ser o díxito ASCII o segundo byte do ficheiro debería ser o díxito ASCII «6», o byte
«6», o byte hexadecimal 0x36.) hexadecimal 0x36.)
Agora cómpre fusionar os dous ficheiros nun só. Fagao coa orde Agora cómpre fusionar os dous ficheiros nun só. Fagao coa orde pnmtopng
pnmtopng, así: , así:
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,94 +7,100 @@
5 de Maio de 2023 5 de Maio de 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint comprende unha serie de variábeis de contorno, ben directamente Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou
ou indirectamente polas bibliotecas que emprega. indirectamente polas bibliotecas que emprega.
Variábeis de contorno relacionadas co almacenamento Variábeis de contorno relacionadas co almacenamento
HOME HOME
Especifica o «directorio persoal» do usuario, que se usa para Especifica o «directorio persoal» do usuario, que se usa para localizar
localizar outros ficheiros ou directorios. Nalgúns casos, úsase outros ficheiros ou directorios. Nalgúns casos, úsase como parte dunha
como parte dunha situación alternativa, cando non se configuran situación alternativa, cando non se configuran outras variábeis de contorno
outras variábeis de contorno (noutros lugares desta (noutros lugares desta documentación). Ás veces, a localización a empregar
documentación). Ás veces, a localización a empregar pode ser pode ser anulada polas opcións fornecidas na liña de ordes ou a través do
anulada polas opcións fornecidas na liña de ordes ou a través do ficheiro de configuración de Tux Paint. Consulte a documentación de
ficheiro de configuración de Tux Paint. Consulte a documentación «OPCIÓNS» (OPTIONS) para máis detalles.
de «OPCIÓNS» (OPTIONS) para máis detalles.
Algúns exemplos de onde se usa «$HOME» inclúen: Algúns exemplos de onde se usa «$HOME» inclúen:
* A localización do ficheiro de configuración de Tux Paint + A localización do ficheiro de configuración de Tux Paint
* A base de onde Tux Paint garda e carga os debuxos dos + A base de onde Tux Paint garda e carga os debuxos dos usuarios
usuarios + A localización da colección privada de ficheiros de datos dun usuario —
* A localización da colección privada de ficheiros de datos dun selos, pinceis, etc. — (fronte aos dispoñíbeis no sistema)
usuario — selos, pinceis, etc. — (fronte aos dispoñíbeis no
sistema)
XDG_CONFIG_HOME XDG_CONFIG_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's configuration files. the location of the user's configuration files. Specifically, where to find
Specifically, where to find "user-dirs.dirs", where the "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used
"XDG_PICTURES_DIR" might be defined. It is used for exporting for exporting drawings and animated GIFs. Generally it's set to something
drawings and animated GIFs. Generally it's set to something like like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory
"$HOME/Pictures/". If not specified, Tux Paint checks in the "$HOME/.config/". If the configuration cannot be found, Tux Paint simply
directory "$HOME/.config/". If the configuration cannot be found, exports drawings and GIFs to "$HOME".
Tux Paint simply exports drawings and GIFs to "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's data directories. the location of the user's data directories. Specifically, where to find
Specifically, where to find the "Trash" directory. It is used when the "Trash" directory. It is used when deleting images from Tux Paint's
deleting images from Tux Paint's "Open" dialog. If not set, the "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is
location "$HOME/.local/share/Trash/" is used, if available. If used, if available. If not, images are simply deleted, rather than moved
not, images are simply deleted, rather than moved anywhere. anywhere.
TEMP TEMP
Especifica a localización onde se poden crear ficheiros temporais. Especifica a localización onde se poden crear ficheiros temporais. Só o usa
Só o usa Tux Paint nos sistemas operativos Microsoft Windows. Tux Paint nos sistemas operativos Microsoft Windows. Emprega «userdata» se
Emprega «userdata» se non se define. non se define.
Variábeis de contorno relacionadas co idioma Variábeis de contorno relacionadas co idioma
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Specify the language Tux Paint should utilize in its user Specify the language Tux Paint should utilize in its user interface.
interface. Overridde by the "--lang" and "--locale" command-line Overridde by the "--lang" and "--locale" command-line options or their
options or their configuration file counterparts. The "LANGUAGE" configuration file counterparts. The "LANGUAGE" environment variable is
environment variable is used, if set. If not, "LC_ALL" is used as used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES",
a fallback. Then "LC_MESSAGES", and finally "LANG". and finally "LANG".
Variábeisbles de contorno relacionadas co que se amosa Variábeisbles de contorno relacionadas co que se amosa
A seguir amósanse algunhas das variábeis de contorno compatíbeis con A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple
Simple DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar gráficos,
gráficos, reproducir sons e recibir entrada do rato, teclado e joystick — reproducir sons e recibir entrada do rato, teclado e joystick — e que poden ser
e que poden ser útiles para os usuarios de Tux Paint. útiles para os usuarios de Tux Paint.
SDL_VIDEO_ALLOW_SCREENSAVER SDL_VIDEO_ALLOW_SCREENSAVER
Especifica se Tux Paint debería permitir a execución dun protector Especifica se Tux Paint debería permitir a execución dun protector de
de pantalla. Pode ser definido como «1» (verdadeiro) polo propio pantalla. Pode ser definido como «1» (verdadeiro) polo propio Tux Paint
Tux Paint emitindo a opción de liña de ordes «--allowscreensaver» emitindo a opción de liña de ordes «--allowscreensaver» ou o seu equivaente
ou o seu equivaente no ficheiro de configuración. no ficheiro de configuración.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -10,23 +10,22 @@
Sobre os PNG Sobre os PNG
PNG é o formato de Gráficos de Rede Portátiles. É un estándar aberto, non PNG é o formato de Gráficos de Rede Portátiles. É un estándar aberto, non
lastrado polas patentes (como os GIF). É un formato moi comprimido (aínda lastrado polas patentes (como os GIF). É un formato moi comprimido (aínda que
que non é «con perda» como os JPEG: a perda permite que os ficheiros sexan non é «con perda» como os JPEG: a perda permite que os ficheiros sexan moito
moito máis pequenos, mais introduce «erros» na imaxe cando se gardan) e máis pequenos, mais introduce «erros» na imaxe cando se gardan) e admite cores
admite cores de 24 bits (16,7 millóns de cores), así como unha «canle de 24 bits (16,7 millóns de cores), así como unha «canle alfa» completo, é
alfa» completo, é dicir, cada píxel pode ter un grao de transparencia dicir, cada píxel pode ter un grao de transparencia variábel.
variábel.
Para obter máis información, visite:http://www.libpng.org/ Para obter máis información, visite:http://www.libpng.org/
Estas características (apertura, perda, compresión, transparencia/alfa) Estas características (apertura, perda, compresión, transparencia/alfa)
convérteno na mellor opción para Tux Paint. (A compatibilidade de Tux convérteno na mellor opción para Tux Paint. (A compatibilidade de Tux Paint co
Paint co formato PNG procede da biblioteca de código aberto SDL_Image, que formato PNG procede da biblioteca de código aberto SDL_Image, que á súa vez a
á súa vez a obtén da biblioteca libPNG.) obtén da biblioteca libPNG.)
A compatibilidade con moitas cores permite utilizar imaxes de «selo de A compatibilidade con moitas cores permite utilizar imaxes de «selo de caucho»
caucho» de calidade fotográfica en Tux Paint e a transparencia alfa de calidade fotográfica en Tux Paint e a transparencia alfa permite pinceis de
permite pinceis de alta calidade. alta calidade.
Como facer imaxes PNG Como facer imaxes PNG
@ -35,57 +34,60 @@ Como facer imaxes PNG
GIMP & Krita GIMP & Krita
GIMP e Krita son dúas excelentes ferramentas coas que crear imaxes GIMP e Krita son dúas excelentes ferramentas coas que crear imaxes PNG para
PNG para usar en Tux Paint , ambos son programas de debuxo usar en Tux Paint , ambos son programas de debuxo interactivo e edición de
interactivo e edición de fotos de código aberto de alta calidade. fotos de código aberto de alta calidade.
É probábel que un ou ambos xa estean instalados no seu sistema. Se non,
deberían estar dispoñíbeis no repositorio de software da súa distribución
Linux. Se non é así, ou para obter máis información, visite http://
www.gimp.org/ e http://www.krita.org/ respectivamente.
É probábel que un ou ambos xa estean instalados no seu sistema. Se
non, deberían estar dispoñíbeis no repositorio de software da súa
distribución Linux. Se non é así, ou para obter máis información,
visite http://www.gimp.org/ e http://www.krita.org/
respectivamente.
Ferramentas da liña de ordes Ferramentas da liña de ordes
NetPBM NetPBM
As ferramentas de Mapas de bits Portátil Portable As ferramentas de Mapas de bits Portátil Portable Bitmap (coñecidas
Bitmap (coñecidas colectivamente como «NetPBM») son colectivamente como «NetPBM») son unha colección de ferramentas de liña
unha colección de ferramentas de liña de ordes de de ordes de código aberto que converten a e dende varios formatos,
código aberto que converten a e dende varios incluíndo GIF, TIFF, BMP, PNG e moitos máis.
formatos, incluíndo GIF, TIFF, BMP, PNG e moitos
máis. É posíbel que xa estea instalado no seu sistema. Se non, estarán
dispoñíbeis no repositorio de software da súa distribución Linux. Se
non é así, ou para saber máis, visite http://netpbm.sourceforge.net/.
É posíbel que xa estea instalado no seu sistema. Se
non, estarán dispoñíbeis no repositorio de software
da súa distribución Linux. Se non é así, ou para
saber máis, visite http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
Os programas de liña de ordes «cjpeg» e «djpeg» Os programas de liña de ordes «cjpeg» e «djpeg» converten entre o
converten entre o formato NetPBM Calquera mapa formato NetPBM Calquera mapa portátil Portable Any Map (PNM) e os
portátil Portable Any Map (PNM) e os JPEG. É JPEG. É posíbel que xa estea instalado no seu sistema. Se non, estarán
posíbel que xa estea instalado no seu sistema. Se dispoñíbeis no repositorio de software da súa distribución Linux. Se
non, estarán dispoñíbeis no repositorio de software non é así, ou para saber máis, visite https://jpegclub.org/.
da súa distribución Linux. Se non é así, ou para
saber máis, visite https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Usuarios de Macintosh Usuarios de Macintosh
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -12,44 +12,47 @@
SIGTERM (tamén, [Control] + [C] dende un terminal executando «tuxpaint») SIGTERM (tamén, [Control] + [C] dende un terminal executando «tuxpaint»)
Tux Paint responde coma se se premese o botón «Saír» ou se lle Tux Paint responde coma se se premese o botón «Saír» ou se lle dixera ao
dixera ao contorno de escritorio que peche Tux Paint (por exemplo, contorno de escritorio que peche Tux Paint (por exemplo, premendo nun botón
premendo nun botón de peche da xanela ou premendo [Alt] + [F4] na de peche da xanela ou premendo [Alt] + [F4] na maioría dos sistemas).
maioría dos sistemas).
Dende a interface principal, Tux Paint preguntará se quere ou non Dende a interface principal, Tux Paint preguntará se quere ou non saír e (a
saír e (a non ser que sexa anulado pol a opción de gardado non ser que sexa anulado pol a opción de gardado automático, p. ex.:
automático, p. ex.: «--autosavex) se quere gardar o debuxo actual «--autosavex) se quere gardar o debuxo actual (se non está gardado) , e se
(se non está gardado) , e se é así, e é unha versión modificada é así, e é unha versión modificada dun debuxo existente (a non ser que sexa
dun debuxo existente (a non ser que sexa anulado polas opcións de anulado polas opcións de gardar sobre imaxes antigas ou gardar sempre
gardar sobre imaxes antigas ou gardar sempre imaxes novas; por imaxes novas; por exemplo, «--saveover« e «--saveovernew»,
exemplo, «--saveover« e «--saveovernew», respectivamente), se respectivamente), se quere ou non sobreescribir o debuxo existente ou
quere ou non sobreescribir o debuxo existente ou gardalo nun novo gardalo nun novo ficheiro.
ficheiro.
Exemplo: killall tuxpaint Exemplo: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint responde axustando a súa opción de gardar Tux Paint responde axustando a súa opción de gardar automaticamente (coma
automaticamente (coma se fora publicada con «--autosave»), así se fora publicada con «--autosave»), así como a opción de gardar sempre
como a opción de gardar sempre novas imaxes (coma se se publicase novas imaxes (coma se se publicase con «--saveovernew») no caso de recibir
con «--saveovernew») no caso de recibir un sinal de SIGUSR1 ou de un sinal de SIGUSR1 ou de gardar sempre sobre a imaxe existente (coma se se
gardar sempre sobre a imaxe existente (coma se se publicase con publicase con «--saveover») no caso de recibir SIGUSR2. Entón Tux Paint
«--saveover») no caso de recibir SIGUSR2. Entón Tux Paint envíase envíase a sí mesmo un sinal de SIGTERM, nun intento de saír. (Ver arriba.)
a sí mesmo un sinal de SIGTERM, nun intento de saír. (Ver arriba.)
Así, dende a interface principal, Tux Paint debería saír case de Así, dende a interface principal, Tux Paint debería saír case de inmediato,
inmediato, sen facer preguntas. sen facer preguntas.
Exemplo: killall -s SIGUSR1 tuxpaint Exemplo: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -9,29 +9,29 @@
Sobre os SVG Sobre os SVG
SVG (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) é un SVG (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) é un estándar
estándar aberto usado para describir gráficos vectoriais bidimensionais. É aberto usado para describir gráficos vectoriais bidimensionais. É xenial para
xenial para diagramas e formas, mentres que PNG son mellores para diagramas e formas, mentres que PNG son mellores para fotografías. Os ficheiros
fotografías. Os ficheiros SVG son un pouco como instrucións sobre como SVG son un pouco como instrucións sobre como facer unha imaxe. Isto significa
facer unha imaxe. Isto significa que poden cambiarse de sen que aparezan que poden cambiarse de sen que aparezan pixelados ou bloques.
pixelados ou bloques.
Para obter máis información, visite:https://www.w3.org/Graphics/SVG/ Para obter máis información, visite:https://www.w3.org/Graphics/SVG/
Como facer imaxes SVG Como facer imaxes SVG
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -14,18 +14,18 @@ Tools (Drawing)
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right. * Choose a stamp on the right.
* Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the
the bottom right. bottom right.
* Some stamps allow you to choose their color (see "Colors"). * Some stamps allow you to choose their color (see "Colors").
* Change stamp size with the bars 📶 at the bottom right. * Change stamp size with the bars 📶 at the bottom right.
* Rotation ⟳ may be enabled, if desired. * Rotation ⟳ may be enabled, if desired.
* Click/tap in the canvas to place a stamp. * Click/tap in the canvas to place a stamp.
* If rotation is enabled, drag to rotate it, and click/tap again to + If rotation is enabled, drag to rotate it, and click/tap again to add
add it to the drawing. it to the drawing.
* Some stamps play sound effects; press the speaker 🕪 button to hear it * Some stamps play sound effects; press the speaker 🕪 button to hear it
again. again.
* Some stamps play descriptive sounds; press the headphones 🎧 button to * Some stamps play descriptive sounds; press the headphones 🎧 button to hear
hear it again. it again.
⚟Lines ⚟Lines
@ -35,71 +35,68 @@ Tools (Drawing)
⭓Shapes ⭓Shapes
* Choose a shape on the right. * Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a * Select whether you want to extend the shape from the center ⧈, or a corner
corner ◰, using controls at the bottom right. ◰, using controls at the bottom right.
* Click/tap to position, and drag to set the size of the shape. * 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. * Drag to rotate it, and click/tap again to add it to the drawing.
🄰Text 🄰Text
* Choose a font on the right. * Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
controls near the bottom right. near the bottom right.
* Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom
right. right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap the canvas to position an insertion cursor. * Click/tap the canvas to position an insertion cursor.
* Enter text via your keyboard or the on-screen keyboard. * Enter text via your keyboard or the on-screen keyboard.
* Click/tap the canvas again if you wish to reposition the text. * Click/tap the canvas again if you wish to reposition the text.
* Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing * Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing and
and begin entering more text one line down. begin entering more text one line down.
* Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and
continue entering more text immediately to the right. continue entering more text immediately to the right.
* Using the on-screen keyboard: * Using the on-screen keyboard:
* "Cmp" can be used to compose characters, e.g. Cmp ' a results in + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á.
á. + "AltGr" can be used to quickly access more characters.
* "AltGr" can be used to quickly access more characters. + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
* Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs.
"ABC")
🅰Label 🅰Label
* (See Text) * (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them, * Labels float 'above' the drawing; you cannot paint or stamp over them,
apply Magic effects, etc. apply Magic effects, etc.
* Labels may be edited, repositioned, and styled after they've been * Labels may be edited, repositioned, and styled after they've been added to
added to the drawing. the drawing.
* Click/tap the ☝ button near the lower right to choose a label. * Click/tap the ☝ button near the lower right to choose a label. Click/tap
Click/tap the label you wish to modify, then click/tap somewhere else the label you wish to modify, then click/tap somewhere else in the canvas
in the canvas to reposition, or change the font/style, change color, to reposition, or change the font/style, change color, and/or type to edit
and/or type to edit the text. the text.
* Or, use the 🖑 button near the lower right to "flatten" a label, * Or, use the 🖑 button near the lower right to "flatten" a label, applying it
applying it to the canvas; it may no longer be edited with the Label to the canvas; it may no longer be edited with the Label tool.
tool.
🪣Fill 🪣Fill
* Choose a fill mode on the right. * Choose a fill mode on the right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap (and drag, with Brush and Linear modes) to fill an area of * Click/tap (and drag, with Brush and Linear modes) to fill an area of the
the picture with a color. picture with a color.
* Solid - Flood-fills an area with a solid color + Solid - Flood-fills an area with a solid color
* Brush - Paints with a solid color, without drawing outside the + Brush - Paints with a solid color, without drawing outside the chosen
chosen area area
* Linear - Fills the area with a linear gradient (drag to choose + Linear - Fills the area with a linear gradient (drag to choose angle
angle and gradient) and gradient)
* Radial - Fills the area with a radial gradient, centered where + Radial - Fills the area with a radial gradient, centered where you
you clicked/tapped clicked/tapped
* Shaped - Fills the area with a gradient that follows the contours + Shaped - Fills the area with a gradient that follows the contours of
of the area being filled the area being filled
🪄Magic 🪄Magic
* Choose a magic tool on the right. * Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Some magic tools draw or apply effects via click/tap and drag 〰🪄, some * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some
affect the entire drawing 🖻🪄, and some offer both options; use the affect the entire drawing 🖻🪄, and some offer both options; use the controls
controls at the bottom right. at the bottom right.
* Some magic tools offer various sizes; change it with the bars 📶 at the * Some magic tools offer various sizes; change it with the bars 📶 at the
bottom right. bottom right.
* Some magic tools allow you to choose their color. * Some magic tools allow you to choose their color.
@ -117,8 +114,8 @@ Tools (Drawing)
◪Eraser ◪Eraser
* Choose the size and shape of the eraser on the right. * Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or * Click/tap and drag to erase parts of the picture (solid color, or starter
starter or template image). or template image).
* Shortcut: [X] and click/tap in the drawing (not always available) * Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls) Tools (Controls)
@ -126,11 +123,10 @@ Tools (Controls)
🗏New 🗏New
* Choose a solid color, starter, or template image to start with. * Choose a solid color, starter, or template image to start with.
* Starters allow drawing "under" a picture (e.g., a coloring book + Starters allow drawing "under" a picture (e.g., a coloring book
outline), sometimes with a background layer, too. outline), sometimes with a background layer, too.
* Templates are pictures to start with (background only). + Templates are pictures to start with (background only).
* Eraser tool ◪ reveals the solid color, or starter/template + Eraser tool ◪ reveals the solid color, or starter/template background.
background.
* Click/tap "🕮⮫Open" to begin a new drawing. * Click/tap "🕮⮫Open" to begin a new drawing.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Ctrl]+[N] * Shortcut: [Ctrl]+[N]
@ -141,32 +137,31 @@ Tools (Controls)
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
* Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures"
folder. folder.
* Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin.
Bin.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Click/tap "📽Slides" to switch to slideshow mode: * Click/tap "📽Slides" to switch to slideshow mode:
* Click/tap two or more of your previously-saved drawings, in the + Click/tap two or more of your previously-saved drawings, in the order
order you want them shown. Numbers will appear on them. you want them shown. Numbers will appear on them.
* Choose the playback speed using the bars 📶 near the lower left. + Choose the playback speed using the bars 📶 near the lower left.
* Click/tap "⯈Play" to watch the slideshow/animation. + Click/tap "⯈Play" to watch the slideshow/animation.
* Or, click/tap "🎞GIF Export" to save an animated GIF of the + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to
animation to your system's "Pictures" folder. your system's "Pictures" folder.
* Click/tap "⤺Back" to return to the Open dialog. + Click/tap "⤺Back" to return to the Open dialog.
* Shortcut: [Ctrl]+[O] * Shortcut: [Ctrl]+[O]
🕮⮪Save 🕮⮪Save
* Click/tap to save your drawing. * Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite * If you've saved previously, you'll be prompted whether to overwrite the
the previously-saved drawing (a la "File→Save") or create a new saved previously-saved drawing (a la "File→Save") or create a new saved drawing
drawing (a la "File→Save As...") (a la "File→Save As...")
* Shortcut: [Ctrl]+[S] * Shortcut: [Ctrl]+[S]
🖶Print 🖶Print
* Click/tap to print your drawing. * Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
dialog, if available. if available.
* Shortcut: [Ctrl]+[P] * Shortcut: [Ctrl]+[P]
🗙Quit 🗙Quit
@ -176,28 +171,27 @@ Tools (Controls)
Colors Colors
* Click/tap to choose a color to use with the Paint, Lines, and Shapes * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
tools, and Stamps and Magic tools that support colors. and Stamps and Magic tools that support colors.
* Use the pipette / color picker 💉 button to choose a color from a pixel * Use the pipette / color picker 💉 button to choose a color from a pixel in
in your current drawing. your current drawing.
* Shortcut: When colors are available, press [Ctrl] and click/tap + Shortcut: When colors are available, press [Ctrl] and click/tap in your
in your drawing, to quickly pick a color from your drawing. drawing, to quickly pick a color from your drawing.
* Click/tap the rainbow 🌈 button to choose a arbitrary color. * Click/tap the rainbow 🌈 button to choose a arbitrary color.
* Click/tap in the rainbow square to pick a color (hue and + Click/tap in the rainbow square to pick a color (hue and saturation).
saturation). + Click/tap in the grey gradient bar to adjust brightness (value).
* Click/tap in the grey gradient bar to adjust brightness (value). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Click/tap "⤺Back" to abort and dismiss the palette.
* Click/tap "⤺Back" to abort and dismiss the palette. + You may grab the currently-chosen built-in color (if any), the color in
* You may grab the currently-chosen built-in color (if any), the the pipette / color picker, or the color in the color mixer, by
color in the pipette / color picker, or the color in the color clicking one of the colored arrow ⇫ buttons.
mixer, by clicking one of the colored arrow ⇫ buttons. * Click/tap the paint palette 🎨 button to create a color by mixing primary
* Click/tap the paint palette 🎨 button to create a color by mixing colors: red, yellow, and blue, and white (tint), grey (tone), and black
primary colors: red, yellow, and blue, and white (tint), grey (tone), (shade).
and black (shade). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Color mixing offers its own 🖓Undo and 🖒Redo options.
* Color mixing offers its own 🖓Undo and 🖒Redo options. + Click/tap "🗑Clear" to start over with no mixed colors.
* Click/tap "🗑Clear" to start over with no mixed colors. + Click/tap "⤺Back" to abort and dismiss the color mixer.
* Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing: Shortcuts while drawing:
@ -213,3 +207,4 @@ Shortcuts while drawing:
* [Esc] - ⤺Back or 🗙Quit * [Esc] - ⤺Back or 🗙Quit
Last updated: 9 de Maio de 2023 Last updated: 9 de Maio de 2023

View file

@ -6,8 +6,7 @@
júní 4, 2022 júní 4, 2022
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+----------------------------------------+ +----------------------------------------+
| Table of Contents | | Table of Contents |
|----------------------------------------| |----------------------------------------|
@ -17,26 +16,22 @@
| * Replace the fringe and junk pixels | | * Replace the fringe and junk pixels |
| * Save the image for Tux Paint | | * Save the image for Tux Paint |
+----------------------------------------+ +----------------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
About this 'How-To' About this 'How-To'
This 'How-To' assumes that you want to make an excellent Tux Paint This 'How-To' assumes that you want to make an excellent Tux Paint stamp,
stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital in PNG bitmapped format, from a JPEG image (e.g., a digital photograph).
photograph). There are easier and faster methods that produce lower There are easier and faster methods that produce lower quality.
quality.
This 'How-To' assumes you are dealing with normal opaque objects. This 'How-To' assumes you are dealing with normal opaque objects. Dealing
Dealing with semi-transparent objects (fire, moving fan blade, kid's with semi-transparent objects (fire, moving fan blade, kid's balloon) or
balloon) or light-giving objects (fire, lightbulb, sun) is best done light-giving objects (fire, lightbulb, sun) is best done with custom
with custom software. Images with perfect solid-color backgrounds are software. Images with perfect solid-color backgrounds are also best done
also best done with custom software, but are not troublesome to do as with custom software, but are not troublesome to do as follows.
follows.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Image choice is crucial Image choice is crucial
@ -44,9 +39,9 @@ Image choice is crucial
If you wish to submit artwork to the Tux Paint developers for If you wish to submit artwork to the Tux Paint developers for
consideration for inclusion in the official project, or if you wish to consideration for inclusion in the official project, or if you wish to
release your own copy of Tux Paint, bundled with your own graphics, release your own copy of Tux Paint, bundled with your own graphics, you
you need an image that is compatible with the GNU General Public need an image that is compatible with the GNU General Public License
License used by Tux Paint. used by Tux Paint.
Images produced by the US government are Public Domain, but be aware Images produced by the US government are Public Domain, but be aware
that the US government sometimes uses other images on the web. Google that the US government sometimes uses other images on the web. Google
@ -71,10 +66,10 @@ Image choice is crucial
Rotating an image can make it blurry, especially if you only rotate by Rotating an image can make it blurry, especially if you only rotate by
a few degrees. Images that don't need rotation are best, images that a few degrees. Images that don't need rotation are best, images that
need lots of rotation (30 to 60 degrees) are next best, and images need lots of rotation (30 to 60 degrees) are next best, and images that
that need just a few degrees are worst. Rotation will also make an need just a few degrees are worst. Rotation will also make an image
image darker because most image editing software is very bad about darker because most image editing software is very bad about gamma
gamma handling. (Rotation is only legitimate for gamma=1.0 images.) handling. (Rotation is only legitimate for gamma=1.0 images.)
Very large images are more forgiving of mistakes, and thus easier to Very large images are more forgiving of mistakes, and thus easier to
work with. Choose an image with an object that is over 1000 pixels work with. Choose an image with an object that is over 1000 pixels
@ -83,31 +78,31 @@ Image choice is crucial
Be sure that the image is not too grainy, dim, or washed out. Be sure that the image is not too grainy, dim, or washed out.
Pay attention to feet and wheels. If they are buried in something, you Pay attention to feet and wheels. If they are buried in something, you
will need to draw new ones. If only one is buried, you might be able will need to draw new ones. If only one is buried, you might be able to
to copy the other one as a replacement. copy the other one as a replacement.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the image Prepare the image
First of all, be sure to avoid re-saving the image as a JPEG. This First of all, be sure to avoid re-saving the image as a JPEG. This causes
causes quality loss. There is a special tool called jpegtran that lets quality loss. There is a special tool called jpegtran that lets you crop an
you crop an image without the normal quality loss. image without the normal quality loss.
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
Bring that image up in your image editor. If you didn't crop it yet, you Bring that image up in your image editor. If you didn't crop it yet, you
may find that your image editor is very slow. Rotate and crop the image may find that your image editor is very slow. Rotate and crop the image as
as needed. Save the image — choose whatever native format supports needed. Save the image — choose whatever native format supports layers,
layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop
Photoshop users should choose "PSD", for example. users should choose "PSD", for example.
If you have rotated or cropped the image in your image editor, flatten If you have rotated or cropped the image in your image editor, flatten it
it now. You need to have just one RGB layer without mask or alpha. now. You need to have just one RGB layer without mask or alpha.
Open the layers dialog box. Replicate the one layer several times. From Open the layers dialog box. Replicate the one layer several times. From top
top to bottom you will need something like this: to bottom you will need something like this:
1. unmodified image (write-protect this if you can) 1. unmodified image (write-protect this if you can)
2. an image you will modify — the "work in progress" layer 2. an image you will modify — the "work in progress" layer
@ -115,152 +110,147 @@ Prepare the image
4. solid magenta (write-protect this if you can) 4. solid magenta (write-protect this if you can)
5. unmodified image (write-protect this if you can) 5. unmodified image (write-protect this if you can)
Give the work in progress (WIP) layer a rough initial mask. You might Give the work in progress (WIP) layer a rough initial mask. You might start
start with a selection, or by using the grayscale value of the WIP with a selection, or by using the grayscale value of the WIP layer. You
layer. You might invert the mask. might invert the mask.
Warning: once you have the mask, you may not rotate or scale the image Warning: once you have the mask, you may not rotate or scale the image
normally. This would cause data loss. You will be given special scaling normally. This would cause data loss. You will be given special scaling
instructions later. instructions later.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Prepare the mask Prepare the mask
Get used to doing [Control]-click and [Alt]-click on the thumbnail Get used to doing [Control]-click and [Alt]-click on the thumbnail images
images in the layers dialog. You will need this to control what you are in the layers dialog. You will need this to control what you are looking at
looking at and what you are editing. Sometimes you will be editing and what you are editing. Sometimes you will be editing things you can't
things you can't see. For example, you might edit the mask of the WIP see. For example, you might edit the mask of the WIP layer while looking at
layer while looking at the unmodified image. Pay attention so you don't the unmodified image. Pay attention so you don't screw up. Always verify
screw up. Always verify that you are editing the right thing. that you are editing the right thing.
Set an unmodified image as what you will view (the top one is easiest). Set an unmodified image as what you will view (the top one is easiest). Set
Set the WIP mask as what you will edit. At some point, perhaps not the WIP mask as what you will edit. At some point, perhaps not immediately,
immediately, you should magnify the image to about 400% (each pixel of you should magnify the image to about 400% (each pixel of the image is seen
the image is seen and edited as a 4x4 block of pixels on your screen). and edited as a 4x4 block of pixels on your screen).
Select parts of the image that need to be 100% opaque or 0% opaque. If Select parts of the image that need to be 100% opaque or 0% opaque. If you
you can select the object or background somewhat accurately by color, do can select the object or background somewhat accurately by color, do so. As
so. As needed to avoid selecting any pixels that should be partially needed to avoid selecting any pixels that should be partially opaque
opaque (generally at the edge of the object) you should grow, shrink, (generally at the edge of the object) you should grow, shrink, and invert
and invert the selection. the selection.
Fill the 100% opaque areas with white, and the 0% opaque areas with Fill the 100% opaque areas with white, and the 0% opaque areas with black.
black. This is most easily done by drag-and-drop from the This is most easily done by drag-and-drop from the foreground/background
foreground/background color indicator. You should not see anything color indicator. You should not see anything happen, because you are
happen, because you are viewing the unmodified image layer while editing viewing the unmodified image layer while editing the mask of the WIP layer.
the mask of the WIP layer. Large changes might be noticable in the Large changes might be noticable in the thumbnail.
thumbnail.
Now you must be zoomed in. Now you must be zoomed in.
Check your work. Hide the top unmodified image layer. Display just the Check your work. Hide the top unmodified image layer. Display just the
mask, which should be a white object on a black background (probably mask, which should be a white object on a black background (probably with
with unedited grey at the edge). Now display the WIP layer normally, so unedited grey at the edge). Now display the WIP layer normally, so that the
that the mask is active. This should show your object over top of the mask is active. This should show your object over top of the next highest
next highest enabled layer, which should be green or magenta as needed enabled layer, which should be green or magenta as needed for maximum
for maximum contrast. You might wish to flip back and forth between contrast. You might wish to flip back and forth between those backgrounds
those backgrounds by repeatedly clicking to enable/disable the green by repeatedly clicking to enable/disable the green layer. Fix any obvious
layer. Fix any obvious and easy problems by editing the mask while and easy problems by editing the mask while viewing the mask.
viewing the mask.
Go back to viewing the top unmodified layer while editing the WIP mask. Go back to viewing the top unmodified layer while editing the WIP mask. Set
Set your drawing tool the paintbrush. For the brush, choose a small your drawing tool the paintbrush. For the brush, choose a small fuzzy
fuzzy circle. The 5x5 size is good for most uses. circle. The 5x5 size is good for most uses.
With a steady hand, trace around the image. Use black around the With a steady hand, trace around the image. Use black around the outside,
outside, and white around the inside. Avoid making more than one pass and white around the inside. Avoid making more than one pass without
without switching colors (and thus sides). switching colors (and thus sides).
Flip views a bit, checking to see that the mask is working well. When Flip views a bit, checking to see that the mask is working well. When the
the WIP layer is composited over the green or magenta, you should see a WIP layer is composited over the green or magenta, you should see a tiny
tiny bit of the original background as an ugly fringe around the edge. bit of the original background as an ugly fringe around the edge. If this
If this fringe is missing, then you made the object mask too small. The fringe is missing, then you made the object mask too small. The fringe
fringe consists of pixels that are neither 100% object nor 0% object. consists of pixels that are neither 100% object nor 0% object. For them,
For them, the mask should be neither 100% nor 0%. The fringe gets the mask should be neither 100% nor 0%. The fringe gets removed soon.
removed soon.
View and edit the mask. Select by color, choosing either black or white. View and edit the mask. Select by color, choosing either black or white.
Most likely you will see unselected specks that are not quite the Most likely you will see unselected specks that are not quite the expected
expected color. Invert the selection, then paint these away using the color. Invert the selection, then paint these away using the pencil tool.
pencil tool. Do this operation for both white and black. Do this operation for both white and black.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Replace the fringe and junk pixels Replace the fringe and junk pixels
Still viewing the mask, select by color. Choose black. Shrink the Still viewing the mask, select by color. Choose black. Shrink the selection
selection by several pixels, being sure to NOT shrink from the edges of by several pixels, being sure to NOT shrink from the edges of the mask (the
the mask (the shrink helps you avoid and recover from mistakes). shrink helps you avoid and recover from mistakes).
Now disable the mask. View and edit the unmasked WIP layer. Using the Now disable the mask. View and edit the unmasked WIP layer. Using the color
color picker tool, choose a color that is average for the object. picker tool, choose a color that is average for the object. Drag-and-drop
Drag-and-drop this color into the selection, thus removing most of the this color into the selection, thus removing most of the non-object pixels.
non-object pixels.
This solid color will compress well and will help prevent ugly color This solid color will compress well and will help prevent ugly color
fringes when Tux Paint scales the image down. If the edge of the object fringes when Tux Paint scales the image down. If the edge of the object has
has multiple colors that are very different, you should split up your multiple colors that are very different, you should split up your selection
selection so that you can color the nearby background to be similar. so that you can color the nearby background to be similar.
Now you will paint away the existing edge fringe. Be sure that you are Now you will paint away the existing edge fringe. Be sure that you are
editing and viewing the WIP image. Frequent layer visibility changes editing and viewing the WIP image. Frequent layer visibility changes will
will help you to see what you are doing. You are likely to use all of: help you to see what you are doing. You are likely to use all of:
* composited over green (mask enabled) + composited over green (mask enabled)
* composited over magenta (mask enabled) + composited over magenta (mask enabled)
* original (the top or bottom layer) + original (the top or bottom layer)
* composited over the original (mask enabled) + composited over the original (mask enabled)
* raw WIP layer (mask disabled) + raw WIP layer (mask disabled)
To reduce accidents, you may wish to select only those pixels that are To reduce accidents, you may wish to select only those pixels that are not
not grey in the mask. (Select by color from the mask, choose black, add grey in the mask. (Select by color from the mask, choose black, add mode,
mode, choose white, invert. Alternately: Select all, select by color choose white, invert. Alternately: Select all, select by color from the
from the mask, subtract mode, choose black, choose white.) If you do mask, subtract mode, choose black, choose white.) If you do this, you'll
this, you'll probably want to expand the selection a bit and/or hide the probably want to expand the selection a bit and/or hide the "crawling ants"
"crawling ants" line that marks the selection. line that marks the selection.
Use the clone tool and the brush tool. Vary the opacity as needed. Use Use the clone tool and the brush tool. Vary the opacity as needed. Use
small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is
generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy
brushes with about 70% opacity.) Unusual drawing modes can be helpful brushes with about 70% opacity.) Unusual drawing modes can be helpful with
with semi-transparent objects. semi-transparent objects.
The goal is to remove the edge fringe, both inside and outside of the The goal is to remove the edge fringe, both inside and outside of the
object. The inside fringe, visible when the object is composited over object. The inside fringe, visible when the object is composited over
magenta or green, must be removed for obvious reasons. The outside magenta or green, must be removed for obvious reasons. The outside fringe
fringe must also be removed because it will become visible when the must also be removed because it will become visible when the image is
image is scaled down. As an example, consider a 2x2 region of pixels at scaled down. As an example, consider a 2x2 region of pixels at the edge of
the edge of a sharp-edged object. The left half is black and 0% opaque. a sharp-edged object. The left half is black and 0% opaque. The right half
The right half is white and 100% opaque. That is, we have a white object is white and 100% opaque. That is, we have a white object on a black
on a black background. When Tux Paint scales this to 50% (a 1x1 pixel background. When Tux Paint scales this to 50% (a 1x1 pixel area), the
area), the result will be a grey 50% opaque pixel. The correct result result will be a grey 50% opaque pixel. The correct result would be a white
would be a white 50% opaque pixel. To get this result, we would paint 50% opaque pixel. To get this result, we would paint away the black pixels.
away the black pixels. They matter, despite being 0% opaque. They matter, despite being 0% opaque.
Tux Paint can scale images down by a very large factor, so it is Tux Paint can scale images down by a very large factor, so it is important
important to extend the edge of your object outward by a great deal. to extend the edge of your object outward by a great deal. Right at the
Right at the edge of your object, you should be very accurate about edge of your object, you should be very accurate about this. As you go
this. As you go outward away from the object, you can get a bit sloppy. outward away from the object, you can get a bit sloppy. It is reasonable to
It is reasonable to paint outward by a dozen pixels or more. The farther paint outward by a dozen pixels or more. The farther you go, the more Tux
you go, the more Tux Paint can scale down without creating ugly color Paint can scale down without creating ugly color fringes. For areas that
fringes. For areas that are more than a few pixels away from the object are more than a few pixels away from the object edge, you should use the
edge, you should use the pencil tool (or sloppy select with pencil tool (or sloppy select with drag-and-drop color) to ensure that the
drag-and-drop color) to ensure that the result will compress well. result will compress well.
---------------------------------------------------------------------- -------------------------------------------------------------------------------
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 It is very easy to ruin your hard work. Image editors can silently destroy
destroy pixels in 0% opaque areas. The conditions under which this pixels in 0% opaque areas. The conditions under which this happens may vary
happens may vary from version to version. If you are very trusting, you from version to version. If you are very trusting, you can try saving your
can try saving your image directly as a PNG. Be sure to read it back in image directly as a PNG. Be sure to read it back in again to verify that
again to verify that the 0% opaque areas didn't turn black or white, the 0% opaque areas didn't turn black or white, which would create fringes
which would create fringes when Tux Paint scales the image down. If you when Tux Paint scales the image down. If you need to scale your image to
need to scale your image to save space (and hide your mistakes), you are save space (and hide your mistakes), you are almost certain to destroy all
almost certain to destroy all the 0% opaque areas. So here is a better the 0% opaque areas. So here is a better way...
way...
A Safer Way to Save A Safer Way to Save
@ -271,17 +261,17 @@ Save the image for Tux Paint
with an image that is about 700 to 1500 pixels across, and end up with with an image that is about 700 to 1500 pixels across, and end up with
one that is 300 to 400. one that is 300 to 400.
Save the mask image as a NetPBM portable greymap (".pgm") file. (If Save the mask image as a NetPBM portable greymap (".pgm") file. (If you
you are using an old release of The GIMP, you might need to convert are using an old release of The GIMP, you might need to convert the
the image to greyscale before you can save it.) Choose the more image to greyscale before you can save it.) Choose the more compact
compact "RAW PGM" format. (The second character of the file should be "RAW PGM" format. (The second character of the file should be the ASCII
the ASCII digit "5", hex byte 0x35.) digit "5", hex byte 0x35.)
You may close the mask image. You may close the mask image.
Going back to the multi-layer image, now select the WIP layer. As you Going back to the multi-layer image, now select the WIP layer. As you
did with the mask, drag this from the layers dialog to the toolbar. did with the mask, drag this from the layers dialog to the toolbar. You
You should get a single-layer image of your WIP data. If the mask came should get a single-layer image of your WIP data. If the mask came
along too, get rid of it. You should be seeing the object and the along too, get rid of it. You should be seeing the object and the
painted-away surroundings, without any mask thumbnail in the layers painted-away surroundings, without any mask thumbnail in the layers
dialog. If you scaled the mask, then scale this image in exactly the dialog. If you scaled the mask, then scale this image in exactly the
@ -289,8 +279,9 @@ Save the image for Tux Paint
(Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second (Note: .ppm, not .pgm.) (If you choose the RAW PPM format, the second
byte of the file should be the ASCII digit "6", hex byte 0x36.) byte of the file should be the ASCII digit "6", hex byte 0x36.)
Now you need to merge the two files into one. Do that with the Now you need to merge the two files into one. Do that with the pnmtopng
pnmtopng command, like this: command, like this:
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,91 +7,97 @@
maí 5, 2023 maí 5, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, Tux Paint understands a number of environment variables, either directly, or
or indirectly by the libraries that it utilizes. 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 Specifies the user's "home directory", which is used to locate numerous
numerous other files or directories. In some cases, it is utilized other files or directories. In some cases, it is utilized as part of a
as part of a fall-back location, when other environment variables fall-back location, when other environment variables (elsewhere in this
(elsewhere in this documentation) are not set. Sometimes, the documentation) are not set. Sometimes, the location to use can be
location to use can be overridden by options provided on the overridden by options provided on the command-line or via Tux Paint's
command-line or via Tux Paint's configuration file. See the configuration file. See the "OPTIONS" documentation for details.
"OPTIONS" documentation for details.
A few examples of where "$HOME" is used include: A few examples of where "$HOME" is used include:
* The location of Tux Paint's configuration file + The location of Tux Paint's configuration file
* The basis of where Tux Paint saves and loads users' drawings + The basis of where Tux Paint saves and loads users' drawings
* The location of a user's private collection of data files — + The location of a user's private collection of data files — stamps,
stamps, brushes, etc. — (versus those available system wide) brushes, etc. — (versus those available system wide)
XDG_CONFIG_HOME XDG_CONFIG_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's configuration files. the location of the user's configuration files. Specifically, where to find
Specifically, where to find "user-dirs.dirs", where the "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used
"XDG_PICTURES_DIR" might be defined. It is used for exporting for exporting drawings and animated GIFs. Generally it's set to something
drawings and animated GIFs. Generally it's set to something like like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory
"$HOME/Pictures/". If not specified, Tux Paint checks in the "$HOME/.config/". If the configuration cannot be found, Tux Paint simply
directory "$HOME/.config/". If the configuration cannot be found, exports drawings and GIFs to "$HOME".
Tux Paint simply exports drawings and GIFs to "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's data directories. the location of the user's data directories. Specifically, where to find
Specifically, where to find the "Trash" directory. It is used when the "Trash" directory. It is used when deleting images from Tux Paint's
deleting images from Tux Paint's "Open" dialog. If not set, the "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is
location "$HOME/.local/share/Trash/" is used, if available. If used, if available. If not, images are simply deleted, rather than moved
not, images are simply deleted, rather than moved anywhere. anywhere.
TEMP TEMP
Specifies the location where temporary files may be created. Only Specifies the location where temporary files may be created. Only used by
used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
not set.
Language-related environment variables Language-related environment variables
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Specify the language Tux Paint should utilize in its user Specify the language Tux Paint should utilize in its user interface.
interface. Overridde by the "--lang" and "--locale" command-line Overridde by the "--lang" and "--locale" command-line options or their
options or their configuration file counterparts. The "LANGUAGE" configuration file counterparts. The "LANGUAGE" environment variable is
environment variable is used, if set. If not, "LC_ALL" is used as used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES",
a fallback. Then "LC_MESSAGES", and finally "LANG". and finally "LANG".
Display-related environment variables Display-related environment variables
The following are a few of the environment variables supported by Simple The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
graphics, playing sounds, and receiving mouse, keyboard, and joystick playing sounds, and receiving mouse, keyboard, and joystick input — and which
input — and which may be useful to users of Tux Paint. 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 Specifies whether Tux Paint should allow a screensaver to run. Can be set
be set to '1' (true) by Tux Paint itself by issuing the to '1' (true) by Tux Paint itself by issuing the command-line option
command-line option "--allowscreensaver" or its configuration file "--allowscreensaver" or its configuration file counterpart.
counterpart.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

View file

@ -6,8 +6,7 @@
júlí 13, 2023 júlí 13, 2023
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+------------------------------+ +------------------------------+
| Table of Contents | | Table of Contents |
|------------------------------| |------------------------------|
@ -20,549 +19,549 @@
| * Other Problems | | * Other Problems |
| * Help / Contact | | * Help / Contact |
+------------------------------+ +------------------------------+
-------------------------------------------------------------------------------
----------------------------------------------------------------------
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 The TrueType Font you're using might have the wrong encoding. If it's
it's 'custom' encoded, for example, you can try running it through 'custom' encoded, for example, you can try running it through FontForge (
FontForge (http://fontforge.sourceforge.net/) to convert it to an http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
ISO-8859 format. (Email us if you need help with special fonts.) (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, This means that Tux Paint either couldn't find any stamp images, or was
or was asked not to load them. asked not to load them.
If you installed Tux Paint, but did not install the separate, If you installed Tux Paint, but did not install the separate, optional
optional "Stamps" collection, quit Tux Paint and install it now. "Stamps" collection, quit Tux Paint and install it now. It should be
It should be available from the same place you got the main Tux available from the same place you got the main Tux Paint program. (Note: As
Paint program. (Note: As of version 0.9.14, Tux Paint comes with a of version 0.9.14, Tux Paint comes with a small collection of example
small collection of example stamps.) stamps.)
If you don't want to install the default collection of stamps, you If you don't want to install the default collection of stamps, you can just
can just create your own. See the "Extending Tux Paint" create your own. See the "Extending Tux Paint" documentation for more on
documentation for more on creating PNG and SVG image files, TXT creating PNG and SVG image files, TXT text description files, Ogg Vorbis,
text description files, Ogg Vorbis, MP3 or WAV sound files, and MP3 or WAV sound files, and DAT text data files that make up stamps.
DAT text data files that make up stamps.
Finally, if you installed stamps, and think they should be loading, check
to see that the "nostamps" option isn't being set. (Either via a
"--nostamps" option to Tux Paint's command line, or "nostamps=yes" in the
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.
Finally, if you installed stamps, and think they should be
loading, check to see that the "nostamps" option isn't being set.
(Either via a "--nostamps" option to Tux Paint's command line, or
"nostamps=yes" in the 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.
Stamp outlines are always rectangles Stamp outlines are always rectangles
Tux Paint was built with low-quality (but faster) stamp outlines. Tux Paint was built with low-quality (but faster) stamp outlines.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_STAMP_OUTLINE #define LOW_QUALITY_STAMP_OUTLINE
in the "tuxpaint.c" file in the "src" directory. 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 Tux Paint was probably compiled with the faster, lower quality thumbnail
thumbnail code enabled. Run the command: "tuxpaint code enabled. Run the command: "tuxpaint --verbose-version" from a command
--verbose-version" from a command line. If, amongst the other line. If, amongst the other output, you see the text: "Low Quality
output, you see the text: "Low Quality Thumbnails enabled", then Thumbnails enabled", then this is what's happening.
this is what's happening.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_THUMBNAILS #define LOW_QUALITY_THUMBNAILS
in the "tuxpaint.c" file in the "src" directory. 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 "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
thumbnails in the Stamp Selector look bad", above. Stamp Selector look bad", above.
All of the text is in uppercase! All of the text is in uppercase!
The "uppercase" option is on. The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override Either change/remove the "uppercase" option, or you can override it with
it with "--mixedcase" on the command line or either "uppercase=no" "--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
or "mixedcase=yes" in a configuration file. 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 Make sure your locale setting is correct. See "Tux Paint won't switch to my
switch to my language", below. 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 + Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your Make sure the locale you want is available. Check your "/etc/
"/etc/locale.gen" file. See the "Options Documentation" for locale.gen" file. See the "Options Documentation" for the locales Tux
the locales Tux Paint uses (especially when using the Paint uses (especially when using the "--lang" option).
"--lang" option).
Note: Debian and derivative (e.g., Ubuntu) users can simply Note: Debian and derivative (e.g., Ubuntu) users can simply run
run "dpkg-reconfigure locales" if the locales are managed by "dpkg-reconfigure locales" if the locales are managed by "dpkg".
"dpkg".
* If you're using the "--lang" command-line option + If you're using the "--lang" command-line option
Try using the "--locale" command-line option, or your Try using the "--locale" command-line option, or your operating
operating system's locale settings (e.g., the "$LANG" system's locale settings (e.g., the "$LANG" environment variable), and
environment variable), and please e-mail us regarding your please e-mail us regarding your trouble.
trouble.
* If you're using the "--locale" command-line option + If you're using the "--locale" command-line option
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* If you're trying to use your Operating System's locale + If you're trying to use your Operating System's locale
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* Make sure you have the necessary font + Make sure you have the necessary font
Some translations require their own font. Chinese and Korean, Some translations require their own font. Chinese and Korean, for
for example, need Chinese and Korean TrueType Fonts installed example, need Chinese and Korean TrueType Fonts installed and placed in
and placed in the proper location, respectively. the proper location, respectively.
The appropriate fonts for such locales can be downloaded from The appropriate fonts for such locales can be downloaded from the Tux
the Tux Paint website: Paint website:
https://tuxpaint.org/download/fonts/ 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 Tux Paint prints by creating a PostScript rendition of the picture and
and sending it to an external command. By default, this command is sending it to an external command. By default, this command is the "lpr"
the "lpr" printing tool. printing tool.
If that program is not available (for example, you're using CUPS, If that program is not available (for example, you're using CUPS, the
the Common Unix Printing System, and do not have "cups-lpr" Common Unix Printing System, and do not have "cups-lpr" installed), you
installed), you will need to specify an appropriate command using will need to specify an appropriate command using the "printcommand" option
the "printcommand" option in Tux Paint's configuration file. (See 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.
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.
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.
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 The "print delay" option is on. You can only print once every X seconds.
seconds.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--printdelay=..." option. giving it a "--printdelay=..." option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--printdelay=..." is listed as a properties of the icon to see if "--printdelay=..." is listed as a
command-line argument. command-line argument.
If a "--printdelay=..." option isn't being sent on the command If a "--printdelay=..." option isn't being sent on the command line, check
line, check Tux Paint's configuration file for a line reading: Tux Paint's configuration file for a line reading: "printdelay=...".
"printdelay=...".
Either remove that line, set the delay value to 0 (no delay), or Either remove that line, set the delay value to 0 (no delay), or decrease
decrease the delay to a value you prefer. (See the "Options the delay to a value you prefer. (See the "Options Documentation".)
Documentation".)
Or, you can simply run Tux Paint with the command-line argument: Or, you can simply run Tux Paint with the command-line argument:
"--printdelay=0", which will override the configuration file's "--printdelay=0", which will override the configuration file's setting, and
setting, and allow unlimited printing. (You won't have to wait allow unlimited printing. (You won't have to wait between prints.)
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. The "no print" option is on.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noprint" option. giving it a "--noprint" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noprint" is listed as a properties of the icon to see if "--noprint" is listed as a command-line
command-line argument. argument.
If a "--noprint" option isn't being sent on the command line, If a "--noprint" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "noprint=yes".
"noprint=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--print", which will override the argument: "--print", which will override the configuration file's setting.
configuration file's setting.
Or use Tux Paint Config. and make sure "Allow Printing" (under Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing")
"Printing") is checked. 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 Unless you asked Tux Paint to save into a specific location (using the
the "savedir" option), Tux Paint saves into a standard location on "savedir" option), Tux Paint saves into a standard location on your local
your local drive: drive:
Windows Vista, Windows 8, Windows 10, Windows 11 Windows Vista, Windows 8, Windows 10, Windows 11
In the user's "AppData" folder: In the user's "AppData" folder:
e.g., e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved
C:\Users\Username\AppData\Roaming\TuxPaint\saved
macOS macOS
In the user's "Application Support" folder: In the user's "Application Support" folder:
e.g., /Users/Username/Library/Applicaton e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/
Support/TuxPaint/saved/
Linux / Unix Linux / Unix
In the user's home directory ("$HOME"), under a In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder:
".tuxpaint" subfolder:
e.g., /home/username/.tuxpaint/saved/ 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 The images are stored as PNG bitmaps, which most modern programs should be
browsers, etc.) 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 The "save over" option is enabled. (This disables the prompt that would
would appear when you click 'Save.') appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveover" option. giving it a "--saveover" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveover" is listed as a properties of the icon to see if "--saveover" is listed as a command-line
command-line argument. argument.
If a "--saveover" option isn't being sent on the command line, If a "--saveover" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=yes".
"saveover=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves a new picture!", below. 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 The "never save over" option is enabled. (This disables the prompt that
that would appear when you click 'Save.') would appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveovernew" option. giving it a "--saveovernew" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveovernew" is listed as a properties of the icon to see if "--saveovernew" is listed as a
command-line argument. command-line argument.
If a "--saveovernew" option isn't being sent on the command line, If a "--saveovernew" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=new".
"saveover=new".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under
(under "Saving") is checked. "Saving") is checked.
Also, see "Tux Paint always saves over my old picture!", above. 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: + First, check the obvious:
* Are your speakers connected and turned on? o Are your speakers connected and turned on?
* Is the volume turned up on your speakers? o Is the volume turned up on your speakers?
* Is the volume turned up in your Operating System's o Is the volume turned up in your Operating System's "mixer?"
"mixer?" o Are you certain you're using a computer with a sound card?
* Are you certain you're using a computer with a sound o Are any other programs running that use sound? (They may be
card? 'blocking' Tux Paint from accessing your sound device)
* Are any other programs running that use sound? (They may o (Unix/Linux) Are you using a sound system, such as aRts, ESD or
be 'blocking' Tux Paint from accessing your sound GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment
device) variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER=
* (Unix/Linux) Are you using a sound system, such as aRts, arts"). Or, run Tux Paint through the system's rerouter (e.g., run
ESD or GStreamer? If so, try setting the "artsdsp tuxpaint" or "esddsp tuxpaint", instead of simply
"SDL_AUDIODRIVER" environment variable before running "tuxpaint").
Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run + Is sound disabled in Tux Paint?
Tux Paint through the system's rerouter (e.g., run
"artsdsp tuxpaint" or "esddsp tuxpaint", instead of
simply "tuxpaint").
* Is sound disabled in Tux Paint?
If sound seems to work otherwise (and you're sure no other If sound seems to work otherwise (and you're sure no other program is
program is "blocking" the sound device), then Tux Paint may "blocking" the sound device), then Tux Paint may be running with a "no
be running with a "no sound" option. sound" option.
If you're running Tux Paint from a command-line, make sure If you're running Tux Paint from a command-line, make sure you're not
you're not giving it a "--nosound" option. giving it a "--nosound" option.
If you're running Tux Paint by double-clicking an icon, check If you're running Tux Paint by double-clicking an icon, check the
the properties of the icon to see if "--nosound" is listed as properties of the icon to see if "--nosound" is listed as a
a command-line argument. command-line argument.
If a "--nosound" option isn't being sent on the command line, If a "--nosound" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "nosound=yes".
"nosound=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--sound", which will override the argument: "--sound", which will override the configuration file's
configuration file's setting. setting.
Or, you can simply run Tux Paint with the command-line Or, you can simply run Tux Paint with the command-line argument:
argument: "Enable Sound Effects", which will override the "Enable Sound Effects", which will override the configuration file's
configuration file's setting, and allow unlimited printing. setting, and allow unlimited printing. (You won't have to wait between
(You won't have to wait between prints.) prints.)
* Were sounds temporarily disabled? + Were sounds temporarily disabled?
Even if sounds are enabled in Tux Paint, it is possible to Even if sounds are enabled in Tux Paint, it is possible to disable and
disable and re-enable them temporarily using the [Alt] + [S] re-enable them temporarily using the [Alt] + [S] key sequence. Try
key sequence. Try pressing those keys to see if sounds begin pressing those keys to see if sounds begin working again.
working again.
* Was Tux Paint built without sound support? + Was Tux Paint built without sound support?
Tux Paint may have been compiled with sound support disabled. Tux Paint may have been compiled with sound support disabled. To test
To test whether sound support was enabled when Tux Paint was whether sound support was enabled when Tux Paint was compiled, run Tux
compiled, run Tux Paint from a command line, like so: Paint from a command line, like so:
tuxpaint --verbose-version tuxpaint --verbose-version
If, amongst the other information, you see "Sound disabled", If, amongst the other information, you see "Sound disabled", then the
then the version of Tux Paint you're running has sound version of Tux Paint you're running has sound disabled. Recompile Tux
disabled. Recompile Tux Paint, and be sure NOT to build the Paint, and be sure NOT to build the "nosound" target. (i.e., don't run
"nosound" target. (i.e., don't run "make nosound") Be sure "make nosound") Be sure the SDL_mixer library and its development
the SDL_mixer library and its development headers are headers are available!
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: Yes, there are a number of ways to disable sounds in Tux Paint:
* Press [Alt] + [S] while in Tux Paint to temporarily disable + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds.
sounds. (Press that key sequence again to re-enable sounds.) (Press that key sequence again to re-enable sounds.)
* Run Tux Paint with the "no sound" option: + Run Tux Paint with the "no sound" option:
* Run "tuxpaint --nosound" from the command line or o Run "tuxpaint --nosound" from the command line or shortcut or
shortcut or desktop icon. desktop icon.
* Edit Tux Paint's configuration file (see "Options o Edit Tux Paint's configuration file (see "Options Documentation"
Documentation" for details) and add a line containing for details) and add a line containing "nosound=yes".
"nosound=yes". o Or use Tux Paint Config. and make sure "Enable Sound Effects"
* Or use Tux Paint Config. and make sure "Enable Sound (under "Video & Sound") is not checked.
Effects" (under "Video & Sound") is not checked. o Alternatively, recompile Tux Paint with sound support disabled.
* Alternatively, recompile Tux Paint with sound support (See above, and the 'Install' documentation.
disabled. (See above, and the 'Install' documentation.
The stereo panning of sound effects is bothersome; can sound effects be The stereo panning of sound effects is bothersome; can sound effects be
monophonic? monophonic?
Run Tux Paint with the "no stereo" option: Run Tux Paint with the "no stereo" option:
* Run "tuxpaint --nostereo" from the command line or shortcut + Run "tuxpaint --nostereo" from the command line or shortcut or desktop
or desktop icon. icon.
* Edit Tux Paint's configuration file (see "Options + Edit Tux Paint's configuration file (see "Options Documentation" for
Documentation" for details) and add a line containing details) and add a line containing "nostereo=yes".
"nostereo=yes". + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
* Or use Tux Paint Config. and make sure "Enable Stereo "Video & Sound") is not checked.
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. This could have to do with how SDL and SDL_mixer were initialized. (The
(The buffer size chosen.) buffer size chosen.)
Please e-mail us with details about your computer system. Please e-mail us with details about your computer system. (Operating system
(Operating system and version, sound card, which version of Tux and version, sound card, which version of Tux Paint you're running (run
Paint you're running (run "tuxpaint --version" to verify), and so "tuxpaint --version" to verify), and so on.)
on.)
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Fullscreen Mode Problems Fullscreen Mode Problems
When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
black!
This is apparently a bug in the SDL library. Sorry. 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 Linux users - Your X-Window server is probably not set with the ability to
ability to switch to the desired resolution: 800×600. (or whatever switch to the desired resolution: 800×600. (or whatever resolution you have
resolution you have Tux Paint set to run at.) (This is typically Tux Paint set to run at.) (This is typically done manually under the
done manually under the X-Window server by pressing [Control] + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and
[Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus [Control] + [Alt] + [Keypad Minus (-)].)
(-)].)
For this to work, your monitor must support that resolution, and For this to work, your monitor must support that resolution, and you need
you need to have it listed in your X server configuration. to have it listed in your X server configuration.
Check the "Display" subsection of the "Screen" section of your Check the "Display" subsection of the "Screen" section of your XFree86 or
XFree86 or X.org configuration file (typically X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/
"/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x,
version of XFree86 you're using; 3.x or 4.x, respectively, or respectively, or "/etc/X11/xorg.conf" for X.org).
"/etc/X11/xorg.conf" for X.org).
Add "800x600" (or whatever resolution(s) you want) to the Add "800x600" (or whatever resolution(s) you want) to the appropriate
appropriate "Modes" line. (e.g., in the "Display" subsection that "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color
contains 24-bit color depth ("Depth 24"), which is what Tux Paint depth ("Depth 24"), which is what Tux Paint tries to use.)
tries to use.)
Modes "1280x1024" "1024x768" "800x600" "640x480" Modes "1280x1024" "1024x768" "800x600" "640x480"
Note that some Linux distributions have tools that can make these Note that some Linux distributions have tools that can make these changes
changes for you. Debian users can run the command for you. Debian users can run the command "dpkg-reconfigure
"dpkg-reconfigure xserver-xfree86" as root, for example. 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. The "fullscreen" option is set.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--fullscreen" option. giving it a "--fullscreen" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--fullscreen" is listed as a properties of the icon to see if "--fullscreen" is listed as a command-line
command-line argument. argument.
If a "--fullscreen" option isn't being sent on the command line, If a "--fullscreen" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "fullscreen=yes".
"fullscreen=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--windowed", which will override the argument: "--windowed", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Fullscreen" (under "Video Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound")
& Sound") is not checked. is not checked.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
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 If Tux Paint aborts with the message: "You're already running a copy of Tux
copy of Tux Paint!", this means it has been launched in the last Paint!", this means it has been launched in the last 30 seconds. (On Unix/
30 seconds. (On Unix/Linux, this message would appear in a Linux, this message would appear in a terminal console if you ran Tux Paint
terminal console if you ran Tux Paint from a command-line. On from a command-line. On Windows, this message would appear in a file named
Windows, this message would appear in a file named "stdout.txt" in "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\
the same folder where TuxPaint.exe resides (e.g., in "C:\Program Program Files\TuxPaint").
Files\TuxPaint").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\
"userdata\lockfile.dat" on Windows) is used to make sure Tux Paint lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many
isn't run too many times at once (e.g., due to a child impatiently times at once (e.g., due to a child impatiently clicking its icon more than
clicking its icon more than once). once).
Even if the lockfile exists, it contains the 'time' Tux Paint was Even if the lockfile exists, it contains the 'time' Tux Paint was last run.
last run. If it's been more than 30 seconds, Tux Paint should run If it's been more than 30 seconds, Tux Paint should run fine, and simply
fine, and simply update the lockfile with the current time. update the lockfile with the current time.
If multiple users are sharing the directory where this file is 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, or "nolockfile=yes" to the configuration file.
If multiple users are sharing the directory where this file is
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, or "nolockfile=yes" to the configuration
file.
I can't quit Tux Paint I can't quit Tux Paint
The "no quit" option is set. This disables the "Quit" button in The "no quit" option is set. This disables the "Quit" button in Tux Paint's
Tux Paint's toolbar (greying it out), and prevents Tux Paint from toolbar (greying it out), and prevents Tux Paint from being exited via the
being exited via the [Escape] key. [Escape] key.
If Tux Paint is not in fullscreen mode, simply click the window If Tux Paint is not in fullscreen mode, simply click the window close
close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.)
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 "no quit" set, you can always use the [Alt] + [F4]
combination on your keyboard to quit Tux Paint.)
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 "no quit" set, you can always use the [Alt]
+ [F4] 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 If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noquit" option. giving it a "--noquit" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noquit" is listed as a properties of the icon to see if "--noquit" is listed as a command-line
command-line argument. argument.
If a "--noquit" option isn't being sent on the command line, check If a "--noquit" option isn't being sent on the command line, check Tux
Tux Paint's configuration file for a line reading: "noquit=yes". 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 configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape]
Key" (under "Simplification") is not checked.
Either remove that line, or simply run Tux Paint with the
command-line argument: "--quit", which will override the
configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and
[Escape] 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 A few messages are normal, but if Tux Paint is being extremely verbose
verbose (like listing the name of every rubber-stamp image it (like listing the name of every rubber-stamp image it finds while loading
finds while loading them), then it was probably compiled with them), then it was probably compiled with debugging output turned on.
debugging output turned on.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define DEBUG #define DEBUG
in the "tuxpaint.c" file in the "src" directory. 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 By default, Tux Paint first looks at configuration files for options.
options.
* Windows + Windows
Under Windows, Tux Paint first examines the configuration Under Windows, Tux Paint first examines the configuration file:
file:
tuxpaint.cfg tuxpaint.cfg
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* macOS + macOS
* Unix and Linux + Unix and Linux
Under Unix and Linux, it first examines the system-wide Under Unix and Linux, it first examines the system-wide configuration
configuration file, located here: file, located here:
/etc/tuxpaint/tuxpaint.conf /etc/tuxpaint/tuxpaint.conf
@ -572,19 +571,19 @@ Other Problems
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* Haiku + Haiku
This means that if anything is set in a configuration file that This means that if anything is set in a configuration file that you don't
you don't want set, you'll need to either change the config. file want set, you'll need to either change the config. file (if you can), or
(if you can), or override the option on the command-line. override the option on the command-line.
For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes
includes this option to disable sound... this option to disable sound...
nosound=yes nosound=yes
...then you can reenable sound by either adding this option to ...then you can reenable sound by either adding this option to your own
your own ".tuxpaintrc" file: ".tuxpaintrc" file:
sound=yes sound=yes
@ -592,24 +591,27 @@ Other Problems
--sound --sound
Linux and Unix users can also disable the system-wide Linux and Unix users can also disable the system-wide configuration file by
configuration file by including the following command-line including the following command-line argument:
argument:
--nosysconfig --nosysconfig
Tux Paint will then only look at "~/.tuxpaintrc" and command-line Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments
arguments to determine what options should be set. to determine what options should be set.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Help / Contact Help / Contact
Any questions you don't see answered? Please let us know! You can Any questions you don't see answered? Please let us know! You can subscribe and
subscribe and post to our "tuxpaint-users" mailing list: post to our "tuxpaint-users" mailing list:
https://tuxpaint.org/lists/ https://tuxpaint.org/lists/
Or, contact lead developer Bill Kendrick directly: Or, contact lead developer Bill Kendrick directly:
bill@newbreedsoftware.com bill@newbreedsoftware.com

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -10,79 +10,83 @@
About PNGs About PNGs
PNG is the Portable Network Graphic format. It is an open standard, not PNG is the Portable Network Graphic format. It is an open standard, not
burdened by patents (like GIFs). It is a highly compressed format (though burdened by patents (like GIFs). It is a highly compressed format (though not
not "lossy" like JPEGs - lossiness allows files to be much smaller, but "lossy" like JPEGs - lossiness allows files to be much smaller, but introduces
introduces 'mistakes' in the image when saved), and supports 24-bit color 'mistakes' in the image when saved), and supports 24-bit color (16.7 million
(16.7 million colors) as well as a full "alpha channel" - that is, each colors) as well as a full "alpha channel" - that is, each pixel can have a
pixel can have a varying degree of transparency. varying degree of transparency.
For more information, visit: http://www.libpng.org/ For more information, visit: http://www.libpng.org/
These features (openness, losslessness, compression, transparency/alpha) These features (openness, losslessness, compression, transparency/alpha) make
make it the best choice for Tux Paint. (Tux Paint's support for the PNG it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes
format comes from the Open Source SDL_Image library, which in turn gets it from the Open Source SDL_Image library, which in turn gets it from the libPNG
from the libPNG library.) library.)
Support for many colors allows photo-quality "rubber stamp" images to be Support for many colors allows photo-quality "rubber stamp" images to be used
used in Tux Paint, and alpha transparency allows for high-quality brushes. 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 The following is a very brief list of ways to create PNGs or convert existing
existing images into PNGs. images into PNGs.
GIMP & Krita GIMP & Krita
Excellent tools with which to create PNG images for use in Tux Excellent tools with which to create PNG images for use in Tux Paint are
Paint are GIMP and Krita, both high-quality Open Source GIMP and Krita, both high-quality Open Source interactive drawing and photo
interactive drawing and photo editing programs. editing programs.
It is likely that one or both are already installed on your system. If not,
they should be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://www.gimp.org/ and http:/
/www.krita.org/, respectively.
It is likely that one or both are already installed on your
system. If not, they should be readily available from your Linux
distribution's software repository. If not, or to learn more,
visit http://www.gimp.org/ and http://www.krita.org/,
respectively.
Command-line Tools Command-line Tools
NetPBM NetPBM
The Portable Bitmap tools (collectively known as The Portable Bitmap tools (collectively known as "NetPBM") is a
"NetPBM") is a collection of Open Source command-line collection of Open Source command-line tools which convert to and from
tools which convert to and from various formats, various formats, including GIF, TIFF, BMP, PNG, and many more.
including GIF, TIFF, BMP, PNG, and many more.
It is possible that it's already installed on your system. If not, they
it be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://
netpbm.sourceforge.net/.
It is possible that it's already installed on your
system. If not, they it be readily available from
your Linux distribution's software repository. If
not, or to learn more, visit
http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
The "cjpeg" and "djpeg" command-line programs convert The "cjpeg" and "djpeg" command-line programs convert between the
between the NetPBM Portable Any Map (PNM) format and NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
JPEGs. It is possible that it's already installed on it's already installed on your system. If not, they it be readily
your system. If not, they it be readily available available from your Linux distribution's software repository. If not,
from your Linux distribution's software repository. or to learn more, visit https://jpegclub.org/.
If not, or to learn more, visit
https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Macintosh Users Macintosh Users
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -7,47 +7,51 @@
júní 4, 2022 júní 4, 2022
Tux Paint responds to the following signals (which can be sent to the Tux Paint responds to the following signals (which can be sent to the program's
program's process via `kill` or `killall`, for example). 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 Tux Paint responds as if the "Quit" button were pressed, or the desktop
desktop environment was told to close Tux Paint (e.g., by clicking environment was told to close Tux Paint (e.g., by clicking a window close
a window close button, or pressing [Alt] + [F4] on most systems). button, or pressing [Alt] + [F4] on most systems).
From the main interface, Tux Paint will prompt whether or not you From the main interface, Tux Paint will prompt whether or not you wish to
wish to quit, and (unless overridden by the auto-save option, e.g. quit, and (unless overridden by the auto-save option, e.g. "--autosave") if
"--autosave") if you'd like to save the current drawing (if you'd like to save the current drawing (if unsaved), and if so, and it's a
unsaved), and if so, and it's a modified version of an existing modified version of an existing drawing (unless overridden by the options
drawing (unless overridden by the options to save over old images, to save over old images, or always save new images; e.g. "--saveover" and
or always save new images; e.g. "--saveover" and "--saveovernew", "--saveovernew", respectively), whether or not to overwrite the existing
respectively), whether or not to overwrite the existing drawing, drawing, or save to a new file.
or save to a new file.
Example: killall tuxpaint Example: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint responds by setting its auto-save option (as if it had Tux Paint responds by setting its auto-save option (as if it had been
been launched with "--autosave"), as well as either the option to launched with "--autosave"), as well as either the option to always save
always save new images (as if launched with "--saveovernew") in new images (as if launched with "--saveovernew") in the case of receiving a
the case of receiving a SIGUSR1 signal, or to always save over the SIGUSR1 signal, or to always save over the existing image (as if launched
existing image (as if launched with "--saveover") in the case of with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends
receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, itself a SIGTERM signal, in an attempt to quit. (See above.)
in an attempt to quit. (See above.)
So, from the main interface, Tux Paint should quit almost So, from the main interface, Tux Paint should quit almost immediately, with
immediately, with no questions asked. no questions asked.
Example: killall -s SIGUSR1 tuxpaint Example: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -10,27 +10,28 @@
About SVGs About SVGs
SVG (Scalable Vector Graphics) is an open standard used to describe SVG (Scalable Vector Graphics) is an open standard used to describe
two-dimensional vector graphics. It is great for diagrams and shapes, two-dimensional vector graphics. It is great for diagrams and shapes, while
while PNGs are better for photographs. SVG files are a bit like PNGs are better for photographs. SVG files are a bit like instructions on how
instructions on how to make an image. This means that they can be resized to make an image. This means that they can be resized without looking pixelated
without looking pixelated or blocky. or blocky.
For more information, visit: https://www.w3.org/Graphics/SVG/ For more information, visit: https://www.w3.org/Graphics/SVG/
How to make SVGs How to make SVGs
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -14,18 +14,18 @@ Tools (Drawing)
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Choose a stamp on the right. * Choose a stamp on the right.
* Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the
the bottom right. bottom right.
* Some stamps allow you to choose their color (see "Colors"). * Some stamps allow you to choose their color (see "Colors").
* Change stamp size with the bars 📶 at the bottom right. * Change stamp size with the bars 📶 at the bottom right.
* Rotation ⟳ may be enabled, if desired. * Rotation ⟳ may be enabled, if desired.
* Click/tap in the canvas to place a stamp. * Click/tap in the canvas to place a stamp.
* If rotation is enabled, drag to rotate it, and click/tap again to + If rotation is enabled, drag to rotate it, and click/tap again to add
add it to the drawing. it to the drawing.
* Some stamps play sound effects; press the speaker 🕪 button to hear it * Some stamps play sound effects; press the speaker 🕪 button to hear it
again. again.
* Some stamps play descriptive sounds; press the headphones 🎧 button to * Some stamps play descriptive sounds; press the headphones 🎧 button to hear
hear it again. it again.
⚟Lines ⚟Lines
@ -35,71 +35,68 @@ Tools (Drawing)
⭓Shapes ⭓Shapes
* Choose a shape on the right. * Choose a shape on the right.
* Select whether you want to extend the shape from the center ⧈, or a * Select whether you want to extend the shape from the center ⧈, or a corner
corner ◰, using controls at the bottom right. ◰, using controls at the bottom right.
* Click/tap to position, and drag to set the size of the shape. * 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. * Drag to rotate it, and click/tap again to add it to the drawing.
🄰Text 🄰Text
* Choose a font on the right. * Choose a font on the right.
* Select whether you want the text bold 𝗔 and/or italic 𝘈, using * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls
controls near the bottom right. near the bottom right.
* Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom
right. right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap the canvas to position an insertion cursor. * Click/tap the canvas to position an insertion cursor.
* Enter text via your keyboard or the on-screen keyboard. * Enter text via your keyboard or the on-screen keyboard.
* Click/tap the canvas again if you wish to reposition the text. * Click/tap the canvas again if you wish to reposition the text.
* Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing * Press [Enter]/[Return] or click/tap ⮨ to add the text to the drawing and
and begin entering more text one line down. begin entering more text one line down.
* Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and
continue entering more text immediately to the right. continue entering more text immediately to the right.
* Using the on-screen keyboard: * Using the on-screen keyboard:
* "Cmp" can be used to compose characters, e.g. Cmp ' a results in + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á.
á. + "AltGr" can be used to quickly access more characters.
* "AltGr" can be used to quickly access more characters. + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC")
* Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs.
"ABC")
🅰Label 🅰Label
* (See Text) * (See Text)
* Labels float 'above' the drawing; you cannot paint or stamp over them, * Labels float 'above' the drawing; you cannot paint or stamp over them,
apply Magic effects, etc. apply Magic effects, etc.
* Labels may be edited, repositioned, and styled after they've been * Labels may be edited, repositioned, and styled after they've been added to
added to the drawing. the drawing.
* Click/tap the ☝ button near the lower right to choose a label. * Click/tap the ☝ button near the lower right to choose a label. Click/tap
Click/tap the label you wish to modify, then click/tap somewhere else the label you wish to modify, then click/tap somewhere else in the canvas
in the canvas to reposition, or change the font/style, change color, to reposition, or change the font/style, change color, and/or type to edit
and/or type to edit the text. the text.
* Or, use the 🖑 button near the lower right to "flatten" a label, * Or, use the 🖑 button near the lower right to "flatten" a label, applying it
applying it to the canvas; it may no longer be edited with the Label to the canvas; it may no longer be edited with the Label tool.
tool.
🪣Fill 🪣Fill
* Choose a fill mode on the right. * Choose a fill mode on the right.
* Choose a color (see "Colors"). * Choose a color (see "Colors").
* Click/tap (and drag, with Brush and Linear modes) to fill an area of * Click/tap (and drag, with Brush and Linear modes) to fill an area of the
the picture with a color. picture with a color.
* Solid - Flood-fills an area with a solid color + Solid - Flood-fills an area with a solid color
* Brush - Paints with a solid color, without drawing outside the + Brush - Paints with a solid color, without drawing outside the chosen
chosen area area
* Linear - Fills the area with a linear gradient (drag to choose + Linear - Fills the area with a linear gradient (drag to choose angle
angle and gradient) and gradient)
* Radial - Fills the area with a radial gradient, centered where + Radial - Fills the area with a radial gradient, centered where you
you clicked/tapped clicked/tapped
* Shaped - Fills the area with a gradient that follows the contours + Shaped - Fills the area with a gradient that follows the contours of
of the area being filled the area being filled
🪄Magic 🪄Magic
* Choose a magic tool on the right. * Choose a magic tool on the right.
* Change categories with the arrow buttons ⇦⇨ near the bottom right. * Change categories with the arrow buttons ⇦⇨ near the bottom right.
* Some magic tools draw or apply effects via click/tap and drag 〰🪄, some * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some
affect the entire drawing 🖻🪄, and some offer both options; use the affect the entire drawing 🖻🪄, and some offer both options; use the controls
controls at the bottom right. at the bottom right.
* Some magic tools offer various sizes; change it with the bars 📶 at the * Some magic tools offer various sizes; change it with the bars 📶 at the
bottom right. bottom right.
* Some magic tools allow you to choose their color. * Some magic tools allow you to choose their color.
@ -117,8 +114,8 @@ Tools (Drawing)
◪Eraser ◪Eraser
* Choose the size and shape of the eraser on the right. * Choose the size and shape of the eraser on the right.
* Click/tap and drag to erase parts of the picture (solid color, or * Click/tap and drag to erase parts of the picture (solid color, or starter
starter or template image). or template image).
* Shortcut: [X] and click/tap in the drawing (not always available) * Shortcut: [X] and click/tap in the drawing (not always available)
Tools (Controls) Tools (Controls)
@ -126,11 +123,10 @@ Tools (Controls)
🗏New 🗏New
* Choose a solid color, starter, or template image to start with. * Choose a solid color, starter, or template image to start with.
* Starters allow drawing "under" a picture (e.g., a coloring book + Starters allow drawing "under" a picture (e.g., a coloring book
outline), sometimes with a background layer, too. outline), sometimes with a background layer, too.
* Templates are pictures to start with (background only). + Templates are pictures to start with (background only).
* Eraser tool ◪ reveals the solid color, or starter/template + Eraser tool ◪ reveals the solid color, or starter/template background.
background.
* Click/tap "🕮⮫Open" to begin a new drawing. * Click/tap "🕮⮫Open" to begin a new drawing.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Shortcut: [Ctrl]+[N] * Shortcut: [Ctrl]+[N]
@ -141,32 +137,31 @@ Tools (Controls)
* Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it.
* Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures"
folder. folder.
* Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin.
Bin.
* Click/tap "⤺Back" to abort and return to your current drawing. * Click/tap "⤺Back" to abort and return to your current drawing.
* Click/tap "📽Slides" to switch to slideshow mode: * Click/tap "📽Slides" to switch to slideshow mode:
* Click/tap two or more of your previously-saved drawings, in the + Click/tap two or more of your previously-saved drawings, in the order
order you want them shown. Numbers will appear on them. you want them shown. Numbers will appear on them.
* Choose the playback speed using the bars 📶 near the lower left. + Choose the playback speed using the bars 📶 near the lower left.
* Click/tap "⯈Play" to watch the slideshow/animation. + Click/tap "⯈Play" to watch the slideshow/animation.
* Or, click/tap "🎞GIF Export" to save an animated GIF of the + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to
animation to your system's "Pictures" folder. your system's "Pictures" folder.
* Click/tap "⤺Back" to return to the Open dialog. + Click/tap "⤺Back" to return to the Open dialog.
* Shortcut: [Ctrl]+[O] * Shortcut: [Ctrl]+[O]
🕮⮪Save 🕮⮪Save
* Click/tap to save your drawing. * Click/tap to save your drawing.
* If you've saved previously, you'll be prompted whether to overwrite * If you've saved previously, you'll be prompted whether to overwrite the
the previously-saved drawing (a la "File→Save") or create a new saved previously-saved drawing (a la "File→Save") or create a new saved drawing
drawing (a la "File→Save As...") (a la "File→Save As...")
* Shortcut: [Ctrl]+[S] * Shortcut: [Ctrl]+[S]
🖶Print 🖶Print
* Click/tap to print your drawing. * Click/tap to print your drawing.
* Hold [Alt] or [Option] while clicking/tapping to bring up printer * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog,
dialog, if available. if available.
* Shortcut: [Ctrl]+[P] * Shortcut: [Ctrl]+[P]
🗙Quit 🗙Quit
@ -176,28 +171,27 @@ Tools (Controls)
Colors Colors
* Click/tap to choose a color to use with the Paint, Lines, and Shapes * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools,
tools, and Stamps and Magic tools that support colors. and Stamps and Magic tools that support colors.
* Use the pipette / color picker 💉 button to choose a color from a pixel * Use the pipette / color picker 💉 button to choose a color from a pixel in
in your current drawing. your current drawing.
* Shortcut: When colors are available, press [Ctrl] and click/tap + Shortcut: When colors are available, press [Ctrl] and click/tap in your
in your drawing, to quickly pick a color from your drawing. drawing, to quickly pick a color from your drawing.
* Click/tap the rainbow 🌈 button to choose a arbitrary color. * Click/tap the rainbow 🌈 button to choose a arbitrary color.
* Click/tap in the rainbow square to pick a color (hue and + Click/tap in the rainbow square to pick a color (hue and saturation).
saturation). + Click/tap in the grey gradient bar to adjust brightness (value).
* Click/tap in the grey gradient bar to adjust brightness (value). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Click/tap "⤺Back" to abort and dismiss the palette.
* Click/tap "⤺Back" to abort and dismiss the palette. + You may grab the currently-chosen built-in color (if any), the color in
* You may grab the currently-chosen built-in color (if any), the the pipette / color picker, or the color in the color mixer, by
color in the pipette / color picker, or the color in the color clicking one of the colored arrow ⇫ buttons.
mixer, by clicking one of the colored arrow ⇫ buttons. * Click/tap the paint palette 🎨 button to create a color by mixing primary
* Click/tap the paint palette 🎨 button to create a color by mixing colors: red, yellow, and blue, and white (tint), grey (tone), and black
primary colors: red, yellow, and blue, and white (tint), grey (tone), (shade).
and black (shade). + Click/tap the green checkbox ✓ to accept.
* Click/tap the green checkbox ✓ to accept. + Color mixing offers its own 🖓Undo and 🖒Redo options.
* Color mixing offers its own 🖓Undo and 🖒Redo options. + Click/tap "🗑Clear" to start over with no mixed colors.
* Click/tap "🗑Clear" to start over with no mixed colors. + Click/tap "⤺Back" to abort and dismiss the color mixer.
* Click/tap "⤺Back" to abort and dismiss the color mixer.
Shortcuts while drawing: Shortcuts while drawing:
@ -213,3 +207,4 @@ Shortcuts while drawing:
* [Esc] - ⤺Back or 🗙Quit * [Esc] - ⤺Back or 🗙Quit
Last updated: maí 9, 2023 Last updated: maí 9, 2023

View file

@ -6,76 +6,104 @@
2022年6月 4日 2022年6月 4日
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+----------------------------------+
+-----------------------+
| 目次 | | 目次 |
|-----------------------| |----------------------------------|
| * この解説について | | * この解説について |
| * 使用する画像の選択 | | * 使用する画像の選択 |
| * マスクの設定 | | * マスクの設定 |
| * 縁取りと不要なピクセルの除去 | | * 縁取りと不要なピクセルの除去 |
| * Tux Paint 用の画像の保存 | | * Tux Paint 用の画像の保存 |
+-----------------------+ +----------------------------------+
-------------------------------------------------------------------------------
---------------------------------------------------------------------- -------------------------------------------------------------------------------
----------------------------------------------------------------------
この解説について この解説について
この解説では、デジカメ写真などのJPEG画像をもとに、PNG形式で、高いクォリティの Tux Paint この解説では、デジカメ写真などのJPEG画像をもとに、PNG形式で、高いクォリティ
用スタンプを作成したいという場合を想定しています。クォリティにこだわらなければ、もっと簡単で早い方法もあります。 の Tux Paint 用スタンプを作成したいという場合を想定しています。クォリティに
こだわらなければ、もっと簡単で早い方法もあります。
扱う対象としては、通常の透明ではないものを前提としており、半透明のもの(火、動く扇風機の羽根、風船)や発光するもの(火、電球、太陽)を扱うには、専用のソフトウェアを使用するのが最適です。背景が完全なベタ塗りの画像も、専用のソフトを使うのが良いですが、以下のようにしても問題はありません。 扱う対象としては、通常の透明ではないものを前提としており、半透明のもの(火
、動く扇風機の羽根、風船)や発光するもの(火、電球、太陽)を扱うには、専用
のソフトウェアを使用するのが最適です。背景が完全なベタ塗りの画像も、専用の
ソフトを使うのが良いですが、以下のようにしても問題はありません。
---------------------------------------------------------------------- -------------------------------------------------------------------------------
使用する画像の選択 使用する画像の選択
著作権 著作権
Tux Paint の開発者に作品を提供して公式プロジェクトへの採用を検討してもらいたい場合や、Tux Paint Tux Paint の開発者に作品を提供して公式プロジェクトへの採用を検討しても
に独自の画像を同梱して配布したい場合には、Tux Paint が採用しているライセンスである GNU 一般公衆利用許諾 らいたい場合や、Tux Paint に独自の画像を同梱して配布したい場合には、Tux
と互換性があるライセンスの画像を用いる必要があります。 Paint が採用しているライセンスである GNU 一般公衆利用許諾と互換性がある
ライセンスの画像を用いる必要があります。
米国政府が制作した画像はパブリックドメインですが、米国政府がウェブ上でパプリックドメイン以外の画像を使用していることもあるので注意が必要です。Googleの画像検索で、site:gov 米国政府が制作した画像はパブリックドメインですが、米国政府がウェブ上で
またはsite:mil のいずれかを指定すると、適切な画像が多数表示されます。(注: *.mil パプリックドメイン以外の画像を使用していることもあるので注意が必要です
のサイトには、軍事関係以外のコンテンツも含まれています!) 。Googleの画像検索で、site:gov またはsite:mil のいずれかを指定すると、
適切な画像が多数表示されます。(注: *.mil のサイトには、軍事関係以外の
コンテンツも含まれています!)
自分自身で作成した画像は、クリエイティブ・コモンズ 自分自身で作成した画像は、クリエイティブ・コモンズ CC0といったパブリッ
CC0といったパブリックドメインあるいは適切なライセンスである旨を明示すれば、そのように位置づけることができます。法的なアドバイスが必要だと感じたら、弁護士に相談してください クドメインあるいは適切なライセンスである旨を明示すれば、そのように位置
づけることができます。(法的なアドバイスが必要だと感じたら、弁護士に相
談してください)
個人的に使用する場合は、合法的に修正して使用できる画像であれば問題ありません。 個人的に使用する場合は、合法的に修正して使用できる画像であれば問題あり
ません。
画像の大きさと向き 画像の大きさと向き
使いやすい向きの画像が必要で、遠近感のあるものは禁物です。被写体を隅の方から見たような画像は、お絵かきに使うには向いていません。一般的には、遠方から、かつ、真横から見たような画像がベストです。実際にはありえませんが、例えば車の2つの車輪が他の2つの車輪の後ろに完全に隠れているというようなものが理想的です。 使いやすい向きの画像が必要で、遠近感のあるものは禁物です。被写体を隅の
方から見たような画像は、お絵かきに使うには向いていません。一般的には、
遠方から、かつ、真横から見たような画像がベストです。実際にはありえませ
んが、例えば車の2つの車輪が他の2つの車輪の後ろに完全に隠れているという
ようなものが理想的です。
画像を回転させるとぼやけてしまいます。回転を必要としない画像が最良で、大きな角度の回転30〜60度を必要とする画像が次に良く、わずかに数度回転が必要な画像は最悪です。画像を回転させると暗くなりますが、これは、ほとんどの画像編集ソフトはガンマ値の扱いが非常に不適切だからです。回転はガンマ値が1.0の画像にのみ有効です)。 画像を回転させるとぼやけてしまいます。回転を必要としない画像が最良で、
大きな角度の回転30〜60度を必要とする画像が次に良く、わずかに数度
)回転が必要な画像は最悪です。画像を回転させると暗くなりますが、これは
、ほとんどの画像編集ソフトはガンマ値の扱いが非常に不適切だからです。(
回転はガンマ値が1.0の画像にのみ有効です)。
非常に大きなサイズの画像は、ミスに寛容なので、作業がしやすくなります。できれば 1000 非常に大きなサイズの画像は、ミスに寛容なので、作業がしやすくなります。
ピクセル以上の被写体が写っている画像を選びましょう。編集後に縮小することで、細かいミスを目立たなくすることができます。 できれば 1000 ピクセル以上の被写体が写っている画像を選びましょう。編集
後に縮小することで、細かいミスを目立たなくすることができます。
画像が、粒度が粗すぎたり、薄暗すぎたり、半透明になりすぎたりしないように注意してください。 画像が、粒度が粗すぎたり、薄暗すぎたり、半透明になりすぎたりしないよう
に注意してください。
生き物の足や車のホイールなどにも注意が必要です。これらが何かに隠れて見えなくなっている場合は新しく描き足す必要があります。隠れているのが一部だけの場合は、他の部分をコピーして描き換えることができるかもしれません。 生き物の足や車のホイールなどにも注意が必要です。これらが何かに隠れて見
えなくなっている場合は新しく描き足す必要があります。隠れているのが一部
だけの場合は、他の部分をコピーして描き換えることができるかもしれません
---------------------------------------------------------------------- -------------------------------------------------------------------------------
画像の準備 画像の準備
まず、画像をJPEGで保存し直さないようにしてください。これは品質低下の原因となります。jpegtranという特別なツールを使えば、品質を維持したまま画像を切り抜くことができます。 まず、画像をJPEGで保存し直さないようにしてください。これは品質低下の原因と
なります。jpegtranという特別なツールを使えば、品質を維持したまま画像を切り
抜くことができます。
jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg >
cropped.jpg cropped.jpg
次に、切り抜いた画像を画像エディタで表示させます。トリミングをしていない大きな画像を開く場合は、画像エディタの動作が非常に遅くなるかもしれません。必要に応じて画像を回転させたりトリミングしたりして、画像を保存します。保存の際は、レイヤー、マスク、アルファチャンネルなどが保存されるように、各ソフトウェア専用のフォーマットを選択します。GIMPをお使いの方は「XCF」、Adobe 次に、切り抜いた画像を画像エディタで表示させます。トリミングをしていない大
きな画像を開く場合は、画像エディタの動作が非常に遅くなるかもしれません。必
要に応じて画像を回転させたりトリミングしたりして、画像を保存します。保存の
際は、レイヤー、マスク、アルファチャンネルなどが保存されるように、各ソフト
ウェア専用のフォーマットを選択します。GIMPをお使いの方は「XCF」、Adobe
Photoshopをお使いの方は「PSD」などを選択して下さい。 Photoshopをお使いの方は「PSD」などを選択して下さい。
画像編集ソフトで画像を回転させたり切り抜いたりした場合は、マスクやアルファチャンネルのない1層の RGB レイヤーに統合して下さい。 画像編集ソフトで画像を回転させたり切り抜いたりした場合は、マスクやアルファ
チャンネルのない1層の RGB レイヤーに統合して下さい。
レイヤーダイアログボックスを開いて、以下のように、レイヤーを上から順に何度か複製します: レイヤーダイアログボックスを開いて、以下のように、レイヤーを上から順に何度
か複製します:
1. 編集前の画像(可能であればプロテクトする) 1. 編集前の画像(可能であればプロテクトする)
2. 編集を行う画像- "作業用" レイヤー 2. 編集を行う画像- "作業用" レイヤー
@ -83,111 +111,175 @@
4. マゼンダ1色のレイヤー(可能であればプロテクトする) 4. マゼンダ1色のレイヤー(可能であればプロテクトする)
5. 編集前の画像(可能であればプロテクトする) 5. 編集前の画像(可能であればプロテクトする)
作業用レイヤーに、大まかに初期マスクを作成します。選択範囲から始めても良いですし、作業レイヤーのグレースケール値を用いても良いでしょう。また、マスクを反転させることもできます。 作業用レイヤーに、大まかに初期マスクを作成します。選択範囲から始めても良い
ですし、作業レイヤーのグレースケール値を用いても良いでしょう。また、マスク
を反転させることもできます。
注: マスクを設定した後は、画像の回転や拡大縮小は行えません。これはデータ損失の原因となります。サイズを調整するための特別な方法は後述します。 注: マスクを設定した後は、画像の回転や拡大縮小は行えません。これはデータ損
失の原因となります。サイズを調整するための特別な方法は後述します。
---------------------------------------------------------------------- -------------------------------------------------------------------------------
マスクの設定 マスクの設定
レイヤーダイアログのサムネイル画像を [Control] キーを押しながらクリックしたり、[Alt] レイヤーダイアログのサムネイル画像を [Control] キーを押しながらクリックした
キーを押しながらクリックしたりすることに慣れておきましょう。これは、何を見て何を編集しているかを把握するために必要となります。例えば、変更されていない画像を見ながら作業用レイヤーのマスクを編集する場合など、見えていないものを編集することもあります。混乱して間違ってしまわないように注意してください。自分が編集しているものが正しいかどうかを常に確認するようにしましょう。 り、[Alt] キーを押しながらクリックしたりすることに慣れておきましょう。これ
は、何を見て何を編集しているかを把握するために必要となります。例えば、変更
されていない画像を見ながら作業用レイヤーのマスクを編集する場合など、見えて
いないものを編集することもあります。混乱して間違ってしまわないように注意し
てください。自分が編集しているものが正しいかどうかを常に確認するようにしま
しょう。
一番上のオリジナル画像のレイヤーを表示しながら、作業用レイヤーに対して編集を加えるするように設定します。編集作業の必要に応じて画像を約400に拡大してください画像の各ピクセルを画面上 一番上のオリジナル画像のレイヤーを表示しながら、作業用レイヤーに対して編集
4x4 ピクセルのブロックとして表示し、編集することができます) を加えるするように設定します。編集作業の必要に応じて画像を約400に拡大して
ください(画像の各ピクセルを画面上 4x4 ピクセルのブロックとして表示し、編集
することができます)
Select parts of the image that need to be 100% opaque or 0% opaque. If Select parts of the image that need to be 100% opaque or 0% opaque. If you
you can select the object or background somewhat accurately by color, do can select the object or background somewhat accurately by color, do so. As
so. As needed to avoid selecting any pixels that should be partially needed to avoid selecting any pixels that should be partially opaque
opaque (generally at the edge of the object) you should grow, shrink, (generally at the edge of the object) you should grow, shrink, and invert
and invert the selection. the selection.
Fill the 100% opaque areas with white, and the 0% opaque areas with Fill the 100% opaque areas with white, and the 0% opaque areas with black.
black. This is most easily done by drag-and-drop from the This is most easily done by drag-and-drop from the foreground/background
foreground/background color indicator. You should not see anything color indicator. You should not see anything happen, because you are
happen, because you are viewing the unmodified image layer while editing viewing the unmodified image layer while editing the mask of the WIP layer.
the mask of the WIP layer. Large changes might be noticable in the Large changes might be noticable in the thumbnail.
thumbnail.
次に、画像を拡大します。 次に、画像を拡大します。
作業内容を確認します。まず、一番上のオリジナルレイヤーを隠します。マスクだけを表示すると、黒の背景に白のオブジェクトが表示されるはずです 作業内容を確認します。まず、一番上のオリジナルレイヤーを隠します。マスクだ
(おそらく輪郭の部分には未編集のグレーが表示されます)。次に けを表示すると、黒の背景に白のオブジェクトが表示されるはずです (おそらく輪
作業用レイヤーを通常通り表示し、マスクがアクティブになるようにします。これで、あなたのオブジェクトが、次の有効レイヤーの上に表示されるはずです。このレイヤーは、コントラストを最大にするために、必要に応じてグリーンまたはマゼンタにする必要があります。緑のレイヤーを繰り返しクリックして有効/無効にすることで、これらの背景を行ったり来たりすることができます。マスクを見ながら編集して、単純なミスを修正します。 郭の部分には未編集のグレーが表示されます)。次に作業用レイヤーを通常通り表示
し、マスクがアクティブになるようにします。これで、あなたのオブジェクトが、
次の有効レイヤーの上に表示されるはずです。このレイヤーは、コントラストを最
大にするために、必要に応じてグリーンまたはマゼンタにする必要があります。緑
のレイヤーを繰り返しクリックして有効/無効にすることで、これらの背景を行った
り来たりすることができます。マスクを見ながら編集して、単純なミスを修正しま
す。
作業用レイヤーのマスクを編集しながら、一番上のオリジナルレイヤーの表示に戻ります。描画ツールを「ブラシ」に設定します。ブラシには、円形の小さなぼかし筆を選びます。5x5 作業用レイヤーのマスクを編集しながら、一番上のオリジナルレイヤーの表示に戻
サイズがほとんどの場合に適しています。 ります。描画ツールを「ブラシ」に設定します。ブラシには、円形の小さなぼかし
筆を選びます。5x5 サイズがほとんどの場合に適しています。
ゆっくりとぶれないように画像の輪郭をトレースします。外側には黒色、内側には白色を使います。色を変更しないまま複数のパスにならないように注意して下さい。 ゆっくりとぶれないように画像の輪郭をトレースします。外側には黒色、内側には
白色を使います。色を変更しないまま複数のパスにならないように注意して下さい
表示をちらっと反転させ、マスクがうまく機能していることを確認します。作業用レイヤーをグリーンまたはマゼンタの上に合成すると、元の背景が、境界周りのほんのわずかなギザギザした縁取りのように見えるはずです。この縁取りが見えない場合、オブジェクトマスクを小さくしすぎたことになります。この縁取りを構成するピクセルは、完全にオブジェクト内でもオブジェクト外でもありません。そのため、マスクは100%でも0%でもありません。この縁取りはこの後に取り除かれます。 表示をちらっと反転させ、マスクがうまく機能していることを確認します。作業用
レイヤーをグリーンまたはマゼンタの上に合成すると、元の背景が、境界周りのほ
んのわずかなギザギザした縁取りのように見えるはずです。この縁取りが見えない
場合、オブジェクトマスクを小さくしすぎたことになります。この縁取りを構成す
るピクセルは、完全にオブジェクト内でもオブジェクト外でもありません。そのた
め、マスクは100%でも0%でもありません。この縁取りはこの後に取り除かれます。
マスクを表示して編集します。黒か白の色で領域を選択します。ほとんどの場合、選択されていない色の斑点が残っていると思います。選択範囲を反転させ、鉛筆ツールを使ってこれらの点を取り除きます。この作業を白と黒の両方で行います。 マスクを表示して編集します。黒か白の色で領域を選択します。ほとんどの場合、
選択されていない色の斑点が残っていると思います。選択範囲を反転させ、鉛筆ツ
ールを使ってこれらの点を取り除きます。この作業を白と黒の両方で行います。
---------------------------------------------------------------------- -------------------------------------------------------------------------------
縁取りと不要なピクセルの除去 縁取りと不要なピクセルの除去
マスクをを表示しながら、黒で領域を選択した後、選択範囲を数ピクセル縮小します。ただし、マスクの端から縮小しないように注意してください(縮小することで、ミスを防いだりやり直したりすることができます) マスクをを表示しながら、黒で領域を選択した後、選択範囲を数ピクセル縮小しま
す。ただし、マスクの端から縮小しないように注意してください(縮小することで
、ミスを防いだりやり直したりすることができます)
ここでマスクを無効にします。マスクされていない作業用レイヤーを表示して編集します。色選択ツールを使って、対象の平均的な色を選択します。この色を選択範囲にドラッグ&ドロップすると、オブジェクト以外のピクセルのほとんどが削除されます。 ここでマスクを無効にします。マスクされていない作業用レイヤーを表示して編集
します。色選択ツールを使って、対象の平均的な色を選択します。この色を選択範
囲にドラッグ&ドロップすると、オブジェクト以外のピクセルのほとんどが削除さ
れます。
この単色の領域は、Tux この単色の領域は、Tux Paintが画像を縮小する際に生じる縁取りを抑制するのに役
Paintが画像を縮小する際に生じる縁取りを抑制するのに役立ちます。オブジェクトの輪郭に大きく異なる複数の色がある場合は、選択範囲を分割して、近くの背景が似たような色になるようにします。 立ちます。オブジェクトの輪郭に大きく異なる複数の色がある場合は、選択範囲を
分割して、近くの背景が似たような色になるようにします。
ここで、輪郭周りの縁取りを消去します。作業用レイヤーの画像を編集、表示していることを確認してください。以下の全てのレイヤーを頻繁に切り替えて表示することで、自分が何をしているのかを確認することができます: ここで、輪郭周りの縁取りを消去します。作業用レイヤーの画像を編集、表示して
いることを確認してください。以下の全てのレイヤーを頻繁に切り替えて表示する
ことで、自分が何をしているのかを確認することができます:
* グリーン との合成(マスク有効) + グリーンとの合成(マスク有効)
* マゼンタ との合成(マスク有効) + マゼンタとの合成(マスク有効)
* オリジナル(一番上、または一番下のレイヤー) + オリジナル(一番上、または一番下のレイヤー)
* オリジナル との合成(マスク有効) + オリジナルとの合成(マスク有効)
* 作業用レイヤー(マスク無効) + 作業用レイヤー(マスク無効)
失敗を減らすために、マスクの中の灰色ではないピクセルだけを選択するとよいでしょう。(「マスクから色で領域選択、黒を選択、色加算モード、白を選択、反転」あるいは「すべてを選択、マスクから色で領域選択、色減算モード、黒を選択、白を選択」)この作業を行う際、選択範囲を少し広げて、選択領域を示す線を隠したくなるかもしれません。 失敗を減らすために、マスクの中の灰色ではないピクセルだけを選択するとよいで
しょう。(「マスクから色で領域選択、黒を選択、色加算モード、白を選択、反転
」あるいは「すべてを選択、マスクから色で領域選択、色減算モード、黒を選択、
白を選択」)この作業を行う際、選択範囲を少し広げて、選択領域を示す線を隠し
たくなるかもしれません。
Use the clone tool and the brush tool. Vary the opacity as needed. Use Use the clone tool and the brush tool. Vary the opacity as needed. Use
small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is small round brushes mostly, perhaps 3x3 or 5x5, fuzzy or not. (It is
generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy
brushes with about 70% opacity.) Unusual drawing modes can be helpful brushes with about 70% opacity.) Unusual drawing modes can be helpful with
with semi-transparent objects. semi-transparent objects.
最終目標は、オブジェクトの内側と外側の両方の縁取りを除去することです。内側の縁取りは、マゼンタやグリーンの上にオブジェクトを合成したときに見えるもので、明らかに除去が必要です。外側のフリンジは、画像を縮小したときに見えるようになるため、こちらも除去する必要があります。例として、鋭角なオブジェクトの輪郭にある2x2のピクセルの領域を考えてみましょう。左半分は黒で、不透明度は0。右半分は白で、100不透明です。つまり、黒い背景に白い物体がある状態です。Tux 最終目標は、オブジェクトの内側と外側の両方の縁取りを除去することです。内側
Paintがこれを501x1ピクセルの領域にスケーリングすると、結果はグレーの50不透明ピクセルになりますが、正しい結果は、白の50不透明ピクセルです。この結果を得るためには、黒いピクセルを塗り潰します。不透明度が0であるにもかかわらず、黒いピクセルは重要です。 の縁取りは、マゼンタやグリーンの上にオブジェクトを合成したときに見えるもの
で、明らかに除去が必要です。外側のフリンジは、画像を縮小したときに見えるよ
うになるため、こちらも除去する必要があります。例として、鋭角なオブジェクト
の輪郭にある2x2のピクセルの領域を考えてみましょう。左半分は黒で、不透明度は
0。右半分は白で、100不透明です。つまり、黒い背景に白い物体がある状態で
す。Tux Paintがこれを501x1ピクセルの領域にスケーリングすると、結果は
グレーの50不透明ピクセルになりますが、正しい結果は、白の50不透明ピクセ
ルです。この結果を得るためには、黒いピクセルを塗り潰します。不透明度が0
あるにもかかわらず、黒いピクセルは重要です。
Tux Paint Tux Paint では、画像を非常に大きく縮小することができるため、オブジェクトの
では、画像を非常に大きく縮小することができるため、オブジェクトの輪郭を外側に大きく広げることが重要です。オブジェクトの輪郭の部分では、非常に正確に処理する必要がありますが、輪郭から離れるにつれて、少々手を抜いても大丈夫です。十数ピクセル以上外側まで描くとちょうど良くなります。これを太くすればするだけ、Tux 輪郭を外側に大きく広げることが重要です。オブジェクトの輪郭の部分では、非常
Paintは汚い色の縁どりを発生させずにスケールダウンすることができます。オブジェクトの端から数ピクセル以上離れた部分については、鉛筆ツールまたはドラッグドロップで適当に色を選択を使用して、結果がきれいに縮小されるようにしてください。 に正確に処理する必要がありますが、輪郭から離れるにつれて、少々手を抜いても
大丈夫です。十数ピクセル以上外側まで描くとちょうど良くなります。これを太く
すればするだけ、Tux Paintは汚い色の縁どりを発生させずにスケールダウンするこ
とができます。オブジェクトの端から数ピクセル以上離れた部分については、鉛筆
ツール(またはドラッグ&ドロップで適当に色を選択)を使用して、結果がきれい
に縮小されるようにしてください。
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint 用の画像の保存 Tux Paint 用の画像の保存
It is very easy to ruin your hard work. Image editors can silently It is very easy to ruin your hard work. Image editors can silently destroy
destroy pixels in 0% opaque areas. The conditions under which this pixels in 0% opaque areas. The conditions under which this happens may vary
happens may vary from version to version. If you are very trusting, you from version to version. If you are very trusting, you can try saving your
can try saving your image directly as a PNG. Be sure to read it back in image directly as a PNG. Be sure to read it back in again to verify that
again to verify that the 0% opaque areas didn't turn black or white, the 0% opaque areas didn't turn black or white, which would create fringes
which would create fringes when Tux Paint scales the image down. If you when Tux Paint scales the image down. If you need to scale your image to
need to scale your image to save space (and hide your mistakes), you are save space (and hide your mistakes), you are almost certain to destroy all
almost certain to destroy all the 0% opaque areas. So here is a better the 0% opaque areas. So here is a better way...
way...
より安全な保存方法 より安全な保存方法
マスクをレイヤーダイアログからツールバーの未使用部分最後の描画ツールの直後にドラッグします。これで、マスクデータを含む1つのレイヤーからなる新しい画像が作成されます。これを、使用する設定に応じた希望のサイズまで縮小します。多くの場合、7001500ピクセル程度の画像から始めて、最終的には300400ピクセル程度の画像を作成します。 マスクをレイヤーダイアログからツールバーの未使用部分(最後の描画ツール
の直後にドラッグします。これで、マスクデータを含む1つのレイヤーからな
る新しい画像が作成されます。これを、使用する設定に応じた希望のサイズま
で縮小します。多くの場合、7001500ピクセル程度の画像から始めて、最終的
には300400ピクセル程度の画像を作成します。
マスク画像を NetPBM の Portable Greymap (".pgm") ファイルとして保存します。(古いバージョンの マスク画像を NetPBM の Portable Greymap (".pgm") ファイルとして保存しま
GIMPを使用している場合は、保存する前に画像をグレースケールに変換する必要があるかもしれません)。よりコンパクトな「RAW す。(古いバージョンの GIMPを使用している場合は、保存する前に画像をグレ
PGM」フォーマットを選択して保存します。(ファイルの2文字目はASCII数字の「5」、16進数のバイト0x35である必要があります) ースケールに変換する必要があるかもしれません)。よりコンパクトな「RAW
PGM」フォーマットを選択して保存します。(ファイルの2文字目はASCII数字の
「5」、16進数のバイト0x35である必要があります)
マスク画像を閉じます マスク画像を閉じます
マルチレイヤー画像に戻って、作業用レイヤーを選択します。マスクと同じように、レイヤーダイアログからツールバーにドラッグしてください。これで作業用データの単一レイヤー画像ができあがります。マスクが付いていた場合は取り除かれます。レイヤーダイアログにマスクのサムネイルが表示されていない状態で、オブジェクトと輪郭の縁取りが表示されているはずです。マスクを拡大縮小したのであれば、この画像も同様に正確に拡大縮小してください。この画像を マルチレイヤー画像に戻って、作業用レイヤーを選択します。マスクと同じよ
NetPBM の Portable pixmap (".ppm") ファイルとして保存します。(注: .ppm ではなく .pgm です。) うに、レイヤーダイアログからツールバーにドラッグしてください。これで作
(RAW PPMフォーマットを選択した場合、ファイルの2バイト目はASCII数字の "6"、16進数のバイト0x36である必要があります) 業用データの単一レイヤー画像ができあがります。マスクが付いていた場合は
取り除かれます。レイヤーダイアログにマスクのサムネイルが表示されていな
い状態で、オブジェクトと輪郭の縁取りが表示されているはずです。マスクを
拡大縮小したのであれば、この画像も同様に正確に拡大縮小してください。こ
の画像を NetPBM の Portable pixmap (".ppm") ファイルとして保存します。
(注: .ppm ではなく .pgm です。) (RAW PPMフォーマットを選択した場合、フ
ァイルの2バイト目はASCII数字の "6"、16進数のバイト0x36である必要があり
ます)
最後に、以下のように pnmtopng コマンドで、2つのファイルを1つに合成します: 最後に、以下のように pnmtopng コマンドで、2つのファイルを1つに合成し
ます:
pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm >
final-stamp.png final-stamp.png

View file

@ -7,91 +7,97 @@
2023年5月 5日 2023年5月 5日
---------------------------------------------------------------------- -------------------------------------------------------------------------------
Tux Paint understands a number of environment variables, either directly, Tux Paint understands a number of environment variables, either directly, or
or indirectly by the libraries that it utilizes. 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 Specifies the user's "home directory", which is used to locate numerous
numerous other files or directories. In some cases, it is utilized other files or directories. In some cases, it is utilized as part of a
as part of a fall-back location, when other environment variables fall-back location, when other environment variables (elsewhere in this
(elsewhere in this documentation) are not set. Sometimes, the documentation) are not set. Sometimes, the location to use can be
location to use can be overridden by options provided on the overridden by options provided on the command-line or via Tux Paint's
command-line or via Tux Paint's configuration file. See the configuration file. See the "OPTIONS" documentation for details.
"OPTIONS" documentation for details.
A few examples of where "$HOME" is used include: A few examples of where "$HOME" is used include:
* The location of Tux Paint's configuration file + The location of Tux Paint's configuration file
* The basis of where Tux Paint saves and loads users' drawings + The basis of where Tux Paint saves and loads users' drawings
* The location of a user's private collection of data files — + The location of a user's private collection of data files — stamps,
stamps, brushes, etc. — (versus those available system wide) brushes, etc. — (versus those available system wide)
XDG_CONFIG_HOME XDG_CONFIG_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's configuration files. the location of the user's configuration files. Specifically, where to find
Specifically, where to find "user-dirs.dirs", where the "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used
"XDG_PICTURES_DIR" might be defined. It is used for exporting for exporting drawings and animated GIFs. Generally it's set to something
drawings and animated GIFs. Generally it's set to something like like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory
"$HOME/Pictures/". If not specified, Tux Paint checks in the "$HOME/.config/". If the configuration cannot be found, Tux Paint simply
directory "$HOME/.config/". If the configuration cannot be found, exports drawings and GIFs to "$HOME".
Tux Paint simply exports drawings and GIFs to "$HOME".
XDG_DATA_HOME XDG_DATA_HOME
On Linux and other platforms where the X Desktop Group standards On Linux and other platforms where the X Desktop Group standards are used,
are used, the location of the user's data directories. the location of the user's data directories. Specifically, where to find
Specifically, where to find the "Trash" directory. It is used when the "Trash" directory. It is used when deleting images from Tux Paint's
deleting images from Tux Paint's "Open" dialog. If not set, the "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is
location "$HOME/.local/share/Trash/" is used, if available. If used, if available. If not, images are simply deleted, rather than moved
not, images are simply deleted, rather than moved anywhere. anywhere.
TEMP TEMP
Specifies the location where temporary files may be created. Only Specifies the location where temporary files may be created. Only used by
used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set.
not set.
Language-related environment variables Language-related environment variables
LANG LANG
LANGUAGE LANGUAGE
LC_ALL LC_ALL
LC_MESSAGES LC_MESSAGES
Specify the language Tux Paint should utilize in its user Specify the language Tux Paint should utilize in its user interface.
interface. Overridde by the "--lang" and "--locale" command-line Overridde by the "--lang" and "--locale" command-line options or their
options or their configuration file counterparts. The "LANGUAGE" configuration file counterparts. The "LANGUAGE" environment variable is
environment variable is used, if set. If not, "LC_ALL" is used as used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES",
a fallback. Then "LC_MESSAGES", and finally "LANG". and finally "LANG".
Display-related environment variables Display-related environment variables
The following are a few of the environment variables supported by Simple The following are a few of the environment variables supported by Simple
DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics,
graphics, playing sounds, and receiving mouse, keyboard, and joystick playing sounds, and receiving mouse, keyboard, and joystick input — and which
input — and which may be useful to users of Tux Paint. 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 Specifies whether Tux Paint should allow a screensaver to run. Can be set
be set to '1' (true) by Tux Paint itself by issuing the to '1' (true) by Tux Paint itself by issuing the command-line option
command-line option "--allowscreensaver" or its configuration file "--allowscreensaver" or its configuration file counterpart.
counterpart.
SDL_VIDEO_WINDOW_POS SDL_VIDEO_WINDOW_POS
Requests where to position Tux Paint's window, and can be used to Requests where to position Tux Paint's window, and can be used to specify
specify what display to place a fullscreen Tux Paint in a what display to place a fullscreen Tux Paint in a multi-monitor
multi-monitor configuration. If not set, or set to "nopref" configuration. If not set, or set to "nopref" (meaning "no preference"),
(meaning "no preference"), Simple DirectMedia Layer (libSDL) Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate
decides. Can be set to an X,Y coordinate (e.g. 200,100), or (e.g. 200,100), or "center" (meaning "center").
"center" (meaning "center").

File diff suppressed because it is too large Load diff

View file

@ -6,8 +6,7 @@
2023年7月13日 2023年7月13日
---------------------------------------------------------------------- -------------------------------------------------------------------------------
+------------------------------+ +------------------------------+
| 目次 | | 目次 |
|------------------------------| |------------------------------|
@ -20,549 +19,549 @@
| * Other Problems | | * Other Problems |
| * Help / Contact | | * Help / Contact |
+------------------------------+ +------------------------------+
-------------------------------------------------------------------------------
----------------------------------------------------------------------
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 The TrueType Font you're using might have the wrong encoding. If it's
it's 'custom' encoded, for example, you can try running it through 'custom' encoded, for example, you can try running it through FontForge (
FontForge (http://fontforge.sourceforge.net/) to convert it to an http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format.
ISO-8859 format. (Email us if you need help with special fonts.) (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, This means that Tux Paint either couldn't find any stamp images, or was
or was asked not to load them. asked not to load them.
If you installed Tux Paint, but did not install the separate, If you installed Tux Paint, but did not install the separate, optional
optional "Stamps" collection, quit Tux Paint and install it now. "Stamps" collection, quit Tux Paint and install it now. It should be
It should be available from the same place you got the main Tux available from the same place you got the main Tux Paint program. (Note: As
Paint program. (Note: As of version 0.9.14, Tux Paint comes with a of version 0.9.14, Tux Paint comes with a small collection of example
small collection of example stamps.) stamps.)
If you don't want to install the default collection of stamps, you If you don't want to install the default collection of stamps, you can just
can just create your own. See the "Extending Tux Paint" create your own. See the "Extending Tux Paint" documentation for more on
documentation for more on creating PNG and SVG image files, TXT creating PNG and SVG image files, TXT text description files, Ogg Vorbis,
text description files, Ogg Vorbis, MP3 or WAV sound files, and MP3 or WAV sound files, and DAT text data files that make up stamps.
DAT text data files that make up stamps.
Finally, if you installed stamps, and think they should be loading, check
to see that the "nostamps" option isn't being set. (Either via a
"--nostamps" option to Tux Paint's command line, or "nostamps=yes" in the
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.
Finally, if you installed stamps, and think they should be
loading, check to see that the "nostamps" option isn't being set.
(Either via a "--nostamps" option to Tux Paint's command line, or
"nostamps=yes" in the 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.
Stamp outlines are always rectangles Stamp outlines are always rectangles
Tux Paint was built with low-quality (but faster) stamp outlines. Tux Paint was built with low-quality (but faster) stamp outlines.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_STAMP_OUTLINE #define LOW_QUALITY_STAMP_OUTLINE
in the "tuxpaint.c" file in the "src" directory. 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 Tux Paint was probably compiled with the faster, lower quality thumbnail
thumbnail code enabled. Run the command: "tuxpaint code enabled. Run the command: "tuxpaint --verbose-version" from a command
--verbose-version" from a command line. If, amongst the other line. If, amongst the other output, you see the text: "Low Quality
output, you see the text: "Low Quality Thumbnails enabled", then Thumbnails enabled", then this is what's happening.
this is what's happening.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define LOW_QUALITY_THUMBNAILS #define LOW_QUALITY_THUMBNAILS
in the "tuxpaint.c" file in the "src" directory. 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 "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the
thumbnails in the Stamp Selector look bad", above. Stamp Selector look bad", above.
All of the text is in uppercase! All of the text is in uppercase!
The "uppercase" option is on. The "uppercase" option is on.
Either change/remove the "uppercase" option, or you can override Either change/remove the "uppercase" option, or you can override it with
it with "--mixedcase" on the command line or either "uppercase=no" "--mixedcase" on the command line or either "uppercase=no" or "mixedcase=
or "mixedcase=yes" in a configuration file. 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 Make sure your locale setting is correct. See "Tux Paint won't switch to my
switch to my language", below. 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 + Linux and Unix users: Make sure the locale is available
Make sure the locale you want is available. Check your Make sure the locale you want is available. Check your "/etc/
"/etc/locale.gen" file. See the "Options Documentation" for locale.gen" file. See the "Options Documentation" for the locales Tux
the locales Tux Paint uses (especially when using the Paint uses (especially when using the "--lang" option).
"--lang" option).
Note: Debian and derivative (e.g., Ubuntu) users can simply Note: Debian and derivative (e.g., Ubuntu) users can simply run
run "dpkg-reconfigure locales" if the locales are managed by "dpkg-reconfigure locales" if the locales are managed by "dpkg".
"dpkg".
* If you're using the "--lang" command-line option + If you're using the "--lang" command-line option
Try using the "--locale" command-line option, or your Try using the "--locale" command-line option, or your operating
operating system's locale settings (e.g., the "$LANG" system's locale settings (e.g., the "$LANG" environment variable), and
environment variable), and please e-mail us regarding your please e-mail us regarding your trouble.
trouble.
* If you're using the "--locale" command-line option + If you're using the "--locale" command-line option
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* If you're trying to use your Operating System's locale + If you're trying to use your Operating System's locale
If this doesn't work, please e-mail us regarding your If this doesn't work, please e-mail us regarding your trouble.
trouble.
* Make sure you have the necessary font + Make sure you have the necessary font
Some translations require their own font. Chinese and Korean, Some translations require their own font. Chinese and Korean, for
for example, need Chinese and Korean TrueType Fonts installed example, need Chinese and Korean TrueType Fonts installed and placed in
and placed in the proper location, respectively. the proper location, respectively.
The appropriate fonts for such locales can be downloaded from The appropriate fonts for such locales can be downloaded from the Tux
the Tux Paint website: Paint website:
https://tuxpaint.org/download/fonts/ https://tuxpaint.org/download/fonts/
----------------------------------------------------------------------
-------------------------------------------------------------------------------
印刷 印刷
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 Tux Paint prints by creating a PostScript rendition of the picture and
and sending it to an external command. By default, this command is sending it to an external command. By default, this command is the "lpr"
the "lpr" printing tool. printing tool.
If that program is not available (for example, you're using CUPS, If that program is not available (for example, you're using CUPS, the
the Common Unix Printing System, and do not have "cups-lpr" Common Unix Printing System, and do not have "cups-lpr" installed), you
installed), you will need to specify an appropriate command using will need to specify an appropriate command using the "printcommand" option
the "printcommand" option in Tux Paint's configuration file. (See 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.
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.
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.
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 The "print delay" option is on. You can only print once every X seconds.
seconds.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--printdelay=..." option. giving it a "--printdelay=..." option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--printdelay=..." is listed as a properties of the icon to see if "--printdelay=..." is listed as a
command-line argument. command-line argument.
If a "--printdelay=..." option isn't being sent on the command If a "--printdelay=..." option isn't being sent on the command line, check
line, check Tux Paint's configuration file for a line reading: Tux Paint's configuration file for a line reading: "printdelay=...".
"printdelay=...".
Either remove that line, set the delay value to 0 (no delay), or Either remove that line, set the delay value to 0 (no delay), or decrease
decrease the delay to a value you prefer. (See the "Options the delay to a value you prefer. (See the "Options Documentation".)
Documentation".)
Or, you can simply run Tux Paint with the command-line argument: Or, you can simply run Tux Paint with the command-line argument:
"--printdelay=0", which will override the configuration file's "--printdelay=0", which will override the configuration file's setting, and
setting, and allow unlimited printing. (You won't have to wait allow unlimited printing. (You won't have to wait between prints.)
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. The "no print" option is on.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noprint" option. giving it a "--noprint" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noprint" is listed as a properties of the icon to see if "--noprint" is listed as a command-line
command-line argument. argument.
If a "--noprint" option isn't being sent on the command line, If a "--noprint" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "noprint=yes".
"noprint=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--print", which will override the argument: "--print", which will override the configuration file's setting.
configuration file's setting.
Or use Tux Paint Config. and make sure "Allow Printing" (under Or use Tux Paint Config. and make sure "Allow Printing" (under "印刷") is
"印刷") is checked. checked.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
保存 保存
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 Unless you asked Tux Paint to save into a specific location (using the
the "savedir" option), Tux Paint saves into a standard location on "savedir" option), Tux Paint saves into a standard location on your local
your local drive: drive:
Windows Vista, Windows 8, Windows 10, Windows 11 Windows Vista, Windows 8, Windows 10, Windows 11
In the user's "AppData" folder: In the user's "AppData" folder:
e.g., e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved
C:\Users\Username\AppData\Roaming\TuxPaint\saved
macOS macOS
In the user's "Application Support" folder: In the user's "Application Support" folder:
e.g., /Users/Username/Library/Applicaton e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/
Support/TuxPaint/saved/
Linux / Unix Linux / Unix
In the user's home directory ("$HOME"), under a In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder:
".tuxpaint" subfolder:
e.g., /home/username/.tuxpaint/saved/ 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 The images are stored as PNG bitmaps, which most modern programs should be
browsers, etc.) 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 The "save over" option is enabled. (This disables the prompt that would
would appear when you click 'Save.') appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveover" option. giving it a "--saveover" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveover" is listed as a properties of the icon to see if "--saveover" is listed as a command-line
command-line argument. argument.
If a "--saveover" option isn't being sent on the command line, If a "--saveover" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=yes".
"saveover=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under "保
(under "保存") is checked. 存") is checked.
Also, see "Tux Paint always saves a new picture!", below. 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 The "never save over" option is enabled. (This disables the prompt that
that would appear when you click 'Save.') would appear when you click 'Save.')
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--saveovernew" option. giving it a "--saveovernew" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--saveovernew" is listed as a properties of the icon to see if "--saveovernew" is listed as a
command-line argument. command-line argument.
If a "--saveovernew" option isn't being sent on the command line, If a "--saveovernew" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "saveover=new".
"saveover=new".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--saveoverask", which will override the argument: "--saveoverask", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Ask Before Overwriting" Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under "保
(under "保存") is checked. 存") is checked.
Also, see "Tux Paint always saves over my old picture!", above. 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: + First, check the obvious:
* Are your speakers connected and turned on? o Are your speakers connected and turned on?
* Is the volume turned up on your speakers? o Is the volume turned up on your speakers?
* Is the volume turned up in your Operating System's o Is the volume turned up in your Operating System's "mixer?"
"mixer?" o Are you certain you're using a computer with a sound card?
* Are you certain you're using a computer with a sound o Are any other programs running that use sound? (They may be
card? 'blocking' Tux Paint from accessing your sound device)
* Are any other programs running that use sound? (They may o (Unix/Linux) Are you using a sound system, such as aRts, ESD or
be 'blocking' Tux Paint from accessing your sound GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment
device) variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER=
* (Unix/Linux) Are you using a sound system, such as aRts, arts"). Or, run Tux Paint through the system's rerouter (e.g., run
ESD or GStreamer? If so, try setting the "artsdsp tuxpaint" or "esddsp tuxpaint", instead of simply
"SDL_AUDIODRIVER" environment variable before running "tuxpaint").
Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run + Is sound disabled in Tux Paint?
Tux Paint through the system's rerouter (e.g., run
"artsdsp tuxpaint" or "esddsp tuxpaint", instead of
simply "tuxpaint").
* Is sound disabled in Tux Paint?
If sound seems to work otherwise (and you're sure no other If sound seems to work otherwise (and you're sure no other program is
program is "blocking" the sound device), then Tux Paint may "blocking" the sound device), then Tux Paint may be running with a "no
be running with a "no sound" option. sound" option.
If you're running Tux Paint from a command-line, make sure If you're running Tux Paint from a command-line, make sure you're not
you're not giving it a "--nosound" option. giving it a "--nosound" option.
If you're running Tux Paint by double-clicking an icon, check If you're running Tux Paint by double-clicking an icon, check the
the properties of the icon to see if "--nosound" is listed as properties of the icon to see if "--nosound" is listed as a
a command-line argument. command-line argument.
If a "--nosound" option isn't being sent on the command line, If a "--nosound" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "nosound=yes".
"nosound=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--sound", which will override the argument: "--sound", which will override the configuration file's
configuration file's setting. setting.
Or, you can simply run Tux Paint with the command-line Or, you can simply run Tux Paint with the command-line argument:
argument: "Enable Sound Effects", which will override the "Enable Sound Effects", which will override the configuration file's
configuration file's setting, and allow unlimited printing. setting, and allow unlimited printing. (You won't have to wait between
(You won't have to wait between prints.) prints.)
* Were sounds temporarily disabled? + Were sounds temporarily disabled?
Even if sounds are enabled in Tux Paint, it is possible to Even if sounds are enabled in Tux Paint, it is possible to disable and
disable and re-enable them temporarily using the [Alt] + [S] re-enable them temporarily using the [Alt] + [S] key sequence. Try
key sequence. Try pressing those keys to see if sounds begin pressing those keys to see if sounds begin working again.
working again.
* Was Tux Paint built without sound support? + Was Tux Paint built without sound support?
Tux Paint may have been compiled with sound support disabled. Tux Paint may have been compiled with sound support disabled. To test
To test whether sound support was enabled when Tux Paint was whether sound support was enabled when Tux Paint was compiled, run Tux
compiled, run Tux Paint from a command line, like so: Paint from a command line, like so:
tuxpaint --verbose-version tuxpaint --verbose-version
If, amongst the other information, you see "Sound disabled", If, amongst the other information, you see "Sound disabled", then the
then the version of Tux Paint you're running has sound version of Tux Paint you're running has sound disabled. Recompile Tux
disabled. Recompile Tux Paint, and be sure NOT to build the Paint, and be sure NOT to build the "nosound" target. (i.e., don't run
"nosound" target. (i.e., don't run "make nosound") Be sure "make nosound") Be sure the SDL_mixer library and its development
the SDL_mixer library and its development headers are headers are available!
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: Yes, there are a number of ways to disable sounds in Tux Paint:
* Press [Alt] + [S] while in Tux Paint to temporarily disable + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds.
sounds. (Press that key sequence again to re-enable sounds.) (Press that key sequence again to re-enable sounds.)
* Run Tux Paint with the "no sound" option: + Run Tux Paint with the "no sound" option:
* Run "tuxpaint --nosound" from the command line or o Run "tuxpaint --nosound" from the command line or shortcut or
shortcut or desktop icon. desktop icon.
* Edit Tux Paint's configuration file (see "Options o Edit Tux Paint's configuration file (see "Options Documentation"
Documentation" for details) and add a line containing for details) and add a line containing "nosound=yes".
"nosound=yes". o Or use Tux Paint Config. and make sure "Enable Sound Effects"
* Or use Tux Paint Config. and make sure "Enable Sound (under "Video & Sound") is not checked.
Effects" (under "Video & Sound") is not checked. o Alternatively, recompile Tux Paint with sound support disabled.
* Alternatively, recompile Tux Paint with sound support (See above, and the 'Install' documentation.
disabled. (See above, and the 'Install' documentation.
The stereo panning of sound effects is bothersome; can sound effects be The stereo panning of sound effects is bothersome; can sound effects be
monophonic? monophonic?
Run Tux Paint with the "no stereo" option: Run Tux Paint with the "no stereo" option:
* Run "tuxpaint --nostereo" from the command line or shortcut + Run "tuxpaint --nostereo" from the command line or shortcut or desktop
or desktop icon. icon.
* Edit Tux Paint's configuration file (see "Options + Edit Tux Paint's configuration file (see "Options Documentation" for
Documentation" for details) and add a line containing details) and add a line containing "nostereo=yes".
"nostereo=yes". + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under
* Or use Tux Paint Config. and make sure "Enable Stereo "Video & Sound") is not checked.
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. This could have to do with how SDL and SDL_mixer were initialized. (The
(The buffer size chosen.) buffer size chosen.)
Please e-mail us with details about your computer system. Please e-mail us with details about your computer system. (Operating system
(Operating system and version, sound card, which version of Tux and version, sound card, which version of Tux Paint you're running (run
Paint you're running (run "tuxpaint --version" to verify), and so "tuxpaint --version" to verify), and so on.)
on.)
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Fullscreen Mode Problems Fullscreen Mode Problems
When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black!
black!
This is apparently a bug in the SDL library. Sorry. 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 Linux users - Your X-Window server is probably not set with the ability to
ability to switch to the desired resolution: 800×600. (or whatever switch to the desired resolution: 800×600. (or whatever resolution you have
resolution you have Tux Paint set to run at.) (This is typically Tux Paint set to run at.) (This is typically done manually under the
done manually under the X-Window server by pressing [Control] + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and
[Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus [Control] + [Alt] + [Keypad Minus (-)].)
(-)].)
For this to work, your monitor must support that resolution, and For this to work, your monitor must support that resolution, and you need
you need to have it listed in your X server configuration. to have it listed in your X server configuration.
Check the "Display" subsection of the "Screen" section of your Check the "Display" subsection of the "Screen" section of your XFree86 or
XFree86 or X.org configuration file (typically X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/
"/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x,
version of XFree86 you're using; 3.x or 4.x, respectively, or respectively, or "/etc/X11/xorg.conf" for X.org).
"/etc/X11/xorg.conf" for X.org).
Add "800x600" (or whatever resolution(s) you want) to the Add "800x600" (or whatever resolution(s) you want) to the appropriate
appropriate "Modes" line. (e.g., in the "Display" subsection that "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color
contains 24-bit color depth ("Depth 24"), which is what Tux Paint depth ("Depth 24"), which is what Tux Paint tries to use.)
tries to use.)
Modes "1280x1024" "1024x768" "800x600" "640x480" Modes "1280x1024" "1024x768" "800x600" "640x480"
Note that some Linux distributions have tools that can make these Note that some Linux distributions have tools that can make these changes
changes for you. Debian users can run the command for you. Debian users can run the command "dpkg-reconfigure
"dpkg-reconfigure xserver-xfree86" as root, for example. 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. The "fullscreen" option is set.
If you're running Tux Paint from a command-line, make sure you're If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--fullscreen" option. giving it a "--fullscreen" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--fullscreen" is listed as a properties of the icon to see if "--fullscreen" is listed as a command-line
command-line argument. argument.
If a "--fullscreen" option isn't being sent on the command line, If a "--fullscreen" option isn't being sent on the command line, check Tux
check Tux Paint's configuration file for a line reading: Paint's configuration file for a line reading: "fullscreen=yes".
"fullscreen=yes".
Either remove that line, or simply run Tux Paint with the Either remove that line, or simply run Tux Paint with the command-line
command-line argument: "--windowed", which will override the argument: "--windowed", which will override the configuration file's
configuration file's setting. setting.
Or use Tux Paint Config. and make sure "Fullscreen" (under "Video Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound")
& Sound") is not checked. is not checked.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
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 If Tux Paint aborts with the message: "You're already running a copy of Tux
copy of Tux Paint!", this means it has been launched in the last Paint!", this means it has been launched in the last 30 seconds. (On Unix/
30 seconds. (On Unix/Linux, this message would appear in a Linux, this message would appear in a terminal console if you ran Tux Paint
terminal console if you ran Tux Paint from a command-line. On from a command-line. On Windows, this message would appear in a file named
Windows, this message would appear in a file named "stdout.txt" in "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\
the same folder where TuxPaint.exe resides (e.g., in "C:\Program Program Files\TuxPaint").
Files\TuxPaint").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\
"userdata\lockfile.dat" on Windows) is used to make sure Tux Paint lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many
isn't run too many times at once (e.g., due to a child impatiently times at once (e.g., due to a child impatiently clicking its icon more than
clicking its icon more than once). once).
Even if the lockfile exists, it contains the 'time' Tux Paint was Even if the lockfile exists, it contains the 'time' Tux Paint was last run.
last run. If it's been more than 30 seconds, Tux Paint should run If it's been more than 30 seconds, Tux Paint should run fine, and simply
fine, and simply update the lockfile with the current time. update the lockfile with the current time.
If multiple users are sharing the directory where this file is 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, or "nolockfile=yes" to the configuration file.
If multiple users are sharing the directory where this file is
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, or "nolockfile=yes" to the configuration
file.
I can't quit Tux Paint I can't quit Tux Paint
The "no quit" option is set. This disables the "Quit" button in The "no quit" option is set. This disables the "Quit" button in Tux Paint's
Tux Paint's toolbar (greying it out), and prevents Tux Paint from toolbar (greying it out), and prevents Tux Paint from being exited via the
being exited via the [Escape] key. [Escape] key.
If Tux Paint is not in fullscreen mode, simply click the window If Tux Paint is not in fullscreen mode, simply click the window close
close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.)
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 "no quit" set, you can always use the [Alt] + [F4]
combination on your keyboard to quit Tux Paint.)
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 "no quit" set, you can always use the [Alt]
+ [F4] 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 If you're running Tux Paint from a command-line, make sure you're not
not giving it a "--noquit" option. giving it a "--noquit" option.
If you're running Tux Paint by double-clicking an icon, check the If you're running Tux Paint by double-clicking an icon, check the
properties of the icon to see if "--noquit" is listed as a properties of the icon to see if "--noquit" is listed as a command-line
command-line argument. argument.
If a "--noquit" option isn't being sent on the command line, check If a "--noquit" option isn't being sent on the command line, check Tux
Tux Paint's configuration file for a line reading: "noquit=yes". 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 configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape]
Key" (under "単純化") is not checked.
Either remove that line, or simply run Tux Paint with the
command-line argument: "--quit", which will override the
configuration file's setting.
Or use Tux Paint Config. and make sure "Disable Quit Button and
[Escape] Key" (under "単純化") 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 A few messages are normal, but if Tux Paint is being extremely verbose
verbose (like listing the name of every rubber-stamp image it (like listing the name of every rubber-stamp image it finds while loading
finds while loading them), then it was probably compiled with them), then it was probably compiled with debugging output turned on.
debugging output turned on.
To change this, you must rebuild Tux Paint from source. Be sure to To change this, you must rebuild Tux Paint from source. Be sure to remove
remove or comment out any line that says: or comment out any line that says:
#define DEBUG #define DEBUG
in the "tuxpaint.c" file in the "src" directory. 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 By default, Tux Paint first looks at configuration files for options.
options.
* Windows + Windows
Under Windows, Tux Paint first examines the configuration Under Windows, Tux Paint first examines the configuration file:
file:
tuxpaint.cfg tuxpaint.cfg
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* macOS + macOS
* Unix and Linux + Unix and Linux
Under Unix and Linux, it first examines the system-wide Under Unix and Linux, it first examines the system-wide configuration
configuration file, located here: file, located here:
/etc/tuxpaint/tuxpaint.conf /etc/tuxpaint/tuxpaint.conf
@ -572,19 +571,19 @@ Other Problems
Finally, any options sent as command-line arguments are used. Finally, any options sent as command-line arguments are used.
* Haiku + Haiku
This means that if anything is set in a configuration file that This means that if anything is set in a configuration file that you don't
you don't want set, you'll need to either change the config. file want set, you'll need to either change the config. file (if you can), or
(if you can), or override the option on the command-line. override the option on the command-line.
For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes
includes this option to disable sound... this option to disable sound...
nosound=yes nosound=yes
...then you can reenable sound by either adding this option to ...then you can reenable sound by either adding this option to your own
your own ".tuxpaintrc" file: ".tuxpaintrc" file:
sound=yes sound=yes
@ -592,24 +591,27 @@ Other Problems
--sound --sound
Linux and Unix users can also disable the system-wide Linux and Unix users can also disable the system-wide configuration file by
configuration file by including the following command-line including the following command-line argument:
argument:
--nosysconfig --nosysconfig
Tux Paint will then only look at "~/.tuxpaintrc" and command-line Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments
arguments to determine what options should be set. to determine what options should be set.
----------------------------------------------------------------------
-------------------------------------------------------------------------------
Help / Contact Help / Contact
Any questions you don't see answered? Please let us know! You can Any questions you don't see answered? Please let us know! You can subscribe and
subscribe and post to our "tuxpaint-users" mailing list: post to our "tuxpaint-users" mailing list:
https://tuxpaint.org/lists/ https://tuxpaint.org/lists/
Or, contact lead developer Bill Kendrick directly: Or, contact lead developer Bill Kendrick directly:
bill@newbreedsoftware.com bill@newbreedsoftware.com

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

File diff suppressed because it is too large Load diff

View file

@ -10,79 +10,83 @@
About PNGs About PNGs
PNG is the Portable Network Graphic format. It is an open standard, not PNG is the Portable Network Graphic format. It is an open standard, not
burdened by patents (like GIFs). It is a highly compressed format (though burdened by patents (like GIFs). It is a highly compressed format (though not
not "lossy" like JPEGs - lossiness allows files to be much smaller, but "lossy" like JPEGs - lossiness allows files to be much smaller, but introduces
introduces 'mistakes' in the image when saved), and supports 24-bit color 'mistakes' in the image when saved), and supports 24-bit color (16.7 million
(16.7 million colors) as well as a full "alpha channel" - that is, each colors) as well as a full "alpha channel" - that is, each pixel can have a
pixel can have a varying degree of transparency. varying degree of transparency.
For more information, visit: http://www.libpng.org/ For more information, visit: http://www.libpng.org/
These features (openness, losslessness, compression, transparency/alpha) These features (openness, losslessness, compression, transparency/alpha) make
make it the best choice for Tux Paint. (Tux Paint's support for the PNG it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes
format comes from the Open Source SDL_Image library, which in turn gets it from the Open Source SDL_Image library, which in turn gets it from the libPNG
from the libPNG library.) library.)
Support for many colors allows photo-quality "rubber stamp" images to be Support for many colors allows photo-quality "rubber stamp" images to be used
used in Tux Paint, and alpha transparency allows for high-quality brushes. 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 The following is a very brief list of ways to create PNGs or convert existing
existing images into PNGs. images into PNGs.
GIMP & Krita GIMP & Krita
Excellent tools with which to create PNG images for use in Tux Excellent tools with which to create PNG images for use in Tux Paint are
Paint are GIMP and Krita, both high-quality Open Source GIMP and Krita, both high-quality Open Source interactive drawing and photo
interactive drawing and photo editing programs. editing programs.
It is likely that one or both are already installed on your system. If not,
they should be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://www.gimp.org/ and http:/
/www.krita.org/, respectively.
It is likely that one or both are already installed on your
system. If not, they should be readily available from your Linux
distribution's software repository. If not, or to learn more,
visit http://www.gimp.org/ and http://www.krita.org/,
respectively.
Command-line Tools Command-line Tools
NetPBM NetPBM
The Portable Bitmap tools (collectively known as The Portable Bitmap tools (collectively known as "NetPBM") is a
"NetPBM") is a collection of Open Source command-line collection of Open Source command-line tools which convert to and from
tools which convert to and from various formats, various formats, including GIF, TIFF, BMP, PNG, and many more.
including GIF, TIFF, BMP, PNG, and many more.
It is possible that it's already installed on your system. If not, they
it be readily available from your Linux distribution's software
repository. If not, or to learn more, visit http://
netpbm.sourceforge.net/.
It is possible that it's already installed on your
system. If not, they it be readily available from
your Linux distribution's software repository. If
not, or to learn more, visit
http://netpbm.sourceforge.net/.
cjpeg/djpeg cjpeg/djpeg
The "cjpeg" and "djpeg" command-line programs convert The "cjpeg" and "djpeg" command-line programs convert between the
between the NetPBM Portable Any Map (PNM) format and NetPBM Portable Any Map (PNM) format and JPEGs. It is possible that
JPEGs. It is possible that it's already installed on it's already installed on your system. If not, they it be readily
your system. If not, they it be readily available available from your Linux distribution's software repository. If not,
from your Linux distribution's software repository. or to learn more, visit https://jpegclub.org/.
If not, or to learn more, visit
https://jpegclub.org/.
Proprietary Software for Windows Proprietary Software for Windows
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Paint Shop Pro (Corel) — https://www.paintshoppro.com/
* Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) — + PIXresizer (Bluefive software) — http://bluefive.pair.com/
http://www.adobe.com/products/photoshop.html pixresizer.htm
* PIXresizer (Bluefive software) —
http://bluefive.pair.com/pixresizer.htm
Macintosh Users Macintosh Users
* CorelDRAW (Corel) — http://www.corel.com/ + CorelDRAW (Corel) — http://www.corel.com/
* GraphicConverter (Lemke Software) — + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/
https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html
* Photoshop (Adobe) —
http://www.adobe.com/products/photoshop.html

File diff suppressed because it is too large Load diff

View file

@ -7,47 +7,51 @@
2022年6月 4日 2022年6月 4日
Tux Paint responds to the following signals (which can be sent to the Tux Paint responds to the following signals (which can be sent to the program's
program's process via `kill` or `killall`, for example). 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 Tux Paint responds as if the "Quit" button were pressed, or the desktop
desktop environment was told to close Tux Paint (e.g., by clicking environment was told to close Tux Paint (e.g., by clicking a window close
a window close button, or pressing [Alt] + [F4] on most systems). button, or pressing [Alt] + [F4] on most systems).
From the main interface, Tux Paint will prompt whether or not you From the main interface, Tux Paint will prompt whether or not you wish to
wish to quit, and (unless overridden by the auto-save option, e.g. quit, and (unless overridden by the auto-save option, e.g. "--autosave") if
"--autosave") if you'd like to save the current drawing (if you'd like to save the current drawing (if unsaved), and if so, and it's a
unsaved), and if so, and it's a modified version of an existing modified version of an existing drawing (unless overridden by the options
drawing (unless overridden by the options to save over old images, to save over old images, or always save new images; e.g. "--saveover" and
or always save new images; e.g. "--saveover" and "--saveovernew", "--saveovernew", respectively), whether or not to overwrite the existing
respectively), whether or not to overwrite the existing drawing, drawing, or save to a new file.
or save to a new file.
例: killall tuxpaint 例: killall tuxpaint
💡 Note: From other parts of the interface, the signal is currently 💡 Note: From other parts of the interface, the signal is currently
interpreted as a request to go back (e.g., from the "New" dialog interpreted as a request to go back (e.g., from the "New" dialog back to
back to the main interface), as if a "Back" button in Tux Paint the main interface), as if a "Back" button in Tux Paint were clicked, or
were clicked, or the [Esc] was key pressed. the [Esc] was key pressed.
SIGUSR1 & SIGUSR2 SIGUSR1 & SIGUSR2
Tux Paint responds by setting its auto-save option (as if it had Tux Paint responds by setting its auto-save option (as if it had been
been launched with "--autosave"), as well as either the option to launched with "--autosave"), as well as either the option to always save
always save new images (as if launched with "--saveovernew") in new images (as if launched with "--saveovernew") in the case of receiving a
the case of receiving a SIGUSR1 signal, or to always save over the SIGUSR1 signal, or to always save over the existing image (as if launched
existing image (as if launched with "--saveover") in the case of with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends
receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, itself a SIGTERM signal, in an attempt to quit. (See above.)
in an attempt to quit. (See above.)
So, from the main interface, Tux Paint should quit almost So, from the main interface, Tux Paint should quit almost immediately, with
immediately, with no questions asked. no questions asked.
例: killall -s SIGUSR1 tuxpaint 例: killall -s SIGUSR1 tuxpaint
💡 Note: From other parts of the interface, unfortunately, Tux 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go
Paint will go back one level in the interface. Therefore, at this back one level in the interface. Therefore, at this time, it may be
time, it may be necessary to send this signal to Tux Paint a few necessary to send this signal to Tux Paint a few times, for it to quit
times, for it to quit completely. completely.

View file

@ -10,27 +10,28 @@
About SVGs About SVGs
SVG (Scalable Vector Graphics) is an open standard used to describe SVG (Scalable Vector Graphics) is an open standard used to describe
two-dimensional vector graphics. It is great for diagrams and shapes, two-dimensional vector graphics. It is great for diagrams and shapes, while
while PNGs are better for photographs. SVG files are a bit like PNGs are better for photographs. SVG files are a bit like instructions on how
instructions on how to make an image. This means that they can be resized to make an image. This means that they can be resized without looking pixelated
without looking pixelated or blocky. or blocky.
For more information, visit: https://www.w3.org/Graphics/SVG/ For more information, visit: https://www.w3.org/Graphics/SVG/
How to make SVGs How to make SVGs
An excellent tool with which to create SVG images for use in Tux Paint is An excellent tool with which to create SVG images for use in Tux Paint is
Inkscape, a high-quality Open Source interactive drawing program available Inkscape, a high-quality Open Source interactive drawing program available for
for Windows, macOS, and Linux. There are also other applications that can Windows, macOS, and Linux. There are also other applications that can produce
produce SVGs, both free/open source, and commerical/proprietary. SVGs, both free/open source, and commerical/proprietary.
Open Source Open Source
* Inkscape — http://www.inkscape.org/ + Inkscape — http://www.inkscape.org/
* Karbon — https://calligra.org/karbon/ + Karbon — https://calligra.org/karbon/
Proprietary Proprietary
* CorelDRAW (Corel) — https://www.coreldraw.com/en/ + CorelDRAW (Corel) — https://www.coreldraw.com/en/
* Illustrator (Adobe) — + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html
http://www.adobe.com/products/illustrator.html + Boxy SVG — https://boxy-svg.com/
* Boxy SVG — https://boxy-svg.com/ + Sketch (Sketch B.V.) — https://boxy-svg.com/
* Sketch (Sketch B.V.) — https://boxy-svg.com/

View file

@ -5,7 +5,8 @@
🖌ふで 🖌ふで
* 右側のブラシを選択します。 * 右側のブラシを選択します。
* ブラシには、アニメーションするもの 🎞, 方向があるもの ✲ があり、両方を併せ持つブラシもあります。 * ブラシには、アニメーションするもの 🎞, 方向があるもの ✲ があり、両方を併せ持
つブラシもあります。
* 右下のバー 📶 でブラシの間隔を変更します。 * 右下のバー 📶 でブラシの間隔を変更します。
* 色を選択します("色" のセクションを参照) * 色を選択します("色" のセクションを参照)
* キャンバスをクリックまたはタップしてドラッグし、描画します。 * キャンバスをクリックまたはタップしてドラッグし、描画します。
@ -14,14 +15,18 @@
* 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。
* 右側のスタンプを選択してください。 * 右側のスタンプを選択してください。
* スタンプの中には、右下の操作ボタンを使って、上下 🪞 左右 ↕ に反転させることができるものがあります。 * スタンプの中には、右下の操作ボタンを使って、上下 🪞 左右 ↕ に反転させること
ができるものがあります。
* 色を変えられるスタンプもあります("色" のセクションを参照) * 色を変えられるスタンプもあります("色" のセクションを参照)
* 右下のバー 📶 でスタンプのサイズを変更します。 * 右下のバー 📶 でスタンプのサイズを変更します。
* 回転 ⟳ は、お好みに応じて有効にすることができます。 * 回転 ⟳ は、お好みに応じて有効にすることができます。
* キャンバスをクリックまたはタップしてスタンプの位置を決めます。 * キャンバスをクリックまたはタップしてスタンプの位置を決めます。
* 回転が有効に設定されている場合、ドラッグして回転させ、もう一度クリックまたはタップして描画します。 + 回転が有効に設定されている場合、ドラッグして回転させ、もう一度クリック
* 効果音があるスタンプでは、スピーカー 🕪 ボタンを押すと、もう一度聞くことができます。 またはタップして描画します。
* 音声解説付きのスタンプもあります。ヘッドフォン 🎧 ボタンを押すと、もう一度聞くことができます。 * 効果音があるスタンプでは、スピーカー 🕪 ボタンを押すと、もう一度聞くことがで
きます。
* 音声解説付きのスタンプもあります。ヘッドフォン 🎧 ボタンを押すと、もう一度聞
くことができます。
⚟せん ⚟せん
@ -31,7 +36,8 @@
⭓かたち ⭓かたち
* 右側の図形を選択してください。 * 右側の図形を選択してください。
* 右下のコントロールを使用して、図形を中心 ⧈ から広げるかコーナー ◰ から広げるかを選択します。 * 右下のコントロールを使用して、図形を中心 ⧈ から広げるかコーナー ◰ から広げ
るかを選択します。
* クリックまたはタップして位置を決め、ドラッグして大きさを変えます。 * クリックまたはタップして位置を決め、ドラッグして大きさを変えます。
* ドラッグして回転させ、もう一度クリックまたはタップして描画します。 * ドラッグして回転させ、もう一度クリックまたはタップして描画します。
@ -43,41 +49,55 @@
* 色を選択します("色" のセクションを参照) * 色を選択します("色" のセクションを参照)
* キャンバスをクリックまたはタップして、入力カーソルの位置を決めます。 * キャンバスをクリックまたはタップして、入力カーソルの位置を決めます。
* キーボードまたはスクリーンキーボードを使用してテキストを入力します。 * キーボードまたはスクリーンキーボードを使用してテキストを入力します。
* テキストの位置を変更したい場合は、キャンバスをもう一度クリックまたはタップします。 * テキストの位置を変更したい場合は、キャンバスをもう一度クリックまたはタップ
* [Enter]/[Return] を押すか、⮨ をクリックまたはタップするとテキストが追加され、次の行の入力が開始されます。 します。
* [Tab] を押すか ⟷ をクリック/タップすれば、テキストが追加され、すぐ右側に続けてテキストを入力できます。 * [Enter]/[Return] を押すか、⮨ をクリックまたはタップするとテキストが追加され
、次の行の入力が開始されます。
* [Tab] を押すか ⟷ をクリック/タップすれば、テキストが追加され、すぐ右側に続
けてテキストを入力できます。
* スクリーンキーボードの使い方: * スクリーンキーボードの使い方:
* 「Cmp」は文字を合成するために使用できます。たとえば、Cmp ' a は á になります。 + 「Cmp」は文字を合成するために使用できます。たとえば、Cmp ' a は á にな
* 「AltGr」を使用すると、より多くの文字にすばやくアクセスできます。 ります。
* 左右の矢印で、キーボード レイアウトを切り替えます (例: "QWERTY" と "ABC") + 「AltGr」を使用すると、より多くの文字にすばやくアクセスできます。
+ 左右の矢印で、キーボードレイアウトを切り替えます (例: "QWERTY" と
"ABC")
🅰ラベル 🅰ラベル
* (「もじ」を参照) * (「もじ」を参照)
* ラベルは絵から離れて「浮いて」います。描画やスタンプでの上書きや、「まほう」の効果などは適用されません。 * ラベルは絵から離れて「浮いて」います。描画やスタンプでの上書きや、「まほう
」の効果などは適用されません。
* ラベルは、後からでも、編集や移動、スタイルの変更ができます。 * ラベルは、後からでも、編集や移動、スタイルの変更ができます。
* 右下の ☝ * 右下の ☝ ボタンをクリックまたはタップして、ラベルを選択します。変更するラベ
ボタンをクリックまたはタップして、ラベルを選択します。変更するラベルをクリックまたはタップしてから、キャンバス内の別の場所をクリックまたはタップして位置を変更したり、フォントやスタイル、色を変更したり、タイプしてテキストを編集したりできます。 ルをクリックまたはタップしてから、キャンバス内の別の場所をクリックまたはタ
* 右下にある 🖑 ボタン押すと、ラベルはキャンバスに貼り付けられ、以後は編集できなくなります。 ップして位置を変更したり、フォントやスタイル、色を変更したり、タイプしてテ
キストを編集したりできます。
* 右下にある 🖑 ボタン押すと、ラベルはキャンバスに貼り付けられ、以後は編集でき
なくなります。
🪣ぬる 🪣ぬる
* 右側で塗りつぶしモードを選択します。 * 右側で塗りつぶしモードを選択します。
* 色を選択します("色" のセクションを参照) * 色を選択します("色" のセクションを参照)
* クリックまたはタップして(「ふで」モードと「リニア」モードでは、さらにドラッグして)、閉じたエリアを色で塗りつぶします。 * クリックまたはタップして(「ふで」モードと「リニア」モードでは、さらにドラ
* なし - グラデーション無しの一色で塗りつぶします ッグして)、閉じたエリアを色で塗りつぶします。
* ふで - ブラシを使ってエリアからはみ出さないように塗りつぶします + なし - グラデーション無しの一色で塗りつぶします
* リニア - エリアを線形グラデーションで塗りつぶします (ドラッグして角度とグラデーションを選択します) + ふで - ブラシを使ってエリアからはみ出さないように塗りつぶします
* ほうしゃ - クリックまたはタップした場所を中心に、放射状のグラデーションでエリアを塗りつぶします + リニア - エリアを線形グラデーションで塗りつぶします (ドラッグして角度と
* あわせる - エリアの輪郭に合わせたグラデーションで塗りつぶします。 グラデーションを選択します)
+ ほうしゃ - クリックまたはタップした場所を中心に、放射状のグラデーション
でエリアを塗りつぶします
+ あわせる - エリアの輪郭に合わせたグラデーションで塗りつぶします。
🪄まほう 🪄まほう
* 右側から、使いたい特殊効果ツールを選択します。 * 右側から、使いたい特殊効果ツールを選択します。
* 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。
* クリックまたはタップとドラッグによって描画または効果を適用するツール 〰🪄 と、絵の全体に影響するツール 🖻🪄 * クリックまたはタップとドラッグによって描画または効果を適用するツール〰🪄 と
があります。両方に対応したツールでは、右下のコントロールでどちらかを選択します。 、絵の全体に影響するツール 🖻🪄 があります。両方に対応したツールでは、右下の
* 効果のサイズを変更できるツールもあります。右下のバー 📶 でサイズを変更します。 コントロールでどちらかを選択します。
* 効果のサイズを変更できるツールもあります。右下のバー 📶 でサイズを変更します
* 使う際に色を選べるツールもあります。 * 使う際に色を選べるツールもあります。
🖓とりけし 🖓とりけし
@ -94,16 +114,20 @@
* 右側から、消しゴムの大きさと形を選びます。 * 右側から、消しゴムの大きさと形を選びます。
* クリックまたはタップしてドラッグすると、ドラッグした部分が消去されます。 * クリックまたはタップしてドラッグすると、ドラッグした部分が消去されます。
* ショートカット: [X]を押しながらクリックまたはタップ(使用中のツールによっては、ショートカットが無効な場合があります) * ショートカット: [X]を押しながらクリックまたはタップ(使用中のツールによって
は、ショートカットが無効な場合があります)
制御ツール 制御ツール
🗏さいしょから 🗏さいしょから
* 開始するキャンバスを、単色の背景、スターター画像、テンプレートから選択します。 * 開始するキャンバスを、単色の背景、スターター画像、テンプレートから選択しま
* スターター画像では、(例えば塗り絵のように)前面のレイヤーの下に描画されます。さらに背景レイヤーを有するものもあります。 す。
* テンプレートは背景レイヤーのみの画像です。 + スターター画像では、(例えば塗り絵のように)前面のレイヤーの下に描画さ
* 消しゴムツール ◪ で消した部分は、単色の背景またはスターター/テンプレートの背面レイヤーが現れます。 れます。さらに背景レイヤーを有するものもあります。
+ テンプレートは背景レイヤーのみの画像です。
+ 消しゴムツール ◪ で消した部分は、単色の背景またはスターター/テンプレー
トの背面レイヤーが現れます。
* 「🕮⮫ひらく」をクリックまたはタップして、新しい描画を開始します。 * 「🕮⮫ひらく」をクリックまたはタップして、新しい描画を開始します。
* 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。
* ショートカット: [Ctrl]+[N] * ショートカット: [Ctrl]+[N]
@ -111,28 +135,36 @@
🕮⮫ひらく 🕮⮫ひらく
* 以前に保存した作品を選択して開きます (書き出しや消去もできます)。 * 以前に保存した作品を選択して開きます (書き出しや消去もできます)。
* 「🕮⮫ひらく」をクリックまたはタップして、保存した作品を開き、編集を続けます。 * 「🕮⮫ひらく」をクリックまたはタップして、保存した作品を開き、編集を続けます
* 「🗏⮫エクスポート」をクリックまたはタップして、作品をシステムの「ピクチャ」フォルダに保存します。
* 「🗏⮫エクスポート」をクリックまたはタップして、作品をシステムの「ピクチャ」
フォルダに保存します。
* 「🗑けす」をクリックまたはタップして、作品をシステムのごみ箱に移動します。 * 「🗑けす」をクリックまたはタップして、作品をシステムのごみ箱に移動します。
* 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。
* 「📽スライド」をクリックまたはタップすると、スライドショー モードに切り替わります: * 「📽スライド」をクリックまたはタップすると、スライドショーモードに切り替わり
* 保存された中から、再生したい順に複数の作品をクリックまたはタップして選択します。順序がサムネール上に表示されます。 ます:
* 左下のバー 📶 で、再生速度を設定します。 + 保存された中から、再生したい順に複数の作品をクリックまたはタップして選
* 「⯈かいし」をクリックまたはタップすると、スライドショー/アニメーションが開始します。 択します。順序がサムネール上に表示されます。
* ここで「🎞かきだす」をクリックまたはタップすると、アニメーションGIF形式のファイルををシステムの「ピクチャ」フォルダに出力します。 + 左下のバー 📶 で、再生速度を設定します。
* 「⤺もどる」をクリックまたはタップして、「ひらく」ダイアログに戻ります。 + 「⯈かいし」をクリックまたはタップすると、スライドショー/アニメーション
が開始します。
+ ここで「🎞かきだす」をクリックまたはタップすると、アニメーションGIF形式
のファイルををシステムの「ピクチャ」フォルダに出力します。
+ 「⤺もどる」をクリックまたはタップして、「ひらく」ダイアログに戻ります。
* ショートカット: [Ctrl]+[O] * ショートカット: [Ctrl]+[O]
🕮⮪セーブ 🕮⮪セーブ
* クリックまたはタップして作品を保存します。 * クリックまたはタップして作品を保存します。
* 以前に保存したことがある場合は、既存の作品を上書きするか、新しい作品として保存するかを選択するよう求められます。 * 以前に保存したことがある場合は、既存の作品を上書きするか、新しい作品として
保存するかを選択するよう求められます。
* ショートカット: [Ctrl]+[S] * ショートカット: [Ctrl]+[S]
🖶いんさつ 🖶いんさつ
* クリックまたはタップして、作品を印刷します。 * クリックまたはタップして、作品を印刷します。
* [Alt] または [Option] を押しながらクリックまたはタップすると、(対応している場合は)システムの印刷ダイアログが表示されます。 * [Alt] または [Option] を押しながらクリックまたはタップすると、(対応してい
る場合は)システムの印刷ダイアログが表示されます。
* ショートカット: [Ctrl]+[P] * ショートカット: [Ctrl]+[P]
🗙やめる 🗙やめる
@ -142,21 +174,29 @@
いろ いろ
* クリックまたはタップして、色が選べるツール(ふで、せん、かたちツール、および、はんこ、まほうツール)で使用する色を選択します。 * クリックまたはタップして、色が選べるツール(ふで、せん、かたちツール、およ
び、はんこ、まほうツール)で使用する色を選択します。
* 画像の中から色を選択するには、ピペット/カラーピッカー 💉 ボタンを使います。 * 画像の中から色を選択するには、ピペット/カラーピッカー 💉 ボタンを使います。
* ショートカット: [Ctrl] を押しながらキャンバスをクリックまたはタップすると、画像の中から素早く色を選択できます。 + ショートカット: [Ctrl] を押しながらキャンバスをクリックまたはタップする
* 虹 🌈 のボタンをクリックまたはタップして、レインボーパレットから、好きな色を選択します。 と、画像の中から素早く色を選択できます。
* 左側の正方形のエリアをクリックまたはタップして色を選択します(色相と彩度を決める) * 虹 🌈 のボタンをクリックまたはタップして、レインボーパレットから、好きな色を
* 灰色のグラデーション バーをクリックまたはタップして、明るさを調整します。 選択します。
* 緑のチェックボックス ✓ をクリックまたはタップして決定します。 + 左側の正方形のエリアをクリックまたはタップして色を選択します(色相と彩
* 「⤺戻る」をクリックまたはタップして中止し、パレットを閉じます。 度を決める)
* 色がついた矢印 ⇫ + 灰色のグラデーションバーをクリックまたはタップして、明るさを調整します
の形のボタンをクリックして、カラーパレット、スポイト、カラーミキサーのいずれかで選択した色をセットすることができます。
* 絵の具パレット 🎨 ボタンをクリックまたはタップして、赤、黄、青の3原色と、白(色合い)、グレー(色調)、黒(濃淡)を混ぜて色を作成します。 + 緑のチェックボックス ✓ をクリックまたはタップして決定します。
* 緑のチェックボックス ✓ をクリックまたはタップして決定します。 + 「⤺戻る」をクリックまたはタップして中止し、パレットを閉じます。
* カラーミキサーでは「🖓とりけし」および「🖒やりなおし」オプションが使えます。 + 色がついた矢印 ⇫ の形のボタンをクリックして、カラーパレット、スポイト、
* 「🗑さいしょから」をクリックまたはタップすると、最初からやり直せます。 カラーミキサーのいずれかで選択した色をセットすることができます。
* 「⤺戻る」をクリックまたはタップすると、色の作成をを中止してダイアログを終了します。 * 絵の具パレット 🎨 ボタンをクリックまたはタップして、赤、黄、青の3原色と、白
(色合い)、グレー(色調)、黒(濃淡)を混ぜて色を作成します。
+ 緑のチェックボックス ✓ をクリックまたはタップして決定します。
+ カラーミキサーでは「🖓とりけし」および「🖒やりなおし」オプションが使えま
す。
+ 「🗑さいしょから」をクリックまたはタップすると、最初からやり直せます。
+ 「⤺戻る」をクリックまたはタップすると、色の作成をを中止してダイアログを
終了します。
描画中に利用できるショートカット: 描画中に利用できるショートカット:
@ -172,3 +212,4 @@
* [Esc] - ⤺もどるまたは 🗙やめる * [Esc] - ⤺もどるまたは 🗙やめる
最終更新日: 2023年5月 9日 最終更新日: 2023年5月 9日