From 0ceb9224c40c273cfe191bfa317ece7923c9f4d6 Mon Sep 17 00:00:00 2001 From: Bill Kendrick Date: Sun, 16 Jul 2023 10:49:44 -0700 Subject: [PATCH] Regen main docs' TXT via w3m! --- docs/en/ADVANCED-STAMPS-HOWTO.txt | 441 +- docs/en/ENVVARS.txt | 130 +- docs/en/EXTENDING.txt | 1571 +++---- docs/en/FAQ.txt | 844 ++-- docs/en/INSTALL.txt | 1307 +++--- docs/en/MAGIC-API.txt | 2146 +++++----- docs/en/OPTIONS.txt | 3472 ++++++++-------- docs/en/PNG.txt | 130 +- docs/en/README.txt | 2203 +++++----- docs/en/SIGNALS.txt | 76 +- docs/en/SVG.txt | 47 +- docs/en/tuxpaint-quickstart-guide.txt | 339 +- docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 439 +- docs/es_ES.UTF-8/ENVVARS.txt | 132 +- docs/es_ES.UTF-8/EXTENDING.txt | 1569 +++---- docs/es_ES.UTF-8/FAQ.txt | 846 ++-- docs/es_ES.UTF-8/INSTALL.txt | 1305 +++--- docs/es_ES.UTF-8/MAGIC-API.txt | 2146 +++++----- docs/es_ES.UTF-8/OPTIONS.txt | 3474 ++++++++-------- docs/es_ES.UTF-8/PNG.txt | 128 +- docs/es_ES.UTF-8/README.txt | 2205 +++++----- docs/es_ES.UTF-8/SIGNALS.txt | 74 +- docs/es_ES.UTF-8/SVG.txt | 45 +- .../es_ES.UTF-8/tuxpaint-quickstart-guide.txt | 339 +- docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 501 ++- docs/fr_FR.UTF-8/ENVVARS.txt | 147 +- docs/fr_FR.UTF-8/EXTENDING.txt | 1686 ++++---- docs/fr_FR.UTF-8/FAQ.txt | 947 ++--- docs/fr_FR.UTF-8/INSTALL.txt | 1352 +++--- docs/fr_FR.UTF-8/MAGIC-API.txt | 2146 +++++----- docs/fr_FR.UTF-8/OPTIONS.txt | 3689 +++++++++-------- docs/fr_FR.UTF-8/PNG.txt | 141 +- docs/fr_FR.UTF-8/README.txt | 2356 ++++++----- docs/fr_FR.UTF-8/SIGNALS.txt | 81 +- docs/fr_FR.UTF-8/SVG.txt | 49 +- .../fr_FR.UTF-8/tuxpaint-quickstart-guide.txt | 339 +- docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 464 +-- docs/gl_ES.UTF-8/ENVVARS.txt | 138 +- docs/gl_ES.UTF-8/EXTENDING.txt | 1628 ++++---- docs/gl_ES.UTF-8/FAQ.txt | 905 ++-- docs/gl_ES.UTF-8/INSTALL.txt | 1324 +++--- docs/gl_ES.UTF-8/MAGIC-API.txt | 2146 +++++----- docs/gl_ES.UTF-8/OPTIONS.txt | 3587 ++++++++-------- docs/gl_ES.UTF-8/PNG.txt | 132 +- docs/gl_ES.UTF-8/README.txt | 2259 +++++----- docs/gl_ES.UTF-8/SIGNALS.txt | 77 +- docs/gl_ES.UTF-8/SVG.txt | 46 +- .../gl_ES.UTF-8/tuxpaint-quickstart-guide.txt | 339 +- docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 441 +- docs/is_IS.UTF-8/ENVVARS.txt | 130 +- docs/is_IS.UTF-8/EXTENDING.txt | 1571 +++---- docs/is_IS.UTF-8/FAQ.txt | 844 ++-- docs/is_IS.UTF-8/INSTALL.txt | 1307 +++--- docs/is_IS.UTF-8/MAGIC-API.txt | 2147 +++++----- docs/is_IS.UTF-8/OPTIONS.txt | 3472 ++++++++-------- docs/is_IS.UTF-8/PNG.txt | 130 +- docs/is_IS.UTF-8/README.txt | 2203 +++++----- docs/is_IS.UTF-8/SIGNALS.txt | 76 +- docs/is_IS.UTF-8/SVG.txt | 47 +- .../is_IS.UTF-8/tuxpaint-quickstart-guide.txt | 339 +- docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt | 338 +- docs/ja_JP.UTF-8/ENVVARS.txt | 134 +- docs/ja_JP.UTF-8/EXTENDING.txt | 1572 +++---- docs/ja_JP.UTF-8/FAQ.txt | 850 ++-- docs/ja_JP.UTF-8/INSTALL.txt | 1309 +++--- docs/ja_JP.UTF-8/MAGIC-API.txt | 2146 +++++----- docs/ja_JP.UTF-8/OPTIONS.txt | 3169 ++++++++------ docs/ja_JP.UTF-8/PNG.txt | 132 +- docs/ja_JP.UTF-8/README.txt | 1494 ++++--- docs/ja_JP.UTF-8/SIGNALS.txt | 78 +- docs/ja_JP.UTF-8/SVG.txt | 49 +- .../ja_JP.UTF-8/tuxpaint-quickstart-guide.txt | 303 +- 72 files changed, 38988 insertions(+), 37180 deletions(-) diff --git a/docs/en/ADVANCED-STAMPS-HOWTO.txt b/docs/en/ADVANCED-STAMPS-HOWTO.txt index b212d2c8b..2758390fd 100644 --- a/docs/en/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/en/ADVANCED-STAMPS-HOWTO.txt @@ -1,296 +1,287 @@ Tux Paint version 0.9.31 Advanced Stamps 'How-To' - Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. + Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. https://tuxpaint.org/ - June 4, 2022 + June 4, 2022 - ---------------------------------------------------------------------- - - +----------------------------------------+ - |Table of Contents | - |----------------------------------------| - | * About this 'How-To' | - | * Image choice is crucial | - | * Prepare the mask | - | * Replace the fringe and junk pixels | - | * Save the image for Tux Paint | - +----------------------------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++----------------------------------------+ +| Table of Contents | +|----------------------------------------| +| * About this 'How-To' | +| * Image choice is crucial | +| * Prepare the mask | +| * Replace the fringe and junk pixels | +| * Save the image for Tux Paint | ++----------------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- About this 'How-To' - This 'How-To' assumes that you want to make an excellent Tux Paint - stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital - photograph). There are easier and faster methods that produce lower - quality. + This 'How-To' assumes that you want to make an excellent Tux Paint stamp, + in PNG bitmapped format, from a JPEG image (e.g., a digital photograph). + There are easier and faster methods that produce lower quality. - This 'How-To' assumes you are dealing with normal opaque objects. - Dealing with semi-transparent objects (fire, moving fan blade, kid's - balloon) or light-giving objects (fire, lightbulb, sun) is best done - with custom software. Images with perfect solid-color backgrounds are - also best done with custom software, but are not troublesome to do as - follows. + This 'How-To' assumes you are dealing with normal opaque objects. Dealing + with semi-transparent objects (fire, moving fan blade, kid's balloon) or + light-giving objects (fire, lightbulb, sun) is best done with custom + software. Images with perfect solid-color backgrounds are also best done + with custom software, but are not troublesome to do as follows. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Image choice is crucial - License + License - If you wish to submit artwork to the Tux Paint developers for - consideration for inclusion in the official project, or if you wish to - release your own copy of Tux Paint, bundled with your own graphics, - you need an image that is compatible with the GNU General Public - License used by Tux Paint. + If you wish to submit artwork to the Tux Paint developers for + consideration for inclusion in the official project, or if you wish to + release your own copy of Tux Paint, bundled with your own graphics, you + need an image that is compatible with the GNU General Public License + used by Tux Paint. - Images produced by the US government are Public Domain, but be aware - that the US government sometimes uses other images on the web. Google - image queries including either site:gov or site:mil will supply many - suitable images. (Note: the *.mil sites include non-military content, - too!) + Images produced by the US government are Public Domain, but be aware + that the US government sometimes uses other images on the web. Google + image queries including either site:gov or site:mil will supply many + suitable images. (Note: the *.mil sites include non-military content, + too!) - Your own images can be placed in the Public Domain or a suitable - license, such as the Creative Commons CC0 by declaring it so. (Hire a - lawyer if you feel the need for legal advice.) + Your own images can be placed in the Public Domain or a suitable + license, such as the Creative Commons CC0 by declaring it so. (Hire a + lawyer if you feel the need for legal advice.) - For personal use, any image you can legitimately modify and use for - your own personal use should be fine. + For personal use, any image you can legitimately modify and use for + your own personal use should be fine. - Image Size and Orientation + Image Size and Orientation - You need an image that has a useful orientation. Perspective is an - enemy. Images that show an object from the corner are difficult to fit - into a nice drawing. As a general rule, telephoto side views are the - best. The impossible ideal is that, for example, two wheels of a car - are perfectly hidden behind the other two. + You need an image that has a useful orientation. Perspective is an + enemy. Images that show an object from the corner are difficult to fit + into a nice drawing. As a general rule, telephoto side views are the + best. The impossible ideal is that, for example, two wheels of a car + are perfectly hidden behind the other two. - 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 - need lots of rotation (30 to 60 degrees) are next best, and images - that need just a few degrees are worst. Rotation will also make an - image darker because most image editing software is very bad about - gamma handling. (Rotation is only legitimate for gamma=1.0 images.) + 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 + need lots of rotation (30 to 60 degrees) are next best, and images that + need just a few degrees are worst. Rotation will also make an image + darker because most image editing software is very bad about gamma + handling. (Rotation is only legitimate for gamma=1.0 images.) - 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 - across if you can. You can shrink this later to hide your mistakes. + 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 + across if you can. You can shrink this later to hide your mistakes. - 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 - will need to draw new ones. If only one is buried, you might be able - to copy the other one as a replacement. + 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 to + copy the other one as a replacement. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the image - First of all, be sure to avoid re-saving the image as a JPEG. This - causes quality loss. There is a special tool called jpegtran that lets - you crop an image without the normal quality loss. + First of all, be sure to avoid re-saving the image as a JPEG. This causes + quality loss. There is a special tool called jpegtran that lets you crop an + image without the normal quality loss. - jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - 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 - as needed. Save the image — choose whatever native format supports - layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe - Photoshop users should choose "PSD", for example. + 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 as + needed. Save the image — choose whatever native format supports layers, + masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop + users should choose "PSD", for example. - If you have rotated or cropped the image in your image editor, flatten - it now. You need to have just one RGB layer without mask or alpha. + If you have rotated or cropped the image in your image editor, flatten it + 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 - top to bottom you will need something like this: + Open the layers dialog box. Replicate the one layer several times. From top + to bottom you will need something like this: - 1. unmodified image (write-protect this if you can) - 2. an image you will modify — the "work in progress" layer - 3. solid green (write-protect this if you can) - 4. solid magenta (write-protect this if you can) - 5. 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 + 3. solid green (write-protect this if you can) + 4. solid magenta (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 - start with a selection, or by using the grayscale value of the WIP - layer. You might invert the mask. + Give the work in progress (WIP) layer a rough initial mask. You might start + with a selection, or by using the grayscale value of the WIP layer. You + might invert the mask. - 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 - instructions later. + 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 + instructions later. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the mask - Get used to doing [Control]-click and [Alt]-click on the thumbnail - images in the layers dialog. You will need this to control what you are - looking at and what you are editing. Sometimes you will be editing - things you can't see. For example, you might edit the mask of the WIP - layer while looking at the unmodified image. Pay attention so you don't - screw up. Always verify that you are editing the right thing. + Get used to doing [Control]-click and [Alt]-click on the thumbnail images + in the layers dialog. You will need this to control what you are looking at + and what you are editing. Sometimes you will be editing things you can't + see. For example, you might edit the mask of the WIP layer while looking at + the unmodified image. Pay attention so you don't screw up. Always verify + that you are editing the right thing. - Set an unmodified image as what you will view (the top one is easiest). - Set the WIP mask as what you will edit. At some point, perhaps not - immediately, you should magnify the image to about 400% (each pixel of - the image is seen and edited as a 4x4 block of pixels on your screen). + Set an unmodified image as what you will view (the top one is easiest). Set + the WIP mask as what you will edit. At some point, perhaps not immediately, + you should magnify the image to about 400% (each pixel of the image is seen + 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 - you can select the object or background somewhat accurately by color, do - so. As needed to avoid selecting any pixels that should be partially - opaque (generally at the edge of the object) you should grow, shrink, - and invert the selection. + Select parts of the image that need to be 100% opaque or 0% opaque. If you + can select the object or background somewhat accurately by color, do so. As + needed to avoid selecting any pixels that should be partially opaque + (generally at the edge of the object) you should grow, shrink, and invert + the selection. - Fill the 100% opaque areas with white, and the 0% opaque areas with - black. This is most easily done by drag-and-drop from the - foreground/background color indicator. You should not see anything - happen, because you are viewing the unmodified image layer while editing - the mask of the WIP layer. Large changes might be noticable in the - thumbnail. + Fill the 100% opaque areas with white, and the 0% opaque areas with black. + This is most easily done by drag-and-drop from the foreground/background + color indicator. You should not see anything happen, because you are + viewing the unmodified image layer while editing the mask of the WIP layer. + Large changes might be noticable in the 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 - mask, which should be a white object on a black background (probably - with unedited grey at the edge). Now display the WIP layer normally, so - that the mask is active. This should show your object over top of the - next highest enabled layer, which should be green or magenta as needed - for maximum contrast. You might wish to flip back and forth between - those backgrounds by repeatedly clicking to enable/disable the green - layer. Fix any obvious and easy problems by editing the mask while - viewing the mask. + Check your work. Hide the top unmodified image layer. Display just the + mask, which should be a white object on a black background (probably with + unedited grey at the edge). Now display the WIP layer normally, so that the + mask is active. This should show your object over top of the next highest + enabled layer, which should be green or magenta as needed for maximum + contrast. You might wish to flip back and forth between those backgrounds + by repeatedly clicking to enable/disable the green layer. Fix any obvious + and easy problems by editing the mask while viewing the mask. - Go back to viewing the top unmodified layer while editing the WIP mask. - Set your drawing tool the paintbrush. For the brush, choose a small - fuzzy circle. The 5x5 size is good for most uses. + Go back to viewing the top unmodified layer while editing the WIP mask. Set + your drawing tool the paintbrush. For the brush, choose a small fuzzy + circle. The 5x5 size is good for most uses. - With a steady hand, trace around the image. Use black around the - outside, and white around the inside. Avoid making more than one pass - without switching colors (and thus sides). + With a steady hand, trace around the image. Use black around the outside, + and white around the inside. Avoid making more than one pass without + switching colors (and thus sides). - Flip views a bit, checking to see that the mask is working well. When - the WIP layer is composited over the green or magenta, you should see a - tiny bit of the original background as an ugly fringe around the edge. - If this fringe is missing, then you made the object mask too small. The - fringe consists of pixels that are neither 100% object nor 0% object. - For them, the mask should be neither 100% nor 0%. The fringe gets - removed soon. + Flip views a bit, checking to see that the mask is working well. When the + WIP layer is composited over the green or magenta, you should see a tiny + bit of the original background as an ugly fringe around the edge. If this + fringe is missing, then you made the object mask too small. The fringe + consists of pixels that are neither 100% object nor 0% object. For them, + the mask should be neither 100% nor 0%. The fringe gets removed soon. - 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 - expected color. Invert the selection, then paint these away using the - pencil tool. Do this operation for both white and black. + 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 expected + color. Invert the selection, then paint these away using the pencil tool. + Do this operation for both white and black. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Replace the fringe and junk pixels - Still viewing the mask, select by color. Choose black. Shrink the - selection by several pixels, being sure to NOT shrink from the edges of - the mask (the shrink helps you avoid and recover from mistakes). + Still viewing the mask, select by color. Choose black. Shrink the selection + by several pixels, being sure to NOT shrink from the edges of the mask (the + shrink helps you avoid and recover from mistakes). - Now disable the mask. View and edit the unmasked WIP layer. Using the - color picker tool, choose a color that is average for the object. - Drag-and-drop this color into the selection, thus removing most of the - non-object pixels. + Now disable the mask. View and edit the unmasked WIP layer. Using the color + picker tool, choose a color that is average for the object. Drag-and-drop + this color into the selection, thus removing most of the non-object pixels. - 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 - has multiple colors that are very different, you should split up your - selection so that you can color the nearby background to be similar. + 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 has + multiple colors that are very different, you should split up your selection + 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 - editing and viewing the WIP image. Frequent layer visibility changes - will help you to see what you are doing. You are likely to use all of: + Now you will paint away the existing edge fringe. Be sure that you are + editing and viewing the WIP image. Frequent layer visibility changes will + help you to see what you are doing. You are likely to use all of: - * composited over green (mask enabled) - * composited over magenta (mask enabled) - * original (the top or bottom layer) - * composited over the original (mask enabled) - * raw WIP layer (mask disabled) + + composited over green (mask enabled) + + composited over magenta (mask enabled) + + original (the top or bottom layer) + + composited over the original (mask enabled) + + raw WIP layer (mask disabled) - To reduce accidents, you may wish to select only those pixels that are - not grey in the mask. (Select by color from the mask, choose black, add - mode, choose white, invert. Alternately: Select all, select by color - from the mask, subtract mode, choose black, choose white.) If you do - this, you'll probably want to expand the selection a bit and/or hide the - "crawling ants" line that marks the selection. + To reduce accidents, you may wish to select only those pixels that are not + grey in the mask. (Select by color from the mask, choose black, add mode, + choose white, invert. Alternately: Select all, select by color from the + mask, subtract mode, choose black, choose white.) If you do this, you'll + probably want to expand the selection a bit and/or hide the "crawling ants" + line that marks the selection. - 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 - generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy - brushes with about 70% opacity.) Unusual drawing modes can be helpful - with semi-transparent objects. + 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 + generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy + brushes with about 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. - 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 - magenta or green, must be removed for obvious reasons. The outside - fringe must also be removed because it will become visible when the - image is scaled down. As an example, consider a 2x2 region of pixels at - the edge of a sharp-edged object. The left half is black and 0% opaque. - The right half is white and 100% opaque. That is, we have a white object - on a black background. When Tux Paint scales this to 50% (a 1x1 pixel - area), the result will be a grey 50% opaque pixel. The correct result - would be a white 50% opaque pixel. To get this result, we would paint - away the black pixels. They matter, despite being 0% opaque. + 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 + magenta or green, must be removed for obvious reasons. The outside fringe + must also be removed because it will become visible when the image is + scaled down. As an example, consider a 2x2 region of pixels at the edge of + a sharp-edged object. The left half is black and 0% opaque. The right half + is white and 100% opaque. That is, we have a white object on a black + background. When Tux Paint scales this to 50% (a 1x1 pixel area), the + result will be a grey 50% opaque pixel. The correct result would be a white + 50% opaque pixel. To get this result, we would paint away the black pixels. + They matter, despite being 0% opaque. - Tux Paint can scale images down by a very large factor, so it is - important to extend the edge of your object outward by a great deal. - Right at the edge of your object, you should be very accurate about - this. As you go outward away from the object, you can get a bit sloppy. - It is reasonable to paint outward by a dozen pixels or more. The farther - you go, the more Tux Paint can scale down without creating ugly color - fringes. For areas that are more than a few pixels away from the object - edge, you should use the pencil tool (or sloppy select with - drag-and-drop color) to ensure that the result will compress well. + Tux Paint can scale images down by a very large factor, so it is important + to extend the edge of your object outward by a great deal. Right at the + edge of your object, you should be very accurate about this. As you go + outward away from the object, you can get a bit sloppy. It is reasonable to + paint outward by a dozen pixels or more. The farther you go, the more Tux + Paint can scale down without creating ugly color fringes. For areas that + are more than a few pixels away from the object edge, you should use the + pencil tool (or sloppy select with drag-and-drop color) to ensure that the + result will compress well. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Save the image for Tux Paint - It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, you - can try saving your image directly as a PNG. Be sure to read it back in - again to verify that the 0% opaque areas didn't turn black or white, - which would create fringes when Tux Paint scales the image down. If you - need to scale your image to save space (and hide your mistakes), you are - almost certain to destroy all the 0% opaque areas. So here is a better - way... + It is very easy to ruin your hard work. Image editors can silently destroy + pixels in 0% opaque areas. The conditions under which this happens may vary + from version to version. If you are very trusting, you can try saving your + image directly as a PNG. Be sure to read it back in again to verify that + the 0% opaque areas didn't turn black or white, which would create fringes + when Tux Paint scales the image down. If you need to scale your image to + save space (and hide your mistakes), you are almost certain to destroy all + the 0% opaque areas. So here is a better way... - A Safer Way to Save + A Safer Way to Save - Drag the mask from the layers dialog to the unused portion of the - toolbar (right after the last drawing tool). This will create a new - image consisting of one layer that contains the mask data. Scale this - as desired, remembering the settings you use. Often you should start - with an image that is about 700 to 1500 pixels across, and end up with - one that is 300 to 400. + Drag the mask from the layers dialog to the unused portion of the + toolbar (right after the last drawing tool). This will create a new + image consisting of one layer that contains the mask data. Scale this + as desired, remembering the settings you use. Often you should start + with an image that is about 700 to 1500 pixels across, and end up with + one that is 300 to 400. - Save the mask image as a NetPBM portable greymap (".pgm") file. (If - you are using an old release of The GIMP, you might need to convert - the image to greyscale before you can save it.) Choose the more - compact "RAW PGM" format. (The second character of the file should be - the ASCII digit "5", hex byte 0x35.) + Save the mask image as a NetPBM portable greymap (".pgm") file. (If you + are using an old release of The GIMP, you might need to convert the + image to greyscale before you can save it.) Choose the more compact + "RAW PGM" format. (The second character of the file should be the ASCII + 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 - did with the mask, drag this from the layers dialog to the toolbar. - You 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 - painted-away surroundings, without any mask thumbnail in the layers - dialog. If you scaled the mask, then scale this image in exactly the - same way. Save this image as a NetPBM portable pixmap (".ppm") file. - (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.) + 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. You + 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 + painted-away surroundings, without any mask thumbnail in the layers + dialog. If you scaled the mask, then scale this image in exactly the + same way. Save this image as a NetPBM portable pixmap (".ppm") file. + (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.) - Now you need to merge the two files into one. Do that with the - pnmtopng command, like this: + Now you need to merge the two files into one. Do that with the pnmtopng + command, like this: + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/en/ENVVARS.txt b/docs/en/ENVVARS.txt index 967cd4ddf..d9c2fc611 100644 --- a/docs/en/ENVVARS.txt +++ b/docs/en/ENVVARS.txt @@ -1,5 +1,5 @@ Tux Paint - version 0.9.31 + version 0.9.31 Environment Variables Documentation Copyright © 2021-2023 by various contributors; see AUTHORS.txt. @@ -7,91 +7,97 @@ May 5, 2023 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint understands a number of environment variables, either directly, - or indirectly by the libraries that it utilizes. +Tux Paint understands a number of environment variables, either directly, or +indirectly by the libraries that it utilizes. Storage-related environment variables - HOME +HOME - Specifies the user's "home directory", which is used to locate - numerous other files or directories. In some cases, it is utilized - as part of a fall-back location, when other environment variables - (elsewhere in this documentation) are not set. Sometimes, the - location to use can be overridden by options provided on the - command-line or via Tux Paint's configuration file. See the - "OPTIONS" documentation for details. + Specifies the user's "home directory", which is used to locate numerous + other files or directories. In some cases, it is utilized as part of a + fall-back location, when other environment variables (elsewhere in this + documentation) are not set. Sometimes, the location to use can be + overridden by options provided on the command-line or via Tux Paint's + configuration file. See the "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 basis of where Tux Paint saves and loads users' drawings - * The location of a user's private collection of data files — - stamps, brushes, etc. — (versus those available system wide) + + The location of Tux Paint's configuration file + + The basis of where Tux Paint saves and loads users' drawings + + The location of a user's private collection of data files — stamps, + brushes, etc. — (versus those available system wide) - XDG_CONFIG_HOME - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's configuration files. - Specifically, where to find "user-dirs.dirs", where the - "XDG_PICTURES_DIR" might be defined. It is used for exporting - drawings and animated GIFs. Generally it's set to something like - "$HOME/Pictures/". If not specified, Tux Paint checks in the - directory "$HOME/.config/". If the configuration cannot be found, - Tux Paint simply exports drawings and GIFs to "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's configuration files. Specifically, where to find + "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used + for exporting drawings and animated GIFs. Generally it's set to something + like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory + "$HOME/.config/". If the configuration cannot be found, Tux Paint simply + exports drawings and GIFs to "$HOME". - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's data directories. - Specifically, where to find the "Trash" directory. It is used when - deleting images from Tux Paint's "Open" dialog. If not set, the - location "$HOME/.local/share/Trash/" is used, if available. If - not, images are simply deleted, rather than moved anywhere. - TEMP - Specifies the location where temporary files may be created. Only - used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if - not set. +XDG_DATA_HOME + + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's data directories. Specifically, where to find + the "Trash" directory. It is used when deleting images from Tux Paint's + "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is + used, if available. If not, images are simply deleted, rather than moved + anywhere. + + + +TEMP + + Specifies the location where temporary files may be created. Only used by + Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set. Language-related environment variables - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Specify the language Tux Paint should utilize in its user interface. + Overridde by the "--lang" and "--locale" command-line options or their + configuration file counterparts. The "LANGUAGE" environment variable is + used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES", + and finally "LANG". - LC_ALL - LC_MESSAGES - Specify the language Tux Paint should utilize in its user - interface. Overridde by the "--lang" and "--locale" command-line - options or their configuration file counterparts. The "LANGUAGE" - environment variable is used, if set. If not, "LC_ALL" is used as - a fallback. Then "LC_MESSAGES", and finally "LANG". Display-related environment variables - The following are a few of the environment variables supported by Simple - DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying - graphics, playing sounds, and receiving mouse, keyboard, and joystick - input — and which may be useful to users of Tux Paint. +The following are a few of the environment variables supported by Simple +DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics, +playing sounds, and receiving mouse, keyboard, and joystick input — and which +may be useful to users of Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Specifies whether Tux Paint should allow a screensaver to run. Can be set + to '1' (true) by Tux Paint itself by issuing the command-line option + "--allowscreensaver" or its configuration file counterpart. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Specifies whether Tux Paint should allow a screensaver to run. Can - be set to '1' (true) by Tux Paint itself by issuing the - command-line option "--allowscreensaver" or its configuration file - counterpart. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/en/EXTENDING.txt b/docs/en/EXTENDING.txt index c732a0725..ca32ec37f 100644 --- a/docs/en/EXTENDING.txt +++ b/docs/en/EXTENDING.txt @@ -1,1054 +1,1071 @@ Extending Tux Paint - version 0.9.31 + version 0.9.31 Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - May 29, 2023 + May 29, 2023 - +------------------------------------------+ - |Table of Contents | - |------------------------------------------| - | * Where Files Go | - | * Standard Files | - | * Personal Files | - | * Brushes | - | * Brush Options | - | * Stamps | - | * Stamp Images | - | * Stamp Descriptive Text | - | * Stamp Sound Effects | - | * Stamp Descriptive Sound | - | * Stamp Options | - | * Pre-Mirrored and Flipped Stamps | - | * Fonts | - | * 'Starters' | - | * Coloring-Book Style Starters | - | * Scene-Style Starters | - | * Starter Options | - | * 'Templates' | - | * Template Options | - | * Translations | - | * Alternative Input Methods | - | * On-screen Keyboard | - | * Magic Tools | - +------------------------------------------+ ++-----------------------------------------+ +| Table of Contents | +|-----------------------------------------| +| * Where Files Go | +| + Standard Files | +| + Personal Files | +| * Brushes | +| + Brush Options | +| * Stamps | +| + Stamp Images | +| + Stamp Descriptive Text | +| + Stamp Sound Effects | +| + Stamp Descriptive Sound | +| + Stamp Options | +| + Pre-Mirrored and Flipped Stamps | +| * Fonts | +| * 'Starters' | +| + Coloring-Book Style Starters | +| + Scene-Style Starters | +| + Starter Options | +| * 'Templates' | +| + Template Options | +| * Translations | +| * Alternative Input Methods | +| * On-screen Keyboard | +| * Magic Tools | ++-----------------------------------------+ - If you wish to add or change things like Brushes, Starters, Rubber Stamps, - and other content used by Tux Paint, you can do so fairly easily by simply - adding, changing, or removing files where Tux Paint looks for them. +If you wish to add or change things like Brushes, Starters, Rubber Stamps, and +other content used by Tux Paint, you can do so fairly easily by simply adding, +changing, or removing files where Tux Paint looks for them. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Where Files Go +Where Files Go Standard Files - Tux Paint looks for its various data files in its 'data' directory. +Tux Paint looks for its various data files in its 'data' directory. - Linux and Unix +Linux and Unix - Where this directory goes depends on what value was set for - "DATA_PREFIX" when Tux Paint was built. See 'Install - documentation' for details. + Where this directory goes depends on what value was set for "DATA_PREFIX" + when Tux Paint was built. See 'Install documentation' for details. - By default, though, the directory is: + By default, though, the directory is: - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - If you installed from a package, it is more likely to be: + If you installed from a package, it is more likely to be: - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint looks for a directory called 'data' in the same - directory as the executable. This is the directory that the - installer used when installing Tux Paint e.g.: - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint looks for a directory called 'data' in the same directory as the + executable. This is the directory that the installer used when installing + Tux Paint e.g.: - Tux Paint stores its data files inside the "Tux Paint" application - icon (which is actually a special kind of folder on macOS & Mac OS - X before it). The following steps explain how to get to the - folders within it: + C:\Program Files\TuxPaint\data - 1. Bring up a 'context' menu by holding the [Control] key and - clicking the Tux Paint icon the in Finder. (If you have a - mouse with more than one button, you can simply right-click - the icon.) - 2. Select "Show Contents" from the menu that appears. A new - Finder window will appear with a folder inside called - "Contents". - 3. Open the "Contents" folder and open the "Resources" folder - found inside. - 4. There, you will find various sub-folders, such as "starters", - "stamps", "brushes", etc. Adding new content to these folders - will make the content available to any user that launches - this copy (icon) of Tux Paint. - 💡 Note: If you install a newer version of Tux Paint and replace or - discard the old version, you will lose changes made by following - the instructions above, so keep backups of your new content - (stamps, brushes, etc.). - Tux Paint also looks for files in a "TuxPaint" folder that you can - place in your system's "Application Support" folder (found under - "Library" at the root of your filesystem): +macOS + + Tux Paint stores its data files inside the "Tux Paint" application icon + (which is actually a special kind of folder on macOS & Mac OS X before it). + The following steps explain how to get to the folders within it: + + 1. Bring up a 'context' menu by holding the [Control] key and clicking the + Tux Paint icon the in Finder. (If you have a mouse with more than one + button, you can simply right-click the icon.) + 2. Select "Show Contents" from the menu that appears. A new Finder window + will appear with a folder inside called "Contents". + 3. Open the "Contents" folder and open the "Resources" folder found + inside. + 4. There, you will find various sub-folders, such as "starters", "stamps", + "brushes", etc. Adding new content to these folders will make the + content available to any user that launches this copy (icon) of Tux + Paint. + + 💡 Note: If you install a newer version of Tux Paint and replace or discard + the old version, you will lose changes made by following the instructions + above, so keep backups of your new content (stamps, brushes, etc.). + + Tux Paint also looks for files in a "TuxPaint" folder that you can place in + your system's "Application Support" folder (found under "Library" at the + root of your filesystem): + + /Library/Application Support/TuxPaint/ + + When you upgrade to a newer version of Tux Paint, the contents of this + "TuxPaint" folder will stay the same, and remain accessible by all users of + Tux Paint. + - /Library/Application Support/TuxPaint/ - When you upgrade to a newer version of Tux Paint, the contents of - this "TuxPaint" folder will stay the same, and remain accessible - by all users of Tux Paint. Personal Files - You can also create brushes, stamps, 'starters', templates, and fonts in - your own user account directory (folder) for Tux Paint to find. +You can also create brushes, stamps, 'starters', templates, and fonts in your +own user account directory (folder) for Tux Paint to find. - Windows +Windows - Your personal Tux Paint folder is stored in your personal - "Application Data". For example, on newer Windows: + Your personal Tux Paint folder is stored in your personal "Application + Data". For example, on newer Windows: - C:\Documents and Settings\(username)\Application Data\TuxPaint\ + C:\Documents and Settings\(username)\Application Data\TuxPaint\ - macOS - Your personal Tux Paint folder is stored in your personal - "Application Support" folder: - /Users/(username)/Library/Application Support/TuxPaint/ +macOS - Linux and Unix + Your personal Tux Paint folder is stored in your personal "Application + Support" folder: - Your personal Tux Paint files go into a 'hidden directory' found - in your account's home directory: "$(HOME)/.tuxpaint/" (also known - as "~/.tuxpaint/"). + /Users/(username)/Library/Application Support/TuxPaint/ - That is, if your home directory is "/home/tux", then your personal - Tux Paint files go in "/home/tux/.tuxpaint/". - Don't forget the period (".") before the "tuxpaint"! - To add your own brushes, stamps, 'starters,' templates, and fonts, create - subdirectories under your personal Tux Paint directory named "brushes", - "stamps", "starters", "templates", "fonts", respectively. +Linux and Unix - (For example, if you created a brush named "flower.png", you would put it - in "~/.tuxpaint/brushes/" under Linux or Unix.) + Your personal Tux Paint files go into a 'hidden directory' found in your + account's home directory: "$(HOME)/.tuxpaint/" (also known as "~/.tuxpaint/ + "). - Brushes + That is, if your home directory is "/home/tux", then your personal Tux + Paint files go in "/home/tux/.tuxpaint/". - The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux - Paint are simply PNG image files. + Don't forget the period (".") before the "tuxpaint"! - The alpha (transparency) of the PNG image is used to determine the shape - of the brush, which means that the shape can be 'anti-aliased' and even - partially-transparent! - Greyscale pixels in the brush PNG will be drawn using the - currently-selected color in Tux Paint. Color pixels will be tinted. + + +To add your own brushes, stamps, 'starters,' templates, and fonts, create +subdirectories under your personal Tux Paint directory named "brushes", "stamps +", "starters", "templates", "fonts", respectively. + +(For example, if you created a brush named "flower.png", you would put it in "~ +/.tuxpaint/brushes/" under Linux or Unix.) + +Brushes + +The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux Paint +are simply PNG image files. + +The alpha (transparency) of the PNG image is used to determine the shape of the +brush, which means that the shape can be 'anti-aliased' and even +partially-transparent! + +Greyscale pixels in the brush PNG will be drawn using the currently-selected +color in Tux Paint. Color pixels will be tinted. Brush Options - Aside from a graphical shape, brushes can also be given other attributes. - To do this, you need to create a 'data file' for the brush. +Aside from a graphical shape, brushes can also be given other attributes. To do +this, you need to create a 'data file' for the brush. - A brush's data file is simply a plain ASCII text file containing the - options for the brush. +A brush's data file is simply a plain ASCII text file containing the options +for the brush. - The file has the same name as the PNG image, but a ".dat" extension. - (e.g., "brush.png"'s data file is the text file "brush.dat", found in the - same directory.) +The file has the same name as the PNG image, but a ".dat" extension. (e.g., +"brush.png"'s data file is the text file "brush.dat", found in the same +directory.) - Brush Spacing +Brush Spacing - As of Tux Paint version 0.9.16, you can now specify the spacing - for brushes (that is, how often they are drawn). By default, the - spacing will be the brush's height, divided by 4. + As of Tux Paint version 0.9.16, you can now specify the spacing for brushes + (that is, how often they are drawn). By default, the spacing will be the + brush's height, divided by 4. - Add a line containing the line "spacing=N" to the brush's data - file, where "N" is the spacing you want for the brush. (The lower - the number, the more often the brush is drawn.) + Add a line containing the line "spacing=N" to the brush's data file, where + "N" is the spacing you want for the brush. (The lower the number, the more + often the brush is drawn.) - Animated Brushes - As of Tux Paint version 0.9.16, you may now create animated - brushes. As the brush is used, each frame of the animation is - drawn. - Lay each frame out across a wide PNG image. For example, if your - brush is 30x30 and you have 5 frames, the image should be 150x30. +Animated Brushes - Add a line containing the line "frames=N" to the brush's data - file, where "N" is the number of frames in the brush. + As of Tux Paint version 0.9.16, you may now create animated brushes. As the + brush is used, each frame of the animation is drawn. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Lay each frame out across a wide PNG image. For example, if your brush is + 30x30 and you have 5 frames, the image should be 150x30. - Directional Brushes + Add a line containing the line "frames=N" to the brush's data file, where " + N" is the number of frames in the brush. - As of Tux Paint version 0.9.16, you may now create directional - brushes. As the brush is used, different shapes are drawn, - depending on the direction the brush is going. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - The directional shapes are divided into a 3x3 square in a PNG - image. For example, if your brush is 30x30, the image should be - 90x90, and each of the direction's shapes placed in a 3x3 grid. - The center region is used for no motion. The top right is used for - motion that's both up, and to the right. And so on. - Add a line containing the word "directional" to the brush's data - file. - Rotating Brushes +Directional Brushes - As of Tux Paint version 0.9.27, you may now create rotating - brushes. As the brush is used, it is rotated 360 degrees, - depending on the direction the brush is going. + As of Tux Paint version 0.9.16, you may now create directional brushes. As + the brush is used, different shapes are drawn, depending on the direction + the brush is going. - Add a line containing the word "rotate" to the brush's data file. + The directional shapes are divided into a 3x3 square in a PNG image. For + example, if your brush is 30x30, the image should be 90x90, and each of the + direction's shapes placed in a 3x3 grid. The center region is used for no + motion. The top right is used for motion that's both up, and to the right. + And so on. - Animated Directional or Rotating Brushes + Add a line containing the word "directional" to the brush's data file. - You may mix both animated and either directional or rotating - features into one brush. Use both options desired ("frames=N" and - "directional" or "rotate"), in separate lines in the brush's - ".dat" file. - For directional brushes, lay the brush out so that each 3x3 set of - directional shapes are laid out across a wide PNG image. For - example, if the brush is 30x30 and there are 5 frames, it would be - 450x90. (The leftmost 150x90 pixels of the image represent the 9 - direction shapes for the first frame, for example.) - Place the brush image PNGs (and any data text files) in the "brushes" - directory. +Rotating Brushes - 💡 Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + As of Tux Paint version 0.9.27, you may now create rotating brushes. As the + brush is used, it is rotated 360 degrees, depending on the direction the + brush is going. - Stamps + Add a line containing the word "rotate" to the brush's data file. - All stamp-related files go in the "stamps" directory. It's useful to - create subdirectories and sub-subdirectories there to organize the stamps. - (For example, you can have a "holidays" folder with "halloween" and - "christmas" sub-folders.) + + +Animated Directional or Rotating Brushes + + You may mix both animated and either directional or rotating features into + one brush. Use both options desired ("frames=N" and "directional" or " + rotate"), in separate lines in the brush's ".dat" file. + + For directional brushes, lay the brush out so that each 3x3 set of + directional shapes are laid out across a wide PNG image. For example, if + the brush is 30x30 and there are 5 frames, it would be 450x90. (The + leftmost 150x90 pixels of the image represent the 9 direction shapes for + the first frame, for example.) + + + + +Place the brush image PNGs (and any data text files) in the "brushes" +directory. + +💡 Note: If your new brushes all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +Stamps + +All stamp-related files go in the "stamps" directory. It's useful to create +subdirectories and sub-subdirectories there to organize the stamps. (For +example, you can have a "holidays" folder with "halloween" and "christmas" +sub-folders.) Stamp Images - Rubber Stamps in Tux Paint can be made up of a number of separate files. - The one file that is required is, of course, the picture itself. +Rubber Stamps in Tux Paint can be made up of a number of separate files. The +one file that is required is, of course, the picture itself. - As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or - SVG vector images. They can be full-color or greyscale. The alpha - (transparency) channel of PNGs is used to determine the actual shape of - the picture (otherwise you'll stamp a large rectangle on your drawings). +As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or SVG +vector images. They can be full-color or greyscale. The alpha (transparency) +channel of PNGs is used to determine the actual shape of the picture (otherwise +you'll stamp a large rectangle on your drawings). - PNGs can be any size, and Tux Paint (by default) provides a set of sizing - buttons to let the user scale the stamp up (larger) and down (smaller). +PNGs can be any size, and Tux Paint (by default) provides a set of sizing +buttons to let the user scale the stamp up (larger) and down (smaller). - SVGs are vector-based, and will be scaled appropriately for the canvas - size being used in Tux Paint. +SVGs are vector-based, and will be scaled appropriately for the canvas size +being used in Tux Paint. - 💡 Note: If your new PNG-based stamps all come out as solid squares or - rectangles, it's because you forgot to use alpha transparency! See the - 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new PNG-based stamps all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in - detail, how to make PNG images which will scale perfectly when used as - stamps in Tux Paint. +⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in detail, +how to make PNG images which will scale perfectly when used as stamps in Tux +Paint. Stamp Descriptive Text - Tux Paint will display descriptive text when a stamp is selected. These - are placed in plain text files with the same name as the PNG or SVG, but - with a ".txt" filename extension. (e.g., "stamp.png"'s description is - stored in "stamp.txt" in the same directory.) +Tux Paint will display descriptive text when a stamp is selected. These are +placed in plain text files with the same name as the PNG or SVG, but with a +".txt" filename extension. (e.g., "stamp.png"'s description is stored in +"stamp.txt" in the same directory.) - The first line of the text file will be used as the US English description - of the stamp's image. It must be encoded in UTF-8. +The first line of the text file will be used as the US English description of +the stamp's image. It must be encoded in UTF-8. - Localization Support +Localization Support - Additional lines can be added to the text file to provide - translations of the description, to be displayed when Tux Paint is - running in a different locale (like French or Spanish). + Additional lines can be added to the text file to provide translations of + the description, to be displayed when Tux Paint is running in a different + locale (like French or Spanish). - The beginning of the line should correspond to the language code - of the language in question (e.g., "fr" for French, and "zh_TW" - for Traditional Chinese), followed by ".utf8=" and the translated - description (Unicode, encoded in UTF-8). + The beginning of the line should correspond to the language code of the + language in question (e.g., "fr" for French, and "zh_TW" for Traditional + Chinese), followed by ".utf8=" and the translated description (Unicode, + encoded in UTF-8). - For Tux Paint developers: There are scripts in the "po" directory - for converting the text files to PO format (and back) for easy - translation to different languages. Therefore you should never add - or change translations in the ".txt" files directly. + For Tux Paint developers: There are scripts in the "po" directory for + converting the text files to PO format (and back) for easy translation to + different languages. Therefore you should never add or change translations + in the ".txt" files directly. + + If no translation is available for the language Tux Paint is currently + running in, the US English text is used. + + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. - If no translation is available for the language Tux Paint is - currently running in, the US English text is used. - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. Stamp Sound Effects - Tux Paint can play a sound effect when a stamp is selected. For example, - the sound of a duck quaking when selecting a duck, or a brief piece of - music when a musical instrument is chosen. Files may be in "WAVE (".wav")" - or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG or - SVG image. (e.g., "stamp.svg"'s sound effect is the sound file "stamp.ogg" - in the same directory.) +Tux Paint can play a sound effect when a stamp is selected. For example, the +sound of a duck quaking when selecting a duck, or a brief piece of music when a +musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis +(".ogg")" formats, and are given same name as the PNG or SVG image. (e.g., +"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same +directory.) - Localization Support +Localization Support - For sounds for different locales (e.g., if the sound is someone - saying a word, and you want translated versions of the word said), - also create WAV or OGG files with the locale's label in the - filename, in the form: "stamp_LOCALE.EXT" + For sounds for different locales (e.g., if the sound is someone saying a + word, and you want translated versions of the word said), also create WAV + or OGG files with the locale's label in the filename, in the form: + "stamp_LOCALE.EXT" - The sound effect that will be played when the stamp corresponding - to the image file "stamp.png" is selected, and when Tux Paint is - using the Spanish locale, would be "stamp_es.wav". Under the - French locale, it would be "stamp_fr.wav". Under the Brazilian - Portuguese locale, "stamp_pt_BR.wav". And so on... + The sound effect that will be played when the stamp corresponding to the + image file "stamp.png" is selected, and when Tux Paint is using the Spanish + locale, would be "stamp_es.wav". Under the French locale, it would be + "stamp_fr.wav". Under the Brazilian Portuguese locale, "stamp_pt_BR.wav". + And so on... - If no localized sound effect can be loaded, Tux Paint will attempt - to load the 'default' sound file. (e.g., "stamp.wav") + If no localized sound effect can be loaded, Tux Paint will attempt to load + the 'default' sound file. (e.g., "stamp.wav") - 💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive - Sound', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound', +below. Stamp Descriptive Sound - Tux Paint can also play a descriptive sound when a stamp is selected. For - example, the sound of someone saying the word "duck" when selecting a - duck, or the name of a musical instrument when one is chosen. Files may be - in "WAVE (".wav")" or "OGG Vorbis (".ogg")" formats, and are given same - name as the PNG or SVG image, with "_desc" at the end. (e.g., - "stamp.svg"'s descriptive sound is the sound file "stamp_desc.ogg" in the - same directory.) +Tux Paint can also play a descriptive sound when a stamp is selected. For +example, the sound of someone saying the word "duck" when selecting a duck, or +the name of a musical instrument when one is chosen. Files may be in "WAVE +(".wav")" or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG +or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound +is the sound file "stamp_desc.ogg" in the same directory.) - Localization Support +Localization Support + + For descriptive sounds for different locales, also create WAV or OGG files + with both "_desc" and the locale's label in the filename, in the form: + "stamp_desc_LOCALE.EXT" + + The descriptive sound that will be played when the stamp corresponding to + the image file "stamp.png" is selected, and when Tux Paint is using the + Spanish locale, would be "stamp_desc_es.wav". Under the French locale, it + would be "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, + "stamp_desc_pt_BR.wav". And so on... + + If no localized descriptive sound can be loaded, Tux Paint will attempt to + load the 'default' sound file. (e.g., "stamp_desc.wav") - For descriptive sounds for different locales, also create WAV or - OGG files with both "_desc" and the locale's label in the - filename, in the form: "stamp_desc_LOCALE.EXT" - The descriptive sound that will be played when the stamp - corresponding to the image file "stamp.png" is selected, and when - Tux Paint is using the Spanish locale, would be - "stamp_desc_es.wav". Under the French locale, it would be - "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, - "stamp_desc_pt_BR.wav". And so on... - If no localized descriptive sound can be loaded, Tux Paint will - attempt to load the 'default' sound file. (e.g., "stamp_desc.wav") Stamp Options - Aside from a graphical shape, a textual description, a sound effect, and a - descriptive sound, stamps can also be given other attributes. To do this, - you need to create a 'data file' for the stamp. +Aside from a graphical shape, a textual description, a sound effect, and a +descriptive sound, stamps can also be given other attributes. To do this, you +need to create a 'data file' for the stamp. - A stamp's data file is simply a plain ASCII text file containing the - options for the stamp. +A stamp's data file is simply a plain ASCII text file containing the options +for the stamp. - The file has the same name as the PNG or SVG image, but a ".dat" - extension. (e.g., "stamp.png"'s data file is the text file "stamp.dat", - found in the same directory.) +The file has the same name as the PNG or SVG image, but a ".dat" extension. +(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same +directory.) - Colored Stamps +Colored Stamps - Stamps can be made to be either "colorable" or "tintable." + Stamps can be made to be either "colorable" or "tintable." - Colorable + Colorable - "Colorable" stamps they work much like brushes - you - pick the stamp to get the shape, and then pick the - color you want it to be. (Symbol stamps, like the - mathematical and musical ones, are an example.) + "Colorable" stamps they work much like brushes - you pick the stamp to + get the shape, and then pick the color you want it to be. (Symbol + stamps, like the mathematical and musical ones, are an example.) - Nothing about the original image is used except the - transparency (from "alpha" channel). The color of the - stamp comes out solid. + Nothing about the original image is used except the transparency (from + "alpha" channel). The color of the stamp comes out solid. - Add a line containing the word "colorable" to the - stamp's data file. + Add a line containing the word "colorable" to the stamp's data file. - Tinted - "Tinted" stamps are similar to "colorable" ones, - except the details of the original image are kept. - (To put it technically, the original image is used, - but its hue is changed, based on the - currently-selected color.) - Add a line containing the word "tintable" to the - stamp's data file. + Tinted - Tinting Options: + "Tinted" stamps are similar to "colorable" ones, except the details of + the original image are kept. (To put it technically, the original image + is used, but its hue is changed, based on the currently-selected + color.) - Depending on the contents of your stamp, you might - want to have Tux Paint use one of a number of methods - when tinting it. Add one of the following lines to - the stamp's data file: + Add a line containing the word "tintable" to the stamp's data file. - Normal tinter — "tinter=normal" (the default) - This is the normal tinting mode. First, - the primary hue of the stamp is - determined. (For example, a picture of a - flower with a stem will have the petal - color seen as the primary hue of the - overall image.) Next, the most highly - saturated part of the picture is found. - With "normal tinter", the range of hue - used to do this starts out within ±18° - of the pimary hue found in step 1. (If - none can be found, it widens the range - by 50% and tries again.) Finally, the - image is tinted. Anything falling within - 50% of the range (e.g., ±27°) is altered - to have the hue of the color chosen by - the user. - Narrow tinter — "tinter=narrow" - This like the "normal" option described - above, but starts a narrower hue range - of ±6°. Anything found within 50% of the - range (e.g. ±9°) is tinted. If too much - of your stamp is being tinted, try this - option. - 'Any hue' tinter — "tinter=anyhue" - This remaps all hues in the stamp. It - works similarly to the "anyhue" and - "narrow" options described above, but - the hue range is ±180°. + Tinting Options: - Vector tinter — "tinter=vector" - This maps 'black through white' to - 'black through destination'. + Depending on the contents of your stamp, you might want to have Tux + Paint use one of a number of methods when tinting it. Add one of the + following lines to the stamp's data file: - Unalterable Stamps + Normal tinter — "tinter=normal" (the default) + This is the normal tinting mode. First, the primary hue of the + stamp is determined. (For example, a picture of a flower with a + stem will have the petal color seen as the primary hue of the + overall image.) Next, the most highly saturated part of the picture + is found. With "normal tinter", the range of hue used to do this + starts out within ±18° of the pimary hue found in step 1. (If none + can be found, it widens the range by 50% and tries again.) Finally, + the image is tinted. Anything falling within 50% of the range + (e.g., ±27°) is altered to have the hue of the color chosen by the + user. - By default, a stamp can be flipped upside down, shown as a mirror - image, or both. This is done using the control buttons below the - stamp selector, at the lower right side of the screen in Tux - Paint. + Narrow tinter — "tinter=narrow" + This like the "normal" option described above, but starts a + narrower hue range of ±6°. Anything found within 50% of the range + (e.g. ±9°) is tinted. If too much of your stamp is being tinted, + try this option. - Sometimes, it doesn't make sense for a stamp to be flippable or - mirrored; for example, stamps of letters or numbers. Sometimes - stamps are symmetrical, so letting the user flip or mirror them - isn't useful. + 'Any hue' tinter — "tinter=anyhue" + This remaps all hues in the stamp. It works similarly to the + "anyhue" and "narrow" options described above, but the hue range is + ±180°. - To prevent a stamp from being flipped vertically, add the option - "noflip" to the stamp's data file. + Vector tinter — "tinter=vector" + This maps 'black through white' to 'black through destination'. - To prevent a stamp from being mirrored horizontally, add the - option "nomirror" to the stamp's data file. - Initial Stamp Size - By default, Tux Paint assumes that your stamp is sized - appropriately for unscaled display on a 608x472 canvas. This was - the original Tux Paint canvas size, provided by a 640x480 screen. - Tux Paint will then adjust the stamp according to the current - canvas size and, if enabled, the user's stamp size controls. - If your stamp would be too big or too small, you can specify a - scale factor. If your stamp would be 2.5 times as wide (or tall) - as it should be, add one of the following options, which represent - the same adjustment, to the stamp's data file. (An equals sign, - "=", may be included after the word "scale".) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. +Unalterable Stamps + + By default, a stamp can be flipped upside down, shown as a mirror image, or + both. This is done using the control buttons below the stamp selector, at + the lower right side of the screen in Tux Paint. + + Sometimes, it doesn't make sense for a stamp to be flippable or mirrored; + for example, stamps of letters or numbers. Sometimes stamps are + symmetrical, so letting the user flip or mirror them isn't useful. + + To prevent a stamp from being flipped vertically, add the option "noflip" + to the stamp's data file. + + To prevent a stamp from being mirrored horizontally, add the option " + nomirror" to the stamp's data file. + + + +Initial Stamp Size + + By default, Tux Paint assumes that your stamp is sized appropriately for + unscaled display on a 608x472 canvas. This was the original Tux Paint + canvas size, provided by a 640x480 screen. Tux Paint will then adjust the + stamp according to the current canvas size and, if enabled, the user's + stamp size controls. + + If your stamp would be too big or too small, you can specify a scale + factor. If your stamp would be 2.5 times as wide (or tall) as it should be, + add one of the following options, which represent the same adjustment, to + the stamp's data file. (An equals sign, "=", may be included after the word + "scale".) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. + + + Pre-Mirrored and Flipped Stamps - In some cases, you may wish to provide a pre-drawn version of a stamp's - mirror-image, flipped image, or even both. For example, imagine a picture - of a fire truck with the words "Fire Department" written across the side. - You probably do not want that text to appear backwards when the image is - flipped! +In some cases, you may wish to provide a pre-drawn version of a stamp's +mirror-image, flipped image, or even both. For example, imagine a picture of a +fire truck with the words "Fire Department" written across the side. You +probably do not want that text to appear backwards when the image is flipped! - To create a mirrored version of a stamp that you want Tux Paint to use, - rather than mirroring one on its own, simply create a second ".png" or - ".svg" graphics file with the same name, except with "_mirror" before the - filename extension. +To create a mirrored version of a stamp that you want Tux Paint to use, rather +than mirroring one on its own, simply create a second ".png" or ".svg" graphics +file with the same name, except with "_mirror" before the filename extension. - For example, for the stamp "stamp.png" you would create another file named - "stamp_mirror.png", which will be used when the stamp is mirrored (rather - than using a backwards version of "stamp.png"). +For example, for the stamp "stamp.png" you would create another file named +"stamp_mirror.png", which will be used when the stamp is mirrored (rather than +using a backwards version of "stamp.png"). - As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with - "_flip" in the name, and/or an image that is both mirrored and flipped, by - naming it "_mirror_flip". +As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with " +_flip" in the name, and/or an image that is both mirrored and flipped, by +naming it "_mirror_flip". - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - Fonts +Fonts - The fonts used by Tux Paint are TrueType Fonts (TTF). +The fonts used by Tux Paint are TrueType Fonts (TTF). - Simply place them in the "fonts" directory. Tux Paint will load the font - and provide four different sizes in the 'Letters' selector when using the - 'Text' and 'Label' tools. +Simply place them in the "fonts" directory. Tux Paint will load the font and +provide four different sizes in the 'Letters' selector when using the 'Text' +and 'Label' tools. - 'Starters' +'Starters' - 'Starter' images appear in the 'New' dialog, along with solid color - background choices. +'Starter' images appear in the 'New' dialog, along with solid color background +choices. - When you use a 'starter' image, make modifications, and save it, the - original 'starter' image is not overwritten. Additionally, as you edit - your new picture, the contents of the original 'starter' can affect it. +When you use a 'starter' image, make modifications, and save it, the original +'starter' image is not overwritten. Additionally, as you edit your new picture, +the contents of the original 'starter' can affect it. Coloring-Book Style Starters - The most basic kind of 'starter' is similar to a picture in a coloring - book. It's an outline of a shape which you can then color in and add - details to. In Tux Paint, as you draw, type text, or stamp stamps, the - outline remains 'above' what you draw. You can erase the parts of the - drawing you made, but you can't erase the outline. +The most basic kind of 'starter' is similar to a picture in a coloring book. +It's an outline of a shape which you can then color in and add details to. In +Tux Paint, as you draw, type text, or stamp stamps, the outline remains 'above' +what you draw. You can erase the parts of the drawing you made, but you can't +erase the outline. - To create this kind of 'starter' image, simply create an outlined black - and white picture in a paint program, and save it as a raster PNG file, or - vector SVG. If saving as a PNG, you may optionally render the image as - black-and-transparent, rather than black-and-white, but (as of Tux Paint - 0.9.21) this is not required. +To create this kind of 'starter' image, simply create an outlined black and +white picture in a paint program, and save it as a raster PNG file, or vector +SVG. If saving as a PNG, you may optionally render the image as +black-and-transparent, rather than black-and-white, but (as of Tux Paint +0.9.21) this is not required. Scene-Style Starters - Along with the 'coloring-book' style overlay, you can also provide a - separate background image as part of a 'starter' picture. The overlay acts - the same: it can't be drawn over, erased, or affected by 'Magic' tools. - However, the background can be! +Along with the 'coloring-book' style overlay, you can also provide a separate +background image as part of a 'starter' picture. The overlay acts the same: it +can't be drawn over, erased, or affected by 'Magic' tools. However, the +background can be! - When the 'Eraser' tool is used on a picture based on this kind of - 'starter' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'starter' image. +When the 'Eraser' tool is used on a picture based on this kind of 'starter' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'starter' image. - By creating both an overlay and a background, you can create a 'starter' - which simulates depth. Imagine a background that shows the ocean, and an - overlay that's a picture of a reef. You can then draw (or stamp) fish in - the picture. They'll appear in the ocean, but never 'in front of' the - reef. +By creating both an overlay and a background, you can create a 'starter' which +simulates depth. Imagine a background that shows the ocean, and an overlay +that's a picture of a reef. You can then draw (or stamp) fish in the picture. +They'll appear in the ocean, but never 'in front of' the reef. - To create this kind of 'starter' picture, simply create an overlay (with - transparency) and save it as a PNG. Then create another image (without - transparency), and save it with the same filename, but with "-back" (short - for 'background') appended to the name. (e.g., "starter-back.png" would be - the background ocean picture that corresponds to the overlay, or - foreground.) +To create this kind of 'starter' picture, simply create an overlay (with +transparency) and save it as a PNG. Then create another image (without +transparency), and save it with the same filename, but with "-back" (short for +'background') appended to the name. (e.g., "starter-back.png" would be the +background ocean picture that corresponds to the overlay, or foreground.) - For best results, 'starter' images should be at least the same size as Tux - Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" - section of Tux Paint's main documentation (README) for details on sizing.) - If they are not, they will be stretched or scaled. This is done without - affecting the shape ("aspect ratio"); however some smudging may be applied - to the edges. +For best results, 'starter' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. - Place them in the "starters" directory. When the 'New' dialog is accessed - in Tux Paint, the 'starter' images will appear in the screen that appears, - after the various solid color choices. +Place them in the "starters" directory. When the 'New' dialog is accessed in +Tux Paint, the 'starter' images will appear in the screen that appears, after +the various solid color choices. - 💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'starter' image, it - will always be affected by it.) +💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a 'starter' image, it will always be affected by it.) Starter Options - Aside from an image, starters can also be given other attributes. To do - this, you need to create a 'data file' for the starter. (Note: Tux Paint - prior to version 0.9.29 did not support starter options.) +Aside from an image, starters can also be given other attributes. To do this, +you need to create a 'data file' for the starter. (Note: Tux Paint prior to +version 0.9.29 did not support starter options.) - A starter's data file is simply a plain ASCII text file containing the - options for the starter. +A starter's data file is simply a plain ASCII text file containing the options +for the starter. - The file has the same name as the image, but a ".dat" extension. (e.g., - "starter.png"'s data file is the text file "starter.dat", found in the - same directory.) +The file has the same name as the image, but a ".dat" extension. (e.g., +"starter.png"'s data file is the text file "starter.dat", found in the same +directory.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + Colors may be listed using three decimal numbers (e.g., "255 68 136") or a + 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "#F48"). - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - 'Templates' + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - 'Template' images also appear in the 'New' dialog, along with solid color - background choices and 'Starters'. (Note: Tux Paint prior to version - 0.9.22 did not have the 'Template' feature.) + Focusing on the top of a starter image stretched to fit the width of the + canvas. - Unlike pictures drawn in Tux Paint by users and then opened later, opening - a 'template' creates a new drawing. When you save, the 'template' image is - not overwritten. Unlike 'starters', there is no immutable 'layer' above - the canvas. You may draw over any part of it. - When the 'Eraser' tool is used on a picture based on this kind of - 'template' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'template' image. + [ Landscape-shaped image of the ground with the sun at the top. ] - 'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) - format). No preparation or conversion should be required. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - For best results, 'template' images should be at least the same size as - Tux Paint's drawing canvas. (See the "Loading Other Pictures into Tux - Paint" section of Tux Paint's main documentation (README) for details on - sizing.) If they are not, they will be stretched or scaled. This is done - without affecting the shape ("aspect ratio"); however some smudging may be - applied to the edges. - Place them in the "templates" directory. When the 'New' dialog is accessed - in Tux Paint, the 'template' images will appear in the screen that - appears, after the various solid color choices. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +'Templates' + +'Template' images also appear in the 'New' dialog, along with solid color +background choices and 'Starters'. (Note: Tux Paint prior to version 0.9.22 did +not have the 'Template' feature.) + +Unlike pictures drawn in Tux Paint by users and then opened later, opening a +'template' creates a new drawing. When you save, the 'template' image is not +overwritten. Unlike 'starters', there is no immutable 'layer' above the canvas. +You may draw over any part of it. + +When the 'Eraser' tool is used on a picture based on this kind of 'template' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'template' image. + +'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) format). +No preparation or conversion should be required. + +For best results, 'template' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. + +Place them in the "templates" directory. When the 'New' dialog is accessed in +Tux Paint, the 'template' images will appear in the screen that appears, after +the various solid color choices. + +💡 Note: 'Templates' are 'attached' to saved pictures, via a small text file +that has the same name as the saved file, but with ".dat" as the extension. +This allows it to continue to affect the drawing even after Tux Paint has been +quit, or another picture is loaded or a new image is created. (In other words, +if you base a drawing on a 'template' image, it will always be affected by it.) - 💡 Note: 'Templates' are 'attached' to saved pictures, via a small text - file that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'template' image, it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Translations +Translations - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - To translate Tux Paint to a new language, copy the translation template - file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder - "src/po/"). Rename the copy as a ".po" file, with an appropriate name for - the locale you're translating to (e.g., "es.po" for Spanish; or "pt_BR.po" - for Brazilian Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese - spoken in Portugal.) +To translate Tux Paint to a new language, copy the translation template file, +"tuxpaint.pot" (found in Tux Paint's source code, in the folder "src/po/"). +Rename the copy as a ".po" file, with an appropriate name for the locale you're +translating to (e.g., "es.po" for Spanish; or "pt_BR.po" for Brazilian +Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese spoken in Portugal.) - Open the newly-created ".po" file — you can edit in a plain text edtior, - such as Emacs, Pico or VI on Linux, or NotePad on Windows. The original - English text used in Tux Paint is listed in lines starting with "msgid". - Enter your translations of each of these pieces of text in the empty - "msgstr" lines directly below the corresponding "msgid" lines. (Note: Do - not remove the quotes.) +Open the newly-created ".po" file — you can edit in a plain text edtior, such +as Emacs, Pico or VI on Linux, or NotePad on Windows. The original English text +used in Tux Paint is listed in lines starting with "msgid". Enter your +translations of each of these pieces of text in the empty "msgstr" lines +directly below the corresponding "msgid" lines. (Note: Do not remove the +quotes.) - Example: +Example: - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - Various tools exist to manage gettext translation catalogs, so you don't - have to edit them by hand in a text editor. Here are a few: - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +Various tools exist to manage gettext translation catalogs, so you don't have +to edit them by hand in a text editor. Here are a few: - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - To edit an existing translation, download the latest ".po" file for that - language, and edit it as described above. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - You may send new or edited translation files to Bill Kendrick, lead - developer of Tux Paint, at: bill@newbreedsoftware.com, or post them to the - "tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). +To edit an existing translation, download the latest ".po" file for that +language, and edit it as described above. - Alternatively, if you have an account with SourceForge.net, you can - request to be added to the "tuxpaint" project and receive write-access to - the Git source code repository so that you may commit your changes - directly. +You may send new or edited translation files to Bill Kendrick, lead developer +of Tux Paint, at: bill@newbreedsoftware.com, or post them to the +"tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). - 💡 Note: Support for new locales requires making additions to Tux Paint's - source code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the - Makefile, to ensure the ".po" files are compiled into ".mo" files, and - available for use at runtime. +Alternatively, if you have an account with SourceForge.net, you can request to +be added to the "tuxpaint" project and receive write-access to the Git source +code repository so that you may commit your changes directly. - Alternative Input Methods +💡 Note: Support for new locales requires making additions to Tux Paint's source +code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the Makefile, +to ensure the ".po" files are compiled into ".mo" files, and available for use +at runtime. - Tux Paint's 'Text' and 'Label' tools can provide alternative input methods - for some languages. For example, when Tux Paint is running with a Japanese - locale, the right [Alt] key can be pressed to cycle between Latin, - Romanized Hiragana and Romanized Katakana modes. This allows native - characters and words to be entered into the 'Text' and 'Label' tools by - typing one or more keys on a keyboard with Latin characters (e.g., a US - QWERTY keyboard). +Alternative Input Methods - To create an input method for a new locale, create a text file with a name - based on the locale (e.g., "ja" for Japanese), with ".im" as the extension - (e.g., "ja.im"). +Tux Paint's 'Text' and 'Label' tools can provide alternative input methods for +some languages. For example, when Tux Paint is running with a Japanese locale, +the right [Alt] key can be pressed to cycle between Latin, Romanized Hiragana +and Romanized Katakana modes. This allows native characters and words to be +entered into the 'Text' and 'Label' tools by typing one or more keys on a +keyboard with Latin characters (e.g., a US QWERTY keyboard). - The ".im" file can have multiple character mapping sections for different - character mapping modes. For example, on a Japanese typing system, typing - [K] [A] in Hiragana mode generates a different Unicode character ("か") - than typing [K] [A] in Katakana mode ("カ"). +To create an input method for a new locale, create a text file with a name +based on the locale (e.g., "ja" for Japanese), with ".im" as the extension +(e.g., "ja.im"). - List the character mappings in this file, one per line. Each line should - contain (separated by whitespace): +The ".im" file can have multiple character mapping sections for different +character mapping modes. For example, on a Japanese typing system, typing [K] +[A] in Hiragana mode generates a different Unicode character ("か") than typing +[K] [A] in Katakana mode ("カ"). - * the Unicode value of the character, in hexadecimal (more than one - character can be listed, separated by a colon (':'), this allowing - some sequences to map to words) - * the keycode sequence (the ASCII characters that must be entered to - generate the Unicode character) - * a flag (or "-" if none) +List the character mappings in this file, one per line. Each line should +contain (separated by whitespace): - Start additional character mapping sections with a line containign the - word "section". + * the Unicode value of the character, in hexadecimal (more than one character + can be listed, separated by a colon (':'), this allowing some sequences to + map to words) + * the keycode sequence (the ASCII characters that must be entered to generate + the Unicode character) + * a flag (or "-" if none) - Example: +Start additional character mapping sections with a line containign the word +"section". - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +Example: - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new input methods requires making additions to Tux - Paint's source code ("/src/im.c"), and requires updates to the Makefile, - to ensure the ".im" files are available for use at runtime. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - On-screen Keyboard +💡 Note: Support for new input methods requires making additions to Tux Paint's +source code ("/src/im.c"), and requires updates to the Makefile, to ensure the +".im" files are available for use at runtime. - As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an - on-screen keyboard that allows the pointer (via a mouse, eye-tracking - systems, etc.) to be used to input characters. Files that describe the - layout and available keys are stored in Tux Paint "osk" directory. Each - keyboard layout is defined by a number of files (some of which may be - shared by different layouts). +On-screen Keyboard - We'll use the QWERTY keyboard as an example: +As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an +on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, +etc.) to be used to input characters. Files that describe the layout and +available keys are stored in Tux Paint "osk" directory. Each keyboard layout is +defined by a number of files (some of which may be shared by different +layouts). + +We'll use the QWERTY keyboard as an example: Layout overview file ("qwerty.layout") - This is a text file that specifies the other files used to describe the - layout and key mappings. +This is a text file that specifies the other files used to describe the layout +and key mappings. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - The "keyboardlist" line describes which layouts to switch to, when the - user clicks the left and right buttons on the keyboard. (See below.) +The "keyboardlist" line describes which layouts to switch to, when the user +clicks the left and right buttons on the keyboard. (See below.) Keyboard layout file ("qwerty.h_layout") - This describes how big the keyboard is (as a "width × height" grid), and - lists each key with its numeric keycode (see the "keymap" file, below), - the width it should be drawn at (typically "1.0", to take one space on the - keyboard, but in the example below, notice the "TAB" and "SPACE" keys are - much wider), the character or text to display on the key, depending on - which modifier keys have been pressed (one each for: no modifiers, - [Shift], [AltGr], and [Shift] + [AltGr]), and finally whether or not the - key is affected by the [CapsLock] key (use "1") or [AltGr] (alternate - graphics) key (use "2"), or not at all (use "0"). +This describes how big the keyboard is (as a "width × height" grid), and lists +each key with its numeric keycode (see the "keymap" file, below), the width it +should be drawn at (typically "1.0", to take one space on the keyboard, but in +the example below, notice the "TAB" and "SPACE" keys are much wider), the +character or text to display on the key, depending on which modifier keys have +been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] + +[AltGr]), and finally whether or not the key is affected by the [CapsLock] key +(use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use +"0"). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # Arrow to left will change to the previous keyboard - KEY 2 1.0 <- <- <- <- 0 + # Arrow to left will change to the previous keyboard + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # The ALT or ALTGR keys are used in im to switch the input mode - KEY 64 2.0 Alt Alt Alt Alt 0 + # The ALT or ALTGR keys are used in im to switch the input mode + KEY 64 2.0 Alt Alt Alt Alt 0 - # Space - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Space + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # Arrow to right will change to the next keyboard - KEY 1 1.0 -> -> -> -> 0 + # Arrow to right will change to the next keyboard + KEY 1 1.0 -> -> -> -> 0 - Notice here that alphabetic keys ([Q], [W], etc.) will be affected by - [CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will - not. +Notice here that alphabetic keys ([Q], [W], etc.) will be affected by +[CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will not. - Keycodes up to "8" are reserved for internal use. The ones currently used - are described below. +Keycodes up to "8" are reserved for internal use. The ones currently used are +described below. - * 0 — empty button - * 1 — next layout (per the layout file's "keyboardlist" setting) - * 2 — previous layout (per the layout file's "keyboardlist" setting) + * 0 — empty button + * 1 — next layout (per the layout file's "keyboardlist" setting) + * 2 — previous layout (per the layout file's "keyboardlist" setting) Keymap file ("us-intl-altgr-dead-keys.keymap") - This file defines which numeric keycodes (seen in the keyboard layout - files, such as "qwerty.h_layout" described above) should be mapped to - which actual characters that an application such as Tux Paint expects to - receive when keys (e.g., on a real keyboard) are pressed. +This file defines which numeric keycodes (seen in the keyboard layout files, +such as "qwerty.h_layout" described above) should be mapped to which actual +characters that an application such as Tux Paint expects to receive when keys +(e.g., on a real keyboard) are pressed. - If you're using an operating system such as Linux, which runs X-Window and - has the "xmodmap" command-line tool available, you can run it with the - ("print keymap expressions" option, "-pke", to generate a keymap file. +If you're using an operating system such as Linux, which runs X-Window and has +the "xmodmap" command-line tool available, you can run it with the ("print +keymap expressions" option, "-pke", to generate a keymap file. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Composemap file ("en_US.UTF-8_Compose") - This file describes single characters that can be composed by multiple - inputs. For example, "[Compose]" followed by "[A]" and "[E]" can be used - to create the "æ" character. +This file describes single characters that can be composed by multiple inputs. +For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the +"æ" character. - The file that comes with Tux Paint is based on the US English UTF-8 - (Unicode) composemap that comes with X.Org's X Window system. The current - version from the Xlib library has a web located page at - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +The file that comes with Tux Paint is based on the US English UTF-8 (Unicode) +composemap that comes with X.Org's X Window system. The current version from +the Xlib library has a web located page at https://www.x.org/releases/current/ +doc/libX11/i18n/compose/en_US.UTF-8.html. Keysym definitions file ("keysymdef.h") - This file (which is a C programming language header file) is also from the - X Window System. It defines the Unicode values of each keycap (e.g., - "XK_equal" corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). +This file (which is a C programming language header file) is also from the X +Window System. It defines the Unicode values of each keycap (e.g., "XK_equal" +corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - It is unlikely that any modification will be required of this file. +It is unlikely that any modification will be required of this file. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/en/FAQ.txt b/docs/en/FAQ.txt index 05599ff46..a864cf83e 100644 --- a/docs/en/FAQ.txt +++ b/docs/en/FAQ.txt @@ -6,610 +6,612 @@ July 13, 2023 - ---------------------------------------------------------------------- - - +------------------------------+ - |Table of Contents | - |------------------------------| - | * Drawing-related | - | * Interface Problems | - | * Printing | - | * Saving | - | * Audio Problems | - | * Fullscreen Mode Problems | - | * Other Problems | - | * Help / Contact | - +------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++------------------------------+ +| Table of Contents | +|------------------------------| +| * Drawing-related | +| * Interface Problems | +| * Printing | +| * Saving | +| * Audio Problems | +| * Fullscreen Mode Problems | +| * Other Problems | +| * Help / Contact | ++------------------------------+ +------------------------------------------------------------------------------- Drawing-related - Fonts I added to Tux Paint only show squares - The TrueType Font you're using might have the wrong encoding. If - it's 'custom' encoded, for example, you can try running it through - FontForge (http://fontforge.sourceforge.net/) to convert it to an - ISO-8859 format. (Email us if you need help with special fonts.) +Fonts I added to Tux Paint only show squares + The TrueType Font you're using might have the wrong encoding. If it's + 'custom' encoded, for example, you can try running it through FontForge ( + http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format. + (Email us if you need help with special fonts.) - The Rubber Stamp tool is greyed out! +The Rubber Stamp tool is greyed out! - This means that Tux Paint either couldn't find any stamp images, - or was asked not to load them. + This means that Tux Paint either couldn't find any stamp images, or was + asked not to load them. - If you installed Tux Paint, but did not install the separate, - optional "Stamps" collection, quit Tux Paint and install it now. - It should be available from the same place you got the main Tux - Paint program. (Note: As of version 0.9.14, Tux Paint comes with a - small collection of example stamps.) + If you installed Tux Paint, but did not install the separate, optional + "Stamps" collection, quit Tux Paint and install it now. It should be + available from the same place you got the main Tux Paint program. (Note: As + of version 0.9.14, Tux Paint comes with a small collection of example + stamps.) - If you don't want to install the default collection of stamps, you - can just create your own. See the "Extending Tux Paint" - documentation for more on creating PNG and SVG image files, TXT - text description files, Ogg Vorbis, MP3 or WAV sound files, and - DAT text data files that make up stamps. + If you don't want to install the default collection of stamps, you can just + create your own. See the "Extending Tux Paint" documentation for more on + creating PNG and SVG image files, TXT text description files, Ogg Vorbis, + MP3 or WAV sound files, and DAT text data files that make up stamps. - 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.) + 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. + 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 - Tux Paint was built with low-quality (but faster) stamp outlines. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: +Stamp outlines are always rectangles - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint was built with low-quality (but faster) stamp outlines. - in the "tuxpaint.c" file in the "src" directory. + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + in the "tuxpaint.c" file in the "src" directory. + + + + +------------------------------------------------------------------------------- Interface Problems - Stamp thumbnails in the Stamp Selector look bad +Stamp thumbnails in the Stamp Selector look bad - Tux Paint was probably compiled with the faster, lower quality - thumbnail code enabled. Run the command: "tuxpaint - --verbose-version" from a command line. If, amongst the other - output, you see the text: "Low Quality Thumbnails enabled", then - this is what's happening. + Tux Paint was probably compiled with the faster, lower quality thumbnail + code enabled. Run the command: "tuxpaint --verbose-version" from a command + line. If, amongst the other output, you see the text: "Low Quality + Thumbnails enabled", then this is what's happening. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - #define LOW_QUALITY_THUMBNAILS + #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 - "Low Quality Thumbnails" is probably enabled. See: "Stamp - thumbnails in the Stamp Selector look bad", above. - All of the text is in uppercase! - The "uppercase" option is on. +Pictures in the 'Open' dialog look bad + "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the + Stamp Selector look bad", above. - Either change/remove the "uppercase" option, or you can override - it with "--mixedcase" on the command line or either "uppercase=no" - or "mixedcase=yes" in a configuration file. +All of the text is in uppercase! - Tux Paint is in a different language - Make sure your locale setting is correct. See "Tux Paint won't - switch to my language", below. + The "uppercase" option is on. - Tux Paint won't switch to my language - * Linux and Unix users: Make sure the locale is available + Either change/remove the "uppercase" option, or you can override it with + "--mixedcase" on the command line or either "uppercase=no" or "mixedcase= + yes" in a configuration file. - Make sure the locale you want is available. Check your - "/etc/locale.gen" file. See the "Options Documentation" for - the locales Tux Paint uses (especially when using the - "--lang" option). +Tux Paint is in a different language + Make sure your locale setting is correct. See "Tux Paint won't switch to my + language", below. - Note: Debian and derivative (e.g., Ubuntu) users can simply - run "dpkg-reconfigure locales" if the locales are managed by - "dpkg". +Tux Paint won't switch to my language + + Linux and Unix users: Make sure the locale is available - * If you're using the "--lang" command-line option + Make sure the locale you want is available. Check your "/etc/ + locale.gen" file. See the "Options Documentation" for the locales Tux + Paint uses (especially when using the "--lang" option). - Try using the "--locale" command-line option, or your - operating system's locale settings (e.g., the "$LANG" - environment variable), and please e-mail us regarding your - trouble. + Note: Debian and derivative (e.g., Ubuntu) users can simply run + "dpkg-reconfigure locales" if the locales are managed by "dpkg". - * If you're using the "--locale" command-line option + + If you're using the "--lang" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + Try using the "--locale" command-line option, or your operating + system's locale settings (e.g., the "$LANG" environment variable), and + please e-mail us regarding your trouble. - * If you're trying to use your Operating System's locale + + If you're using the "--locale" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + If this doesn't work, please e-mail us regarding your trouble. - * Make sure you have the necessary font + + If you're trying to use your Operating System's locale - Some translations require their own font. Chinese and Korean, - for example, need Chinese and Korean TrueType Fonts installed - and placed in the proper location, respectively. + If this doesn't work, please e-mail us regarding your trouble. - The appropriate fonts for such locales can be downloaded from - the Tux Paint website: + + Make sure you have the necessary font - https://tuxpaint.org/download/fonts/ + Some translations require their own font. Chinese and Korean, for + example, need Chinese and Korean TrueType Fonts installed and placed in + the proper location, respectively. - ---------------------------------------------------------------------- + The appropriate fonts for such locales can be downloaded from the Tux + Paint website: + + https://tuxpaint.org/download/fonts/ + + + + +------------------------------------------------------------------------------- Printing - Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) +Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) - Tux Paint prints by creating a PostScript rendition of the picture - and sending it to an external command. By default, this command is - the "lpr" printing tool. + Tux Paint prints by creating a PostScript rendition of the picture and + sending it to an external command. By default, this command is the "lpr" + printing tool. - If that program is not available (for example, you're using CUPS, - the Common Unix Printing System, and do not have "cups-lpr" - installed), you will need to specify an appropriate command using - the "printcommand" option in Tux Paint's configuration file. (See - the "Options Documentation".) + If that program is not available (for example, you're using CUPS, the + Common Unix Printing System, and do not have "cups-lpr" installed), you + will need to specify an appropriate command using the "printcommand" option + in Tux Paint's configuration file. (See the "Options Documentation".) - 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. + 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. + 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 - The "print delay" option is on. You can only print once every X - seconds. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--printdelay=..." option. +I get the message "You can't print yet!" when I go to print - 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 - command-line argument. + The "print delay" option is on. You can only print once every X seconds. - If a "--printdelay=..." option isn't being sent on the command - line, check Tux Paint's configuration file for a line reading: - "printdelay=...". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--printdelay=..." option. - Either remove that line, set the delay value to 0 (no delay), or - decrease the delay to a value you prefer. (See the "Options - Documentation".) + 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 + command-line argument. - Or, you can simply run Tux Paint with the command-line argument: - "--printdelay=0", which will override the configuration file's - setting, and allow unlimited printing. (You won't have to wait - between prints.) + If a "--printdelay=..." option isn't being sent on the command line, check + Tux Paint's configuration file for a line reading: "printdelay=...". - I simply can't print! The button is greyed out! + Either remove that line, set the delay value to 0 (no delay), or decrease + the delay to a value you prefer. (See the "Options Documentation".) - The "no print" option is on. + Or, you can simply run Tux Paint with the command-line argument: + "--printdelay=0", which will override the configuration file's setting, and + allow unlimited printing. (You won't have to wait between prints.) - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noprint" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--noprint" is listed as a - command-line argument. - If a "--noprint" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "noprint=yes". +I simply can't print! The button is greyed out! - Either remove that line, or simply run Tux Paint with the - command-line argument: "--print", which will override the - configuration file's setting. + The "no print" option is on. - Or use Tux Paint Config. and make sure "Allow Printing" (under - "Printing") is checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noprint" option. - ---------------------------------------------------------------------- + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--noprint" is listed as a command-line + argument. + + If a "--noprint" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noprint=yes". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--print", which will override the configuration file's setting. + + Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing") + is checked. + + + + +------------------------------------------------------------------------------- Saving - Where does Tux Paint save my drawings? +Where does Tux Paint save my drawings? - Unless you asked Tux Paint to save into a specific location (using - the "savedir" option), Tux Paint saves into a standard location on - your local drive: + Unless you asked Tux Paint to save into a specific location (using the + "savedir" option), Tux Paint saves into a standard location on your local + drive: - Windows Vista, Windows 8, Windows 10, Windows 11 - In the user's "AppData" folder: - e.g., - C:\Users\Username\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + In the user's "AppData" folder: + e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved - macOS - In the user's "Application Support" folder: - e.g., /Users/Username/Library/Applicaton - Support/TuxPaint/saved/ + macOS + In the user's "Application Support" folder: + e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - In the user's home directory ("$HOME"), under a - ".tuxpaint" subfolder: - e.g., /home/username/.tuxpaint/saved/ + Linux / Unix + In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder: + e.g., /home/username/.tuxpaint/saved/ - The images are stored as PNG bitmaps, which most modern programs - should be able to load (image editors, word processors, web - browsers, etc.) - Tux Paint always saves over my old picture + The images are stored as PNG bitmaps, which most modern programs should be + able to load (image editors, word processors, web browsers, etc.) - The "save over" option is enabled. (This disables the prompt that - would appear when you click 'Save.') - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveover" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--saveover" is listed as a - command-line argument. +Tux Paint always saves over my old picture - If a "--saveover" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=yes". + The "save over" option is enabled. (This disables the prompt that would + appear when you click 'Save.') - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveover" option. - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + 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 command-line + argument. - Also, see "Tux Paint always saves a new picture!", below. + If a "--saveover" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=yes". - Tux Paint always saves a new picture! + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. - The "never save over" option is enabled. (This disables the prompt - that would appear when you click 'Save.') + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveovernew" option. + Also, see "Tux Paint always saves a new picture!", below. - 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 - command-line argument. - If a "--saveovernew" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=new". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. +Tux Paint always saves a new picture! - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + The "never save over" option is enabled. (This disables the prompt that + would appear when you click 'Save.') - Also, see "Tux Paint always saves over my old picture!", above. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveovernew" option. - ---------------------------------------------------------------------- + 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 + command-line argument. + + If a "--saveovernew" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=new". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. + + Also, see "Tux Paint always saves over my old picture!", above. + + + + +------------------------------------------------------------------------------- Audio Problems - There's no sound! - * First, check the obvious: - * Are your speakers connected and turned on? - * Is the volume turned up on your speakers? - * Is the volume turned up in your Operating System's - "mixer?" - * Are you certain you're using a computer with a sound - card? - * Are any other programs running that use sound? (They may - be 'blocking' Tux Paint from accessing your sound - device) - * (Unix/Linux) Are you using a sound system, such as aRts, - ESD or GStreamer? If so, try setting the - "SDL_AUDIODRIVER" environment variable before running - Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run - 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? +There's no sound! + + First, check the obvious: + o Are your speakers connected and turned on? + o Is the volume turned up on your speakers? + o Is the volume turned up in your Operating System's "mixer?" + o Are you certain you're using a computer with a sound card? + o Are any other programs running that use sound? (They may be + 'blocking' Tux Paint from accessing your sound device) + o (Unix/Linux) Are you using a sound system, such as aRts, ESD or + GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment + variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER= + arts"). Or, run 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 - program is "blocking" the sound device), then Tux Paint may - be running with a "no sound" option. + If sound seems to work otherwise (and you're sure no other program is + "blocking" the sound device), then Tux Paint may be running with a "no + sound" option. - If you're running Tux Paint from a command-line, make sure - you're not giving it a "--nosound" option. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--nosound" option. - If you're running Tux Paint by double-clicking an icon, check - the properties of the icon to see if "--nosound" is listed as - a command-line argument. + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--nosound" is listed as a + command-line argument. - If a "--nosound" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "nosound=yes". + If a "--nosound" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "nosound=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--sound", which will override the - configuration file's setting. + Either remove that line, or simply run Tux Paint with the command-line + argument: "--sound", which will override the configuration file's + setting. - Or, you can simply run Tux Paint with the command-line - argument: "Enable Sound Effects", which will override the - configuration file's setting, and allow unlimited printing. - (You won't have to wait between prints.) + Or, you can simply run Tux Paint with the command-line argument: + "Enable Sound Effects", which will override the configuration file's + setting, and allow unlimited printing. (You won't have to wait between + prints.) - * Were sounds temporarily disabled? + + Were sounds temporarily disabled? - Even if sounds are enabled in Tux Paint, it is possible to - disable and re-enable them temporarily using the [Alt] + [S] - key sequence. Try pressing those keys to see if sounds begin - working again. + Even if sounds are enabled in Tux Paint, it is possible to disable and + re-enable them temporarily using the [Alt] + [S] key sequence. Try + pressing those keys to see if sounds begin 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. - To test whether sound support was enabled when Tux Paint was - compiled, run Tux Paint from a command line, like so: + Tux Paint may have been compiled with sound support disabled. To test + whether sound support was enabled when Tux Paint was compiled, run Tux + Paint from a command line, like so: - tuxpaint --verbose-version + tuxpaint --verbose-version - If, amongst the other information, you see "Sound disabled", - then the version of Tux Paint you're running has sound - disabled. Recompile Tux Paint, and be sure NOT to build the - "nosound" target. (i.e., don't run "make nosound") Be sure - the SDL_mixer library and its development headers are - available! + If, amongst the other information, you see "Sound disabled", then the + version of Tux Paint you're running has sound disabled. Recompile Tux + Paint, and be sure NOT to build the "nosound" target. (i.e., don't run + "make nosound") Be sure the SDL_mixer library and its development + headers are available! - Tux Paint makes too much noise! Can I turn them off? - Yes, there are a number of ways to disable sounds in Tux Paint: - * Press [Alt] + [S] while in Tux Paint to temporarily disable - sounds. (Press that key sequence again to re-enable sounds.) - * Run Tux Paint with the "no sound" option: - * Run "tuxpaint --nosound" from the command line or - shortcut or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nosound=yes". - * Or use Tux Paint Config. and make sure "Enable Sound - Effects" (under "Video & Sound") is not checked. - * Alternatively, recompile Tux Paint with sound support - disabled. (See above, and the 'Install' documentation. +Tux Paint makes too much noise! Can I turn them off? - The stereo panning of sound effects is bothersome; can sound effects be - monophonic? + Yes, there are a number of ways to disable sounds in Tux Paint: - Run Tux Paint with the "no stereo" option: + + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds. + (Press that key sequence again to re-enable sounds.) + + Run Tux Paint with the "no sound" option: + o Run "tuxpaint --nosound" from the command line or shortcut or + desktop icon. + o Edit Tux Paint's configuration file (see "Options Documentation" + for details) and add a line containing "nosound=yes". + o Or use Tux Paint Config. and make sure "Enable Sound Effects" + (under "Video & Sound") is not checked. + o Alternatively, recompile Tux Paint with sound support disabled. + (See above, and the 'Install' documentation. - * Run "tuxpaint --nostereo" from the command line or shortcut - or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nostereo=yes". - * Or use Tux Paint Config. and make sure "Enable Stereo - Effects" (under "Video & Sound") is not checked. - The sound effects sound strange +The stereo panning of sound effects is bothersome; can sound effects be + monophonic? - This could have to do with how SDL and SDL_mixer were initialized. - (The buffer size chosen.) + Run Tux Paint with the "no stereo" option: - Please e-mail us with details about your computer system. - (Operating system and version, sound card, which version of Tux - Paint you're running (run "tuxpaint --version" to verify), and so - on.) + + Run "tuxpaint --nostereo" from the command line or shortcut or desktop + icon. + + Edit Tux Paint's configuration file (see "Options Documentation" for + details) and add a line containing "nostereo=yes". + + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under + "Video & Sound") is not checked. - ---------------------------------------------------------------------- + +The sound effects sound strange + + This could have to do with how SDL and SDL_mixer were initialized. (The + buffer size chosen.) + + Please e-mail us with details about your computer system. (Operating system + and version, sound card, which version of Tux Paint you're running (run + "tuxpaint --version" to verify), and so on.) + + + + +------------------------------------------------------------------------------- Fullscreen Mode Problems - When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns - black! - This is apparently a bug in the SDL library. Sorry. +When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black! + This is apparently a bug in the SDL library. Sorry. - When I run Tux Paint full-screen, it has large borders around it +When I run Tux Paint full-screen, it has large borders around it - Linux users - Your X-Window server is probably not set with the - ability to switch to the desired resolution: 800×600. (or whatever - resolution you have Tux Paint set to run at.) (This is typically - done manually under the X-Window server by pressing [Control] + - [Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus - (-)].) + Linux users - Your X-Window server is probably not set with the ability to + switch to the desired resolution: 800×600. (or whatever resolution you have + Tux Paint set to run at.) (This is typically done manually under the + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and + [Control] + [Alt] + [Keypad Minus (-)].) - For this to work, your monitor must support that resolution, and - you need to have it listed in your X server configuration. + For this to work, your monitor must support that resolution, and you need + to have it listed in your X server configuration. - Check the "Display" subsection of the "Screen" section of your - XFree86 or X.org configuration file (typically - "/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the - version of XFree86 you're using; 3.x or 4.x, respectively, or - "/etc/X11/xorg.conf" for X.org). + Check the "Display" subsection of the "Screen" section of your XFree86 or + X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/ + XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x, + respectively, or "/etc/X11/xorg.conf" for X.org). - Add "800x600" (or whatever resolution(s) you want) to the - appropriate "Modes" line. (e.g., in the "Display" subsection that - contains 24-bit color depth ("Depth 24"), which is what Tux Paint - tries to use.) + Add "800x600" (or whatever resolution(s) you want) to the appropriate + "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color + depth ("Depth 24"), which is what Tux Paint tries to use.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Note that some Linux distributions have tools that can make these - changes for you. Debian users can run the command - "dpkg-reconfigure xserver-xfree86" as root, for example. + Note that some Linux distributions have tools that can make these changes + for you. Debian users can run the command "dpkg-reconfigure + xserver-xfree86" as root, for example. - Tux Paint keeps running in Full Screen mode - I want it windowed! - The "fullscreen" option is set. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--fullscreen" option. +Tux Paint keeps running in Full Screen mode - I want it windowed! - 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 - command-line argument. + The "fullscreen" option is set. - If a "--fullscreen" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "fullscreen=yes". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--fullscreen" option. - Either remove that line, or simply run Tux Paint with the - command-line argument: "--windowed", which will override the - configuration file's setting. + 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 command-line + argument. - Or use Tux Paint Config. and make sure "Fullscreen" (under "Video - & Sound") is not checked. + If a "--fullscreen" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "fullscreen=yes". - ---------------------------------------------------------------------- + Either remove that line, or simply run Tux Paint with the command-line + argument: "--windowed", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound") + is not checked. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint won't run +Tux Paint won't run - If Tux Paint aborts with the message: "You're already running a - copy of Tux Paint!", this means it has been launched in the last - 30 seconds. (On Unix/Linux, this message would appear in a - terminal console if you ran Tux Paint from a command-line. On - Windows, this message would appear in a file named "stdout.txt" in - the same folder where TuxPaint.exe resides (e.g., in "C:\Program - Files\TuxPaint"). + If Tux Paint aborts with the message: "You're already running a copy of Tux + Paint!", this means it has been launched in the last 30 seconds. (On Unix/ + Linux, this message would appear in a terminal console if you ran Tux Paint + from a command-line. On Windows, this message would appear in a file named + "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\ + Program Files\TuxPaint"). - A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, - "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint - isn't run too many times at once (e.g., due to a child impatiently - clicking its icon more than once). + A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\ + lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many + times at once (e.g., due to a child impatiently clicking its icon more than + once). - Even if the lockfile exists, it contains the 'time' Tux Paint was - last run. If it's been more than 30 seconds, Tux Paint should run - fine, and simply update the lockfile with the current time. + Even if the lockfile exists, it contains the 'time' Tux Paint was last run. + If it's been more than 30 seconds, Tux Paint should run fine, and simply + 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. + 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. + To disable the lockfile, add the "--nolockfile" argument to Tux Paint's + command-line, or "nolockfile=yes" to the configuration file. - I can't quit Tux Paint - The "no quit" option is set. This disables the "Quit" button in - Tux Paint's toolbar (greying it out), and prevents Tux Paint from - being exited via the [Escape] key. - If Tux Paint is not in fullscreen mode, simply click the window - close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper - right.) +I can't 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. + The "no quit" option is set. This disables the "Quit" button in Tux Paint's + toolbar (greying it out), and prevents Tux Paint from being exited via the + [Escape] key. - (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 not in fullscreen mode, simply click the window close + button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.) - I don't want "no quit" mode enabled! + If Tux Paint is in fullscreen mode, you will need to use the [Shift] + + [Control] + [Escape] sequence on the keyboard to quit Tux Paint. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noquit" option. + (Note: with or without "no quit" set, you can always use the [Alt] + [F4] + combination on your keyboard to quit Tux Paint.) - 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 - command-line argument. - If a "--noquit" option isn't being sent on the command line, check - Tux Paint's configuration file for a line reading: "noquit=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--quit", which will override the - configuration file's setting. +I don't want "no quit" mode enabled! - Or use Tux Paint Config. and make sure "Disable Quit Button and - [Escape] Key" (under "Simplification") is not checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noquit" option. - Tux Paint keeps writing weird messages to the screen / to a text file + 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 command-line + argument. - A few messages are normal, but if Tux Paint is being extremely - verbose (like listing the name of every rubber-stamp image it - finds while loading them), then it was probably compiled with - debugging output turned on. + If a "--noquit" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noquit=yes". - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + Either remove that line, or simply run Tux Paint with the command-line + argument: "--quit", which will override the configuration file's setting. - #define DEBUG + Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape] + Key" (under "Simplification") is not checked. - in the "tuxpaint.c" file in the "src" directory. - Tux Paint is using options I didn't specify! - By default, Tux Paint first looks at configuration files for - options. +Tux Paint keeps writing weird messages to the screen / to a text file - * Windows + A few messages are normal, but if Tux Paint is being extremely verbose + (like listing the name of every rubber-stamp image it finds while loading + them), then it was probably compiled with debugging output turned on. - Under Windows, Tux Paint first examines the configuration - file: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - tuxpaint.cfg + #define DEBUG - Finally, any options sent as command-line arguments are used. + in the "tuxpaint.c" file in the "src" directory. - * macOS - * Unix and Linux - Under Unix and Linux, it first examines the system-wide - configuration file, located here: +Tux Paint is using options I didn't specify! - /etc/tuxpaint/tuxpaint.conf + By default, Tux Paint first looks at configuration files for options. - It then examines the user's personal configuration file: + + Windows - ~/.tuxpaintrc + Under Windows, Tux Paint first examines the configuration file: - Finally, any options sent as command-line arguments are used. + tuxpaint.cfg - * Haiku + Finally, any options sent as command-line arguments are used. - This means that if anything is set in a configuration file that - you don't want set, you'll need to either change the config. file - (if you can), or override the option on the command-line. + + macOS - For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" - includes this option to disable sound... + + Unix and Linux - nosound=yes + Under Unix and Linux, it first examines the system-wide configuration + file, located here: - ...then you can reenable sound by either adding this option to - your own ".tuxpaintrc" file: + /etc/tuxpaint/tuxpaint.conf - sound=yes + It then examines the user's personal configuration file: - ...or by using this command-line argument: + ~/.tuxpaintrc - --sound + Finally, any options sent as command-line arguments are used. - Linux and Unix users can also disable the system-wide - configuration file by including the following command-line - argument: + + Haiku - --nosysconfig + This means that if anything is set in a configuration file that you don't + want set, you'll need to either change the config. file (if you can), or + override the option on the command-line. - Tux Paint will then only look at "~/.tuxpaintrc" and command-line - arguments to determine what options should be set. + For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes + this option to disable sound... - ---------------------------------------------------------------------- + nosound=yes + + ...then you can reenable sound by either adding this option to your own + ".tuxpaintrc" file: + + sound=yes + + ...or by using this command-line argument: + + --sound + + Linux and Unix users can also disable the system-wide configuration file by + including the following command-line argument: + + --nosysconfig + + Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments + to determine what options should be set. + + + + +------------------------------------------------------------------------------- Help / Contact - Any questions you don't see answered? Please let us know! You can - subscribe and post to our "tuxpaint-users" mailing list: +Any questions you don't see answered? Please let us know! You can subscribe and +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 diff --git a/docs/en/INSTALL.txt b/docs/en/INSTALL.txt index c7f90cf66..33b8ea2ad 100644 --- a/docs/en/INSTALL.txt +++ b/docs/en/INSTALL.txt @@ -1,936 +1,935 @@ Tux Paint - version 0.9.31 - Installation Documentation + version 0.9.31 + Installation Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - May 13, 2023 + May 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Requirements | - | * Simple DirectMedia Layer library (libSDL) | - | * Other Libraries | - | * Compiling and Installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Debugging | - | * Uninstalling Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +----------------------------------------------------+ ++---------------------------------------------------+ +| Table of Contents | +|---------------------------------------------------| +| * Requirements | +| + Simple DirectMedia Layer library (libSDL) | +| + Other Libraries | +| * Compiling and Installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Debugging | +| * Uninstalling Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++---------------------------------------------------+ - Requirements +Requirements Simple DirectMedia Layer library (libSDL) - Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open - Source multimedia programming library available under the GNU Lesser - General Public License (LGPL). +Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open +Source multimedia programming library available under the GNU Lesser General +Public License (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - The SDL libraries are available as source-code, or as RPM or Debian - packages for various distributions of Linux. They can be downloaded from: +The SDL libraries are available as source-code, or as RPM or Debian packages +for various distributions of Linux. They can be downloaded from: - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) - They are also typically available along with your Linux distribution (e.g. - on an installation media, or available via package maintainance software - like Debian's "apt"). +They are also typically available along with your Linux distribution (e.g. on +an installation media, or available via package maintainance software like +Debian's "apt"). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Other Libraries +Other Libraries - Tux Paint also takes advantage of a number of other free, LGPL'd - libraries. Under Linux, just like SDL, they should either already be - installed, or are readily available for installation as part of your Linux - distribution. +Tux Paint also takes advantage of a number of other free, LGPL'd libraries. +Under Linux, just like SDL, they should either already be installed, or are +readily available for installation as part of your Linux distribution. - libPNG +libPNG - Tux Paint uses PNG (Portable Network Graphics) format for its data - files. SDL_image will require libPNG be installed. + Tux Paint uses PNG (Portable Network Graphics) format for its data files. + SDL_image will require libPNG be installed. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint uses your system's locale settings along with the - "gettext" library to support various languages (e.g., Spanish). - You'll need the gettext library installed. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Linux/Unix only) + Tux Paint uses your system's locale settings along with the "gettext" + library to support various languages (e.g., Spanish). You'll need the + gettext library installed. - As of Tux Paint 0.9.17, Tux Paint can determine your system's - default paper size (e.g., A4 or Letter), or can be told to use a - particular paper size, thanks to "libpaper". + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - Tux Paint's "Text" and also "Label" tools support bidirectional - languages, thanks to the "FriBiDi" library. +libpaper (Linux/Unix only) - http://fribidi.org/ + As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper + size (e.g., A4 or Letter), or can be told to use a particular paper size, + thanks to "libpaper". - SVG graphics support + https://github.com/naota/libpaper - As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector - Graphics) images as stamps. Two sets of libraries are supported, - and SVG support can be completely disabled (via "make SVG_LIB:=") - librsvg-2 & libCairo2 (newer libraries) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * These also depend on the following: - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Older SVG libraries - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * These also depend on the following: - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Animated GIF Export feature + Tux Paint's "Text" and also "Label" tools support bidirectional languages, + thanks to the "FriBiDi" library. - To support export of animated GIFs (slideshows), the - "libimagequant" library (from the "pngquant2" project) is - required. + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - NetPBM Tools (optional) No longer used, by default - 📜 Under Linux and Unix, earlier versions of Tux Paint used the - NetPBM tools to assist with printing. (A PNG is generated by Tux - Paint, and converted into a PostScript using the 'pngtopnm' and - 'pnmtops' NetPBM command-line tools.) +SVG graphics support - http://netpbm.sourceforge.net/ + As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics) + images as stamps. Two sets of libraries are supported, and SVG support can + be completely disabled (via "make SVG_LIB:=") - Compiling and Installation + librsvg-2 & libCairo2 (newer libraries) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o These also depend on the following: + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint is released under the GNU General Public License (GPL) (see - "COPYING.txt" for details), and therefore the 'source code' to the program - is available freely. - ------------------------------------------------------------------ + Older SVG libraries + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o These also depend on the following: + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Animated GIF Export feature + + To support export of animated GIFs (slideshows), the "libimagequant" + library (from the "pngquant2" project) is required. + + https://github.com/ImageOptim/libimagequant + + + +NetPBM Tools (optional) No longer used, by default + + 📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools + to assist with printing. (A PNG is generated by Tux Paint, and converted + into a PostScript using the 'pngtopnm' and 'pnmtops' NetPBM command-line + tools.) + + http://netpbm.sourceforge.net/ + + + + +Compiling and Installation + +Tux Paint is released under the GNU General Public License (GPL) (see +"COPYING.txt" for details), and therefore the 'source code' to the program is +available freely. + + ----------------------------------------------------------------------- Windows - July 10, 2022 Shin-ichi TOYAMA +July 10, 2022 Shin-ichi TOYAMA - Compiling Set-Up +Compiling Set-Up - As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" - includes support for building on a Windows system using MinGW/MSYS - (https://sourceforge.net/projects/msys2/). +As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes +support for building on a Windows system using MinGW/MSYS (https:// +sourceforge.net/projects/msys2/). - Many tools and libraries are required to build Tux Paint. The package - management system "pacman" helps you install them automatically solving - complicated dependencies. +Many tools and libraries are required to build Tux Paint. The package +management system "pacman" helps you install them automatically solving +complicated dependencies. - MYSYS2 +MYSYS2 - Download the latest MSYS2 environment from https://www.msys2.org/ and - install it where you'd like (the default is "C:\msys64") +Download the latest MSYS2 environment from https://www.msys2.org/ and install +it where you'd like (the default is "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Within the MSYS2 shell, run the following command to install basic - development tools: +Within the MSYS2 shell, run the following command to install basic development +tools: - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to - the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build - environment. +Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to the " +MinGW 32bit (i686) toolchains" section if you need only a 32bit build +environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Within the MSYS2 shell, run the following command to install 64bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 64bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to - the "ImageMagick" section if you need only a 64bit build environment. +Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to the " +ImageMagick" section if you need only a 64bit build environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Within the MSYS2 shell, run the following command to install 32bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 32bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick is a compilation of command line tools to create, edit, - compose, or convert bitmap images supporting quite a large number of image - formats. Tux Paint uses two functions ("convert" and "composite") in it to - generate thumbnails for startar images and templates during the build - process. +ImageMagick is a compilation of command line tools to create, edit, compose, or +convert bitmap images supporting quite a large number of image formats. Tux +Paint uses two functions ("convert" and "composite") in it to generate +thumbnails for startar images and templates during the build process. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - Do not forget to enable "Install legacy utilities (e.g. convert)" while - installing it, because Tux Paint's build process uses them. +Do not forget to enable "Install legacy utilities (e.g. convert)" while +installing it, because Tux Paint's build process uses them. - Add the path to the directory in which ImageMagick is installed at the top - of your "PATH" environment variable. For example: +Add the path to the directory in which ImageMagick is installed at the top of +your "PATH" environment variable. For example: - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - You can make this permanent by adding the above to your the BASH shell - configuration file, "~/.bash_profile". +You can make this permanent by adding the above to your the BASH shell +configuration file, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - All the files needed for starting Tux Paint (and Tux Paint Config.) are - collected in the directory for binary distribution "bdist" directory under - "win32". You can start them by double-clicking their executable (.exe) - files in the "bdist" directory. +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup is used to build executable installer for Tux Paint. Therefore - you have to install it in the first place. +All the files needed for starting Tux Paint (and Tux Paint Config.) are +collected in the directory for binary distribution "bdist" directory under +"win32". You can start them by double-clicking their executable (.exe) files in +the "bdist" directory. - Inno Setup officially supports translations for only about 20 languages. - However, one of the great points of Tux Paint is it supports so many - languages. Therefore, the set up script "tuxpaint.iss" to build the - installer is written to use much more translations including unofficial - one which are available on "Inno Setup Translations". You have to download - translation files (.isl) required and put them in "Languages" directory - under the directory in which Inno Setup is installed. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup is used to build executable installer for Tux Paint. Therefore you +have to install it in the first place. - Then, you can easily build an executable installer by right-clicking on - the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" - on the list. It will run for a while, and eventually you will find a - "tuxpaint-X.Y.Z-windows--installer.exe" file in the same directory. +Inno Setup officially supports translations for only about 20 languages. +However, one of the great points of Tux Paint is it supports so many languages. +Therefore, the set up script "tuxpaint.iss" to build the installer is written +to use much more translations including unofficial one which are available on " +Inno Setup Translations". You have to download translation files (.isl) +required and put them in "Languages" directory under the directory in which +Inno Setup is installed. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Double-click the Tux Paint installer executable (.EXE file) and follow the - instructions. +Then, you can easily build an executable installer by right-clicking on the +"tuxpaint.iss" icon in the "win32" directory and selecting "Compile" on the +list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z +-windows--installer.exe" file in the same directory. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - You will then be asked whether you want to install shortcuts to Tux Paint - in your Windows Start Menu and on your Windows Desktop. (Both options are - set by default.) +Double-click the Tux Paint installer executable (.EXE file) and follow the +instructions. - Then you will be asked where you wish to install Tux Paint. The default - should be suitable, as long as there is space available. Otherwise, pick a - different location. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - At this point, you can click 'Install' to install Tux Paint! +You will then be asked whether you want to install shortcuts to Tux Paint in +your Windows Start Menu and on your Windows Desktop. (Both options are set by +default.) - Changing the Settings Using the Shortcut +Then you will be asked where you wish to install Tux Paint. The default should +be suitable, as long as there is space available. Otherwise, pick a different +location. - To change program settings, right-click on the TuxPaint shortcut and - select 'Properties' (at the bottom). +At this point, you can click 'Install' to install Tux Paint! - Make sure the 'Shortcut' tab is selected in the window that appears, and - examine the 'Target:' field. You should see something like this: +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +To change program settings, right-click on the TuxPaint shortcut and select +'Properties' (at the bottom). - You can now add command-line options which will be enabled when you - double-click the icon. +Make sure the 'Shortcut' tab is selected in the window that appears, and +examine the 'Target:' field. You should see something like this: - For example, to make the game run in fullscreen mode, with simple shapes - (no rotation option) and in French, add the options (after - 'TuxPaint.exe'), like so: + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +You can now add command-line options which will be enabled when you +double-click the icon. - (See the main documentation for a full list of available command-line - options.) +For example, to make the game run in fullscreen mode, with simple shapes (no +rotation option) and in French, add the options (after 'TuxPaint.exe'), like +so: - If you make a mistake or it all disappears use [Control] + [Z] to undo or - just hit the [Esc] key and the box will close with no changes made (unless - you pushed the "Apply" button!). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - When you have finished, click "OK." +(See the main documentation for a full list of available command-line options.) - If Something Goes Wrong +If you make a mistake or it all disappears use [Control] + [Z] to undo or just +hit the [Esc] key and the box will close with no changes made (unless you +pushed the "Apply" button!). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +When you have finished, click "OK." - It will contain a description of what was wrong. Usually it will just be - due to incorrect character-case (capital 'Z' instead of lowercase 'z') or - a missing (or extra) '-' (dash). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +It will contain a description of what was wrong. Usually it will just be due to +incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing +(or extra) '-' (dash). + + ----------------------------------------------------------------------- Linux/Unix - Compiling: +Compiling: - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - To compile the program from source, simply run the following command from - a shell prompt (e.g., "$"): +To compile the program from source, simply run the following command from a +shell prompt (e.g., "$"): - $ make + $ make - Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): +Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): - To disable SVG support (e.g., if your system is not currently supported by - the Cairo library or other SVG-related dependencies), you can run "make" - with "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: +To disable SVG support (e.g., if your system is not currently supported by the +Cairo library or other SVG-related dependencies), you can run "make" with +"SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - If you don't have a sound card, or would prefer to build the program with - no sound support (and therefore without a the SDL_mixer dependency), you - can run "make" with "SDL_MIXER_LIB=" added: +If you don't have a sound card, or would prefer to build the program with no +sound support (and therefore without a the SDL_mixer dependency), you can run +"make" with "SDL_MIXER_LIB=" added: - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Various other options (e.g., installation paths) may be overridden; see - them in "Makefile" for further details. +Various other options (e.g., installation paths) may be overridden; see them in +"Makefile" for further details. - If you get errors +If you get errors - If you receive any errors during compile-time, make sure you have the - appropriate libraries installed (see above). If using packaged versions of - the libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to - get the corresponding "-dev" or "-devel" packages as well, otherwise you - won't be able to compile Tux Paint (and other programs) from source! +If you receive any errors during compile-time, make sure you have the +appropriate libraries installed (see above). If using packaged versions of the +libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the +corresponding "-dev" or "-devel" packages as well, otherwise you won't be able +to compile Tux Paint (and other programs) from source! - Installng +Installng - Assuming no fatal errors occured, you can now install the program so that - it can be run by users on the system. By default, this must be done by the - "root" user ('superuser'). Switch to "root" by typing the command: +Assuming no fatal errors occured, you can now install the program so that it +can be run by users on the system. By default, this must be done by the "root" +user ('superuser'). Switch to "root" by typing the command: - $ su + $ su - Enter "root"'s password at the prompt. You should now be "root" (with a - prompt like "#"). To install the program and its data files, type: +Enter "root"'s password at the prompt. You should now be "root" (with a prompt +like "#"). To install the program and its data files, type: - # make install + # make install - Finally, you can switch back to your regular user by exiting superuser - mode: +Finally, you can switch back to your regular user by exiting superuser mode: - # exit + # exit - Alternatively, you may be able to simply use the "sudo" command (e.g., on - Ubuntu Linux): +Alternatively, you may be able to simply use the "sudo" command (e.g., on +Ubuntu Linux): - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Changing Where Things Go +Changing Where Things Go - You can change where things will go by setting "Makefile"variables on the - command line. "DESTDIR" is used to place output in a staging area for - package creation. "PREFIX" is the basis of where all other files go, and - is, by default, set to "/usr/local". +You can change where things will go by setting "Makefile"variables on the +command line. "DESTDIR" is used to place output in a staging area for package +creation. "PREFIX" is the basis of where all other files go, and is, by +default, set to "/usr/local". - Other variables are: +Other variables are: - BIN_PREFIX - Where the "tuxpaint" binary will be installed. (Set to - "$(PREFIX)/bin" by default - e.g., "/usr/local/bin") +BIN_PREFIX + Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by + default - e.g., "/usr/local/bin") - DATA_PREFIX - Where the data files (sound, graphics, brushes, stamps, fonts) - will go, and where Tux Paint will look for them when it's run. - (Set to "$(PREFIX)/share/tuxpaint") +DATA_PREFIX + Where the data files (sound, graphics, brushes, stamps, fonts) will go, and + where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/ + tuxpaint") - DOC_PREFIX - Where the documentation text files (the "docs" directory) will go. - (Set to "$(PREFIX)/share/doc/tuxpaint") +DOC_PREFIX + Where the documentation text files (the "docs" directory) will go. (Set to + "$(PREFIX)/share/doc/tuxpaint") - MAN_PREFIX - Where the manual page for Tux Paint will go. (Set to - "$(PREFIX)/share/man") +MAN_PREFIX + Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man") - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Where the icons and launchers (for GNOME and KDE) will go. - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Where the translation files for Tux Paint will go, and where Tux Paint will + look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a + translation file will be under the locale's directory (e.g., "es" for + Spanish), within the "LC_MESSAGES" subdirectory.) - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Where the icons and launchers (for GNOME and KDE) will go. +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Where the translation files for Tux Paint will go, and where Tux - Paint will look for them. (Set to "$(PREFIX)/share/locale/") - (Final location of a translation file will be under the locale's - directory (e.g., "es" for Spanish), within the "LC_MESSAGES" - subdirectory.) - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - June 5, 2022 Mark Kim +June 5, 2022 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prerequisites +Prerequisites - Although Tux Paint is built without the Xcode IDE, Xcode itself is still - required to build Tux Paint. Download it from the App Store, and launch it - once to accept its license agreements. You may also need to install the - Xcode command line tools using the command: +Although Tux Paint is built without the Xcode IDE, Xcode itself is still +required to build Tux Paint. Download it from the App Store, and launch it once +to accept its license agreements. You may also need to install the Xcode +command line tools using the command: - $ xcode-select --install + $ xcode-select --install - Building Tux Paint also requires various libraries. We install them from - MacPorts where possible, source code otherwise. Install MacPorts to the - default /opt/local path according to the instructions found on their - website: https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... but you should install any package that is required by the latest - version of Tux Paint. +Building Tux Paint also requires various libraries. We install them from +MacPorts where possible, source code otherwise. Install MacPorts to the default +/opt/local path according to the instructions found on their website: https:// +www.macports.org/ - ^* Not available from MacPorts as of this writing, see below. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... but you should install any package that is required by the latest version +of Tux Paint. - libimagequant is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. +^* Not available from MacPorts as of this writing, see below. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - WARNING: Having any UNIX-like toolset installed on your Mac besides - MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle - from being portable. Be sure Fink and Brew are not accessible from your - build environment. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - How to Build + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Simply, run: +WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts +and Xcode, such as Fink or Brew, will prevent your app bundle from being +portable. Be sure Fink and Brew are not accessible from your build environment. - % make - % make install +How to Build - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Simply, run: - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Known Issues +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * A macOS binary built on a specific version of macOS only runs on that - version of macOS or later. To ensure Tux Paint can run on the oldest - version of macOS possible, build it on the oldest version of macOS - available. As of this writing we know Tux Paint cannot be built to run - on macOS 10.7 or earlier. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - See "Old Versions of macOS" below for best-effort instructions on how - to obtain, install, and build Tux Paint on an old version of macOS. +Known Issues - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * A macOS binary built on a specific version of macOS only runs on that + version of macOS or later. To ensure Tux Paint can run on the oldest + version of macOS possible, build it on the oldest version of macOS + available. As of this writing we know Tux Paint cannot be built to run on + macOS 10.7 or earlier. - Old Versions of macOS + See "Old Versions of macOS" below for best-effort instructions on how to + obtain, install, and build Tux Paint on an old version of macOS. - Some old versions of macOS can be downloaded from Apple's support page: - https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Old Versions of macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Some old versions of macOS can be downloaded from Apple's support page: https:/ +/support.apple.com/en-us/HT211683 - As of this writing, the oldest version of macOS available on Apple's - support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" - partitioning scheme instead of the older MBR scheme, and "Mac OS Extended - (Journaled)" as the partition type instead of the newer APFS partition - type. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Upon launching the installer, if you get a popup about macOS being too old - or new to be installed, a bootable installer can be created using the - instructions found here: https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Once the old macOS is installed, you may find the Xcode on the App Store - is too new to run on the version of the old macOS. Old versions of Xcode - can be downloaded from Apple's Developer site in an area accessible with - free registration: https://developer.apple.com/download/more/ +As of this writing, the oldest version of macOS available on Apple's support +site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning +scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as +the partition type instead of the newer APFS partition type. - The list of macOS versions and the last version of Xcode compatible with - them are laid out nicely on the Wikipedia page on Xcode: - https://en.wikipedia.org/wiki/Xcode#Version_comparison_table +Upon launching the installer, if you get a popup about macOS being too old or +new to be installed, a bootable installer can be created using the instructions +found here: https://support.apple.com/en-mide/HT201372 - And because Xcode is being installed manually, you can skip the step to - install the Xcode command line tools (do not run "xcode-select --install") - but otherwise build Tux Paint using the same steps described in the - earlier part of this document. +Once the old macOS is installed, you may find the Xcode on the App Store is too +new to run on the version of the old macOS. Old versions of Xcode can be +downloaded from Apple's Developer site in an area accessible with free +registration: https://developer.apple.com/download/more/ - Recompiling MacPorts +The list of macOS versions and the last version of Xcode compatible with them +are laid out nicely on the Wikipedia page on Xcode: https://en.wikipedia.org/ +wiki/Xcode#Version_comparison_table - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +And because Xcode is being installed manually, you can skip the step to install +the Xcode command line tools (do not run "xcode-select --install") but +otherwise build Tux Paint using the same steps described in the earlier part of +this document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - March 29, 2023 Pere Pujal i Carabantes (Edited by - Bill Kendrick) +March 29, 2023 Pere Pujal i Carabantes (Edited by Bill +Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prerequisites +Prerequisites - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - May 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) +May 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) - Prerequisites +Prerequisites - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Debugging +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file - on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled - by setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines - in "src/debug.h" and (re)compiling Tux Paint. +Debugging - Uninstalling Tux Paint +⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file on +Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled by +setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src +/debug.h" and (re)compiling Tux Paint. + +Uninstalling Tux Paint Windows - Using the Uninstaller +Using the Uninstaller - If you installed the Start Menu shortcuts (the default), then go to the - TuxPaint folder and select "Uninstall". A box will be displayed that will - confirm that you are about to uninstall Tux Paint and, if you are certain - that you want to permanently remove Tux Paint, click on the 'Uninstall' - button. +If you installed the Start Menu shortcuts (the default), then go to the +TuxPaint folder and select "Uninstall". A box will be displayed that will +confirm that you are about to uninstall Tux Paint and, if you are certain that +you want to permanently remove Tux Paint, click on the 'Uninstall' button. - When it has finished, click on the close button. +When it has finished, click on the close button. - Using the Control Panel +Using the Control Panel - It is also possible to use the entry "TuxPaint (remove only)" in the - Control Panel Add/Remove programs section. +It is also possible to use the entry "TuxPaint (remove only)" in the Control +Panel Add/Remove programs section. macOS - Delete "TuxPaint.app" from the "Applications" folder. Data files, - including the configuration files, stamps, and saved pictures, may be - found in "/Library/Application Support/TuxPaint" (all users) and - "/Users/USERNAME/Library/Application Support/TuxPaint" (individual users). +Delete "TuxPaint.app" from the "Applications" folder. Data files, including the +configuration files, stamps, and saved pictures, may be found in "/Library/ +Application Support/TuxPaint" (all users) and "/Users/USERNAME/Library/ +Application Support/TuxPaint" (individual users). Linux - Within the Tux Paint source directory (where you compiled Tux Paint), you - can use the "make uninstall" target to uninstall Tux Paint. By default, - this must be done by the "root" user ('superuser'), but if you installed - Tux Paint somewhere else (e.g., using a "PREFIX=..." setting to "make" and - "make install"), you may not, and will want to provide those same settings - here. (See the installation instructions above for further information.) +Within the Tux Paint source directory (where you compiled Tux Paint), you can +use the "make uninstall" target to uninstall Tux Paint. By default, this must +be done by the "root" user ('superuser'), but if you installed Tux Paint +somewhere else (e.g., using a "PREFIX=..." setting to "make" and "make +install"), you may not, and will want to provide those same settings here. (See +the installation instructions above for further information.) + diff --git a/docs/en/MAGIC-API.txt b/docs/en/MAGIC-API.txt index d30fd3df3..88cc85673 100644 --- a/docs/en/MAGIC-API.txt +++ b/docs/en/MAGIC-API.txt @@ -1,1273 +1,1279 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Magic Tool Plugin API Documentation + Magic Tool Plugin API Documentation Copyright © 2007-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - April 13, 2023 + April 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Prequisites | - | * Interfaces | - | * 'Magic' tool plugin functions | - | * Common arguments to plugin functions | - | * Required Plugin Functions | - | * Plugin "housekeeping" functions | - | * Plugin event functions | - | * Tux Paint Functions and Data | - | * Pixel Manipulations | - | * Helper Functions | - | * Informational | - | * Tux Paint System Calls | - | * Color Conversions | - | * Helper Macros in "tp_magic_api.h" | - | * Constant Definitions in "tp_magic_api.h" | - | * Compiling | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Installing | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Creating plugins with multiple effects | - | * Example Code | - | * Getting Help | - | * Glossary | - +----------------------------------------------------+ ++--------------------------------------------------+ +| Table of Contents | +|--------------------------------------------------| +| * Prequisites | +| * Interfaces | +| + 'Magic' tool plugin functions | +| o Common arguments to plugin functions | +| o Required Plugin Functions | +| # Plugin "housekeeping" functions | +| # Plugin event functions | +| + Tux Paint Functions and Data | +| o Pixel Manipulations | +| o Helper Functions | +| o Informational | +| o Tux Paint System Calls | +| o Color Conversions | +| + Helper Macros in "tp_magic_api.h" | +| + Constant Definitions in "tp_magic_api.h" | +| * Compiling | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Installing | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Creating plugins with multiple effects | +| * Example Code | +| * Getting Help | +| * Glossary | ++--------------------------------------------------+ - Overview +Overview - Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted - from routines that lived within the application itself, to a set of - 'plugins' that are loaded when Tux Paint starts up. +Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted from +routines that lived within the application itself, to a set of 'plugins' that +are loaded when Tux Paint starts up. - This division allows more rapid development of 'Magic' tools, and allows - programmers to create and test new tools without needing to integrate them - within the main Tux Paint source code. (Users of more professional - graphics tools, such as GIMP, should be familiar with this plugin - concept.) +This division allows more rapid development of 'Magic' tools, and allows +programmers to create and test new tools without needing to integrate them +within the main Tux Paint source code. (Users of more professional graphics +tools, such as GIMP, should be familiar with this plugin concept.) - Prerequisites +Prerequisites - Tux Paint is written in the C programming language, and uses the Simple - DirectMedia Layer library ('libSDL', or simply 'SDL'; available from - https://www.libsdl.org/). Therefore, for the moment at least, one must - understand the C language and how to compile C-based programs. Familiarity - with the SDL API is highly recommended, but some basic SDL concepts will - be covered in this document. +Tux Paint is written in the C programming language, and uses the Simple +DirectMedia Layer library ('libSDL', or simply 'SDL'; available from https:// +www.libsdl.org/). Therefore, for the moment at least, one must understand the C +language and how to compile C-based programs. Familiarity with the SDL API is +highly recommended, but some basic SDL concepts will be covered in this +document. - Interfaces +Interfaces - Those who create 'Magic' tool plugins for Tux Paint must provide some - interfaces (C functions) that Tux Paint may invoke. +Those who create 'Magic' tool plugins for Tux Paint must provide some +interfaces (C functions) that Tux Paint may invoke. - Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" - routines to load plugins (shared objects files; e.g., ".so" files on Linux - or ".dll" files on Windows) and find the functions within. +Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" routines +to load plugins (shared objects files; e.g., ".so" files on Linux or ".dll" +files on Windows) and find the functions within. - In turn, Tux Paint provides a number of helper functions that the plugin - may (or sometimes is required to) use. This is exposed as a C structure - (or "struct") which contains pointers to functions and other data inside - Tux Paint. A pointer to this structure gets passed along to the plugin's - functions as an argument when Tux Paint invokes them. +In turn, Tux Paint provides a number of helper functions that the plugin may +(or sometimes is required to) use. This is exposed as a C structure (or +"struct") which contains pointers to functions and other data inside Tux Paint. +A pointer to this structure gets passed along to the plugin's functions as an +argument when Tux Paint invokes them. - Plugins should #include the C header file "tp_magic_api.h", which exposes - the 'Magic' tool plugin API. Also, when you run the C compiler to build a - plugin, you should use the command-line tool "tp-magic-config" to get the - appropriate compiler flags (such as where the compiler can find the Tux - Paint plugin header file, as well as SDL's header files) for building a - plugin. (See "Compiling", below.) +Plugins should #include the C header file "tp_magic_api.h", which exposes the +'Magic' tool plugin API. Also, when you run the C compiler to build a plugin, +you should use the command-line tool "tp-magic-config" to get the appropriate +compiler flags (such as where the compiler can find the Tux Paint plugin header +file, as well as SDL's header files) for building a plugin. (See "Compiling", +below.) - The C header file and command-line tool mentioned above are included with - Tux Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package". +The C header file and command-line tool mentioned above are included with Tux +Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin +Development package". 'Magic' tool plugin functions - 'Magic' tool plugins must contain the functions listed below. Note: To - avoid 'namespace' collisions, each function's name must start with the - shared object's filename (e.g., "blur.so" or "blur.dll" would have - functions whose names begin with "blur_"). This includes private functions - (ones not used by Tux Paint directly), unless you declare those as - 'static'. - - Common arguments to plugin functions - - Here is a description of arguments that many of your plugin's functions - will need to accept. - - magic_api * api - - Pointer to a C structure containing pointers to Tux Paint - functions and other data that the plugin can (and sometimes - should) use. The contents of this struct are described below. - - Note: The magic_api struct is defined in the C header file - "tp_magic_api.h", which you should include at the top of your - plugin's C source file: - - #include "tp_magic_api.h" - - int which - An index the plugin should use to differentiate different 'Magic' - tools, if the plugin provides more than one. (If not, "which" will - always be 0.) See "Creating plugins with multiple effects", below. +'Magic' tool plugins must contain the functions listed below. Note: To avoid +'namespace' collisions, each function's name must start with the shared +object's filename (e.g., "blur.so" or "blur.dll" would have functions whose +names begin with "blur_"). This includes private functions (ones not used by +Tux Paint directly), unless you declare those as 'static'. - SDL_Surface * snapshot - A snapshot of the previous Tux Paint canvas, taken when the the - mouse was first clicked to activate the current magic tool. If you - don't continuously affect the image during one hold of the mouse - button, you should base your effects off the contents of this - canvas. (That is, read from "snapshot" and write to "canvas", - below.) - - SDL_Surface * canvas - The current Tux Paint drawing canvas. Your magical effects should - end up here! - - SDL_Rect * update_rect - A pointer to an SDL 'rectangle' structure that you use to tell Tux - Paint what part of the canvas has been updated. If your effect - affects a 32x32 area centered around the mouse pointer, you would - fill the SDL_Rect as follows: - - update_rect->x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Informational + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Informational - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Getting Help +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Getting Help - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Glossary +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Glossary + + * alpha: See "RGBA" + * &: See "ampersand" + * ampersand (pointers): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * ampersand (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bit" + * API: Application Programming Interface. TBD + * argument: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * backtick: See "grave" + * bit: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "byte" + * blue: See "RGBA" + * boolean 'or': A mathematical operation that results in a true value if + either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 + | 0" results in "0".) + * |: See "boolean 'or'" + * .: See "dot" + * `: See "grave" + * *: See "star" + * byte: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * callback: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * channel: TBD + * click: The action of pressing a button on a mouse. + * coordinates: A set of numbers corresponding to a physical position; for + example, in a two-dimensional (2D) image, "X" and "Y" coordinates specify + the position across (left-to-right) and down the image, respectively. In + SDL, the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * dimensions: The size of an object, in terms of its width (left to right) + and height (top to bottom). + * .dll: See "Shared Object" + * dot: ".". A symbol in C that references an element within a struct. + * drag: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "floating point" + * floating point: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * green: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * header: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * hue: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * linear: TBD + * macro: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Plugin: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * prototype: See "C function prototype" + * red: See "RGBA" + * release: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "ampersand" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * unsigned: In C, a variable that can store a numeric value can be declared + as either "signed" (the default), or "unsigned". In the former case, one + bit of the value is used to denote the sign of the value (either positive + or negative). In the latter case, the value can only be positive, but + benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * value: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Dimensions" + * (x,y): See "Coordinates" - * alpha: See "RGBA" - * &: See "ampersand" - * ampersand (pointers): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * ampersand (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bit" - * API: Application Programming Interface. TBD - * argument: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * backtick: See "grave" - * bit: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "byte" - * blue: See "RGBA" - * boolean 'or': A mathematical operation that results in a true value if - either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in - "1". "0 | 0" results in "0".) - * |: See "boolean 'or'" - * .: See "dot" - * `: See "grave" - * *: See "star" - * byte: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * callback: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * channel: TBD - * click: The action of pressing a button on a mouse. - * coordinates: A set of numbers corresponding to a physical position; - for example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * dimensions: The size of an object, in terms of its width (left to - right) and height (top to bottom). - * .dll: See "Shared Object" - * dot: ".". A symbol in C that references an element within a struct. - * drag: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "floating point" - * floating point: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * green: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * header: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * hue: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * linear: TBD - * macro: A C construct that looks similar to a C function, but is simply - a #define that is expanded 'inline'. For example, if you declared the - macro "#define ADD(A,B) ((A)+(B))", and then used it with "c = - ADD(1,2);", that line of code would literally expand to "c = ((1) + - (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Plugin: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * prototype: See "C function prototype" - * red: See "RGBA" - * release: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "ampersand" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * unsigned: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * value: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Dimensions" - * (x,y): See "Coordinates" diff --git a/docs/en/OPTIONS.txt b/docs/en/OPTIONS.txt index 15b0c0eeb..4713c87b9 100644 --- a/docs/en/OPTIONS.txt +++ b/docs/en/OPTIONS.txt @@ -1,2011 +1,2183 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Options Documentation + Options Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ July 13, 2023 - +---------------------------------------------+ - |Table of Contents | - |---------------------------------------------| - | * Tux Paint Config. | - | * Configuration File | - | * Available Options | - | * Video/Sound | - | * Mouse/Keyboard | - | * Simplification | - | * Languages | - | * Printing | - | * Saving | - | * Data | - | * Accessibility | - | * Joystick | - | * Overriding System Config. Options | - | * Command-Line Options | - | * Command-Line Informational Options | - | * Choosing a Different Language | - | * Available Languages | - | * Setting Your Environment's Locale | - | * Special Fonts | - +---------------------------------------------+ ++--------------------------------------------+ +| Table of Contents | +|--------------------------------------------| +| * Tux Paint Config. | +| * Configuration File | +| * Available Options | +| + Video/Sound | +| + Mouse/Keyboard | +| + Simplification | +| + Languages | +| + Printing | +| + Saving | +| + Data | +| + Accessibility | +| + Joystick | +| * Overriding System Config. Options | +| * Command-Line Options | +| + Command-Line Informational Options | +| * Choosing a Different Language | +| + Available Languages | +| + Setting Your Environment's Locale | +| + Special Fonts | ++--------------------------------------------+ - Tux Paint Config. +Tux Paint Config. - A graphical tool is available that allows you to change Tux Paint's - behavior. However, if you'd rather not install and use this tool, or want - a better understanding of the available options, please continue reading. +A graphical tool is available that allows you to change Tux Paint's behavior. +However, if you'd rather not install and use this tool, or want a better +understanding of the available options, please continue reading. - Configuration File +Configuration File - You can create a simple configuration file for Tux Paint, which it will - read each time you start it up. +You can create a simple configuration file for Tux Paint, which it will read +each time you start it up. - The file is simply a plain text file containing the options you want - enabled: +The file is simply a plain text file containing the options you want enabled: Linux and Unix Users - The file you should create is called ".tuxpaintrc" and it should be placed - in your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") +The file you should create is called ".tuxpaintrc" and it should be placed in +your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf macOS Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in your home folder, under the sub-folder: Library/Application - Support/TuxPaint +The file you should create is called "tuxpaint.cfg" and it should be placed in +your home folder, under the sub-folder: Library/Application Support/TuxPaint - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Windows Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in in your personal AppData folder: - C:\Users\username\AppData\Roaming\TuxPaint\ +The file you should create is called "tuxpaint.cfg" and it should be placed in +in your personal AppData folder: C:\Users\username\AppData\Roaming\TuxPaint\ - You can use NotePad or WordPad to create this file. Be sure to save it as - Plain Text, and make sure the filename doesn't have ".txt" at the end... +You can use NotePad or WordPad to create this file. Be sure to save it as Plain +Text, and make sure the filename doesn't have ".txt" at the end... - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ You can disable reading of this file altogether, leaving the settings as - defaults (which can then be overridden by your personal config. file - and/or command-line arguments) by using the command-line option - "--nosysconfig". +⚙ You can disable reading of this file altogether, leaving the settings as +defaults (which can then be overridden by your personal config. file and/or +command-line arguments) by using the command-line option "--nosysconfig". - Available Options +Available Options - The following settings can be set in the configuration file. (Command-line - settings will override these. See the "Command-Line Options" section, - below.) +The following settings can be set in the configuration file. (Command-line +settings will override these. See the "Command-Line Options" section, below.) Video/Sound - Video +Video - fullscreen=yes +fullscreen=yes - Run the program in full screen mode, rather than in a window. + Run the program in full screen mode, rather than in a window. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "fullscreen=no". - In both cases, may be overridden by the command-line option - "--windowed". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "fullscreen=no". In both cases, may be + overridden by the command-line option "--windowed". - fullscreen=native - Run the program in full screen mode. Additionally, assume the - screen's current resolution (set by the operating system). - windowsize=SIZE +fullscreen=native - Run the program at a different size (in windowed mode) or at a - different screen resolution (in fullscreen mode), rather than the - default (usually 800x600). + Run the program in full screen mode. Additionally, assume the screen's + current resolution (set by the operating system). - The SIZE value should be presented in pixels, in 'width-by-height' - format, with an "x" (lowercase X) between the values. The size can - be anything that's at least 640 wide, and at least 480 tall. - Some examples: - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=SIZE - 💡 If only one display is available, and Tux Paint is being run in - windowed (not fullscreen) mode, and the chosen window size exceeds - the capabilities of the display, Tux Paint will fall back to the - display's dimensions. + Run the program at a different size (in windowed mode) or at a different + screen resolution (in fullscreen mode), rather than the default (usually + 800x600). - orient=portrait + The SIZE value should be presented in pixels, in 'width-by-height' format, + with an "x" (lowercase X) between the values. The size can be anything + that's at least 640 wide, and at least 480 tall. - Swaps the width/height options given to Tux Paint, useful for - rotating the window on portait displays, such as a tablet PC - that's in tablet orientation. + Some examples: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 If only one display is available, and Tux Paint is being run in windowed + (not fullscreen) mode, and the chosen window size exceeds the capabilities + of the display, Tux Paint will fall back to the display's dimensions. - When running Tux Paint in fullscreen mode, this assumes the - screen's current resolution (overriding any "windowsize" option), - as set by the operating system. - allowscreensaver=yes - By default, Tux Paint prevents your system's screensaver from - starting up. You can override this by using the "allowscreensaver" - option. Note: This requires version 1.2.12 or higher of the SDL - library. (You can also do this by setting the - "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your system - to "1".) +orient=portrait - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both cases, - may be overridden by the command-line option - "--disablescreensaver". + Swaps the width/height options given to Tux Paint, useful for rotating the + window on portait displays, such as a tablet PC that's in tablet + orientation. - Sound + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "orient=landscape". In both cases, may + be overridden by the command-line option "--orient=landscape". - nosound=yes - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used - to reenable sounds if they were disabled using this option.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" or - "sound=yes". In both cases, may be overridden by the command-line - option "--sound". +native=yes - nostereo=yes + When running Tux Paint in fullscreen mode, this assumes the screen's + current resolution (overriding any "windowsize" option), as set by the + operating system. - Disable stereo panning support. (Useful for users with hearing - impairment in one ear, or places where a single speaker or - headphone is being used.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" or - "stereo=yes". In both cases, may be overridden by the command-line - option "--stereo". - Interface Size +allowscreensaver=yes - buttonsize=SIZE + By default, Tux Paint prevents your system's screensaver from starting up. + You can override this by using the "allowscreensaver" option. Note: This + requires version 1.2.12 or higher of the SDL library. (You can also do this + by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your + system to "1".) - Set the pixel size of buttons in Tux Paint's user interface - (overriding the default of "48"). Useful when using very - high-density displays or coarse input devices, such as eye gaze - trackers. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "allowscreensaver=no" or + "disablescreensaver=yes". In both cases, may be overridden by the + command-line option "--disablescreensaver". - The SIZE value should be presented in pixels, and can be anything - between 24 and 192, inclusive. Most buttons are square, and this - will affect their width and height. - A value of "auto" may be provided, and Tux Paint will choose a - suitable button size based on the size of Tux Paint's window (or - fullscreen display). (For the default screen size of 800x600, it - will be the default button size: "48".) - 💡 Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux Paint's - chosen window size, the largest possible button size will be used. - (A note will appear in stderr.) - colorsrows=ROWS +Sound + +nosound=yes + + Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to + reenable sounds if they were disabled using this option.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nosound=no" or "sound=yes". In both + cases, may be overridden by the command-line option "--sound". + + + +nostereo=yes + + Disable stereo panning support. (Useful for users with hearing impairment + in one ear, or places where a single speaker or headphone is being used.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostereo=no" or "stereo=yes". In both + cases, may be overridden by the command-line option "--stereo". + + + + +Interface Size + +buttonsize=SIZE + + Set the pixel size of buttons in Tux Paint's user interface (overriding the + default of "48"). Useful when using very high-density displays or coarse + input devices, such as eye gaze trackers. + + The SIZE value should be presented in pixels, and can be anything between + 24 and 192, inclusive. Most buttons are square, and this will affect their + width and height. + + A value of "auto" may be provided, and Tux Paint will choose a suitable + button size based on the size of Tux Paint's window (or fullscreen + display). (For the default screen size of 800x600, it will be the default + button size: "48".) + + 💡 Note: If the chosen button size would cause the buttons to be too large + for all required UI elements to appear under Tux Paint's chosen window + size, the largest possible button size will be used. (A note will appear in + stderr.) + + + +colorsrows=ROWS + + How many rows of color palette buttons to show; useful when using a large + color palette (see "colorfile", above), and/or for use with coarse input + devices (like eyegaze trackers). "ROWS" may be between "1" (the default) + and "3". + + - How many rows of color palette buttons to show; useful when using - a large color palette (see "colorfile", above), and/or for use - with coarse input devices (like eyegaze trackers). "ROWS" may be - between "1" (the default) and "3". Mouse/Keyboard - Cursor +Cursor - nofancycursors=yes +nofancycursors=yes - This disables the fancy mouse pointer shapes in Tux Paint, and - uses your environment's normal mouse pointer. + This disables the fancy mouse pointer shapes in Tux Paint, and uses your + environment's normal mouse pointer. - In some enviornments, the fancy cursors cause problems. Use this - option to avoid them. + In some enviornments, the fancy cursors cause problems. Use this option to + avoid them. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nofancycursors=no" or "fancycursors= + yes". In both cases, may be overridden by the command-line option + "--fancycursors". - hidecursor=yes - This completely hides the mouse pointer shapes in Tux Paint. - This is useful for touchscreen devices, such as tablet PCs. +hidecursor=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "hidecursor=no" - or "showcursor=yes". In both cases, may be overridden by the - command-line option "--showcursor". + This completely hides the mouse pointer shapes in Tux Paint. - Keyboard + This is useful for touchscreen devices, such as tablet PCs. - noshortcuts=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "hidecursor=no" or "showcursor=yes". In + both cases, may be overridden by the command-line option "--showcursor". - This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, - [Ctrl]-[N] for a new image, etc.) - This is useful to prevent unwanted commands from being activated - by children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noshortcuts=no" - or "shortcuts=yes". In both cases, may be overridden by the - command-line option "--shortcuts". - Mouse +Keyboard - grab=yes +noshortcuts=yes - Tux Paint will attempt to 'grab' the mouse and keyboard, so that - the mouse is confined to Tux Paint's window, and nearly all - keyboard input is passed directly to it. + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for + a new image, etc.) - This is useful to disable operating system actions that could get - the user out of Tux Paint [Alt]-[Tab] window cycling, - [Ctrl]-[Escape], etc. This is especially useful in fullscreen - mode. + This is useful to prevent unwanted commands from being activated by + children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In + both cases, may be overridden by the command-line option "--shortcuts". - nowheelmouse=yes - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the right.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". - nobuttondistinction=yes +Mouse + +grab=yes + + Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse + is confined to Tux Paint's window, and nearly all keyboard input is passed + directly to it. + + This is useful to disable operating system actions that could get the user + out of Tux Paint [Alt]-[Tab] window cycling, [Ctrl]-[Escape], etc. This is + especially useful in fullscreen mode. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "grab=no" or "dontgrab=yes". In both + cases, may be overridden by the command-line option "--dontgrab". + + + +nowheelmouse=yes + + This disables support for the wheel on mice that have it. (Normally, the + wheel will scroll the selector menu on the right.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". + In both cases, may be overridden by the command-line option "--wheelmouse". + + + +nobuttondistinction=yes + + Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could + also be used for clicking. In version 0.9.15, it was changed so that only + the left mouse button worked, so as to not train children to use the wrong + button. + + However, for children who have trouble with the mouse, this distinction + between the two or three buttons on a mouse can be disabled (returning Tux + Paint to its old behavior) by using this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobuttondistinction=no" or + "buttondistinction=yes". In both cases, may be overridden by the + command-line option "--buttondistinction". - Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse - could also be used for clicking. In version 0.9.15, it was changed - so that only the left mouse button worked, so as to not train - children to use the wrong button. - However, for children who have trouble with the mouse, this - distinction between the two or three buttons on a mouse can be - disabled (returning Tux Paint to its old behavior) by using this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". Simplification - Interface Simplification +Interface Simplification - simpleshapes=yes +simpleshapes=yes - Disable the rotation step of the 'Shape' tool. Click, drag and - release is all that will be needed to draw a shape. + Disable the rotation step of the 'Shape' tool. Click, drag and release is + all that will be needed to draw a shape. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "simpleshapes=no" or "complexshapes= + yes". In both cases, may be overridden by the command-line option + "--complexshapes". - nooutlines=yes - In this mode, much simpler outlines and 'rubber-band' lines are - displayed when using the Lines, Shapes, Stamps and Eraser tools. - This can help when Tux Paint is run on very slow computers, or - displayed on a remote X-Window display. +nooutlines=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nooutlines=no" - or "outlines=yes". In both cases, may be overridden by the - command-line option "--outlines". + In this mode, much simpler outlines and 'rubber-band' lines are displayed + when using the Lines, Shapes, Stamps and Eraser tools. - uppercase=yes + This can help when Tux Paint is run on very slow computers, or displayed on + a remote X-Window display. - All text will be rendered only in uppercase (e.g., "Brush" will be - "BRUSH"). Useful for children who can read, but who have only - learned uppercase letters so far. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nooutlines=no" or "outlines=yes". In + both cases, may be overridden by the command-line option "--outlines". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". - Initial Stamp Size - stampsize=SIZE +uppercase=yes - Use this option to force Tux Paint to set the starting size of all - stamps. The SIZE value should be between 0 (smallest) and 10 - (largest). The size is relative to the available sizes of the - stamp, which depends on the stamp itself, and Tux Paint's current - canvas size. + All text will be rendered only in uppercase (e.g., "Brush" will be + "BRUSH"). Useful for children who can read, but who have only learned + uppercase letters so far. - Specify "default" to let Tux Paint decide (its standard behavior). + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "uppercase=no" or "mixedcase=yes". In + both cases, may be overridden by the command-line option "--mixedcase". - Control Simplification - noquit=yes - Disable the on-screen "Quit" button and prevent the [Escape] key - from quitting Tux Paint. - Using the [Alt] + [F4] keyboard combination or clicking the - window's close button (assuming you're not in fullscreen mode) - still works to quit Tux Paint. +Initial Stamp Size - You can also use the following keyboard combination to quit: - [Shift] + [Control] + [Escape]. +stampsize=SIZE - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Use this option to force Tux Paint to set the starting size of all stamps. + The SIZE value should be between 0 (smallest) and 10 (largest). The size is + relative to the available sizes of the stamp, which depends on the stamp + itself, and Tux Paint's current canvas size. - nostamps=yes + Specify "default" to let Tux Paint decide (its standard behavior). - This option tells Tux Paint to not load any rubber stamp images, - which in turn ends up disabling the Stamps tool. - This can speed up Tux Paint when it first loads up, and reduce - memory usage while it's running. Of course, no stamps will be - available at all. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" or - "stamps=yes". In both cases, may be overridden by the command-line - option "--stamps". - nostampcontrols=yes +Control Simplification - Some images in the Stamps tool can be mirrored, flipped, and/or - have their size changed. This option disables the controls, and - only provides the basic stamps. +noquit=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be - overridden by the command-line option "--stampcontrols". + Disable the on-screen "Quit" button and prevent the [Escape] key from + quitting Tux Paint. - nostamprotation=yes + Using the [Alt] + [F4] keyboard combination or clicking the window's close + button (assuming you're not in fullscreen mode) still works to quit Tux + Paint. - This disables the rotation step of the Stamps tool, immediately - placing the stamp in its regular orientation (with any flipping or - mirroring applied) on the first click. + You can also use the following keyboard combination to quit: [Shift] + + [Control] + [Escape]. - 📜 Note: The stamp rotation feature was added to Tux Paint in - version 0.9.29. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noquit=no" or "quit=yes". In both + cases, may be overridden by the command-line option "--quit". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostamprotation=no" or "stamprotation=yes". In both cases, may be - overridden by the command-line option "--stamprotation". - nomagiccontrols=yes - Some Magic tools have the option of acting like a paintbrush, or - affecting the entire canvas at once. This option disables the - controls, and only provides the default functionality (usually - paint-mode). +nostamps=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be - overridden by the command-line option "--magiccontrols". + This option tells Tux Paint to not load any rubber stamp images, which in + turn ends up disabling the Stamps tool. - nomagicsizes=yes + This can speed up Tux Paint when it first loads up, and reduce memory usage + while it's running. Of course, no stamps will be available at all. - Some Magic tools offer various size settings. This option disables - the sizing control, and only provides the tools' default sizes. - (Some plugins may offer additional variations of a Magic tool, to - make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamps=no" or "stamps=yes". In both + cases, may be overridden by the command-line option "--stamps". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagicsizes=no" or "magicsizes=yes". In both cases, may be - overridden by the command-line option "--magicsizes". - noshapecontrols=yes - Disable the control buttons shown when using the Shapes tool that - allow changing how shapes are drawn — centered around the initial - mouse click, or with a corner at the initial mouse click. +nostampcontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be - overridden by the command-line option "--shapecontrols". + Some images in the Stamps tool can be mirrored, flipped, and/or have their + size changed. This option disables the controls, and only provides the + basic stamps. - nolabel=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostampcontrols=no" or "stampcontrols= + yes". In both cases, may be overridden by the command-line option + "--stampcontrols". - Disables the Label tool: the tool that allows text entry which can - be edited later. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" or - "label=yes". In both cases, may be overridden by the command-line - option "--label". - nobrushspacing=yes +nostamprotation=yes - Disables the brush spacing option of the Paint and Lines tools. - The brushes' default spacings will be used. + This disables the rotation step of the Stamps tool, immediately placing the + stamp in its regular orientation (with any flipping or mirroring applied) + on the first click. - 📜 Note: The brush spacing option was added to Tux Paint's user - interface in version 0.9.28. For more information on brush - spacing, see EXTENDING.html + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobrushspacing=no" or "brushspacing=yes". In both cases, may be - overridden by the command-line option "--brushspacing". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamprotation=no" or "stamprotation= + yes". In both cases, may be overridden by the command-line option + "--stamprotation". - notemplateexport=yes - Disables the ability to create a new Template image (based on a - saved drawing) from within the Open dialog. - 📜 Note: The Template creation feature was added to Tux Paint in - version 0.9.31. +nomagiccontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "notemplateexport=no" or "templateexport=yes". In both cases, may - be overridden by the command-line option "--templateexport". + Some Magic tools have the option of acting like a paintbrush, or affecting + the entire canvas at once. This option disables the controls, and only + provides the default functionality (usually paint-mode). - noerase=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagiccontrols=no" or "magiccontrols= + yes". In both cases, may be overridden by the command-line option + "--magiccontrols". + + + +nomagicsizes=yes + + Some Magic tools offer various size settings. This option disables the + sizing control, and only provides the tools' default sizes. (Some plugins + may offer additional variations of a Magic tool, to make a few sizes + possible, e.g. "Bricks" and "Googly Eyes".) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagicsizes=no" or "magicsizes=yes". + In both cases, may be overridden by the command-line option "--magicsizes". + + + +noshapecontrols=yes + + Disable the control buttons shown when using the Shapes tool that allow + changing how shapes are drawn — centered around the initial mouse click, or + with a corner at the initial mouse click. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshapecontrols=no" or "shapecontrols= + yes". In both cases, may be overridden by the command-line option + "--shapecontrols". + + + +nolabel=yes + + Disables the Label tool: the tool that allows text entry which can be + edited later. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nolabel=no" or "label=yes". In both + cases, may be overridden by the command-line option "--label". + + + +nobrushspacing=yes + + Disables the brush spacing option of the Paint and Lines tools. The + brushes' default spacings will be used. + + 📜 Note: The brush spacing option was added to Tux Paint's user interface in + version 0.9.28. For more information on brush spacing, see EXTENDING.html + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobrushspacing=no" or "brushspacing= + yes". In both cases, may be overridden by the command-line option + "--brushspacing". + + + +notemplateexport=yes + + Disables the ability to create a new Template image (based on a saved + drawing) from within the Open dialog. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "notemplateexport=no" or + "templateexport=yes". In both cases, may be overridden by the command-line + option "--templateexport". + + + +noerase=yes + + Disables the ability to erase saved drawings via the "Erase" button on the + Open dialog, or exported Template images (based on a saved drawing) via the + "Erase" button on the New dialog. Useful to prevent users from erasing + work, especially combined with the --saveovernew option. + + 📜 Note: This option was added to Tux Paint in version 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noerase=no" or "erase=yes". In both + cases, may be overridden by the command-line option "--erase". - Disables the ability to erase saved drawings via the "Erase" - button on the Open dialog, or exported Template images (based on a - saved drawing) via the "Erase" button on the New dialog. Useful to - prevent users from erasing work, especially combined with the - --saveovernew option. - 📜 Note: This option was added to Tux Paint in version 0.9.31. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noerase=no" or - "erase=yes". In both cases, may be overridden by the command-line - option "--erase". Languages - Language +Language - lang=LANGUAGE +lang=LANGUAGE - Run Tux Paint in one of the supported languages. Possible choices - for LANGUAGE currently include: + Run Tux Paint in one of the supported languages. Possible choices for + LANGUAGE currently include: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale LOCALE - Run Tux Paint in one of the support languages. See the "Choosing a - Different Language" section below for the locale strings (e.g., - "de_DE" for German) to use. - (If your locale is already set, e.g. with the "$LANG" environment - variable, this option is not necessary, since Tux Paint honors - your environment's setting, if possible.) +--locale LOCALE - mirrorstamps=yes + Run Tux Paint in one of the support languages. See the "Choosing a + Different Language" section below for the locale strings (e.g., "de_DE" for + German) to use. - For stamps that can be mirrored, this option sets them to their - mirrored shape by default. + (If your locale is already set, e.g. with the "$LANG" environment variable, + this option is not necessary, since Tux Paint honors your environment's + setting, if possible.) - This can be useful for people who prefer things right-to-left, - rather than left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be - overridden by the command-line option "--dontmirrorstamps". - Fonts +mirrorstamps=yes - sysfonts=yes + For stamps that can be mirrored, this option sets them to their mirrored + shape by default. - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. + This can be useful for people who prefer things right-to-left, rather than + left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" or - "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps= + yes". In both cases, may be overridden by the command-line option + "--dontmirrorstamps". - alllocalefonts=yes - Prior to version 0.9.21, Tux Paint loaded all fonts in its own - fonts directory, including locale-specific ones (e.g., the one for - Tibetan, which had no latin characters). As of 0.9.21, the only - font loaded from the locale-specific subdirectory, if any, is one - matching the locale Tux Paint is running on. - To load all locale-specific fonts (the old behavior), set this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may - be overridden by the command-line option "--currentlocalefont". +Fonts + +sysfonts=yes + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In + both cases, may be overridden by the command-line option "--nosysfonts". + + + +alllocalefonts=yes + + Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts + directory, including locale-specific ones (e.g., the one for Tibetan, which + had no latin characters). As of 0.9.21, the only font loaded from the + locale-specific subdirectory, if any, is one matching the locale Tux Paint + is running on. + + To load all locale-specific fonts (the old behavior), set this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "alllocalefonts=no" or + "currentlocalefont=yes". In both cases, may be overridden by the + command-line option "--currentlocalefont". + + + +uifont=FONT NAME + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + Specify "default" to let Tux Paint use its default font, "DejaVu Sans" (its + standard behavior). - uifont=FONT NAME - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. - Specify "default" to let Tux Paint use its default font, "DejaVu - Sans" (its standard behavior). Printing - Print Permissions +Print Permissions - noprint=yes +noprint=yes - Disable the printing feature. + Disable the printing feature. - printdelay=SECONDS - Restrict printing so that printing can occur only once every - SECONDS seconds. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printdelay=0". - In both cases, may be overridden by the command-line option - "--printdelay=0". +printdelay=SECONDS - Show Printer Dialog + Restrict printing so that printing can occur only once every SECONDS + seconds. - altprint=always + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "printdelay=0". In both cases, may be + overridden by the command-line option "--printdelay=0". - This causes Tux Paint to always show the printer dialog (or, on - Linux/Unix, run the "altprintcommand") when the 'Print' button is - clicked. In other words, it's like clicking 'Print' while holding - [Alt], except you don't need to hold [Alt] every time. - altprint=never - This prevents Tux Paint from ever showing the printer dialog (or, - on Linux/Unix, run the "altprintcommand") when the 'Print' button - is clicked. In other words, it makes the [Alt] key have no effect - when clicking the 'Print' button. - altprint=mod +Show Printer Dialog - This is the normal, default behavior. Tux Paint shows a printer - dialog (or, on Linux/Unix, runs the "altprintcommand"), when the - [Alt] key is pressed while the 'Print' button is clicked. Clicking - 'Print' without holding [Alt] prints without showing a dialog. +altprint=always - Save Printer Configuration + This causes Tux Paint to always show the printer dialog (or, on Linux/Unix, + run the "altprintcommand") when the 'Print' button is clicked. In other + words, it's like clicking 'Print' while holding [Alt], except you don't + need to hold [Alt] every time. - printcfg=yes - (Windows and macOS only) - Tux Paint will use a printer configuration file when printing. - Push the [Alt] key while clicking the 'Print' button in Tux - Paint to cause a Windows print dialog window to appear. +altprint=never - Any configuration changes made in this dialog will be saved to - the file "userdata/print.cfg" , and used again, as long as the - "printcfg" option is set. + This prevents Tux Paint from ever showing the printer dialog (or, on Linux/ + Unix, run the "altprintcommand") when the 'Print' button is clicked. In + other words, it makes the [Alt] key have no effect when clicking the + 'Print' button. - 💡 Note: This only works when not running Tux Paint in fullscreen - mode. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". - Print Commands +altprint=mod - printcommand=COMMAND + This is the normal, default behavior. Tux Paint shows a printer dialog (or, + on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed + while the 'Print' button is clicked. Clicking 'Print' without holding [Alt] + prints without showing a dialog. - (Linux and Unix only) - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked. If this option is not - specifically not set, the default command is: - lpr - 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format - data to the print command (which defaulted to "pngtopnm | - pnmtops | lpr"). +Save Printer Configuration - If you set an alternative printcommand in the configuration file - prior to version 0.9.15, you will need to change it. + printcfg=yes - altprintcommand=COMMAND + (Windows and macOS only) - (Linux and Unix only) + Tux Paint will use a printer configuration file when printing. Push the + [Alt] key while clicking the 'Print' button in Tux Paint to cause a + Windows print dialog window to appear. - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked while the [Alt] modifier key is - being held. (This is typically used for providing a print - dialog, similar to when pressing [Alt]+'Print' in Windows and - macOS.) + Any configuration changes made in this dialog will be saved to the file + "userdata/print.cfg" , and used again, as long as the "printcfg" option + is set. - If this option is not specifically not set, the default command - is KDE's graphical print dialog: + 💡 Note: This only works when not running Tux Paint in fullscreen mode. - kprinter + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "printcfg=no" or "noprintcfg= + yes". In both cases, may be overridden by the command-line option + "--noprintcfg". - Paper Size - papersize=PAPERSIZE - (Platforms that use Tux Paint's internal PostScript generator — - not Windows, macOS, BeOS, or Haiku.) - Tell Tux Paint what size PostScript to generate. If none is - specified, Tux Paint first checks your $PAPER environment - variable, then the file /etc/papersize, then uses the the - 'libpaper' library's default paper size. + Print Commands - Valid paper sizes include: letter, legal, tabloid, executive, - note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, - b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, - halfnote, folio, quarto, ledger, archA, archB, archC, archD, - archE, flsa, flse, csheet, dsheet, esheet. + printcommand=COMMAND -Saving + (Linux and Unix only) - Save Over Earlier Work + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked. If this option is not specifically not set, + the default command is: - saveover=yes + lpr - This disables the "Save over the old version...?" prompt when - saving an existing file. With this option, the older version - will always be replaced by the new version, automatically. + 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data to + the print command (which defaulted to "pngtopnm | pnmtops | lpr"). - saveover=new + If you set an alternative printcommand in the configuration file prior + to version 0.9.15, you will need to change it. - This also disables the "Save over the old version...?" prompt - when saving an existing file. This option, however, will always - save a new file, rather than overwrite the older version. - saveover=ask - (This option is redundant, since this is the default.) When - saving an existing drawing, you will be first asked whether to - save over the older version or not. + altprintcommand=COMMAND - Starting Out + (Linux and Unix only) - startblank=yes + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked while the [Alt] modifier key is being held. + (This is typically used for providing a print dialog, similar to when + pressing [Alt]+'Print' in Windows and macOS.) - This causes Tux Paint to display a blank canvas when it first - starts up, rather than loading the last image that was being - edited. + If this option is not specifically not set, the default command is + KDE's graphical print dialog: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". + kprinter - newcolorslast=yes - Places the blank color options in the New dialog at the end, so - that any Starters and/or Templates are shown first. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". - Save and Export Directories + Paper Size - savedir=DIRECTORY + papersize=PAPERSIZE - Use this option to change where Tux Paint's "saved" - directory/folder is located, which is where Tux Paint saves and - opens pictures. + (Platforms that use Tux Paint's internal PostScript generator — not + Windows, macOS, BeOS, or Haiku.) - If you do not override it, the default location is: + Tell Tux Paint what size PostScript to generate. If none is specified, + Tux Paint first checks your $PAPER environment variable, then the file + /etc/papersize, then uses the the 'libpaper' library's default paper + size. - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/saved/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/saved/ + Valid paper sizes include: letter, legal, tabloid, executive, note, + statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, + b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, + ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, + esheet. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - 📜 Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - Example: savedir=Z:\tuxpaint\ - exportdir=DIRECTORY + Saving - Use this option to change where Tux Paint exports files — single - images, or animated GIF slideshows — for external use. + Save Over Earlier Work - If you do not override it, the default location is: + saveover=yes - * Linux & Unix — If available, wherever your desktop - environment is configured for pictures to be stored, based - on your XDG (X Desktop Group) configuration. (Try running - the command-line "xdg-user-dir PICTURES" to find out.) - Typically (in an English locale), this will be a "Pictures" - subdirectory in your home directory (i.e., "$HOME/Pictures" - aka "~/Pictures"). - Tux Paint will fall back to using that typical directory, - of no XDG configuration can be read, or nothing is set for - "XDG_PICTURES_DIR". - * Windows - "My Pictures" directory for each user (normaly - "c:\Users\USERNAME\Pictures"). - You can directly open the folder as follows: - * Press "[Windows]+[R]" key to open "Run ..." dialogue. - * Enter "Shell:My Pictures" in the text box and push - [OK]. - * macOS — TBD! + This disables the "Save over the old version...?" prompt when saving an + existing file. With this option, the older version will always be + replaced by the new version, automatically. - 💡 Note: When the defaults are used, a new "TuxPaint" - subdirectory will be created and used. (e.g., - "~/Pictures/TuxPaint") When the "--exportdir" option is used, - the exact path specified will be used (no "TuxPaint" - subdirectory is created). - The directory itself (e.g., "~/Pictures/TuxPaint") will be - created, if it doesn't exist. - If the parent directory (e.g., "~/Pictures/TuxPaint") also does - not exist, Tux Paint will attempt to create it as well (but not - any directories higher than that). + saveover=new - Example: exportdir=/home/penguin/TuxPaintExports + This also disables the "Save over the old version...?" prompt when + saving an existing file. This option, however, will always save a new + file, rather than overwrite the older version. - More Saving Options - nosave=yes - This disables Tux Paint's ability to save files (and therefore - disables the on-screen "Save" button). It can be used in - situations where the program is only being used for fun, or in a - test environment. + saveover=ask - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". + (This option is redundant, since this is the default.) When saving an + existing drawing, you will be first asked whether to save over the + older version or not. - autosave=yes - This prevents Tux Paint from asking whether you want to save the - current picture when quitting, and assumes you do. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - reversesort=yes + Starting Out - This reverses the sorting of the Open and Slideshow dialogs, - placing the newest images at the top of the list. + startblank=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "reversesort=no" or "noreversesort=yes". In both cases, may be - overridden by the command-line option "--noreversesort". + This causes Tux Paint to display a blank canvas when it first starts + up, rather than loading the last image that was being edited. -Data + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "startblank=no" or "startlast= + yes". In both cases, may be overridden by the command-line option + "--startlast". - Lockfile - nolockfile=yes - By default, Tux Paint uses what's known as a 'lockfile' to - prevent it from being launched more than once in 30 seconds. - (This is to avoid accidentally running multiple copies; for - example, by double-clicking a single-click launcher, or simply - impatiently clicking the icon multiple times.) + newcolorslast=yes - To make Tux Paint ignore the lockfile, allowing it to run again, - even if it was just launched less than 30 seconds ago, enable - this setting in the configuration file, or run Tux Paint with - the --nolockfile option on the command-line. + Places the blank color options in the New dialog at the end, so that + any Starters and/or Templates are shown first. - By default, the lockfile is stored in "~/.tuxpaint/" under Linux - and Unix, and "userdata\" under Windows. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "newcolorslast=no" or + "newcolorsfirst=yes". In both cases, may be overridden by the + command-line option "--newcolorsfirst". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". - Data Directory - datadir=DIRECTORY - Use this option to change where Tux Paint looks for personal - data files (brushes, stamps, starters, templates, and fonts - specific to the current user). - - Tux Paint will search for subdirectories/subfolders named - "brushes", "stamps", "starters", "templates", and "fonts" under - the specified data directory. - - If you do not override it, the default location is: - - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/brushes/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/brushes/ + Save and Export Directories - 📜 Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. + savedir=DIRECTORY - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. + Use this option to change where Tux Paint's "saved" directory/folder is + located, which is where Tux Paint saves and opens pictures. - Example: datadir=/home/johnny/tuxpaint-data/ + If you do not override it, the default location is: - Color Palette File + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/saved/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\saved\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/saved + / - colorfile=FILENAME + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - You may override Tux Paint's default color palette by creating a - plain ASCII text file that describes the colors you want, and - pointing to that file using the "colorfile" option. + 📜 Note: Prior to version 0.9.18, Tux Paint would also use the setting + or default for "savedir" as the place to search for personal data files + (brushes, stamps, starters and fonts). As of version 0.9.18, they may + be specified separately (see the "datadir" option, below). - The file should list one color per line. Colors are defined in - terms of their Red, Green and Blue values, each from 0 (off) to - 255 (brightest). (For more information, try Wikipedia's "RGB - color model" article.) + Example: savedir=Z:\tuxpaint\ - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). - After the color definition (on the same line) you may enter text - to describe the color. Tux will display this text when the color - is clicked. (For example, "#FFF White as snow.") - As an example, you can see the default colors currently used in - Tux Paint in: "default_colors.txt". + exportdir=DIRECTORY - NOTES: You must separate decimal values with spaces, and begin - hexadecimal values with a pound/number-sign character ("#"). In - 3-digit hexadecimal, each digit is used for both the high and - low halves of the byte, so "#FFF" is the same as "#FFFFFF", not - "#F0F0F0". + Use this option to change where Tux Paint exports files — single + images, or animated GIF slideshows — for external use. -Accessibility + If you do not override it, the default location is: - Mouse + o Linux & Unix — If available, wherever your desktop environment is + configured for pictures to be stored, based on your XDG (X Desktop + Group) configuration. (Try running the command-line "xdg-user-dir + PICTURES" to find out.) + Typically (in an English locale), this will be a "Pictures" + subdirectory in your home directory (i.e., "$HOME/Pictures" aka "~/ + Pictures"). + Tux Paint will fall back to using that typical directory, of no XDG + configuration can be read, or nothing is set for + "XDG_PICTURES_DIR". + o Windows - "My Pictures" directory for each user (normaly "c:\Users\ + USERNAME\Pictures"). + You can directly open the folder as follows: + # Press "[Windows]+[R]" key to open "Run ..." dialogue. + # Enter "Shell:My Pictures" in the text box and push [OK]. + o macOS — TBD! - mouse-accessibility=yes + 💡 Note: When the defaults are used, a new "TuxPaint" subdirectory will + be created and used. (e.g., "~/Pictures/TuxPaint") When the + "--exportdir" option is used, the exact path specified will be used (no + "TuxPaint" subdirectory is created). - In this mode, instead of clicking, dragging and releasing (e.g., - to draw), you click, move, and click again to end the motion. + The directory itself (e.g., "~/Pictures/TuxPaint") will be created, if + it doesn't exist. - Keyboard + If the parent directory (e.g., "~/Pictures/TuxPaint") also does not + exist, Tux Paint will attempt to create it as well (but not any + directories higher than that). - keyboard=yes + Example: exportdir=/home/penguin/TuxPaintExports - This allows the keyboard arrow keys to be used to control the - mouse pointer. (e.g., for mouseless environments, or - handicapped/accessibility purposes) - Features: - * Fine movement within canvas, or coarse movement if Shift is - held. - * Coarse movement within tool button areas. - * Key controls: - * [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move - mouse - * [Space]/[5]: Click mouse (except when using "Text" or - "Label" tools) - * [Insert]/[F5]: Click mouse (always) - * [F4] jump mouse between "Tools", "Colors" and canvas - areas - * If mouse is within "Tools" section on the left, or - "Colors" section at the bottom: - * [F7], [F8]: Move down/up between buttons, - respectively (Tools section, only) - * [F11], [F12]: Move to previous/next button, - respectively - * To click-and-drag, hold one of the 'click' keys (e.g., - [Insert]), and use the movement keys (e.g., [Left]). - 💡 Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a 'click' - key to start clicking, movement keys to move around (which - will draw), and another 'click' key to end the click (stop - drawing). + More Saving Options - * A regular mouse and/or joystick may still be used (so you - can, e.g., move with the mouse, and click with the - keyboard, or vice-versa) + nosave=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "mouse=yes". In both cases, may be overridden by the - command-line option "--mouse". + This disables Tux Paint's ability to save files (and therefore disables + the on-screen "Save" button). It can be used in situations where the + program is only being used for fun, or in a test environment. - Onscreen Keyboard + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nosave=no" or "save=yes". In + both cases, may be overridden by the command-line option "--save". - onscreen-keyboard=yes - Presents a clickable on-screen keyboard when using the Text and - Label tools. - onscreen-keyboard-layout=LAYOUTNAME + autosave=yes - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. + This prevents Tux Paint from asking whether you want to save the + current picture when quitting, and assumes you do. - onscreen-keyboard-disable-change=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "autosave=no" or "noautosave= + yes". In both cases, may be overridden by the command-line option + "--noautosave". - Disables the possibility for changing the layout of the - on-screen keyboard when using the Text and Label tools, useful - for simplifying things for the small children. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". -Joystick + reversesort=yes - Main Device + This reverses the sorting of the Open and Slideshow dialogs, placing + the newest images at the top of the list. - joystick-dev=N + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "reversesort=no" or + "noreversesort=yes". In both cases, may be overridden by the + command-line option "--noreversesort". - Specify which joystick device should be used by Tux Paint. - Default value is 0 (the first joystick). - joystick-slowness=SPEED - Sets a delay at each axis motion, allowing to slow the joystick. - Allowed values are from 0 to 500. Default value is 15. - joystick-threshold=THRESHOLD + Data - Sets the minimum level of axis motion to start moving the - pointer. Allowed values are from 0 to 32766. Default value is - 3200. + Lockfile - joystick-maxsteps=STEPS + nolockfile=yes - Sets the maximum pixels the pointer will move at once. Allowed - values are from 1 to 7. Default value is 7. + By default, Tux Paint uses what's known as a 'lockfile' to prevent it + from being launched more than once in 30 seconds. (This is to avoid + accidentally running multiple copies; for example, by double-clicking a + single-click launcher, or simply impatiently clicking the icon multiple + times.) - Hat + To make Tux Paint ignore the lockfile, allowing it to run again, even + if it was just launched less than 30 seconds ago, enable this setting + in the configuration file, or run Tux Paint with the --nolockfile + option on the command-line. - joystick-hat-slowness=SPEED + By default, the lockfile is stored in "~/.tuxpaint/" under Linux and + Unix, and "userdata\" under Windows. - Sets a delay at each automatic motion, allowing to slow the - speed of the hat. Allowed values are from 0 to 500. Default - value is 15. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nolockfile=no" or "lockfile= + yes". In both cases, may be overridden by the command-line option + "--lockfile". - joystick-hat-timeout=MILLISECONDS - Sets the delay after wich the pointer will start moving - automatically if the hat is keeped pushed. Allowed values are - from 0 to 3000. Default value is 1000. - Buttons to Disable - joystick-buttons-ignore=BUTTON1,BUTTON2,... + Data Directory - A set of joystick button numbers, as seen by SDL, that should be - ignored. Otherwise, unless they are used by one of the - "joystick-btn-" options above, buttons will be seen as a mouse - left-click. + datadir=DIRECTORY - Button Shortcuts + Use this option to change where Tux Paint looks for personal data files + (brushes, stamps, starters, templates, and fonts specific to the + current user). - joystick-btn-escape=BUTTON NUMBER + Tux Paint will search for subdirectories/subfolders named "brushes", + "stamps", "starters", "templates", and "fonts" under the specified data + directory. - Selects the joystick button number, as seen by SDL, that will be - used to generate a escape event. Useful to dismiss dialogs and - quit. + If you do not override it, the default location is: - joystick-btn-brush=BUTTON NUMBER + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/brushes/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\brushes\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/ + brushes/ - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the brush tool. + 📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting + or default as for "savedir" to search for data files. As of version + 0.9.18, they may be specified separately. - joystick-btn-stamp=BUTTON NUMBER + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the stamp tool. + Example: datadir=/home/johnny/tuxpaint-data/ - joystick-btn-lines=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the lines tool. - joystick-btn-shapes=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the shapes tool. + Color Palette File - joystick-btn-text=BUTTON NUMBER + colorfile=FILENAME - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the text tool. + You may override Tux Paint's default color palette by creating a plain + ASCII text file that describes the colors you want, and pointing to + that file using the "colorfile" option. - joystick-btn-label=BUTTON NUMBER + The file should list one color per line. Colors are defined in terms of + their Red, Green and Blue values, each from 0 (off) to 255 (brightest). + (For more information, try Wikipedia's "RGB color model" article.) - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the label tool. + Colors may be listed using three decimal numbers (e.g., "255 68 136") + or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "# + F48"). - joystick-btn-fill=BUTTON NUMBER + After the color definition (on the same line) you may enter text to + describe the color. Tux will display this text when the color is + clicked. (For example, "#FFF White as snow.") - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the fill tool. + As an example, you can see the default colors currently used in Tux + Paint in: "default_colors.txt". - joystick-btn-magic=BUTTON NUMBER + NOTES: You must separate decimal values with spaces, and begin + hexadecimal values with a pound/number-sign character ("#"). In 3-digit + hexadecimal, each digit is used for both the high and low halves of the + byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the magic tool. - joystick-btn-undo=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to invoke the undo tool. - joystick-btn-redo=BUTTON NUMBER + Accessibility - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select redo tool. + Mouse - joystick-btn-eraser=BUTTON NUMBER + mouse-accessibility=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select eraser tool. + In this mode, instead of clicking, dragging and releasing (e.g., to + draw), you click, move, and click again to end the motion. - joystick-btn-new=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for creating a new drawing. - joystick-btn-open=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for opening an existing drawing. + Keyboard - joystick-btn-save=BUTTON NUMBER + keyboard=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to save the drawing. + This allows the keyboard arrow keys to be used to control the mouse + pointer. (e.g., for mouseless environments, or handicapped/ + accessibility purposes) - joystick-btn-pgsetup=BUTTON NUMBER + Features: - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the page setup dialog for printing. + o Fine movement within canvas, or coarse movement if Shift is held. + o Coarse movement within tool button areas. + o Key controls: + # [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move mouse + # [Space]/[5]: Click mouse (except when using "Text" or "Label" + tools) + # [Insert]/[F5]: Click mouse (always) + # [F4] jump mouse between "Tools", "Colors" and canvas areas + # If mouse is within "Tools" section on the left, or "Colors" + section at the bottom: + @ [F7], [F8]: Move down/up between buttons, respectively + (Tools section, only) + @ [F11], [F12]: Move to previous/next button, respectively + o To click-and-drag, hold one of the 'click' keys (e.g., [Insert]), + and use the movement keys (e.g., [Left]). - joystick-btn-print=BUTTON NUMBER + 💡 Note: The "mouse accessibility" feature works with the keyboard + mouse controls. With both options enabled, painting tools can be + used to draw by pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another 'click' key to + end the click (stop drawing). - Selects the joystick button number, as seen by SDL, that will be - a shortcut to print. - - Overriding System Config. Options - - (For Linux and Unix users) - - If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", - you can override them in your own "~/.tuxpaintrc" file. - - For true/false options, like "noprint" and "grab", you can simply say - they equal 'no' in your "~/.tuxpaintrc" file: - - noprint=no - uppercase=no - - Or, you can use options similar to the command-line override options - described below. For example: - - print=yes - mixedcase=yes - - Command-Line Options - - Options may also be issued on the command-line when you go to launch Tux - Paint. - - --fullscreen - --WIDTHxHEIGHT - --buttonsize=SIZE - --colorsrows=ROWS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDS - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --printcommand=COMMAND - --altprintcommand=COMMAND - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang LANGUAGE - --colorfile FILE - - These enable or correspond to the configuration file options - described above. - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - These options can be used to override any settings made in the - configuration file. (If the option isn't set in the - configuration file(s), no overriding option is necessary.) - - --nosysconfig - - Under Linux and Unix, this prevents the system-wide - configuration file, "/etc/tuxpaint/tuxpaint.conf", from being - read. - - Only your own configuration file, "~/.tuxpaintrc", if it exists, - will be used. - -Command-Line Informational Options - - The following options display some informative text on the screen. Tux - Paint doesn't actually start up and run afterwards, however. - - --version - --verbose-version - - Display the version number and date of the copy of Tux Paint you - are running. The "--verbose-version" also lists what - compile-time options were set. (See INSTALL and FAQ). - - --copying - - Show brief license information about copying Tux Paint. - - --usage - - Display the list of available command-line options. - - --help - - Display brief help on using Tux Paint. - - --lang help - - Display a list of available languages in Tux Paint. - - --joystick-dev list - - Display list of attached joysticks available to Tux Paint. - - Choosing a Different Language - - Tux Paint has been translated into a number of languages. To access the - translations, you can use the "--lang" option on the command-line to set - the language (e.g. "--lang spanish") or use the "lang=" setting in the - configuration file (e.g., "lang=spanish"). - - Tux Paint also honors your environment's current locale. (You can - override it on the command-line using the "--locale" option; see above.) - - Use the option "--lang help" to list the language options available. - -Available Languages - - +----------------------------------------------------------------------+ - | |Language |Language |Input Method | - |Locale Code |(native name) |(English name) |Cycle Key | - | | | |Combination | - |----------------+-------------------+-----------------+---------------| - |C | |English | | - |----------------+-------------------+-----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+-------------------+-----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+-------------------+-----------------+---------------| - |ak_GH | |Akan | | - |----------------+-------------------+-----------------+---------------| - |am_ET | |Amharic | | - |----------------+-------------------+-----------------+---------------| - |an_ES | |Aragones | | - |----------------+-------------------+-----------------+---------------| - |ar_SA | |Arabic | | - |----------------+-------------------+-----------------+---------------| - |as_IN | |Assamese | | - |----------------+-------------------+-----------------+---------------| - |ast_ES | |Asturian | | - |----------------+-------------------+-----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+-------------------+-----------------+---------------| - |bm_ML | |Bambara | | - |----------------+-------------------+-----------------+---------------| - |bn_IN | |Bengali | | - |----------------+-------------------+-----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+-------------------+-----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+-------------------+-----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+-------------------+-----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+-------------------+-----------------+---------------| - |brx_IN | |Bodo | | - |----------------+-------------------+-----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+-------------------+-----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+-------------------+-----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+-------------------+-----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+-------------------+-----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+-------------------+-----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+-------------------+-----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+-------------------+-----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+-------------------+-----------------+---------------| - |doi_IN | |Dogri | | - |----------------+-------------------+-----------------+---------------| - |et_EE | |Estonian | | - |----------------+-------------------+-----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+-------------------+-----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |en_CA | |Canadian English | | - |----------------+-------------------+-----------------+---------------| - |en_GB | |British English | | - |----------------+-------------------+-----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |eo | |Esperanto | | - |----------------+-------------------+-----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+-------------------+-----------------+---------------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+-------------------+-----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+-------------------+-----------------+---------------| - |fa_IR | |Persian | | - |----------------+-------------------+-----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+-------------------+-----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+-------------------+-----------------+---------------| - |fo_FO | |Faroese | | - |----------------+-------------------+-----------------+---------------| - |fr_FR |Français |French | | - |----------------+-------------------+-----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+-------------------+-----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+-------------------+-----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+-------------------+-----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+-------------------+-----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+-------------------+-----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+-------------------+-----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+-------------------+-----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+-------------------+-----------------+---------------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+-------------------+-----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+-------------------+-----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+-------------------+-----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+-------------------+-----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |ka_GE | |Georgian | | - |----------------+-------------------+-----------------+---------------| - |kab | |Kabyle | | - |----------------+-------------------+-----------------+---------------| - |km_KH | |Khmer | | - |----------------+-------------------+-----------------+---------------| - |kn_IN | |Kannada | | - |----------------+-------------------+-----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+-------------------+-----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+-------------------+-----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+-------------------+-----------------+---------------| - |lg_UG | |Luganda | | - |----------------+-------------------+-----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+-------------------+-----------------+---------------| - |lv_LV | |Latvian | | - |----------------+-------------------+-----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+-------------------+-----------------+---------------| - |mai_IN | |Maithili | | - |----------------+-------------------+-----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+-------------------+-----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+-------------------+-----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+-------------------+-----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+-------------------+-----------------+---------------| - |mr_IN | |Marathi | | - |----------------+-------------------+-----------------+---------------| - |ms_MY | |Malay | | - |----------------+-------------------+-----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+-------------------+-----------------+---------------| - |ne_NP |Nepali | | | - |----------------+-------------------+-----------------+---------------| - |nl_NL | |Dutch | | - |----------------+-------------------+-----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk| | - |----------------+-------------------+-----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+-------------------+-----------------+---------------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+-------------------+-----------------+---------------| - |oc_FR | |Occitan | | - |----------------+-------------------+-----------------+---------------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+-------------------+-----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+-------------------+-----------------+---------------| - |or_IN |Odia |Oriya | | - |----------------+-------------------+-----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+-------------------+-----------------+---------------| - |pt_BR |Portugês Brazileiro|Brazilian | | - | | |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |ro_RO | |Romanian | | - |----------------+-------------------+-----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+-------------------+-----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+-------------------+-----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+-------------------+-----------------+---------------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+-------------------+-----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+-------------------+-----------------+---------------| - |si_LK | |Sinhala | | - |----------------+-------------------+-----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+-------------------+-----------------+---------------| - |sk_SK | |Slovak | | - |----------------+-------------------+-----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+-------------------+-----------------+---------------| - |son | |Songhay | | - |----------------+-------------------+-----------------+---------------| - |sq_AL | |Albanian | | - |----------------+-------------------+-----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+-------------------+-----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+-------------------+-----------------+---------------| - |su_ID | |Sundanese | | - |----------------+-------------------+-----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+-------------------+-----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+-------------------+-----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+-------------------+-----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+-------------------+-----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+-------------------+-----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+-------------------+-----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+-------------------+-----------------+---------------| - |tr_TR | |Turkish | | - |----------------+-------------------+-----------------+---------------| - |tw_GH | |Twi | | - |----------------+-------------------+-----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+-------------------+-----------------+---------------| - |ur_IN | |Urdu | | - |----------------+-------------------+-----------------+---------------| - |ve_ZA | |Venda | | - |----------------+-------------------+-----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+-------------------+-----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+-------------------+-----------------+---------------| - |wa_BE | |Walloon | | - |----------------+-------------------+-----------------+---------------| - |wo_SN | |Wolof | | - |----------------+-------------------+-----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+-------------------+-----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+-------------------+-----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+-------------------+-----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+-------------------+-----------------+---------------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - These languages require their own fonts, since they are not - represented using a Latin character set, like the others. See the - "Special Fonts" section, below. - - 💡 Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods while - the Text tool is active. - -Setting Your Environment's Locale - - Changing your locale will affect much of your environment. - - As stated above, along with letting you choose the language at runtime - using command-line options ("--lang" and "--locale"), Tux Paint honors - the global locale setting in your environment. - - If you haven't already set your environment's locale, the following will - briefly explain how: - - Linux/Unix Users - - First, be sure the locale you want to use is enabled by editing the file - "/etc/locale.gen" on your system and then running the program - "locale-gen" as root. - - 💡 Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration dialog. - Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the - "localeconf" package may need to be installed first), or you may need to - edit the file "/var/lib/locales/supported.d/local" first, and add - locales they want, from the list found in "/usr/share/i18n/SUPPORTED". - - Then, before running Tux Paint, set your "$LANG" environment variable to - one of the locales listed above. (If you want all programs that can be - translated to be, you may wish to place the following in your login - script; e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) - - For example, in a Bourne Shell (like BASH): - - export LANG=es_ES ; \ - tuxpaint - - And in a C Shell (like TCSH): - - setenv LANG es_ES ; \ - tuxpaint - - Windows Users - - Tux Paint will recognize the current locale and use the appropriate - files by default. So this section is only for people trying different - languages. - - The simplest thing to do is to use the "--lang" switch in the shortcut - (see "INSTALL"). However, by using an MSDOS Prompt window, it is also - possible to issue a command like this: - - set LANG=es_ES - - ...which will set the language for the lifetime of that DOS window. - - For something more permanent, you can set an 'environment variable' - using the "System properties" dialogue as follows: - - * Press the "[Windows]+[R]" key combination to open the "Run ..." - dialogue. - * Enter "sysdm.cpl" in the text box and click the "[OK]" button to - open the "System properties" dialogue. - * Select the "Advanced" tab. - * Click the "Environment Variables..." button. - * Edit the value of the parameter "LANG" (create it, if it doesn't - exists). - -Special Fonts - - Some languages require special fonts be installed. These font files - (which are in TrueType format (TTF)), are much too large to include with - the Tux Paint download, and are available separately. (See the table - above, under the "Choosing a Different Language" section.) - - 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user interface, - rather than using "SDL_ttf" directly. Unless your copy of Tux Paint was - built without Pango support, special fonts should no longer be - necessary. + o A regular mouse and/or joystick may still be used (so you can, + e.g., move with the mouse, and click with the keyboard, or + vice-versa) - When running Tux Paint in a language that requires its own font, Tux - Paint will try to load the font file from its system-wide "fonts" - directory (under a "locale" subdirectory). The name of the file - corresponds to the first two letters in the 'locale' code of the - language (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for - Traditional Chinese). + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "keyboard=no" or "mouse=yes". In + both cases, may be overridden by the command-line option "--mouse". - For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., - with the option "--lang korean"), Tux Paint will attempt to load the - following font file: - /usr/share/tuxpaint/fonts/locale/ko.ttf - You can download fonts for supported languages from Tux Paint's website, - https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') - Under Unix and Linux, you can use the Makefile that comes with the font - to install the font in the appropriate location. + Onscreen Keyboard + + onscreen-keyboard=yes + + Presents a clickable on-screen keyboard when using the Text and Label + tools. + + + + onscreen-keyboard-layout=LAYOUTNAME + + Selects the initial layout for the on-screen keyboard when using the + Text and Label tools. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + + + onscreen-keyboard-disable-change=yes + + Disables the possibility for changing the layout of the on-screen + keyboard when using the Text and Label tools, useful for simplifying + things for the small children. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be overridden + by the command-line option "--onscreen-keyboard-disable-change=no". + + + + + Joystick + + Main Device + + joystick-dev=N + + Specify which joystick device should be used by Tux Paint. Default + value is 0 (the first joystick). + + + + joystick-slowness=SPEED + + Sets a delay at each axis motion, allowing to slow the joystick. + Allowed values are from 0 to 500. Default value is 15. + + + + joystick-threshold=THRESHOLD + + Sets the minimum level of axis motion to start moving the pointer. + Allowed values are from 0 to 32766. Default value is 3200. + + + + joystick-maxsteps=STEPS + + Sets the maximum pixels the pointer will move at once. Allowed values + are from 1 to 7. Default value is 7. + + + + + Hat + + joystick-hat-slowness=SPEED + + Sets a delay at each automatic motion, allowing to slow the speed of + the hat. Allowed values are from 0 to 500. Default value is 15. + + + + joystick-hat-timeout=MILLISECONDS + + Sets the delay after wich the pointer will start moving automatically + if the hat is keeped pushed. Allowed values are from 0 to 3000. Default + value is 1000. + + + + + Buttons to Disable + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + A set of joystick button numbers, as seen by SDL, that should be + ignored. Otherwise, unless they are used by one of the "joystick-btn-" + options above, buttons will be seen as a mouse left-click. + + + + +Button Shortcuts + + joystick-btn-escape=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be used + to generate a escape event. Useful to dismiss dialogs and quit. + + + + joystick-btn-brush=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the brush tool. + + + + joystick-btn-stamp=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the stamp tool. + + + + joystick-btn-lines=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the lines tool. + + + + joystick-btn-shapes=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the shapes tool. + + + + joystick-btn-text=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the text tool. + + + + joystick-btn-label=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the label tool. + + + + joystick-btn-fill=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the fill tool. + + + + joystick-btn-magic=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the magic tool. + + + + joystick-btn-undo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to invoke the undo tool. + + + + joystick-btn-redo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select redo tool. + + + + joystick-btn-eraser=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select eraser tool. + + + + joystick-btn-new=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for creating a new drawing. + + + + joystick-btn-open=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for opening an existing drawing. + + + + joystick-btn-save=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to save the drawing. + + + + joystick-btn-pgsetup=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the page setup dialog for printing. + + + + joystick-btn-print=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to print. + + + + + Overriding System Config. Options + + (For Linux and Unix users) + + If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", you + can override them in your own "~/.tuxpaintrc" file. + + For true/false options, like "noprint" and "grab", you can simply say they + equal 'no' in your "~/.tuxpaintrc" file: + + noprint=no + uppercase=no + + Or, you can use options similar to the command-line override options + described below. For example: + + print=yes + mixedcase=yes + + Command-Line Options + + Options may also be issued on the command-line when you go to launch Tux + Paint. + + --fullscreen + --WIDTHxHEIGHT + --buttonsize=SIZE + --colorsrows=ROWS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDS + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --printcommand=COMMAND + --altprintcommand=COMMAND + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang LANGUAGE + --colorfile FILE + + These enable or correspond to the configuration file options described + above. + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + These options can be used to override any settings made in the + configuration file. (If the option isn't set in the configuration file + (s), no overriding option is necessary.) + + + + --nosysconfig + + Under Linux and Unix, this prevents the system-wide configuration file, + "/etc/tuxpaint/tuxpaint.conf", from being read. + + Only your own configuration file, "~/.tuxpaintrc", if it exists, will + be used. + + + + + Command-Line Informational Options + + The following options display some informative text on the screen. Tux + Paint doesn't actually start up and run afterwards, however. + + --version + --verbose-version + + Display the version number and date of the copy of Tux Paint you are + running. The "--verbose-version" also lists what compile-time options + were set. (See INSTALL and FAQ). + + + + --copying + + Show brief license information about copying Tux Paint. + + + + --usage + + Display the list of available command-line options. + + + + --help + + Display brief help on using Tux Paint. + + + + --lang help + + Display a list of available languages in Tux Paint. + + + + --joystick-dev list + + Display list of attached joysticks available to Tux Paint. + + + + + Choosing a Different Language + + Tux Paint has been translated into a number of languages. To access the + translations, you can use the "--lang" option on the command-line to set + the language (e.g. "--lang spanish") or use the "lang=" setting in the + configuration file (e.g., "lang=spanish"). + + Tux Paint also honors your environment's current locale. (You can override + it on the command-line using the "--locale" option; see above.) + + Use the option "--lang help" to list the language options available. + + Available Languages + + +-------------------------------------------------------------------------+ + | | Language | Language | Input Method | + | Locale Code | (native name) | (English name) | Cycle Key | + | | | | Combination | + |------------------+------------------+----------------+------------------| + | C | | English | | + |------------------+------------------+----------------+------------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+----------------+------------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+----------------+------------------| + | ak_GH | | Akan | | + |------------------+------------------+----------------+------------------| + | am_ET | | Amharic | | + |------------------+------------------+----------------+------------------| + | an_ES | | Aragones | | + |------------------+------------------+----------------+------------------| + | ar_SA | | Arabic | | + |------------------+------------------+----------------+------------------| + | as_IN | | Assamese | | + |------------------+------------------+----------------+------------------| + | ast_ES | | Asturian | | + |------------------+------------------+----------------+------------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+----------------+------------------| + | bm_ML | | Bambara | | + |------------------+------------------+----------------+------------------| + | bn_IN | | Bengali | | + |------------------+------------------+----------------+------------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+----------------+------------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+----------------+------------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+----------------+------------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+----------------+------------------| + | brx_IN | | Bodo | | + |------------------+------------------+----------------+------------------| + | bs_BA | | Bosnian | | + |------------------+------------------+----------------+------------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+----------------+------------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+----------------+------------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+----------------+------------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+----------------+------------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+----------------+------------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+----------------+------------------| + | de_DE | Deutsch | German | | + |------------------+------------------+----------------+------------------| + | doi_IN | | Dogri | | + |------------------+------------------+----------------+------------------| + | et_EE | | Estonian | | + |------------------+------------------+----------------+------------------| + | el_GR (*) | | Greek | | + |------------------+------------------+----------------+------------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_GB | | British | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+----------------+------------------| + | eo | | Esperanto | | + |------------------+------------------+----------------+------------------| + | es_ES | Español | Spanish | | + |------------------+------------------+----------------+------------------| + | es_MX | Español-Mejicano | Mexican | | + | | | Spanish | | + |------------------+------------------+----------------+------------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+----------------+------------------| + | fa_IR | | Persian | | + |------------------+------------------+----------------+------------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+----------------+------------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+----------------+------------------| + | fo_FO | | Faroese | | + |------------------+------------------+----------------+------------------| + | fr_FR | Français | French | | + |------------------+------------------+----------------+------------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+----------------+------------------| + | gd_GB | Ghaidhlig | Scottish | | + | | | Gaelic | | + |------------------+------------------+----------------+------------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+----------------+------------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+----------------+------------------| + | gu_IN | | Gujarati | | + |------------------+------------------+----------------+------------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+----------------+------------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+----------------+------------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+----------------+------------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+----------------+------------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+----------------+------------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+----------------+------------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+----------------+------------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+----------------+------------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+----------------+------------------| + | ja_JP (*) | | Japanese | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | ka_GE | | Georgian | | + |------------------+------------------+----------------+------------------| + | kab | | Kabyle | | + |------------------+------------------+----------------+------------------| + | km_KH | | Khmer | | + |------------------+------------------+----------------+------------------| + | kn_IN | | Kannada | | + |------------------+------------------+----------------+------------------| + | ko_KR (*) | | Korean | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | kok@roman | | Konkani | | + | | | (Roman) | | + |------------------+------------------+----------------+------------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+----------------+------------------| + | ku_TR | | Kurdish | | + |------------------+------------------+----------------+------------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+----------------+------------------| + | lg_UG | | Luganda | | + |------------------+------------------+----------------+------------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+----------------+------------------| + | lv_LV | | Latvian | | + |------------------+------------------+----------------+------------------| + | mk_MK | | Macedonian | | + |------------------+------------------+----------------+------------------| + | mai_IN | | Maithili | | + |------------------+------------------+----------------+------------------| + | ml_IN | | Malayalam | | + |------------------+------------------+----------------+------------------| + | mn_MN | | Mongolian | | + |------------------+------------------+----------------+------------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+----------------+------------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+----------------+------------------| + | mr_IN | | Marathi | | + |------------------+------------------+----------------+------------------| + | ms_MY | | Malay | | + |------------------+------------------+----------------+------------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+----------------+------------------| + | ne_NP | Nepali | | | + |------------------+------------------+----------------+------------------| + | nl_NL | | Dutch | | + |------------------+------------------+----------------+------------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+----------------+------------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+----------------+------------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+----------------+------------------| + | oc_FR | | Occitan | | + |------------------+------------------+----------------+------------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+----------------+------------------| + | pa_IN | | Punjabi | | + |------------------+------------------+----------------+------------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+----------------+------------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+----------------+------------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+----------------+------------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+----------------+------------------| + | ro_RO | | Romanian | | + |------------------+------------------+----------------+------------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+----------------+------------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+----------------+------------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+----------------+------------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+----------------+------------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+----------------+------------------| + | si_LK | | Sinhala | | + |------------------+------------------+----------------+------------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sd_IN | | Sindhi | | + |------------------+------------------+----------------+------------------| + | sk_SK | | Slovak | | + |------------------+------------------+----------------+------------------| + | sl_SI | | Slovenian | | + |------------------+------------------+----------------+------------------| + | son | | Songhay | | + |------------------+------------------+----------------+------------------| + | sq_AL | | Albanian | | + |------------------+------------------+----------------+------------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+----------------+------------------| + | sr_RS@latin | | Serbian | | + | | | (latin) | | + |------------------+------------------+----------------+------------------| + | su_ID | | Sundanese | | + |------------------+------------------+----------------+------------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+----------------+------------------| + | sw_TZ | | Swahili | | + |------------------+------------------+----------------+------------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+----------------+------------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+----------------+------------------| + | th_TH (*) | | Thai | | + |------------------+------------------+----------------+------------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+----------------+------------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+----------------+------------------| + | tr_TR | | Turkish | | + |------------------+------------------+----------------+------------------| + | tw_GH | | Twi | | + |------------------+------------------+----------------+------------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+----------------+------------------| + | ur_IN | | Urdu | | + |------------------+------------------+----------------+------------------| + | ve_ZA | | Venda | | + |------------------+------------------+----------------+------------------| + | vec | Venèto | Venetian | | + |------------------+------------------+----------------+------------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+----------------+------------------| + | wa_BE | | Walloon | | + |------------------+------------------+----------------+------------------| + | wo_SN | | Wolof | | + |------------------+------------------+----------------+------------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+----------------+------------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+----------------+------------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+----------------+------------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+----------------+------------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - These languages require their own fonts, since they are not + represented using a Latin character set, like the others. See the "Special + Fonts" section, below. + + 💡 Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) listed + can be used to cycle through the supported input methods while the Text + tool is active. + + Setting Your Environment's Locale + + Changing your locale will affect much of your environment. + + As stated above, along with letting you choose the language at runtime + using command-line options ("--lang" and "--locale"), Tux Paint honors the + global locale setting in your environment. + + If you haven't already set your environment's locale, the following will + briefly explain how: + + Linux/Unix Users + + First, be sure the locale you want to use is enabled by editing the file "/ + etc/locale.gen" on your system and then running the program "locale-gen" as + root. + + 💡 Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration dialog. + Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the + "localeconf" package may need to be installed first), or you may need to + edit the file "/var/lib/locales/supported.d/local" first, and add locales + they want, from the list found in "/usr/share/i18n/SUPPORTED". + + Then, before running Tux Paint, set your "$LANG" environment variable to + one of the locales listed above. (If you want all programs that can be + translated to be, you may wish to place the following in your login script; + e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) + + For example, in a Bourne Shell (like BASH): + + export LANG=es_ES ; \ + tuxpaint + + And in a C Shell (like TCSH): + + setenv LANG es_ES ; \ + tuxpaint + + Windows Users + + Tux Paint will recognize the current locale and use the appropriate files + by default. So this section is only for people trying different languages. + + The simplest thing to do is to use the "--lang" switch in the shortcut (see + "INSTALL"). However, by using an MSDOS Prompt window, it is also possible + to issue a command like this: + + set LANG=es_ES + + ...which will set the language for the lifetime of that DOS window. + + For something more permanent, you can set an 'environment variable' using + the "System properties" dialogue as follows: + + + Press the "[Windows]+[R]" key combination to open the "Run ..." + dialogue. + + Enter "sysdm.cpl" in the text box and click the "[OK]" button to open + the "System properties" dialogue. + + Select the "Advanced" tab. + + Click the "Environment Variables..." button. + + Edit the value of the parameter "LANG" (create it, if it doesn't + exists). + + Special Fonts + + Some languages require special fonts be installed. These font files (which + are in TrueType format (TTF)), are much too large to include with the Tux + Paint download, and are available separately. (See the table above, under + the "Choosing a Different Language" section.) + + 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, which + utilizes the "Pango" library to render text in the user interface, rather + than using "SDL_ttf" directly. Unless your copy of Tux Paint was built + without Pango support, special fonts should no longer be necessary. + + When running Tux Paint in a language that requires its own font, Tux Paint + will try to load the font file from its system-wide "fonts" directory + (under a "locale" subdirectory). The name of the file corresponds to the + first two letters in the 'locale' code of the language (e.g., "ko" for + Korean, "ja" for Japanese, "zh_tw" for Traditional Chinese). + + For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., + with the option "--lang korean"), Tux Paint will attempt to load the + following font file: + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + You can download fonts for supported languages from Tux Paint's website, + https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + + Under Unix and Linux, you can use the Makefile that comes with the font to + install the font in the appropriate location. + diff --git a/docs/en/PNG.txt b/docs/en/PNG.txt index 7702052c5..30772c584 100644 --- a/docs/en/PNG.txt +++ b/docs/en/PNG.txt @@ -1,88 +1,92 @@ Tux Paint - version 0.9.31 + version 0.9.31 PNG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - June 4, 2022 + June 4, 2022 - About PNGs +About PNGs - 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 - not "lossy" like JPEGs - lossiness allows files to be much smaller, but - introduces 'mistakes' in the image when saved), and supports 24-bit color - (16.7 million colors) as well as a full "alpha channel" - that is, each - pixel can have a varying degree of transparency. +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 not +"lossy" like JPEGs - lossiness allows files to be much smaller, but introduces +'mistakes' in the image when saved), and supports 24-bit color (16.7 million +colors) as well as a full "alpha channel" - that is, each pixel can have a +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) - make it the best choice for Tux Paint. (Tux Paint's support for the PNG - format comes from the Open Source SDL_Image library, which in turn gets it - from the libPNG library.) +These features (openness, losslessness, compression, transparency/alpha) make +it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes +from the Open Source SDL_Image library, which in turn gets it from the libPNG +library.) - Support for many colors allows photo-quality "rubber stamp" images to be - used in Tux Paint, and alpha transparency allows for high-quality brushes. +Support for many colors allows photo-quality "rubber stamp" images to be used +in Tux Paint, and alpha transparency allows for high-quality brushes. How To Make PNGs - The following is a very brief list of ways to create PNGs or convert - existing images into PNGs. +The following is a very brief list of ways to create PNGs or convert existing +images into PNGs. - GIMP & Krita +GIMP & Krita - Excellent tools with which to create PNG images for use in Tux - Paint are GIMP and Krita, both high-quality Open Source - interactive drawing and photo editing programs. + Excellent tools with which to create PNG images for use in Tux Paint are + GIMP and Krita, both high-quality Open Source interactive drawing and photo + 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 - NetPBM - The Portable Bitmap tools (collectively known as - "NetPBM") is a collection of Open Source command-line - tools which convert to and from various formats, - including GIF, TIFF, BMP, PNG, and many more. +Command-line Tools - 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/. + NetPBM - cjpeg/djpeg + The Portable Bitmap tools (collectively known as "NetPBM") is a + collection of Open Source command-line tools which convert to and from + various formats, 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/. + + + + cjpeg/djpeg + + The "cjpeg" and "djpeg" command-line programs convert between the + NetPBM Portable Any Map (PNM) format and JPEGs. 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 https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Macintosh Users + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - The "cjpeg" and "djpeg" command-line programs convert - between the NetPBM Portable Any Map (PNM) format and - JPEGs. 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 - https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Macintosh Users - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/en/README.txt b/docs/en/README.txt index 8db267ebd..a2bc7d59e 100644 --- a/docs/en/README.txt +++ b/docs/en/README.txt @@ -1,5 +1,5 @@ Tux Paint - version 0.9.31 + version 0.9.31 A simple drawing program for children @@ -8,1343 +8,1332 @@ July 13, 2023 - +------------------------------------------------------+ - |Table of Contents | - |------------------------------------------------------| - |I. About Tux Paint | - |II. Using Tux Paint | - | A. Launching Tux Paint | - | B. Title Screen | - | C. Main Screen | - | D. Available Tools | - | 1. Drawing Tools | - | a. "Paint" Tool (Brush) | - | b. "Stamp" Tool (Rubber Stamps) | - | c. "Lines" Tool | - | d. "Shapes" Tool | - | e. "Text" and "Label" Tools | - | f. "Fill" Tool | - | g. "Magic" Tool (Special Effects) | - | h. "Eraser" Tool | - | 2. Other Controls | - | a. "Undo" and "Redo" Commands | - | b. "New" Command | - | c. "Open" Command | - | d. "Save" Command | - | e. "Print" Command | - | f. "Slides" Command (under "Open") | - | g. "Quit" Command | - | h. Sound Muting | - | E. Controlling Tux Paint | - |III. Loading Other Pictures into Tux Paint | - |IV. Further Reading | - |V. How to Get Help | - |VI. How to Participate | - +------------------------------------------------------+ ++-------------------------------------------------+ +| Table of Contents | +|-------------------------------------------------| +| I. About Tux Paint | +| II. Using Tux Paint | +| A. Launching Tux Paint | +| B. Title Screen | +| C. Main Screen | +| D. Available Tools | +| 1. Drawing Tools | +| a. "Paint" Tool (Brush) | +| b. "Stamp" Tool (Rubber Stamps) | +| c. "Lines" Tool | +| d. "Shapes" Tool | +| e. "Text" and "Label" Tools | +| f. "Fill" Tool | +| g. "Magic" Tool (Special Effects) | +| h. "Eraser" Tool | +| 2. Other Controls | +| a. "Undo" and "Redo" Commands | +| b. "New" Command | +| c. "Open" Command | +| d. "Save" Command | +| e. "Print" Command | +| f. "Slides" Command (under "Open") | +| g. "Quit" Command | +| h. Sound Muting | +| E. Controlling Tux Paint | +| III. Loading Other Pictures into Tux Paint | +| IV. Further Reading | +| V. How to Get Help | +| VI. How to Participate | ++-------------------------------------------------+ - I. About Tux Paint +I. About Tux Paint A. What Is "Tux Paint"? - Tux Paint is a free drawing program designed for young children (kids ages - 3 and up). It has a simple, easy-to-use interface, fun sound effects, and - an encouraging cartoon mascot who helps guide children as they use the - program. It provides a blank canvas and a variety of drawing tools to help - your child be creative. +Tux Paint is a free drawing program designed for young children (kids ages 3 +and up). It has a simple, easy-to-use interface, fun sound effects, and an +encouraging cartoon mascot who helps guide children as they use the program. It +provides a blank canvas and a variety of drawing tools to help your child be +creative. B. Objectives - Easy and Fun - Tux Paint is meant to be a simple drawing program for young - children. It is not meant as a general-purpose drawing tool. It is - meant to be fun and easy to use. Sound effects and a cartoon - character help let the user know what's going on, and keeps them - entertained. There are also extra-large cartoon-style mouse - pointer shapes. +Easy and Fun + Tux Paint is meant to be a simple drawing program for young children. It is + not meant as a general-purpose drawing tool. It is meant to be fun and easy + to use. Sound effects and a cartoon character help let the user know what's + going on, and keeps them entertained. There are also extra-large + cartoon-style mouse pointer shapes. - Extensibility - Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be - dropped in and pulled out. For example, a teacher can drop in a - collection of animal shapes and ask their students to draw an - ecosystem. Each shape can have a sound which is played, and - textual facts which are displayed, when the child selects the - shape. +Extensibility + Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped + in and pulled out. For example, a teacher can drop in a collection of + animal shapes and ask their students to draw an ecosystem. Each shape can + have a sound which is played, and textual facts which are displayed, when + the child selects the shape. - Portability - Tux Paint is portable among various computer platforms: Windows, - Macintosh, Linux, etc. The interface looks the same among them - all. Tux Paint runs suitably well on older systems, and can be - built to run better on slow systems. +Portability + Tux Paint is portable among various computer platforms: Windows, Macintosh, + Linux, etc. The interface looks the same among them all. Tux Paint runs + suitably well on older systems, and can be built to run better on slow + systems. - Simplicity - There is no direct access to the computer's underlying - intricacies. The current image is kept when the program quits, and - reappears when it is restarted. Saving images requires no need to - create filenames or use the keyboard. Opening an image is done by - selecting it from a collection of thumbnails. Access to other - files on the computer is restricted. +Simplicity + There is no direct access to the computer's underlying intricacies. The + current image is kept when the program quits, and reappears when it is + restarted. Saving images requires no need to create filenames or use the + keyboard. Opening an image is done by selecting it from a collection of + thumbnails. Access to other files on the computer is restricted. + +Accessibility + Tux Paint offers a number of accessibility options, including increasing + the size of control buttons, changing the UI font, options to control the + cursor (mouse pointer) using the keyboard or other input devices (joystick, + gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks. - Accessibility - Tux Paint offers a number of accessibility options, including - increasing the size of control buttons, changing the UI font, - options to control the cursor (mouse pointer) using the keyboard - or other input devices (joystick, gamepad, etc.), an on-screen - keyboard, and "stick" mouse clicks. C. License - Tux Paint is an Open Source project, Free Software released under the GNU - General Public License (GPL). It is free, and the 'source code' behind the - program is available. (This allows others to add features, fix bugs, and - use parts of the program in their own GPL'd software.) +Tux Paint is an Open Source project, Free Software released under the GNU +General Public License (GPL). It is free, and the 'source code' behind the +program is available. (This allows others to add features, fix bugs, and use +parts of the program in their own GPL'd software.) - See COPYING.txt for the full text of the GPL license. +See COPYING.txt for the full text of the GPL license. D. What's New in Tux Paint version 0.9.31? - Fuzzy Erasers - Fuzzy-edged round erasers have been added to the Eraser tool +Fuzzy Erasers + Fuzzy-edged round erasers have been added to the Eraser tool - New Magic tools - Loops, Ribbon, Smooth, and Squiggles +New Magic tools + Loops, Ribbon, Smooth, and Squiggles - Create templates from Open dialog - Saved drawings can be turned into templates (used to make new - drawings) via a new option in the Open dialog. (This feature may - be deactivated using the "notemplateexport" simplification - option.) +Create templates from Open dialog + Saved drawings can be turned into templates (used to make new drawings) via + a new option in the Open dialog. (This feature may be deactivated using the + "notemplateexport" simplification option.) - User interface font may be overridden - The font used for the user interface (button labels, dialog - pop-ups, and instructions) can be overridden from its default - ("DejaVu Sans"). (See the "uifont" configuration option. Use - "--listfonts" to see a list of available fonts.) +User interface font may be overridden + The font used for the user interface (button labels, dialog pop-ups, and + instructions) can be overridden from its default ("DejaVu Sans"). (See the + "uifont" configuration option. Use "--listfonts" to see a list of available + fonts.) - File Erase may be disabled - Controls to erase saved work — saved drawings (via the Open - dialog) and exported templates (via the New dialog) — can be - disabled. (See the "noerase" configuration option.) +File Erase may be disabled - "Controlling Tux Paint" documentation - A brief overview of how Tux Paint can be controlled — mouse, - tablet, touchscreen, joystick, and keyboard — has been added to - the README documentation. + Controls to erase saved work — saved drawings (via the Open dialog) and + exported templates (via the New dialog) — can be disabled. (See the + "noerase" configuration option.) - See CHANGES.txt for the complete list of changes. +"Controlling Tux Paint" documentation - II. Using Tux Paint + A brief overview of how Tux Paint can be controlled — mouse, tablet, + touchscreen, joystick, and keyboard — has been added to the README + documentation. + + +See CHANGES.txt for the complete list of changes. + +II. Using Tux Paint A. Launching Tux Paint - 1. Linux/Unix Users +1. Linux/Unix Users - Tux Paint should have placed a launcher icon in your KDE and/or GNOME - menus, under 'Graphics.' +Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus, +under 'Graphics.' - Alternatively, you can run the following command at a shell prompt (e.g., - "$"): +Alternatively, you can run the following command at a shell prompt (e.g., "$"): - $ tuxpaint + $ tuxpaint - If any errors occur, they will be displayed on the terminal (to STDERR). +If any errors occur, they will be displayed on the terminal (to STDERR). - 2. Windows Users +2. Windows Users - [Tux Paint Icon] - Tux Paint +[Tux Paint Icon] + Tux Paint - If you installed Tux Paint on your computer using the 'Tux Paint - Installer,' it will have asked you whether you wanted a 'Start' menu - short-cut, and/or a desktop shortcut. If you agreed, you can simply run - Tux Paint from the 'Tux Paint' section of your 'Start' menu (e.g., under - 'All Programs'), or by double-clicking the 'Tux Paint' icon on your - desktop, if you had the installer place one there. +If you installed Tux Paint on your computer using the 'Tux Paint Installer,' it +will have asked you whether you wanted a 'Start' menu short-cut, and/or a +desktop shortcut. If you agreed, you can simply run Tux Paint from the 'Tux +Paint' section of your 'Start' menu (e.g., under 'All Programs'), or by +double-clicking the 'Tux Paint' icon on your desktop, if you had the installer +place one there. - If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you - used the 'Tux Paint Installer,' but chose not to have shortcuts installed, - you'll need to double-click the "tuxpaint.exe" icon in the "Tux Paint" - folder on your computer. +If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you used +the 'Tux Paint Installer,' but chose not to have shortcuts installed, you'll +need to double-click the "tuxpaint.exe" icon in the "Tux Paint" folder on your +computer. - By default, the 'Tux Paint Installer' will put Tux Paint's folder in - "C:\Program Files\", though you may have changed this when you ran the - installer. +By default, the 'Tux Paint Installer' will put Tux Paint's folder in "C:\ +Program Files\", though you may have changed this when you ran the installer. - If you used the 'ZIP-file' download, Tux Paint's folder will be wherever - you extracted the contents of the ZIP file. +If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you +extracted the contents of the ZIP file. - 3. macOS Users +3. macOS Users - Simply double-click the "Tux Paint" icon. +Simply double-click the "Tux Paint" icon. - [Title screen] +[Title screen] B. Title Screen - When Tux Paint first loads, a title/credits screen will appear. +When Tux Paint first loads, a title/credits screen will appear. - Once loading is complete, press a key or click or tap in the Tux Paint - window to continue. (Or, after about 5 seconds, the title screen will go - away automatically.) +Once loading is complete, press a key or click or tap in the Tux Paint window +to continue. (Or, after about 5 seconds, the title screen will go away +automatically.) C. Main Screen - The main screen is divided into the following sections: +The main screen is divided into the following sections: - [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, - Eraser, New, Open, Save, Print, Quit] +[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, + New, Open, Save, Print, Quit] +Left Side: Toolbar - Left Side: Toolbar + The toolbar contains the drawing and editing controls. - The toolbar contains the drawing and editing controls. - [Canvas] - Middle: Drawing Canvas + [Canvas] +Middle: Drawing Canvas - The largest part of the screen, in the center, is the drawing - canvas. This is, obviously, where you draw! + The largest part of the screen, in the center, is the drawing canvas. This + is, obviously, where you draw! - 💡 Note: The size of the drawing canvas depends on the size of Tux - Paint. You can change the size of Tux Paint using the Tux Paint - Config. configuration tool, or by other means. See the Options - documentation for more details. + 💡 Note: The size of the drawing canvas depends on the size of Tux Paint. + You can change the size of Tux Paint using the Tux Paint Config. + configuration tool, or by other means. See the Options documentation for + more details. - [Selectors - Brushes, Letters, Shapes, Stamps] - Right Side: Selector - Depending on the current tool, the selector shows different - things. e.g., when the Paint Brush or Line tool is selected, it - shows the various brushes available. When the Rubber Stamp tool is - selected, it shows the different shapes you can use. When the Text - or Label tool is selected, it shows various fonts. + [Selectors - Brushes, Letters, Shapes, Stamps] +Right Side: Selector - [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, - Blue, Purple, Brown, Grey] + Depending on the current tool, the selector shows different things. e.g., + when the Paint Brush or Line tool is selected, it shows the various brushes + available. When the Rubber Stamp tool is selected, it shows the different + shapes you can use. When the Text or Label tool is selected, it shows + various fonts. - Lower: Colors - When the active tool supports colors, a palette of colors choices - will be shown near the bottom of the screen. Click one to choose a - color, and it will be used by the active tool. (For example, the - "Paint" tool will use it as the color to draw with the chosen - brush, and the "Fill" tool will use it as the color to use when - flood-filling an area of the picture.) - On the far right are three special color options: - * Color Picker - The "color picker" (which has an outline of an eye-dropper) - allows you to pick a color found within your drawing. - (A shortcut key is available to access this feature quickly; - see below.) - * Rainbow Palette - The rainbow palette allows you to pick any color by choosing - the hue, saturation, and value of the color you want. A box - on the left displays hundreds of hues — from red at the top - through to violet at the bottom — at hundreds of - saturation/intensity levels — from pale & washed-out on the - left through to pure on the right. A grey vertical bar - provides access to hundreds of value levels — from lighest at - the top through to darkest at the bottom. - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. - You may also set this tool's color to that of other color - choices: - * Whichever built-in color is selected, if any - * The Color Picker's current color - * The Color Mixer's current color - * Color Mixer - The "color mixer" (which has silhouette of a paint palette) - allows you to create colors by blending primary additive - colors — red, yellow, and blue — along with white (to - "tint"), grey (to "tone"), and black (to "shade"). - You may click any button multiple times (for example, red + - red + yellow results in a red-orange color). The ratios of - colors added are shown at the bottom. - You can start over (reset to no colors in your picture) by - clicking the "Clear" button. You can also undo or redo - multiple steps of mixing, in case you made a mistake (without - having to start over). - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. + [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, + Purple, Brown, Grey] +Lower: Colors - ⌨ When the active tool supports colors, a shortcut may be used for - quick access to the "color picker" option. Hold the [Control] key - while clicking, and the color under the mouse cursor will be shown - at the bottom. You may drag around to canvas to find the color you - want. When you release the mouse button, the color under the - cursor will be selected. If you release the mouse outside of the - canvas (e.g., over the "Tools" area), the color selection will be - left unchanged. (This is similar to clicking the "Back" button - that's available when bringing up the "color picker" option via - its button the color palette.) + When the active tool supports colors, a palette of colors choices will be + shown near the bottom of the screen. Click one to choose a color, and it + will be used by the active tool. (For example, the "Paint" tool will use it + as the color to draw with the chosen brush, and the "Fill" tool will use it + as the color to use when flood-filling an area of the picture.) - ⚙ Note: You can define your own colors for Tux Paint. See the - "Options" documentation. + On the far right are three special color options: + + Color Picker + The "color picker" (which has an outline of an eye-dropper) allows you + to pick a color found within your drawing. + (A shortcut key is available to access this feature quickly; see + below.) + + Rainbow Palette + The rainbow palette allows you to pick any color by choosing the hue, + saturation, and value of the color you want. A box on the left displays + hundreds of hues — from red at the top through to violet at the bottom + — at hundreds of saturation/intensity levels — from pale & washed-out + on the left through to pure on the right. A grey vertical bar provides + access to hundreds of value levels — from lighest at the top through to + darkest at the bottom. + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + You may also set this tool's color to that of other color choices: + o Whichever built-in color is selected, if any + o The Color Picker's current color + o The Color Mixer's current color + + Color Mixer + The "color mixer" (which has silhouette of a paint palette) allows you + to create colors by blending primary additive colors — red, yellow, and + blue — along with white (to "tint"), grey (to "tone"), and black (to + "shade"). + You may click any button multiple times (for example, red + red + + yellow results in a red-orange color). The ratios of colors added are + shown at the bottom. + You can start over (reset to no colors in your picture) by clicking the + "Clear" button. You can also undo or redo multiple steps of mixing, in + case you made a mistake (without having to start over). + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + + ⌨ When the active tool supports colors, a shortcut may be used for quick + access to the "color picker" option. Hold the [Control] key while clicking, + and the color under the mouse cursor will be shown at the bottom. You may + drag around to canvas to find the color you want. When you release the + mouse button, the color under the cursor will be selected. If you release + the mouse outside of the canvas (e.g., over the "Tools" area), the color + selection will be left unchanged. (This is similar to clicking the "Back" + button that's available when bringing up the "color picker" option via its + button the color palette.) + + ⚙ Note: You can define your own colors for Tux Paint. See the "Options" + documentation. + + + + (Example tip: 'Pick a shape. Click to pick the center, drag, then let go + when it is the size you want. Move around to rotate it, and click to draw + it.') +Bottom: Help Area + + At the very bottom of the screen, Tux, the Linux Penguin, provides tips and + other information while you use Tux Paint. - (Example tip: 'Pick a shape. Click to pick the center, drag, then - let go when it is the size you want. Move around to rotate it, and - click to draw it.') - Bottom: Help Area - At the very bottom of the screen, Tux, the Linux Penguin, provides - tips and other information while you use Tux Paint. D. Available Tools - 1. Drawing Tools - - a. "Paint" Tool (Brush) - - The Paint Brush tool lets you draw freehand, using various brushes - (chosen in the Selector on the right) and colors (chosen in the - Color palette towards the bottom). - - If you hold the mouse button down, and move the mouse, it will - draw as you move. - - Some brushes are animated — they change their shape as you draw - them. A good example of this is the vines brush that ships with - Tux Paint. These brushes will have a small "filmstrip" icon drawn - on their Selector buttons. - - Other brushes are directional — they will draw a different shape - depending on what direction you are painting with them. An example - of this is the arrow brush that ships with Tux Paint. These - brushes have a small 8-way arrow icon drawn on their Selector - buttons. - - Finally, some brushes can be both direction and animated. Examples - of this are the cat and squirrel brushes that ship with Tux Paint. - These brushes will have both the "filmstrip" and 8-way arrow - icons. - - As you draw, a sound is played. The bigger the brush, the lower - the pitch. - - Brush Spacing - - The space between each position where a brush is applied to the - canvas can vary. Some brushes (such as the footprints and - flower) are spaced, by default, far enough apart that they don't - overlap. Other brushes (such as the basic circular ones) are - spaced closely, so they make a continuous stroke. - - The default spacing of brushes may be overridden using by - clicking within the triangular-shaped series of bars at the - bottom right; the larger the bar, the wider the spacing. Brush - spacing affects both tools that use the brushes: the "Paint" - tool and the "Lines" tool. - - ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't - display the brush spacing controls. See the "Options" - documentation. - - b."Stamp" Tool (Rubber Stamps) - - The Stamp tool is like a set of rubber stamps or stickers. It lets - you paste pre-drawn or photographic images (like a picture of a - horse, or a tree, or the moon) in your picture. - - As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be. Click on the canvas where you wish to place the stamp. - - Stamp Categories - There can be numerous categories of stamps (e.g., - animals, plants, outer space, vehicles, people, - etc.). Use the Left and Right arrows near the bottom - of the Selector to cycle through the collections. - - Stamp Rotation - - Using the rotation toggle button near the bottom - right, you can enable a rotation step when placing - stamps. Once you've placed the stamp, choose the - angle to rotate it by moving the mouse around the - canvas. Click the mouse button again and the stamp - will be added to the drawing. - - ⚙ Note: If "stamp rotation" option is disabled, the - stamp will be drawn on the canvas when you let go of - the mouse button. (There's no rotation step.) See the - "Options" documentation to learn about the "stamp - rotation" ("stamprotation") option. - - 📜 Note: The stamp rotation feature was added to Tux - Paint in version 0.9.29. +1. Drawing Tools - Stamp Controls - - Prior to 'stamping' an image onto your drawing, - various effects can sometimes be applied (depending - on the stamp): - - * Some stamps can be colored or tinted. If the - color palette below the canvas is activated, you - can click the colors to change the tint or color - of the stamp before placing it in the picture. - * Stamps can be shrunk and expanded, by clicking - within the triangular-shaped series of bars at - the bottom right; the larger the bar, the larger - the stamp will appear in your picture. - * Many stamps may be flipped vertically, or - displayed as a mirror-image, using the control - buttons at the bottom right. +a. "Paint" Tool (Brush) - ⚙ Note: If the "nostampcontrols" option is set, Tux - Paint won't display the Rotation, Mirror, Flip, or - sizing controls for stamps. See the "Options" - documentation. - - Stamp Sounds - - Different stamps can have different sound effects - and/or descriptive (spoken) sounds. Buttons in the - Help Area at the lower left (near Tux, the Linux - penguin) allow you to re-play the sound effects and - descriptive sounds for the currently-selected stamp. - - c."Lines" Tool - - This tool lets you draw straight lines using the various brushes - and colors you normally use with the Paint Brush. - - Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line will - show where the line will be drawn. At the bottom, you'll see the - angle of your line, in degrees. A line going straight to the right - is 0°, a line going straight up is 90°, a line going straight left - is 180°, a line going straight down is 270°, and so on. - - Let go of the mouse to complete the line. A "sproing!" sound will - play. - - Some brushes are animated, and will show a pattern of shapes along - the line. Others are directional, and will show a different shape - depending on the angle of the brush. And finally some are both - animated and directional. See "Paint", above, to learn more. - - Different brushes have different spacing, leaving either a series - of individual shapes, or a continuous stroke of the brush shape. - Brush spacing may be adjusted. See the brush spacing section of - the "Paint" tool, above, to learn more. - - d."Shapes" Tool - - This tool lets you draw some simple filled, and un-filled shapes. - - Select a shape from the selector on the right (circle, square, - oval, etc.). - - Use the options at the bottom right to choose the shape tool's - behavior: - - Shapes from center - The shape will expand from where you initially - clicked, and will be centered around that position. - - 📜 This was Tux Paint's only behavior through version - 0.9.24.) - - Shapes from corner - The shape will extend with one corner starting from - where you initially clicked. This is the default - method of most other traditional drawing software. - - 📜 This option was added starting with Tux Paint - version 0.9.25. - - ⚙ Note: If shape controls are disabled (e.g., with the - "noshapecontrols" option), the controls will not be presented, and - the "shapes from center" method will be used. - - In the canvas, click the mouse and hold it to stretch the shape - out from where you clicked. Some shapes can change proportion - (e.g., rectangle and oval may be wider than tall, or taller than - wide), others cannot (e.g., square and circle). - - For shapes that can change proportion, the aspect ratio of the - shape will be shown at the bottom. For example: "1:1" will be - shown if it is "square" (as tall as it is wide); "2:1" if it is - either twice as wide as it is tall, or twice as tall as it is - wide; and so on. - - Let go of the mouse when you're done stretching. - - Normal Shapes Mode - - Now you can move the mouse around the canvas to - rotate the shape. The angle your shape is rotated - will be shown at the bottom, in degrees (similar to - the "Lines" tool, described above). - - Click the mouse button again and the shape will be - drawn in the current color. - - Simple Shapes Mode - If the "simple shapes" option is enabled, the shape - will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) - - ⚙ See the "Options" documentation to learn about the - "simple shapes" ("simpleshapes") option. - - e."Text" and "Label" Tools - - Choose a font (from the 'Letters' available on the right) and a - color (from the color palette near the bottom). You may also apply - a bold, and/or an italic styling effect to the text. Click on the - screen and a cursor will appear. Type text and it will show up on - the screen. (You can change the font, color, and styling while - entering the text, before it is applied to the canvas.) - - Press [Enter] or [Return] and the text will be drawn onto the - picture and the cursor will move down one line. - - Alternatively, press [Tab] and the text will be drawn onto the - picture, but the cursor will move to the right of the text, rather - than down a line, and to the left. (This can be useful to create a - line of text with mixed colors, fonts, styles and sizes.) - - Clicking elsewhere in the picture while the text entry is still - active causes the current line of text to move to that location - (where you can continue editing it). - - "Text" versus "Label" - - The Text tool is the original text-entry tool in Tux - Paint. Text entered using this tool can't be modified - or moved later, since it becomes part of the drawing. - However, because the text becomes part of the - picture, it can be drawn over or modified using Magic - tool effects (e.g., smudged, tinted, embossed, etc.) - - When using the Label tool (which was added to Tux - Paint in version 0.9.22), the text 'floats' over the - image, and the details of the label (the text, the - position of the label, the font choice and the color) - get stored separately. This allows the label to be - repositioned or edited later. - - To edit a label, click the label selection button. - All labels in the drawing will appear highlighted. - Click one — or use the [Tab] key to cycle through all - the labels, and the [Enter] or [Return] key to select - one — and you may then edit the label. (Use they - [Backspace] key to erase characters, and other keys - to add text to the label; click in the canvas to - reposition the label; click in the palette to change - the color of the text in the label; etc.) - - You may "apply" a label to the canvas, painting the - text into the picture as if it had been added using - the Text tool, by clicking the label application - button. (This feature was added in Tux Paint version - 0.9.28.) All labels in the drawing will appear - highlighted, and you select one just as you do when - selecting a label to edit. The chosen label will be - removed, and the text will be added directly to the - canvas. - - ⚙ The Label tool can be disabled (e.g., by selecting - "Disable 'Label' Tool" in Tux Paint Config. or - running Tux Paint with the "nolabel" option). - - International Character Input - - Tux Paint allows inputting characters in different - languages. Most Latin characters (A-Z, ñ, è, etc.) - can by entered directly. Some languages require that - Tux Paint be switched into an alternate input mode - before entering, and some characters must be composed - using numerous keypresses. - - When Tux Paint's locale is set to one of the - languages that provide alternate input modes, a key - is used to cycle through normal (Latin character) and - locale-specific mode or modes. - - Currently supported locales, the input methods - available, and the key to toggle or cycle modes, are - listed below. - - * Japanese — Romanized Hiragana and Romanized - Katakana — right [Alt] key or left [Alt] key - * Korean — Hangul 2-Bul — right [Alt] key or left - [Alt] key - * Traditional Chinese — right [Alt] key or left - [Alt] key - * Thai — right [Alt] key - - 💡 Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change - fonts to see the characters you're trying to type. - - On-screen Keyboard - - An optional on-screen keyboard is available for the - Text and Label tools, which can provide a variety of - layouts and character composition (e.g., composing - "a" and "e" into "æ"). - - ⚙ See the "Options" and "Extending Tux Paint" - documentation for more information. - - f."Fill" Tool - - The 'Fill' tool 'flood-fills' a contiguous area of your drawing - with a color of your choice. Three fill options are offered: - * Solid — click once to fill an area with a solid color. - * Brush — click and drag to fill an area with a solid color - using freehand painting. - * Linear — click and then drag to fill the area with color that - fades away (a gradient) towards where you drag the mouse. - * Radial — click once to fill an area with a color that fades - away (a gradient) radially, centered on where you clicked. - * Shaped — click once to fill an area with a color that fades - away (a gradient), following the contours of the shape you're - filling. - - 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see - below). Prior to Tux Paint 0.9.26, the "Fill" tool only offered - the 'Solid' method of filling. 'Shaped' fill was introduced in Tux - Paint 0.9.29. - - g."Magic" Tool (Special Effects) - - The Magic tool is actually a set of special tools. Select one of - the 'magic' effects from the selector on the right. Then, - depending on the tool, you can either click and drag around the - picture, and/or simply click the picture once, to apply the - effect. - - Magic Controls - - If the tool can be used by clicking and dragging, a 'painting' - button will be available on the left, below the list of Magic - tools on the right side of the screen. If the tool can affect - the entire picture at once, an 'entire picture' button will be - available on the right. - - ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't - display the painting or entire picture controls. See the - "Options" documentation. - - 💡 If the magic controls are disabled, the Magic plugin may make - separate tools available, one for painting and one that affects - the entire pictre. - - Magic Sizing - - Some tools offer different sizing options. If so, a slider will - appear at the bottom right side of the screen. This may affect - the radius of a special effect (e.g., Darken) or painted object - (e.g., Patterns), or other attributes (e.g., large versus small - Brick shapes). - - ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't - display the sizing controls. See the "Options" documentation. - - 💡 If the sizing option is disabled, the Magic plugin may simply - offer a default size (e.g., Patterns), or it may make separate - tools available with different pre-set sizes (e.g., Bricks and - Googly Eyes). - - 📜 This option was added starting with Tux Paint version 0.9.30. - - See the instructions for each Magic tool (in the 'magic-docs' - folder). - - h."Eraser" Tool - - This tool is similar to the Paint Brush. Wherever you click (or - click and drag), the picture will be erased. (This may be white, - some other color, or to a background picture, depending on the - picture.) - - A number of eraser sizes are available, with both square and round - shapes. Fuzzy-edged round shapes are also available. - - As you move the mouse around, a square outline follows the - pointer, showing what part of the picture will be erased to white. - - As you erase, a 'squeaky clean' eraser wiping sound is played. - - ⌨ Hold the [X] key while clicking for quick access to a small - sharp round eraser (not available when the Text or Label tools are - selected, when you're in the process of rotating a stamp or shape, - or when using an interactive magic tool). Release the mouse to - return to your currently-selected tool. - - 2. Other Controls - - a."Undo" and "Redo" Commands - - Clicking the "Undo" button will undo (revert) the last drawing - action. You can even undo more than once! - - ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to - Undo. - - Clicking the "Redo" button will redo the drawing action you just - un-did via the "Undo" command. - - As long as you don't draw again, you can redo as many times as you - had undone! - - ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to - Redo. - - b."New" Command - - Clicking the 'New' button will start a new drawing. A dialog will - appear where you may choose to start a new picture using a solid - background color, or using a 'Starter' or 'Template' image (see - below). You will first be asked whether you really want to do - this. - - ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to - start a new drawing. - - Special Solid Background Color Choices - Along with the preset solid colors, you can also - choose colors using a rainbow palette or a "color - mixer". These operate identically to the options - found in the color palette shown below the canvas - when drawing a picture. See Main Screen > Lower: - Colors > Special color options for details. - - 'Starter' & Template Images - * 'Starters' can behave like a page from a - coloring book — a black-and-white outline of a - picture, which you can then color in, and the - black outline remains intact — or like a 3D - photograph, where you draw in between a - foreground and background layer. - * 'Templates' are similar, but simply provide a - background drawing to work off of. Unlike - 'Starters', there is no layer that remains in - the foreground of anything you draw in the - picture. + The Paint Brush tool lets you draw freehand, using various brushes (chosen + in the Selector on the right) and colors (chosen in the Color palette + towards the bottom). - When using the 'Eraser' tool, the original image from - the 'Starter' or 'Template' will reappear. The 'Flip' - and 'Mirror' Magic tools affect the orientation of - the 'Starter' or 'Template', as well. + If you hold the mouse button down, and move the mouse, it will draw as you + move. - When you load a 'Starter' or 'Template', draw on it, - and then click 'Save,' it creates a new picture file - — it doesn't overwrite the original, so you can use - it again later (by accessing it from the 'New' - dialog). + Some brushes are animated — they change their shape as you draw them. A + good example of this is the vines brush that ships with Tux Paint. These + brushes will have a small "filmstrip" icon drawn on their Selector buttons. - ⚙ You can create your own 'Starter' and Template - images. See the Extending Tux Paint documentation's - sections on 'Starters' and Templates. + Other brushes are directional — they will draw a different shape depending + on what direction you are painting with them. An example of this is the + arrow brush that ships with Tux Paint. These brushes have a small 8-way + arrow icon drawn on their Selector buttons. - 💡 You can also convert your saved drawings into - Templates directly within Tux Paint, from the 'Open' - dialog. See "Open", below. + Finally, some brushes can be both direction and animated. Examples of this + are the cat and squirrel brushes that ship with Tux Paint. These brushes + will have both the "filmstrip" and 8-way arrow icons. - Erasing Exported Template Images + As you draw, a sound is played. The bigger the brush, the lower the pitch. - If you've selected a Template in your personal - templates folder, and it was created from within Tux - Paint (using the "Template" button in the "Open" - dialog), you may remove it from within Tux Paint, - too. An 'Erase' (trash can) button will appear at the - lower right of the list. Click it to erase the - selected template. (You will be asked to confirm.) + Brush Spacing - 💡 Note: On Linux, Windows, and macOS, the picture - will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you - change your mind). - ⚙ Note: The 'Erase' button may be disabled, via the - "noerase" option. + The space between each position where a brush is applied to the canvas + can vary. Some brushes (such as the footprints and flower) are spaced, + by default, far enough apart that they don't overlap. Other brushes + (such as the basic circular ones) are spaced closely, so they make a + continuous stroke. - ⚙ Note: The solid colors can be placed at the end of the 'New' - dialog (below the Starters and Templates), via the "newcolorslast" - option. + The default spacing of brushes may be overridden using by clicking + within the triangular-shaped series of bars at the bottom right; the + larger the bar, the wider the spacing. Brush spacing affects both tools + that use the brushes: the "Paint" tool and the "Lines" tool. - c."Open" Command + ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't display + the brush spacing controls. See the "Options" documentation. - This shows you a list of all of the pictures you've saved. If - there are more than can fit on the screen, use the up and down - arrows at the top and bottom of the list to scroll through the - list of pictures. - Click a picture to select it, and then... - * Click the green 'Open' button at the lower left of the list - to load the selected picture. You will then be able to edit - it. - (Alternatively, you can double-click a picture's icon to load - it.) +b."Stamp" Tool (Rubber Stamps) - 💡 If choose to open a picture, and your current drawing - hasn't been saved, you will be prompted as to whether you - want to save it or not. (See "Save," below.) + The Stamp tool is like a set of rubber stamps or stickers. It lets you + paste pre-drawn or photographic images (like a picture of a horse, or a + tree, or the moon) in your picture. - * Click the brown 'Erase' (trash can) button at the lower right - of the list to erase the selected picture. (You will be asked - to confirm.) + As you move the mouse around the canvas, an outline follows the mouse, + showing where the stamp will be placed, and how big it will be. Click on + the canvas where you wish to place the stamp. - 📜 Note: On Linux (as of version 0.9.22), Windows (as of - version 0.9.27), and macOS (as of version 0.9.29), the - picture will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you change your - mind). + Stamp Categories + There can be numerous categories of stamps (e.g., animals, plants, + outer space, vehicles, people, etc.). Use the Left and Right arrows + near the bottom of the Selector to cycle through the collections. - ⚙ Note: The 'Erase' button may be disabled, via the "noerase" - option. + Stamp Rotation - * Click the 'Export' button near the lower right to export the - selected picture to your export folder. (e.g., - "~/Pictures/TuxPaint/") + Using the rotation toggle button near the bottom right, you can enable + a rotation step when placing stamps. Once you've placed the stamp, + choose the angle to rotate it by moving the mouse around the canvas. + Click the mouse button again and the stamp will be added to the + drawing. - From the "Open" screen you can also: - * Click the blue 'Slides' (slide projector) button at the lower - left to go to slideshow mode. See "Slides", below, for - details. + ⚙ Note: If "stamp rotation" option is disabled, the stamp will be drawn + on the canvas when you let go of the mouse button. (There's no rotation + step.) See the "Options" documentation to learn about the "stamp + rotation" ("stamprotation") option. - * Click the blue 'Template' button at the lower left to go to - convert the selected picture into a new template, which can - be used as the basis for new drawings. + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - 📜 Note: The Template creation feature was added to Tux Paint - in version 0.9.31. To learn how to create Templates outside - of Tux Paint, see Extending Tux Paint - ⚙ The Template creation feature can be disabled (e.g., by - selecting "Disable 'Make Template'" in Tux Paint Config. or - running Tux Paint with the "notemplateexport" option). - * Click the red 'Back' arrow button at the lower right of the - list to cancel and return to the picture you were drawing. + Stamp Controls - ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to - bring up the 'Open' dialog. + Prior to 'stamping' an image onto your drawing, various effects can + sometimes be applied (depending on the stamp): - d."Save" Command + o Some stamps can be colored or tinted. If the color palette below + the canvas is activated, you can click the colors to change the + tint or color of the stamp before placing it in the picture. + o Stamps can be shrunk and expanded, by clicking within the + triangular-shaped series of bars at the bottom right; the larger + the bar, the larger the stamp will appear in your picture. + o Many stamps may be flipped vertically, or displayed as a + mirror-image, using the control buttons at the bottom right. - This saves your current picture. + ⚙ Note: If the "nostampcontrols" option is set, Tux Paint won't display + the Rotation, Mirror, Flip, or sizing controls for stamps. See the " + Options" documentation. - If you haven't saved it before, it will create a new entry in the - list of saved images. (i.e., it will create a new file) - 💡 Note: It won't ask you anything (e.g., for a filename). It will - simply save the picture, and play a "camera shutter" sound effect. - If you have saved the picture before, or this is a picture you - just loaded using the "Open" command, you will first be asked - whether you want to save over the old version, or create a new - entry (a new file). + Stamp Sounds - ⚙ Note: If either the "saveover" or "saveovernew" options are set, - it won't ask before saving over. See the "Options" documentation. + Different stamps can have different sound effects and/or descriptive + (spoken) sounds. Buttons in the Help Area at the lower left (near Tux, + the Linux penguin) allow you to re-play the sound effects and + descriptive sounds for the currently-selected stamp. - ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to - save. - e."Print" Command - Click this button and your picture will be printed! - On most platforms, you can also hold the [Alt] key (called - [Option] on Macs) while clicking the 'Print' button to get a - printer dialog. Note that this may not work if you're running Tux - Paint in fullscreen mode. See below. - Disabling Printing - The "noprint" option can be set, which will disable - Tux Paint's 'Print' button. +c."Lines" Tool - ⚙ See the "Options" documentation. + This tool lets you draw straight lines using the various brushes and colors + you normally use with the Paint Brush. - Restricting Printing + Click the mouse and hold it to choose the starting point of the line. As + you move the mouse around, a thin 'rubber-band' line will show where the + line will be drawn. At the bottom, you'll see the angle of your line, in + degrees. A line going straight to the right is 0°, a line going straight up + is 90°, a line going straight left is 180°, a line going straight down is + 270°, and so on. - The "printdelay" option can be set, which will only - allow occasional printing — once every so many - seconds, as configured by you. + Let go of the mouse to complete the line. A "sproing!" sound will play. - For example, with "printdelay=60" in Tux Paint's - configuration file, printing can only occur once per - minute (60 seconds). + Some brushes are animated, and will show a pattern of shapes along the + line. Others are directional, and will show a different shape depending on + the angle of the brush. And finally some are both animated and directional. + See "Paint", above, to learn more. - ⚙ See the "Options" documentation. + Different brushes have different spacing, leaving either a series of + individual shapes, or a continuous stroke of the brush shape. Brush spacing + may be adjusted. See the brush spacing section of the "Paint" tool, above, + to learn more. - Printing Commands - (Linux and Unix only) - Tux Paint prints by generating a PostScript - representation of the drawing and sending it to an - external program. By default, the program is: +d."Shapes" Tool - lpr + This tool lets you draw some simple filled, and un-filled shapes. - This command can be changed by setting a - "printcommand" option in Tux Paint's configuration - file. + Select a shape from the selector on the right (circle, square, oval, etc.). - An alternative print command can be invoked by - holding the "[Alt]" key on the keyboard while - clicking clicking the 'Print' button, as long as - you're not in fullscreen mode, an alternative program - is run. By default, the program is KDE's graphical - print dialog: + Use the options at the bottom right to choose the shape tool's behavior: - kprinter + Shapes from center + The shape will expand from where you initially clicked, and will be + centered around that position. - This command can be changed by setting a - "altprintcommand" option in Tux Paint's configuration - file. + 📜 This was Tux Paint's only behavior through version 0.9.24.) - ⚙ See the "Options" documentation. - Printer Settings - (Windows and macOS) + Shapes from corner + The shape will extend with one corner starting from where you initially + clicked. This is the default method of most other traditional drawing + software. - By default, Tux Paint simply prints to the default - printer with default settings when the 'Print' button - is pushed. + 📜 This option was added starting with Tux Paint version 0.9.25. - However, if you hold the [Alt] (or [Option]) key on - the keyboard while clicking the 'Print' button, as - long as you're not in fullscreen mode, your operating - system's printer dialog will appear, where you can - change the settings. - You can have the printer configuration changes stored - between Tux Paint sessions by setting the "printcfg" - option. - If the "printcfg" option is used, printer settings - will be loaded from the file "printcfg.cfg" in your - personal folder (see below). Any changes will be - saved there as well. - ⚙ See the "Options" documentation. + ⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols" + option), the controls will not be presented, and the "shapes from center" + method will be used. - Printer Dialog Options + In the canvas, click the mouse and hold it to stretch the shape out from + where you clicked. Some shapes can change proportion (e.g., rectangle and + oval may be wider than tall, or taller than wide), others cannot (e.g., + square and circle). - By default, Tux Paint only shows the printer dialog - (or, on Linux/Unix, runs the "altprintcommand"; e.g., - "kprinter" instead of "lpr") if the [Alt] (or - [Option]) key is held while clicking the 'Print' - button. + For shapes that can change proportion, the aspect ratio of the shape will + be shown at the bottom. For example: "1:1" will be shown if it is "square" + (as tall as it is wide); "2:1" if it is either twice as wide as it is tall, + or twice as tall as it is wide; and so on. - However, this behavior can be changed. You can have - the printer dialog always appear by using - "--altprintalways" on the command-line, or - "altprint=always" in Tux Paint's configuration file. - Conversely, you can prevent the [Alt]/[Option] key - from having any effect by using "--altprintnever", or - "altprint=never". + Let go of the mouse when you're done stretching. - ⚙ See the "Options" documentation. + Normal Shapes Mode - f."Slides" Command (under "Open") + Now you can move the mouse around the canvas to rotate the shape. The + angle your shape is rotated will be shown at the bottom, in degrees + (similar to the "Lines" tool, described above). - The 'Slides' button is available in the 'Open' dialog. It can be - used to play a simple animation within Tux Paint, or a slideshow - of pictures. It can also export an animated GIF based on the - chosen images. + Click the mouse button again and the shape will be drawn in the current + color. - Chosing pictures - When you enter the 'Slides' section of Tux Paint, it - displays a list of your saved files, just like the - 'Open' dialog. - Click each of the images you wish to display in a - slideshow-style presentation, one by one. A digit - will appear over each image, letting you know in - which order they will be displayed. + Simple Shapes Mode + If the "simple shapes" option is enabled, the shape will be drawn on + the canvas when you let go of the mouse button. (There's no rotation + step.) - You can click a selected image to unselect it (take - it out of your slideshow). Click it again if you wish - to add it to the end of the list. + ⚙ See the "Options" documentation to learn about the "simple shapes" + ("simpleshapes") option. - Set playback speed - A sliding scale at the lower left of the screen (next - to the 'Play' button) can be used to adjust the speed - of the slideshow or animated GIF, from slowest to - fastest. Choose the leftmost setting to disable - automatic advancement during playback within Tux - Paint — you will need to press a key or click to go - to the next slide (see below). - 💡 Note: The slowest setting does not automatically - advance through the slides. Use it for when you want - to step through them manually. (This does not apply - to an exported animated GIF.) - Playback in Tux Paint - To play a slideshow within Tux Paint, click the - 'Play' button. - 💡 Note: If you hadn't selected any images, then all - of your saved images will be played in the slideshow! +e."Text" and "Label" Tools - During the slideshow, press [Space], [Enter] or - [Return], or the [Right arrow] — or click the 'Next' - button at the lower left — to manually advance to the - next slide. Press [Left arrow] to go back to the - previous slide. + Choose a font (from the 'Letters' available on the right) and a color (from + the color palette near the bottom). You may also apply a bold, and/or an + italic styling effect to the text. Click on the screen and a cursor will + appear. Type text and it will show up on the screen. (You can change the + font, color, and styling while entering the text, before it is applied to + the canvas.) - Press [Escape], or click the 'Back' button at the - lower right, to exit the slideshow and return to the - slideshow image selection screen. + Press [Enter] or [Return] and the text will be drawn onto the picture and + the cursor will move down one line. - Exporting an animated GIF + Alternatively, press [Tab] and the text will be drawn onto the picture, but + the cursor will move to the right of the text, rather than down a line, and + to the left. (This can be useful to create a line of text with mixed + colors, fonts, styles and sizes.) - Click the 'GIF Export' button near the lower right to - have Tux Paint generate an animated GIF file based on - the selected images. + Clicking elsewhere in the picture while the text entry is still active + causes the current line of text to move to that location (where you can + continue editing it). - 💡 Note: At least two images must be selected. (To - export a single image, use the 'Export' option from - the main 'Open' dialog.) If no images are selected, - Tux Paint will not attempt to generate a GIF based on - all saved images. + "Text" versus "Label" - Pressing [Escape] during the export process will - abort the process, and return you to the 'Slideshow' - dialog. + The Text tool is the original text-entry tool in Tux Paint. Text + entered using this tool can't be modified or moved later, since it + becomes part of the drawing. However, because the text becomes part of + the picture, it can be drawn over or modified using Magic tool effects + (e.g., smudged, tinted, embossed, etc.) - Click 'Back' in the slideshow image selection screen to return to - the 'Open' dialog. + When using the Label tool (which was added to Tux Paint in version + 0.9.22), the text 'floats' over the image, and the details of the label + (the text, the position of the label, the font choice and the color) + get stored separately. This allows the label to be repositioned or + edited later. - g."Quit" Command + To edit a label, click the label selection button. All labels in the + drawing will appear highlighted. Click one — or use the [Tab] key to + cycle through all the labels, and the [Enter] or [Return] key to select + one — and you may then edit the label. (Use they [Backspace] key to + erase characters, and other keys to add text to the label; click in the + canvas to reposition the label; click in the palette to change the + color of the text in the label; etc.) - Clicking the 'Quit' button, closing the Tux Paint window, or - pushing the [Escape] key will quit Tux Paint. + You may "apply" a label to the canvas, painting the text into the + picture as if it had been added using the Text tool, by clicking the + label application button. (This feature was added in Tux Paint version + 0.9.28.) All labels in the drawing will appear highlighted, and you + select one just as you do when selecting a label to edit. The chosen + label will be removed, and the text will be added directly to the + canvas. - You will first be prompted as to whether you really want to quit. + ⚙ The Label tool can be disabled (e.g., by selecting "Disable 'Label' + Tool" in Tux Paint Config. or running Tux Paint with the "nolabel" + option). - If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new - image, you will then be asked if you want to save over the old - version, or create a new entry. (See "Save" above.) - ⚙ Note: If the image is saved, it will be reloaded automatically - the next time you run Tux Paint -- unless the "startblank" option - is set. - ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the - [Escape] key, may be disabled, via the "noquit" option. + International Character Input - In that case, the "window close" button on Tux Paint's title bar - (if not in fullscreen mode) or the [Alt] + [F4] key sequence may - be used to quit. + Tux Paint allows inputting characters in different languages. Most + Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some + languages require that Tux Paint be switched into an alternate input + mode before entering, and some characters must be composed using + numerous keypresses. - If neither of those are possible, the key sequence of [Shift] + - [Control / ⌘] + [Escape] may be used to quit. + When Tux Paint's locale is set to one of the languages that provide + alternate input modes, a key is used to cycle through normal (Latin + character) and locale-specific mode or modes. - ⚙ See the "Options" documentation. + Currently supported locales, the input methods available, and the key + to toggle or cycle modes, are listed below. - h.Sound Muting + o Japanese — Romanized Hiragana and Romanized Katakana — right [Alt] + key or left [Alt] key + o Korean — Hangul 2-Bul — right [Alt] key or left [Alt] key + o Traditional Chinese — right [Alt] key or left [Alt] key + o Thai — right [Alt] key + + 💡 Note: Many fonts do not include all characters for all languages, so + sometimes you'll need to change fonts to see the characters you're + trying to type. + + + + On-screen Keyboard + + An optional on-screen keyboard is available for the Text and Label + tools, which can provide a variety of layouts and character composition + (e.g., composing "a" and "e" into "æ"). + + ⚙ See the "Options" and "Extending Tux Paint" documentation for more + information. + + + + + + +f."Fill" Tool + + The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a + color of your choice. Three fill options are offered: + + Solid — click once to fill an area with a solid color. + + Brush — click and drag to fill an area with a solid color using + freehand painting. + + Linear — click and then drag to fill the area with color that fades + away (a gradient) towards where you drag the mouse. + + Radial — click once to fill an area with a color that fades away (a + gradient) radially, centered on where you clicked. + + Shaped — click once to fill an area with a color that fades away (a + gradient), following the contours of the shape you're filling. + + 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see below). + Prior to Tux Paint 0.9.26, the "Fill" tool only offered the 'Solid' method + of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29. + + + +g."Magic" Tool (Special Effects) + + The Magic tool is actually a set of special tools. Select one of the + 'magic' effects from the selector on the right. Then, depending on the + tool, you can either click and drag around the picture, and/or simply click + the picture once, to apply the effect. + + Magic Controls + + + If the tool can be used by clicking and dragging, a 'painting' button + will be available on the left, below the list of Magic tools on the + right side of the screen. If the tool can affect the entire picture at + once, an 'entire picture' button will be available on the right. + + ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't display + the painting or entire picture controls. See the "Options" + documentation. + + 💡 If the magic controls are disabled, the Magic plugin may make + separate tools available, one for painting and one that affects the + entire pictre. + + Magic Sizing + + + Some tools offer different sizing options. If so, a slider will appear + at the bottom right side of the screen. This may affect the radius of a + special effect (e.g., Darken) or painted object (e.g., Patterns), or + other attributes (e.g., large versus small Brick shapes). + + ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't display + the sizing controls. See the "Options" documentation. + + 💡 If the sizing option is disabled, the Magic plugin may simply offer a + default size (e.g., Patterns), or it may make separate tools available + with different pre-set sizes (e.g., Bricks and Googly Eyes). + + 📜 This option was added starting with Tux Paint version 0.9.30. + + See the instructions for each Magic tool (in the 'magic-docs' folder). + + + +h."Eraser" Tool + + This tool is similar to the Paint Brush. Wherever you click (or click and + drag), the picture will be erased. (This may be white, some other color, or + to a background picture, depending on the picture.) + + A number of eraser sizes are available, with both square and round shapes. + Fuzzy-edged round shapes are also available. + + As you move the mouse around, a square outline follows the pointer, showing + what part of the picture will be erased to white. + + As you erase, a 'squeaky clean' eraser wiping sound is played. + + ⌨ Hold the [X] key while clicking for quick access to a small sharp round + eraser (not available when the Text or Label tools are selected, when + you're in the process of rotating a stamp or shape, or when using an + interactive magic tool). Release the mouse to return to your + currently-selected tool. + + + + +2. Other Controls + +a."Undo" and "Redo" Commands + + Clicking the "Undo" button will undo (revert) the last drawing action. You + can even undo more than once! + + ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to Undo. + + Clicking the "Redo" button will redo the drawing action you just un-did via + the "Undo" command. + + As long as you don't draw again, you can redo as many times as you had + undone! + + ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo. + + + +b."New" Command + + Clicking the 'New' button will start a new drawing. A dialog will appear + where you may choose to start a new picture using a solid background color, + or using a 'Starter' or 'Template' image (see below). You will first be + asked whether you really want to do this. + + ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a + new drawing. + + Special Solid Background Color Choices + Along with the preset solid colors, you can also choose colors using a + rainbow palette or a "color mixer". These operate identically to the + options found in the color palette shown below the canvas when drawing + a picture. See Main Screen > Lower: Colors > Special color options for + details. + + 'Starter' & Template Images + o 'Starters' can behave like a page from a coloring book — a + black-and-white outline of a picture, which you can then color in, + and the black outline remains intact — or like a 3D photograph, + where you draw in between a foreground and background layer. + o 'Templates' are similar, but simply provide a background drawing to + work off of. Unlike 'Starters', there is no layer that remains in + the foreground of anything you draw in the picture. + + When using the 'Eraser' tool, the original image from the 'Starter' or + 'Template' will reappear. The 'Flip' and 'Mirror' Magic tools affect + the orientation of the 'Starter' or 'Template', as well. + + When you load a 'Starter' or 'Template', draw on it, and then click + 'Save,' it creates a new picture file — it doesn't overwrite the + original, so you can use it again later (by accessing it from the 'New' + dialog). + + ⚙ You can create your own 'Starter' and Template images. See the + Extending Tux Paint documentation's sections on 'Starters' and + Templates. + + 💡 You can also convert your saved drawings into Templates directly + within Tux Paint, from the 'Open' dialog. See "Open", below. + + + + Erasing Exported Template Images + + If you've selected a Template in your personal templates folder, and it + was created from within Tux Paint (using the "Template" button in the + "Open" dialog), you may remove it from within Tux Paint, too. An + 'Erase' (trash can) button will appear at the lower right of the list. + Click it to erase the selected template. (You will be asked to + confirm.) + + 💡 Note: On Linux, Windows, and macOS, the picture will be placed in + your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + + + ⚙ Note: The solid colors can be placed at the end of the 'New' dialog + (below the Starters and Templates), via the "newcolorslast" option. + + + +c."Open" Command + + This shows you a list of all of the pictures you've saved. If there are + more than can fit on the screen, use the up and down arrows at the top and + bottom of the list to scroll through the list of pictures. + + Click a picture to select it, and then... + + Click the green 'Open' button at the lower left of the list to load the + selected picture. You will then be able to edit it. + + (Alternatively, you can double-click a picture's icon to load it.) + + 💡 If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.) + + + Click the brown 'Erase' (trash can) button at the lower right of the + list to erase the selected picture. (You will be asked to confirm.) + + 📜 Note: On Linux (as of version 0.9.22), Windows (as of version + 0.9.27), and macOS (as of version 0.9.29), the picture will be placed + in your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + Click the 'Export' button near the lower right to export the selected + picture to your export folder. (e.g., "~/Pictures/TuxPaint/") + + From the "Open" screen you can also: + + Click the blue 'Slides' (slide projector) button at the lower left to + go to slideshow mode. See "Slides", below, for details. + + + Click the blue 'Template' button at the lower left to go to convert the + selected picture into a new template, which can be used as the basis + for new drawings. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. To learn how to create Templates outside of Tux Paint, see + Extending Tux Paint + + ⚙ The Template creation feature can be disabled (e.g., by selecting + "Disable 'Make Template'" in Tux Paint Config. or running Tux Paint + with the "notemplateexport" option). + + + Click the red 'Back' arrow button at the lower right of the list to + cancel and return to the picture you were drawing. + + ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to bring up + the 'Open' dialog. + + + +d."Save" Command + + This saves your current picture. + + If you haven't saved it before, it will create a new entry in the list of + saved images. (i.e., it will create a new file) + + 💡 Note: It won't ask you anything (e.g., for a filename). It will simply + save the picture, and play a "camera shutter" sound effect. + + If you have saved the picture before, or this is a picture you just loaded + using the "Open" command, you will first be asked whether you want to save + over the old version, or create a new entry (a new file). + + ⚙ Note: If either the "saveover" or "saveovernew" options are set, it won't + ask before saving over. See the "Options" documentation. + + ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save. + + + +e."Print" Command + + Click this button and your picture will be printed! + + On most platforms, you can also hold the [Alt] key (called [Option] on + Macs) while clicking the 'Print' button to get a printer dialog. Note that + this may not work if you're running Tux Paint in fullscreen mode. See + below. + + Disabling Printing + + The "noprint" option can be set, which will disable Tux Paint's 'Print' + button. + + ⚙ See the "Options" documentation. + + + + Restricting Printing + + The "printdelay" option can be set, which will only allow occasional + printing — once every so many seconds, as configured by you. + + For example, with "printdelay=60" in Tux Paint's configuration file, + printing can only occur once per minute (60 seconds). + + ⚙ See the "Options" documentation. + + + + Printing Commands + + (Linux and Unix only) + + Tux Paint prints by generating a PostScript representation of the + drawing and sending it to an external program. By default, the program + is: + + lpr + + This command can be changed by setting a "printcommand" option in Tux + Paint's configuration file. + + An alternative print command can be invoked by holding the "[Alt]" key + on the keyboard while clicking clicking the 'Print' button, as long as + you're not in fullscreen mode, an alternative program is run. By + default, the program is KDE's graphical print dialog: + + kprinter + + This command can be changed by setting a "altprintcommand" option in + Tux Paint's configuration file. + + ⚙ See the "Options" documentation. + + + + Printer Settings + + (Windows and macOS) + + By default, Tux Paint simply prints to the default printer with default + settings when the 'Print' button is pushed. + + However, if you hold the [Alt] (or [Option]) key on the keyboard while + clicking the 'Print' button, as long as you're not in fullscreen mode, + your operating system's printer dialog will appear, where you can + change the settings. + + You can have the printer configuration changes stored between Tux Paint + sessions by setting the "printcfg" option. + + If the "printcfg" option is used, printer settings will be loaded from + the file "printcfg.cfg" in your personal folder (see below). Any + changes will be saved there as well. + + ⚙ See the "Options" documentation. + + + + Printer Dialog Options + + By default, Tux Paint only shows the printer dialog (or, on Linux/Unix, + runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the + [Alt] (or [Option]) key is held while clicking the 'Print' button. + + However, this behavior can be changed. You can have the printer dialog + always appear by using "--altprintalways" on the command-line, or + "altprint=always" in Tux Paint's configuration file. Conversely, you + can prevent the [Alt]/[Option] key from having any effect by using + "--altprintnever", or "altprint=never". + + ⚙ See the "Options" documentation. + + + + + + +f."Slides" Command (under "Open") + + The 'Slides' button is available in the 'Open' dialog. It can be used to + play a simple animation within Tux Paint, or a slideshow of pictures. It + can also export an animated GIF based on the chosen images. + + Chosing pictures + + When you enter the 'Slides' section of Tux Paint, it displays a list of + your saved files, just like the 'Open' dialog. + + Click each of the images you wish to display in a slideshow-style + presentation, one by one. A digit will appear over each image, letting + you know in which order they will be displayed. + + You can click a selected image to unselect it (take it out of your + slideshow). Click it again if you wish to add it to the end of the + list. + + + + Set playback speed + + A sliding scale at the lower left of the screen (next to the 'Play' + button) can be used to adjust the speed of the slideshow or animated + GIF, from slowest to fastest. Choose the leftmost setting to disable + automatic advancement during playback within Tux Paint — you will need + to press a key or click to go to the next slide (see below). + + 💡 Note: The slowest setting does not automatically advance through the + slides. Use it for when you want to step through them manually. (This + does not apply to an exported animated GIF.) + + + + Playback in Tux Paint + + To play a slideshow within Tux Paint, click the 'Play' button. + + 💡 Note: If you hadn't selected any images, then all of your saved + images will be played in the slideshow! + + During the slideshow, press [Space], [Enter] or [Return], or the [Right + arrow] — or click the 'Next' button at the lower left — to manually + advance to the next slide. Press [Left arrow] to go back to the + previous slide. + + Press [Escape], or click the 'Back' button at the lower right, to exit + the slideshow and return to the slideshow image selection screen. + + + + Exporting an animated GIF + + Click the 'GIF Export' button near the lower right to have Tux Paint + generate an animated GIF file based on the selected images. + + 💡 Note: At least two images must be selected. (To export a single + image, use the 'Export' option from the main 'Open' dialog.) If no + images are selected, Tux Paint will not attempt to generate a GIF based + on all saved images. + + Pressing [Escape] during the export process will abort the process, and + return you to the 'Slideshow' dialog. + + + + + Click 'Back' in the slideshow image selection screen to return to the + 'Open' dialog. + + + +g."Quit" Command + + Clicking the 'Quit' button, closing the Tux Paint window, or pushing the + [Escape] key will quit Tux Paint. + + You will first be prompted as to whether you really want to quit. + + If you choose to quit, and you haven't saved the current picture, you will + first be asked if wish to save it. If it's not a new image, you will then + be asked if you want to save over the old version, or create a new entry. + (See "Save" above.) + + ⚙ Note: If the image is saved, it will be reloaded automatically the next + time you run Tux Paint -- unless the "startblank" option is set. + + ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the [Escape] + key, may be disabled, via the "noquit" option. + + In that case, the "window close" button on Tux Paint's title bar (if not in + fullscreen mode) or the [Alt] + [F4] key sequence may be used to quit. + + If neither of those are possible, the key sequence of [Shift] + [Control / + ⌘] + [Escape] may be used to quit. + + ⚙ See the "Options" documentation. + + + +h.Sound Muting + + There is no on-screen control button at this time, but by using the [Alt] + + [S] keyboard sequence, sound effects can be disabled and re-enabled (muted + and unmuted) while the program is running. + + Note that if sounds are completely disabled via the "nosound" option, the + [Alt] + [S] key combination has no effect. (i.e., it cannot be used to turn + on sounds when the parent/teacher wants them disabled.) + + ⚙ See the "Options" documentation. - There is no on-screen control button at this time, but by using - the [Alt] + [S] keyboard sequence, sound effects can be disabled - and re-enabled (muted and unmuted) while the program is running. - Note that if sounds are completely disabled via the "nosound" - option, the [Alt] + [S] key combination has no effect. (i.e., it - cannot be used to turn on sounds when the parent/teacher wants - them disabled.) - ⚙ See the "Options" documentation. E. Controlling Tux Paint - 1. Using a Mouse or Trackball +1. Using a Mouse or Trackball - Tux Paint's main mode of operation is via any device that appears to your - operating system as a mouse, including standard mice, trackballs, and - trackpads, as well as drawing tablets (usually operated with a stylus) and - touch screens (operated with a finger and/or a stylus) (see "Using a - Tablet or Touchscreen" below for more information). +Tux Paint's main mode of operation is via any device that appears to your +operating system as a mouse, including standard mice, trackballs, and +trackpads, as well as drawing tablets (usually operated with a stylus) and +touch screens (operated with a finger and/or a stylus) (see "Using a Tablet or +Touchscreen" below for more information). - For drawing and controlling Tux Paint, only a single mouse button is used - — typically, on multi-button mice, this will the left mouse button, but - this can usually be configured at the operating system level. By default, - Tux Paint will ignore input from the other button(s). If a user attempts - to use the other button(s), a pop-up dialog will eventually appear - reminding them that only one button is recognized Tux Paint. However, you - may configure Tux Paint to accept any button as input (see the Options - documentation). +For drawing and controlling Tux Paint, only a single mouse button is used — +typically, on multi-button mice, this will the left mouse button, but this can +usually be configured at the operating system level. By default, Tux Paint will +ignore input from the other button(s). If a user attempts to use the other +button(s), a pop-up dialog will eventually appear reminding them that only one +button is recognized Tux Paint. However, you may configure Tux Paint to accept +any button as input (see the Options documentation). - a. Scrolling +a. Scrolling - Many input devices offer a way to quickly scroll within applications — - many mice have a scroll wheel, trackballs have scroll rings, and trackpads - recognize certain "scroll" gestures (e.g., two-finger vertical motion, or - vertical motion on the edge of the trackpad). Tux Paint supports scrolling - input to allow quick scrolling through certain lists (e.g., Stamps, Magic - tools, and the New and Open dialogs). +Many input devices offer a way to quickly scroll within applications — many +mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize +certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion +on the edge of the trackpad). Tux Paint supports scrolling input to allow quick +scrolling through certain lists (e.g., Stamps, Magic tools, and the New and +Open dialogs). - Tux Paint will also automatically scroll if you click and hold the mouse - down on an scroll button — the "up" and "down" arrow buttons that appear - above and below scrolling lists. +Tux Paint will also automatically scroll if you click and hold the mouse down +on an scroll button — the "up" and "down" arrow buttons that appear above and +below scrolling lists. - b. Mouse Accessibility +b. Mouse Accessibility - Other devices that appear as a mouse can be used to control Tux Paint. For - example: - * Head pointing/tracking devices - * Eye gaze trackers - * Foot mice +Other devices that appear as a mouse can be used to control Tux Paint. For +example: - Tux Paint offers a "sticky mouse click" accessibility setting, where a - single click begins a click-and-drag operation, and a subsequent click - ends it. (See the Options documentation.) + * Head pointing/tracking devices + * Eye gaze trackers + * Foot mice - 2. Using a Tablet or Touchscreen +Tux Paint offers a "sticky mouse click" accessibility setting, where a single +click begins a click-and-drag operation, and a subsequent click ends it. (See +the Options documentation.) - As noted above, Tux Paint recognizes any device that appears as a mouse. - This means drawing tablets and touchscreens may be used. However, these - devices often support other features beyond X/Y motion, button clicks, and - scroll-wheel motion. Currently, those additional features are not - supported by Tux Paint. Some examples: - * Pressure and angle - * Eraser tip - * Multi-touch gestures +2. Using a Tablet or Touchscreen - 3. Using a Joystick-like Device +As noted above, Tux Paint recognizes any device that appears as a mouse. This +means drawing tablets and touchscreens may be used. However, these devices +often support other features beyond X/Y motion, button clicks, and scroll-wheel +motion. Currently, those additional features are not supported by Tux Paint. +Some examples: - Tux Paint may be configured to recognize input from any game controller - that appears to your operating system as a joystick. That even includes - modern game console controllers connected via USB or Bluetooth (e.g., - Nintendo Switch or Microsoft Xbox game pads)! + * Pressure and angle + * Eraser tip + * Multi-touch gestures - Numerous configuration options are available to best suit the device being - used, and the user's needs. Analog input will be used for coarse movement, - and digital "hat" input for fine movement. Buttons on the controller can - be mapped to different Tux Paint controls (e.g., acting as the [Escape] - key, switching to the Paint tool, invoking Undo and Redo operations, - etc.). See the Options documentation for more details. +3. Using a Joystick-like Device - 4. Using the Keyboard +Tux Paint may be configured to recognize input from any game controller that +appears to your operating system as a joystick. That even includes modern game +console controllers connected via USB or Bluetooth (e.g., Nintendo Switch or +Microsoft Xbox game pads)! - Tux Paint offers an option to allow the keyboard to be used to control the - mouse pointer. This includes motion and clicking, as well as shortcuts to - navigate between and within certain parts of the interface. See the - Options documentation for more details. +Numerous configuration options are available to best suit the device being +used, and the user's needs. Analog input will be used for coarse movement, and +digital "hat" input for fine movement. Buttons on the controller can be mapped +to different Tux Paint controls (e.g., acting as the [Escape] key, switching to +the Paint tool, invoking Undo and Redo operations, etc.). See the Options +documentation for more details. - III. Loading Other Pictures into Tux Paint +4. Using the Keyboard + +Tux Paint offers an option to allow the keyboard to be used to control the +mouse pointer. This includes motion and clicking, as well as shortcuts to +navigate between and within certain parts of the interface. See the Options +documentation for more details. + +III. Loading Other Pictures into Tux Paint A. Overview - Tux Paint's 'Open' dialog only displays pictures you created with Tux - Paint. So what do you do if you want to load some other drawinng or even a - photograph into Tux Paint, so you can edit or draw on it? +Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So +what do you do if you want to load some other drawinng or even a photograph +into Tux Paint, so you can edit or draw on it? - You can simply convert the picture to the format Tux Paint uses — PNG - (Portable Network Graphic) — and place it in Tux Paint's "saved" - directory/folder. Here is where to find it (by default): +You can simply convert the picture to the format Tux Paint uses — PNG (Portable +Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here +is where to find it (by default): - Windows 10, 8, 7, Vista - Inside the user's "AppData" folder, e.g.: - "C:\Users\username\AppData\Roaming\TuxPaint\saved\". +Windows 10, 8, 7, Vista + Inside the user's "AppData" folder, e.g.: "C:\Users\username\AppData\ + Roaming\TuxPaint\saved\". - Windows 2000, XP - Inside the user's "Application Data" folder, e.g.: "C:\Documents - and Settings\username\Application Data\TuxPaint\saved\". +Windows 2000, XP + Inside the user's "Application Data" folder, e.g.: "C:\Documents and + Settings\username\Application Data\TuxPaint\saved\". - macOS - Inside the user's "Library" folder, e.g.: - "/Users/username/Library/Application Support/Tux Paint/saved/". +macOS + Inside the user's "Library" folder, e.g.: "/Users/username/Library/ + Application Support/Tux Paint/saved/". - Linux/Unix - Inside a hidden ".tuxpaint" directory, in the user's home - directory ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". +Linux/Unix + Inside a hidden ".tuxpaint" directory, in the user's home directory + ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". - 💡 Note: It is also from this folder that you can copy or open pictures - drawn in Tux Paint using other applications, though the 'Export' option - from Tux Paint's 'Open' dialog can be used to copy them to a location - that's easier and safer to access. + +💡 Note: It is also from this folder that you can copy or open pictures drawn in +Tux Paint using other applications, though the 'Export' option from Tux Paint's +'Open' dialog can be used to copy them to a location that's easier and safer to +access. B. Using the import script, "tuxpaint-import" - Linux and Unix users can use the "tuxpaint-import" shell script which gets - installed when you install Tux Paint. It uses some NetPBM tools to convert - the image ("anytopnm"), resize it so that it will fit in Tux Paint's - canvas ("pnmscale"), and convert it to a PNG ("pnmtopng"). +Linux and Unix users can use the "tuxpaint-import" shell script which gets +installed when you install Tux Paint. It uses some NetPBM tools to convert the +image ("anytopnm"), resize it so that it will fit in Tux Paint's canvas +("pnmscale"), and convert it to a PNG ("pnmtopng"). - It also uses the "date" command to get the current time and date, which is - the file-naming convention Tux Paint uses for saved files. (Remember, you - are never asked for a 'filename' when you go to save or open pictures!) +It also uses the "date" command to get the current time and date, which is the +file-naming convention Tux Paint uses for saved files. (Remember, you are never +asked for a 'filename' when you go to save or open pictures!) - To use this script, simply run it from a command-line prompt, and provide - it the name(s) of the file(s) you wish to convert. +To use this script, simply run it from a command-line prompt, and provide it +the name(s) of the file(s) you wish to convert. - They will be converted and placed in your Tux Paint "saved" directory. +They will be converted and placed in your Tux Paint "saved" directory. - 💡 Note: If you're doing this for a different user (e.g., your child) - you'll need to make sure to run the command under their account.) +💡 Note: If you're doing this for a different user (e.g., your child) you'll +need to make sure to run the command under their account.) - Example: +Example: - $ tuxpaint-import grandma.jpg - grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import grandma.jpg + grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - The first line ("tuxpaint-import grandma.jpg") is the command to run. The - following two lines are output from the program while it's working. +The first line ("tuxpaint-import grandma.jpg") is the command to run. The +following two lines are output from the program while it's working. - Now you can load Tux Paint, and a version of that original picture will be - available under the 'Open' dialog. Just double-click its icon! +Now you can load Tux Paint, and a version of that original picture will be +available under the 'Open' dialog. Just double-click its icon! C. Importing Pictures Manually - Windows, macOS, and Haiku users who wish to import arbitrary images into - Tux Paint must do so via a manual process. +Windows, macOS, and Haiku users who wish to import arbitrary images into Tux +Paint must do so via a manual process. - Load a graphics program that is capable of both loading your picture and - saving a PNG format file. (See the documentation file "PNG.html" for a - list of suggested software, and other references.) +Load a graphics program that is capable of both loading your picture and saving +a PNG format file. (See the documentation file "PNG.html" for a list of +suggested software, and other references.) - When Tux Paint loads an image that's not the same size as its drawing - canvas, it scales (and sometimes smears the edges of) the image so that it - fits within the canvas. +When Tux Paint loads an image that's not the same size as its drawing canvas, +it scales (and sometimes smears the edges of) the image so that it fits within +the canvas. - To avoid having the image stretched or smeared, you can resize it to Tux - Paint's canvas size. This size depends on the size of the Tux Paint - window, or resolution at which Tux Paint is run, if in fullscreen. (Note: - The default resolution is 800x600.) See "Calculating Image Dimensions", - below. +To avoid having the image stretched or smeared, you can resize it to Tux +Paint's canvas size. This size depends on the size of the Tux Paint window, or +resolution at which Tux Paint is run, if in fullscreen. (Note: The default +resolution is 800x600.) See "Calculating Image Dimensions", below. - 1. Naming the File +1. Naming the File - Save the picture in PNG format. It is highly recommended that you name the - filename using the current date and time, since that's the convention Tux - Paint uses: +Save the picture in PNG format. It is highly recommended that you name the +filename using the current date and time, since that's the convention Tux Paint +uses: - YYYYMMDDhhmmss.png + YYYYMMDDhhmmss.png - * YYYY = Year - * MM = Month (two digits, "01"-"12") - * DD = Day of month (two digits, "01"-"31") - * HH = Hour (two digits, in 24-hour format, "00"-"23") - * mm = Minute (two digits, "00"-"59") - * ss = Seconds (two digits, "00"-"59") + * YYYY = Year + * MM = Month (two digits, "01"-"12") + * DD = Day of month (two digits, "01"-"31") + * HH = Hour (two digits, in 24-hour format, "00"-"23") + * mm = Minute (two digits, "00"-"59") + * ss = Seconds (two digits, "00"-"59") - Example: "20210731110500.png", for July 31, 2021 at 11:05am. +Example: "20210731110500.png", for July 31, 2021 at 11:05am. - Place this PNG file in your Tux Paint "saved" directory/folder. (See - above.) +Place this PNG file in your Tux Paint "saved" directory/folder. (See above.) - 2. Calculating Image Dimensions +2. Calculating Image Dimensions - This part of the documentation needs to be rewritten, since the new - "buttonsize" option was added. For now, try drawing and saving an image - within Tux Paint, then determine what size (pixel width and height) it - came out to, and try to match that when scaling the picture(s) you're - importing into Tux Paint. +This part of the documentation needs to be rewritten, since the new +"buttonsize" option was added. For now, try drawing and saving an image within +Tux Paint, then determine what size (pixel width and height) it came out to, +and try to match that when scaling the picture(s) you're importing into Tux +Paint. - IV.Further Reading +IV.Further Reading - Other documentation included with Tux Paint (found in the "docs" - folder/directory) includes: +Other documentation included with Tux Paint (found in the "docs" folder/ +directory) includes: - Using Tux Paint: - * OPTIONS.html - Detailed instructions on command-line and configuration-file - options, for those who don't want to use the Tux Paint - Config. tool to manage Tux Paint's configuration. - * 'Magic' Tool Documentation ("magic-docs") - Documentation for each of the currently-installed 'Magic' - tools. +Using Tux Paint: + + OPTIONS.html + Detailed instructions on command-line and configuration-file options, + for those who don't want to use the Tux Paint Config. tool to manage + Tux Paint's configuration. + + 'Magic' Tool Documentation ("magic-docs") + Documentation for each of the currently-installed 'Magic' tools. - How to extend Tux Paint: - * EXTENDING.html - Detailed instructions on extending Tux Paint: creating - brushes, stamps, starters, and templates; adding fonts; and - creating new on-screen keyboard layouts and input methods. - * PNG.html - Notes on creating PNG format bitmapped (raster) images for - use in Tux Paint. - * SVG.html - Notes on creating SVG format vector images for use in Tux - Paint. - Technical information: - * INSTALL.html - Instructions for compiling and installing Tux Paint, when - applicable. - * SIGNALS.html - Information about the POSIX signals that Tux Paint responds - to. - * MAGIC-API.html - Creating new Magic tools using Tux Paint's plugin API. +How to extend Tux Paint: + + EXTENDING.html + Detailed instructions on extending Tux Paint: creating brushes, stamps, + starters, and templates; adding fonts; and creating new on-screen + keyboard layouts and input methods. + + PNG.html + Notes on creating PNG format bitmapped (raster) images for use in Tux + Paint. + + SVG.html + Notes on creating SVG format vector images for use in Tux Paint. - Development history and license: - * AUTHORS.txt - List of authors and contributors. - * CHANGES.txt - Summary of what has changed between releases of Tux Paint. - * COPYING.txt - Tux Paint's software license, the GNU General Public License - (GPL) - V.How to Get Help +Technical information: + + INSTALL.html + Instructions for compiling and installing Tux Paint, when applicable. + + SIGNALS.html + Information about the POSIX signals that Tux Paint responds to. + + MAGIC-API.html + Creating new Magic tools using Tux Paint's plugin API. - If you need help, there are numerous ways to interact with Tux Paint - developers and other users: - * Report bugs or request new features via the project's bug-tracking - system - * Participate in the various project mailing lists - * Contact the developers directly - To learn more, visit the "Contact" page of the official Tux Paint website: - https://tuxpaint.org/contact/ +Development history and license: + + AUTHORS.txt + List of authors and contributors. + + CHANGES.txt + Summary of what has changed between releases of Tux Paint. + + COPYING.txt + Tux Paint's software license, the GNU General Public License (GPL) - VI.How to Participate - Tux Paint is a volunteer-driven project, and we're happy to accept your - help in a variety of ways: - * Translate Tux Paint to another language - * Improve existing translations - * Create artwork (stamps, starters, templates, brushes) - * Add or improve features or magic tools - * Create classroom curriculum - * Promote or help support others using Tux Paint - To learn more, visit the "Help Us" page of the official Tux Paint website: - https://tuxpaint.org/help/ +V.How to Get Help - VII.Follow the Tux Paint project on social media +If you need help, there are numerous ways to interact with Tux Paint developers +and other users: - Tux Paint maintains a presence on a variety of social media networks, - where we post updates and artwork. - * Join the Tux Paint page on Facebook - * Follow @TuxPaintDevs on Instagram - * Follow @tuxpaint@floss.social on Mastodon - * Follow u/TuxPaintDevs on Reddit - * Follow @TuxPaintDevs on Threads - * Follow Tux Paint on Tumblr - * Follow @TuxPaintTweets on Twitter + * Report bugs or request new features via the project's bug-tracking system + * Participate in the various project mailing lists + * Contact the developers directly - VIII. Trademark notices +To learn more, visit the "Contact" page of the official Tux Paint website: +https://tuxpaint.org/contact/ + +VI.How to Participate + +Tux Paint is a volunteer-driven project, and we're happy to accept your help in +a variety of ways: + + * Translate Tux Paint to another language + * Improve existing translations + * Create artwork (stamps, starters, templates, brushes) + * Add or improve features or magic tools + * Create classroom curriculum + * Promote or help support others using Tux Paint + +To learn more, visit the "Help Us" page of the official Tux Paint website: +https://tuxpaint.org/help/ + +VII.Follow the Tux Paint project on social media + +Tux Paint maintains a presence on a variety of social media networks, where we +post updates and artwork. + + * Join the Tux Paint page on Facebook + * Follow @TuxPaintDevs on Instagram + * Follow @tuxpaint@floss.social on Mastodon + * Follow u/TuxPaintDevs on Reddit + * Follow @TuxPaintDevs on Threads + * Follow Tux Paint on Tumblr + * Follow @TuxPaintTweets on Twitter + +VIII. Trademark notices + + * "Linux" is a registered trademark of Linus Torvalds. + * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. + * "Apple" and "macOS" are registered trademarks of Apple Inc. + * "Facebook", "Instagram", and "Threads" are registered trademarks of Meta + Platforms, Inc. + * "Mastodon" is a registered trademark of Mastodon gGmbH. + * "Reddit" is a registered trademark of Reddit, Inc. + * "Tumblr" is a registered trademark of Tumblr, Inc. + * "Twitter" is a registered trademark of X Corp. - * "Linux" is a registered trademark of Linus Torvalds. - * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. - * "Apple" and "macOS" are registered trademarks of Apple Inc. - * "Facebook", "Instagram", and "Threads" are registered trademarks of - Meta Platforms, Inc. - * "Mastodon" is a registered trademark of Mastodon gGmbH. - * "Reddit" is a registered trademark of Reddit, Inc. - * "Tumblr" is a registered trademark of Tumblr, Inc. - * "Twitter" is a registered trademark of X Corp. diff --git a/docs/en/SIGNALS.txt b/docs/en/SIGNALS.txt index d9c296c39..054856678 100644 --- a/docs/en/SIGNALS.txt +++ b/docs/en/SIGNALS.txt @@ -1,53 +1,57 @@ Tux Paint - version 0.9.31 + version 0.9.31 Signals Documentation Copyright © 2019-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - June 4, 2022 + June 4, 2022 - Tux Paint responds to the following signals (which can be sent to the - program's process via `kill` or `killall`, for example). +Tux Paint responds to the following signals (which can be sent to the program's +process via `kill` or `killall`, for example). - SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) +SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) - Tux Paint responds as if the "Quit" button were pressed, or the - desktop environment was told to close Tux Paint (e.g., by clicking - a window close button, or pressing [Alt] + [F4] on most systems). + Tux Paint responds as if the "Quit" button were pressed, or the desktop + environment was told to close Tux Paint (e.g., by clicking a window close + button, or pressing [Alt] + [F4] on most systems). - From the main interface, Tux Paint will prompt whether or not you - wish to quit, and (unless overridden by the auto-save option, e.g. - "--autosave") if you'd like to save the current drawing (if - unsaved), and if so, and it's a modified version of an existing - drawing (unless overridden by the options to save over old images, - or always save new images; e.g. "--saveover" and "--saveovernew", - respectively), whether or not to overwrite the existing drawing, - or save to a new file. + From the main interface, Tux Paint will prompt whether or not you wish to + quit, and (unless overridden by the auto-save option, e.g. "--autosave") if + you'd like to save the current drawing (if unsaved), and if so, and it's a + modified version of an existing drawing (unless overridden by the options + to save over old images, or always save new images; e.g. "--saveover" and + "--saveovernew", respectively), whether or not to overwrite the existing + drawing, or save to a new file. - Example: killall tuxpaint + Example: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint responds by setting its auto-save option (as if it had - been launched with "--autosave"), as well as either the option to - always save new images (as if launched with "--saveovernew") in - the case of receiving a SIGUSR1 signal, or to always save over the - existing image (as if launched with "--saveover") in the case of - receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, - in an attempt to quit. (See above.) - So, from the main interface, Tux Paint should quit almost - immediately, with no questions asked. +SIGUSR1 & SIGUSR2 + + Tux Paint responds by setting its auto-save option (as if it had been + launched with "--autosave"), as well as either the option to always save + new images (as if launched with "--saveovernew") in the case of receiving a + SIGUSR1 signal, or to always save over the existing image (as if launched + with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends + itself a SIGTERM signal, in an attempt to quit. (See above.) + + So, from the main interface, Tux Paint should quit almost immediately, with + no questions asked. + + Example: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - Example: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/en/SVG.txt b/docs/en/SVG.txt index 91d93c0c1..b9a394282 100644 --- a/docs/en/SVG.txt +++ b/docs/en/SVG.txt @@ -1,36 +1,37 @@ Tux Paint - version 0.9.31 + version 0.9.31 SVG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - June 4, 2022 + June 4, 2022 - About SVGs +About SVGs - SVG (Scalable Vector Graphics) is an open standard used to describe - two-dimensional vector graphics. It is great for diagrams and shapes, - while PNGs are better for photographs. SVG files are a bit like - instructions on how to make an image. This means that they can be resized - without looking pixelated or blocky. +SVG (Scalable Vector Graphics) is an open standard used to describe +two-dimensional vector graphics. It is great for diagrams and shapes, while +PNGs are better for photographs. SVG files are a bit like instructions on how +to make an image. This means that they can be resized without looking pixelated +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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/en/tuxpaint-quickstart-guide.txt b/docs/en/tuxpaint-quickstart-guide.txt index 37e9af2f1..46517dc41 100644 --- a/docs/en/tuxpaint-quickstart-guide.txt +++ b/docs/en/tuxpaint-quickstart-guide.txt @@ -1,215 +1,210 @@ - Tux Paint 0.9.29 Quickstart Guide +Tux Paint 0.9.29 Quickstart Guide Tools (Drawing) - 🖌Paint +🖌Paint - * Choose a brush on the right. - * Some brushes are animated 🎞, some are directional ✲, some are both. - * Change brush spacing with the bars 📶 at the bottom right. - * Choose a color (see "Colors"). - * Click/tap and drag in the canvas to paint. + * Choose a brush on the right. + * Some brushes are animated 🎞, some are directional ✲, some are both. + * Change brush spacing with the bars 📶 at the bottom right. + * Choose a color (see "Colors"). + * Click/tap and drag in the canvas to paint. - ⌧Stamps +⌧Stamps - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Choose a stamp on the right. - * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near - the bottom right. - * Some stamps allow you to choose their color (see "Colors"). - * Change stamp size with the bars 📶 at the bottom right. - * Rotation ⟳ may be enabled, if desired. - * Click/tap in the canvas to place a stamp. - * If rotation is enabled, drag to rotate it, and click/tap again to - add it to the drawing. - * Some stamps play sound effects; press the speaker 🕪 button to hear it - again. - * Some stamps play descriptive sounds; press the headphones 🎧 button to - hear it again. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Choose a stamp on the right. + * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the + bottom right. + * Some stamps allow you to choose their color (see "Colors"). + * Change stamp size with the bars 📶 at the bottom right. + * Rotation ⟳ may be enabled, if desired. + * Click/tap in the canvas to place a stamp. + + If rotation is enabled, drag to rotate it, and click/tap again to add + it to the drawing. + * Some stamps play sound effects; press the speaker 🕪 button to hear it + again. + * Some stamps play descriptive sounds; press the headphones 🎧 button to hear + it again. - ⚟Lines +⚟Lines - * (See Paint) - * Click/tap and drag to draw a line. + * (See Paint) + * Click/tap and drag to draw a line. - ⭓Shapes +⭓Shapes - * Choose a shape on the right. - * Select whether you want to extend the shape from the center ⧈, or a - corner ◰, using controls at the bottom right. - * 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. + * Choose a shape on the right. + * Select whether you want to extend the shape from the center ⧈, or a corner + ◰, using controls at the bottom right. + * Click/tap to position, and drag to set the size of the shape. + * Drag to rotate it, and click/tap again to add it to the drawing. - 🄰Text +🄰Text - * Choose a font on the right. - * Select whether you want the text bold 𝗔 and/or italic 𝘈, using - controls near the bottom right. - * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom - right. - * Choose a color (see "Colors"). - * Click/tap the canvas to position an insertion cursor. - * Enter text via your keyboard or the on-screen keyboard. - * 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 - and begin entering more text one line down. - * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and - continue entering more text immediately to the right. - * Using the on-screen keyboard: - * "Cmp" can be used to compose characters, e.g. Cmp ' a results in - á. - * "AltGr" can be used to quickly access more characters. - * Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. - "ABC") + * Choose a font on the right. + * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls + near the bottom right. + * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom + right. + * Choose a color (see "Colors"). + * Click/tap the canvas to position an insertion cursor. + * Enter text via your keyboard or the on-screen keyboard. + * 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 and + begin entering more text one line down. + * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and + continue entering more text immediately to the right. + * Using the on-screen keyboard: + + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á. + + "AltGr" can be used to quickly access more characters. + + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC") - 🅰Label +🅰Label - * (See Text) - * Labels float 'above' the drawing; you cannot paint or stamp over them, - apply Magic effects, etc. - * Labels may be edited, repositioned, and styled after they've been - added to the drawing. - * Click/tap the ☝ button near the lower right to choose a label. - Click/tap the label you wish to modify, then click/tap somewhere else - in the canvas to reposition, or change the font/style, change color, - and/or type to edit the text. - * Or, use the 🖑 button near the lower right to "flatten" a label, - applying it to the canvas; it may no longer be edited with the Label - tool. + * (See Text) + * Labels float 'above' the drawing; you cannot paint or stamp over them, + apply Magic effects, etc. + * Labels may be edited, repositioned, and styled after they've been added to + the drawing. + * Click/tap the ☝ button near the lower right to choose a label. Click/tap + the label you wish to modify, then click/tap somewhere else in the canvas + to reposition, or change the font/style, change color, and/or type to edit + the text. + * Or, use the 🖑 button near the lower right to "flatten" a label, applying it + to the canvas; it may no longer be edited with the Label tool. - 🪣Fill +🪣Fill - * Choose a fill mode on the right. - * Choose a color (see "Colors"). - * Click/tap (and drag, with Brush and Linear modes) to fill an area of - the picture with a color. - * Solid - Flood-fills an area with a solid color - * Brush - Paints with a solid color, without drawing outside the - chosen area - * Linear - Fills the area with a linear gradient (drag to choose - angle and gradient) - * Radial - Fills the area with a radial gradient, centered where - you clicked/tapped - * Shaped - Fills the area with a gradient that follows the contours - of the area being filled + * Choose a fill mode on the right. + * Choose a color (see "Colors"). + * Click/tap (and drag, with Brush and Linear modes) to fill an area of the + picture with a color. + + Solid - Flood-fills an area with a solid color + + Brush - Paints with a solid color, without drawing outside the chosen + area + + Linear - Fills the area with a linear gradient (drag to choose angle + and gradient) + + Radial - Fills the area with a radial gradient, centered where you + clicked/tapped + + Shaped - Fills the area with a gradient that follows the contours of + the area being filled - 🪄Magic +🪄Magic - * Choose a magic tool on the right. - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some - affect the entire drawing 🖻🪄, and some offer both options; use the - controls at the bottom right. - * Some magic tools offer various sizes; change it with the bars 📶 at the - bottom right. - * Some magic tools allow you to choose their color. + * Choose a magic tool on the right. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some + affect the entire drawing 🖻🪄, and some offer both options; use the controls + at the bottom right. + * Some magic tools offer various sizes; change it with the bars 📶 at the + bottom right. + * Some magic tools allow you to choose their color. - 🖓Undo +🖓Undo - * Use to undo the most recent changes (multiple undo available). - * Shortcut: [Ctrl]+[Z] + * Use to undo the most recent changes (multiple undo available). + * Shortcut: [Ctrl]+[Z] - 🖒Redo +🖒Redo - * Use to redo the most recent undone change (multiple redo available). - * Shortcut: [Ctrl]+[R] + * Use to redo the most recent undone change (multiple redo available). + * Shortcut: [Ctrl]+[R] - ◪Eraser +◪Eraser - * Choose the size and shape of the eraser on the right. - * Click/tap and drag to erase parts of the picture (solid color, or - starter or template image). - * Shortcut: [X] and click/tap in the drawing (not always available) + * Choose the size and shape of the eraser on the right. + * Click/tap and drag to erase parts of the picture (solid color, or starter + or template image). + * Shortcut: [X] and click/tap in the drawing (not always available) Tools (Controls) - 🗏New +🗏New - * Choose a solid color, starter, or template image to start with. - * Starters allow drawing "under" a picture (e.g., a coloring book - outline), sometimes with a background layer, too. - * Templates are pictures to start with (background only). - * Eraser tool ◪ reveals the solid color, or starter/template - background. - * Click/tap "🕮⮫Open" to begin a new drawing. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Shortcut: [Ctrl]+[N] + * Choose a solid color, starter, or template image to start with. + + Starters allow drawing "under" a picture (e.g., a coloring book + outline), sometimes with a background layer, too. + + Templates are pictures to start with (background only). + + Eraser tool ◪ reveals the solid color, or starter/template background. + * Click/tap "🕮⮫Open" to begin a new drawing. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Shortcut: [Ctrl]+[N] - 🕮⮫Open +🕮⮫Open - * Choose a previously-saved drawing to open (or export or erase). - * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. - * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" - folder. - * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle - Bin. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Click/tap "📽Slides" to switch to slideshow mode: - * Click/tap two or more of your previously-saved drawings, in the - order you want them shown. Numbers will appear on them. - * Choose the playback speed using the bars 📶 near the lower left. - * Click/tap "⯈Play" to watch the slideshow/animation. - * Or, click/tap "🎞GIF Export" to save an animated GIF of the - animation to your system's "Pictures" folder. - * Click/tap "⤺Back" to return to the Open dialog. - * Shortcut: [Ctrl]+[O] + * Choose a previously-saved drawing to open (or export or erase). + * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. + * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" + folder. + * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Click/tap "📽Slides" to switch to slideshow mode: + + Click/tap two or more of your previously-saved drawings, in the order + you want them shown. Numbers will appear on them. + + Choose the playback speed using the bars 📶 near the lower left. + + Click/tap "⯈Play" to watch the slideshow/animation. + + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to + your system's "Pictures" folder. + + Click/tap "⤺Back" to return to the Open dialog. + * Shortcut: [Ctrl]+[O] - 🕮⮪Save +🕮⮪Save - * Click/tap to save your drawing. - * If you've saved previously, you'll be prompted whether to overwrite - the previously-saved drawing (a la "File→Save") or create a new saved - drawing (a la "File→Save As...") - * Shortcut: [Ctrl]+[S] + * Click/tap to save your drawing. + * If you've saved previously, you'll be prompted whether to overwrite the + previously-saved drawing (a la "File→Save") or create a new saved drawing + (a la "File→Save As...") + * Shortcut: [Ctrl]+[S] - 🖶Print +🖶Print - * Click/tap to print your drawing. - * Hold [Alt] or [Option] while clicking/tapping to bring up printer - dialog, if available. - * Shortcut: [Ctrl]+[P] + * Click/tap to print your drawing. + * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog, + if available. + * Shortcut: [Ctrl]+[P] - 🗙Quit +🗙Quit - * Click/tap to quit Tux Paint. - * Shortcut: [Esc] + * Click/tap to quit Tux Paint. + * Shortcut: [Esc] Colors - * Click/tap to choose a color to use with the Paint, Lines, and Shapes - tools, and Stamps and Magic tools that support colors. - * Use the pipette / color picker 💉 button to choose a color from a pixel - in your current drawing. - * Shortcut: When colors are available, press [Ctrl] and click/tap - in your drawing, to quickly pick a color from your drawing. - * Click/tap the rainbow 🌈 button to choose a arbitrary color. - * Click/tap in the rainbow square to pick a color (hue and - saturation). - * Click/tap in the grey gradient bar to adjust brightness (value). - * Click/tap the green checkbox ✓ to accept. - * Click/tap "⤺Back" to abort and dismiss the palette. - * You may grab the currently-chosen built-in color (if any), the - color in the pipette / color picker, or the color in the color - mixer, by clicking one of the colored arrow ⇫ buttons. - * Click/tap the paint palette 🎨 button to create a color by mixing - primary colors: red, yellow, and blue, and white (tint), grey (tone), - and black (shade). - * Click/tap the green checkbox ✓ to accept. - * Color mixing offers its own 🖓Undo and 🖒Redo options. - * Click/tap "🗑Clear" to start over with no mixed colors. - * Click/tap "⤺Back" to abort and dismiss the color mixer. + * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools, + and Stamps and Magic tools that support colors. + * Use the pipette / color picker 💉 button to choose a color from a pixel in + your current drawing. + + Shortcut: When colors are available, press [Ctrl] and click/tap in your + drawing, to quickly pick a color from your drawing. + * Click/tap the rainbow 🌈 button to choose a arbitrary color. + + Click/tap in the rainbow square to pick a color (hue and saturation). + + Click/tap in the grey gradient bar to adjust brightness (value). + + Click/tap the green checkbox ✓ to accept. + + Click/tap "⤺Back" to abort and dismiss the palette. + + You may grab the currently-chosen built-in color (if any), the color in + the pipette / color picker, or the color in the color mixer, by + clicking one of the colored arrow ⇫ buttons. + * Click/tap the paint palette 🎨 button to create a color by mixing primary + colors: red, yellow, and blue, and white (tint), grey (tone), and black + (shade). + + Click/tap the green checkbox ✓ to accept. + + Color mixing offers its own 🖓Undo and 🖒Redo options. + + Click/tap "🗑Clear" to start over with no mixed colors. + + Click/tap "⤺Back" to abort and dismiss the color mixer. Shortcuts while drawing: - * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access - * [X]+Click/tap - Quick eraser ◪ access - * [Ctrl]+[Z] - 🖓Undo - * [Ctrl]+[R] - 🖒Redo - * [Ctrl]+[N] - 🗏New - * [Ctrl]+[O] - 🕮⮫Open - * [Ctrl]+[S] - 🕮⮪Save - * [Ctrl]+[P] - 🖶Print - * [Alt]+[S] - Toggle sound effects on/off - * [Esc] - ⤺Back or 🗙Quit + * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access + * [X]+Click/tap - Quick eraser ◪ access + * [Ctrl]+[Z] - 🖓Undo + * [Ctrl]+[R] - 🖒Redo + * [Ctrl]+[N] - 🗏New + * [Ctrl]+[O] - 🕮⮫Open + * [Ctrl]+[S] - 🕮⮪Save + * [Ctrl]+[P] - 🖶Print + * [Alt]+[S] - Toggle sound effects on/off + * [Esc] - ⤺Back or 🗙Quit + +Last updated: May 9, 2023 - Last updated: May 9, 2023 diff --git a/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt index 98f6ba13b..3c1b9bac3 100644 --- a/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/es_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt @@ -1,296 +1,287 @@ Tux Paint versión 0.9.31 Advanced Stamps 'How-To' - Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. + Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. https://tuxpaint.org/ junio 4, 2022 - ---------------------------------------------------------------------- - - +----------------------------------------+ - |Table of Contents | - |----------------------------------------| - | * About this 'How-To' | - | * Image choice is crucial | - | * Prepare the mask | - | * Replace the fringe and junk pixels | - | * Save the image for Tux Paint | - +----------------------------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++----------------------------------------+ +| Table of Contents | +|----------------------------------------| +| * About this 'How-To' | +| * Image choice is crucial | +| * Prepare the mask | +| * Replace the fringe and junk pixels | +| * Save the image for Tux Paint | ++----------------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- About this 'How-To' - This 'How-To' assumes that you want to make an excellent Tux Paint - stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital - photograph). There are easier and faster methods that produce lower - quality. + This 'How-To' assumes that you want to make an excellent Tux Paint stamp, + in PNG bitmapped format, from a JPEG image (e.g., a digital photograph). + There are easier and faster methods that produce lower quality. - This 'How-To' assumes you are dealing with normal opaque objects. - Dealing with semi-transparent objects (fire, moving fan blade, kid's - balloon) or light-giving objects (fire, lightbulb, sun) is best done - with custom software. Images with perfect solid-color backgrounds are - also best done with custom software, but are not troublesome to do as - follows. + This 'How-To' assumes you are dealing with normal opaque objects. Dealing + with semi-transparent objects (fire, moving fan blade, kid's balloon) or + light-giving objects (fire, lightbulb, sun) is best done with custom + software. Images with perfect solid-color backgrounds are also best done + with custom software, but are not troublesome to do as follows. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Image choice is crucial - License + License - If you wish to submit artwork to the Tux Paint developers for - consideration for inclusion in the official project, or if you wish to - release your own copy of Tux Paint, bundled with your own graphics, - you need an image that is compatible with the GNU General Public - License used by Tux Paint. + If you wish to submit artwork to the Tux Paint developers for + consideration for inclusion in the official project, or if you wish to + release your own copy of Tux Paint, bundled with your own graphics, you + need an image that is compatible with the GNU General Public License + used by Tux Paint. - Images produced by the US government are Public Domain, but be aware - that the US government sometimes uses other images on the web. Google - image queries including either site:gov or site:mil will supply many - suitable images. (Note: the *.mil sites include non-military content, - too!) + Images produced by the US government are Public Domain, but be aware + that the US government sometimes uses other images on the web. Google + image queries including either site:gov or site:mil will supply many + suitable images. (Note: the *.mil sites include non-military content, + too!) - Your own images can be placed in the Public Domain or a suitable - license, such as the Creative Commons CC0 by declaring it so. (Hire a - lawyer if you feel the need for legal advice.) + Your own images can be placed in the Public Domain or a suitable + license, such as the Creative Commons CC0 by declaring it so. (Hire a + lawyer if you feel the need for legal advice.) - For personal use, any image you can legitimately modify and use for - your own personal use should be fine. + For personal use, any image you can legitimately modify and use for + your own personal use should be fine. - Image Size and Orientation + Image Size and Orientation - You need an image that has a useful orientation. Perspective is an - enemy. Images that show an object from the corner are difficult to fit - into a nice drawing. As a general rule, telephoto side views are the - best. The impossible ideal is that, for example, two wheels of a car - are perfectly hidden behind the other two. + You need an image that has a useful orientation. Perspective is an + enemy. Images that show an object from the corner are difficult to fit + into a nice drawing. As a general rule, telephoto side views are the + best. The impossible ideal is that, for example, two wheels of a car + are perfectly hidden behind the other two. - 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 - need lots of rotation (30 to 60 degrees) are next best, and images - that need just a few degrees are worst. Rotation will also make an - image darker because most image editing software is very bad about - gamma handling. (Rotation is only legitimate for gamma=1.0 images.) + 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 + need lots of rotation (30 to 60 degrees) are next best, and images that + need just a few degrees are worst. Rotation will also make an image + darker because most image editing software is very bad about gamma + handling. (Rotation is only legitimate for gamma=1.0 images.) - 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 - across if you can. You can shrink this later to hide your mistakes. + 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 + across if you can. You can shrink this later to hide your mistakes. - 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 - will need to draw new ones. If only one is buried, you might be able - to copy the other one as a replacement. + 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 to + copy the other one as a replacement. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the image - First of all, be sure to avoid re-saving the image as a JPEG. This - causes quality loss. There is a special tool called jpegtran that lets - you crop an image without the normal quality loss. + First of all, be sure to avoid re-saving the image as a JPEG. This causes + quality loss. There is a special tool called jpegtran that lets you crop an + image without the normal quality loss. - jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - 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 - as needed. Save the image — choose whatever native format supports - layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe - Photoshop users should choose "PSD", for example. + 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 as + needed. Save the image — choose whatever native format supports layers, + masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop + users should choose "PSD", for example. - If you have rotated or cropped the image in your image editor, flatten - it now. You need to have just one RGB layer without mask or alpha. + If you have rotated or cropped the image in your image editor, flatten it + 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 - top to bottom you will need something like this: + Open the layers dialog box. Replicate the one layer several times. From top + to bottom you will need something like this: - 1. unmodified image (write-protect this if you can) - 2. an image you will modify — the "work in progress" layer - 3. solid green (write-protect this if you can) - 4. solid magenta (write-protect this if you can) - 5. 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 + 3. solid green (write-protect this if you can) + 4. solid magenta (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 - start with a selection, or by using the grayscale value of the WIP - layer. You might invert the mask. + Give the work in progress (WIP) layer a rough initial mask. You might start + with a selection, or by using the grayscale value of the WIP layer. You + might invert the mask. - 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 - instructions later. + 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 + instructions later. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the mask - Get used to doing [Control]-click and [Alt]-click on the thumbnail - images in the layers dialog. You will need this to control what you are - looking at and what you are editing. Sometimes you will be editing - things you can't see. For example, you might edit the mask of the WIP - layer while looking at the unmodified image. Pay attention so you don't - screw up. Always verify that you are editing the right thing. + Get used to doing [Control]-click and [Alt]-click on the thumbnail images + in the layers dialog. You will need this to control what you are looking at + and what you are editing. Sometimes you will be editing things you can't + see. For example, you might edit the mask of the WIP layer while looking at + the unmodified image. Pay attention so you don't screw up. Always verify + that you are editing the right thing. - Set an unmodified image as what you will view (the top one is easiest). - Set the WIP mask as what you will edit. At some point, perhaps not - immediately, you should magnify the image to about 400% (each pixel of - the image is seen and edited as a 4x4 block of pixels on your screen). + Set an unmodified image as what you will view (the top one is easiest). Set + the WIP mask as what you will edit. At some point, perhaps not immediately, + you should magnify the image to about 400% (each pixel of the image is seen + 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 - you can select the object or background somewhat accurately by color, do - so. As needed to avoid selecting any pixels that should be partially - opaque (generally at the edge of the object) you should grow, shrink, - and invert the selection. + Select parts of the image that need to be 100% opaque or 0% opaque. If you + can select the object or background somewhat accurately by color, do so. As + needed to avoid selecting any pixels that should be partially opaque + (generally at the edge of the object) you should grow, shrink, and invert + the selection. - Fill the 100% opaque areas with white, and the 0% opaque areas with - black. This is most easily done by drag-and-drop from the - foreground/background color indicator. You should not see anything - happen, because you are viewing the unmodified image layer while editing - the mask of the WIP layer. Large changes might be noticable in the - thumbnail. + Fill the 100% opaque areas with white, and the 0% opaque areas with black. + This is most easily done by drag-and-drop from the foreground/background + color indicator. You should not see anything happen, because you are + viewing the unmodified image layer while editing the mask of the WIP layer. + Large changes might be noticable in the 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 - mask, which should be a white object on a black background (probably - with unedited grey at the edge). Now display the WIP layer normally, so - that the mask is active. This should show your object over top of the - next highest enabled layer, which should be green or magenta as needed - for maximum contrast. You might wish to flip back and forth between - those backgrounds by repeatedly clicking to enable/disable the green - layer. Fix any obvious and easy problems by editing the mask while - viewing the mask. + Check your work. Hide the top unmodified image layer. Display just the + mask, which should be a white object on a black background (probably with + unedited grey at the edge). Now display the WIP layer normally, so that the + mask is active. This should show your object over top of the next highest + enabled layer, which should be green or magenta as needed for maximum + contrast. You might wish to flip back and forth between those backgrounds + by repeatedly clicking to enable/disable the green layer. Fix any obvious + and easy problems by editing the mask while viewing the mask. - Go back to viewing the top unmodified layer while editing the WIP mask. - Set your drawing tool the paintbrush. For the brush, choose a small - fuzzy circle. The 5x5 size is good for most uses. + Go back to viewing the top unmodified layer while editing the WIP mask. Set + your drawing tool the paintbrush. For the brush, choose a small fuzzy + circle. The 5x5 size is good for most uses. - With a steady hand, trace around the image. Use black around the - outside, and white around the inside. Avoid making more than one pass - without switching colors (and thus sides). + With a steady hand, trace around the image. Use black around the outside, + and white around the inside. Avoid making more than one pass without + switching colors (and thus sides). - Flip views a bit, checking to see that the mask is working well. When - the WIP layer is composited over the green or magenta, you should see a - tiny bit of the original background as an ugly fringe around the edge. - If this fringe is missing, then you made the object mask too small. The - fringe consists of pixels that are neither 100% object nor 0% object. - For them, the mask should be neither 100% nor 0%. The fringe gets - removed soon. + Flip views a bit, checking to see that the mask is working well. When the + WIP layer is composited over the green or magenta, you should see a tiny + bit of the original background as an ugly fringe around the edge. If this + fringe is missing, then you made the object mask too small. The fringe + consists of pixels that are neither 100% object nor 0% object. For them, + the mask should be neither 100% nor 0%. The fringe gets removed soon. - 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 - expected color. Invert the selection, then paint these away using the - pencil tool. Do this operation for both white and black. + 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 expected + color. Invert the selection, then paint these away using the pencil tool. + Do this operation for both white and black. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Replace the fringe and junk pixels - Still viewing the mask, select by color. Choose black. Shrink the - selection by several pixels, being sure to NOT shrink from the edges of - the mask (the shrink helps you avoid and recover from mistakes). + Still viewing the mask, select by color. Choose black. Shrink the selection + by several pixels, being sure to NOT shrink from the edges of the mask (the + shrink helps you avoid and recover from mistakes). - Now disable the mask. View and edit the unmasked WIP layer. Using the - color picker tool, choose a color that is average for the object. - Drag-and-drop this color into the selection, thus removing most of the - non-object pixels. + Now disable the mask. View and edit the unmasked WIP layer. Using the color + picker tool, choose a color that is average for the object. Drag-and-drop + this color into the selection, thus removing most of the non-object pixels. - 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 - has multiple colors that are very different, you should split up your - selection so that you can color the nearby background to be similar. + 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 has + multiple colors that are very different, you should split up your selection + 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 - editing and viewing the WIP image. Frequent layer visibility changes - will help you to see what you are doing. You are likely to use all of: + Now you will paint away the existing edge fringe. Be sure that you are + editing and viewing the WIP image. Frequent layer visibility changes will + help you to see what you are doing. You are likely to use all of: - * composited over green (mask enabled) - * composited over magenta (mask enabled) - * original (the top or bottom layer) - * composited over the original (mask enabled) - * raw WIP layer (mask disabled) + + composited over green (mask enabled) + + composited over magenta (mask enabled) + + original (the top or bottom layer) + + composited over the original (mask enabled) + + raw WIP layer (mask disabled) - To reduce accidents, you may wish to select only those pixels that are - not grey in the mask. (Select by color from the mask, choose black, add - mode, choose white, invert. Alternately: Select all, select by color - from the mask, subtract mode, choose black, choose white.) If you do - this, you'll probably want to expand the selection a bit and/or hide the - "crawling ants" line that marks the selection. + To reduce accidents, you may wish to select only those pixels that are not + grey in the mask. (Select by color from the mask, choose black, add mode, + choose white, invert. Alternately: Select all, select by color from the + mask, subtract mode, choose black, choose white.) If you do this, you'll + probably want to expand the selection a bit and/or hide the "crawling ants" + line that marks the selection. - 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 - generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy - brushes with about 70% opacity.) Unusual drawing modes can be helpful - with semi-transparent objects. + 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 + generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy + brushes with about 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. - 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 - magenta or green, must be removed for obvious reasons. The outside - fringe must also be removed because it will become visible when the - image is scaled down. As an example, consider a 2x2 region of pixels at - the edge of a sharp-edged object. The left half is black and 0% opaque. - The right half is white and 100% opaque. That is, we have a white object - on a black background. When Tux Paint scales this to 50% (a 1x1 pixel - area), the result will be a grey 50% opaque pixel. The correct result - would be a white 50% opaque pixel. To get this result, we would paint - away the black pixels. They matter, despite being 0% opaque. + 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 + magenta or green, must be removed for obvious reasons. The outside fringe + must also be removed because it will become visible when the image is + scaled down. As an example, consider a 2x2 region of pixels at the edge of + a sharp-edged object. The left half is black and 0% opaque. The right half + is white and 100% opaque. That is, we have a white object on a black + background. When Tux Paint scales this to 50% (a 1x1 pixel area), the + result will be a grey 50% opaque pixel. The correct result would be a white + 50% opaque pixel. To get this result, we would paint away the black pixels. + They matter, despite being 0% opaque. - Tux Paint can scale images down by a very large factor, so it is - important to extend the edge of your object outward by a great deal. - Right at the edge of your object, you should be very accurate about - this. As you go outward away from the object, you can get a bit sloppy. - It is reasonable to paint outward by a dozen pixels or more. The farther - you go, the more Tux Paint can scale down without creating ugly color - fringes. For areas that are more than a few pixels away from the object - edge, you should use the pencil tool (or sloppy select with - drag-and-drop color) to ensure that the result will compress well. + Tux Paint can scale images down by a very large factor, so it is important + to extend the edge of your object outward by a great deal. Right at the + edge of your object, you should be very accurate about this. As you go + outward away from the object, you can get a bit sloppy. It is reasonable to + paint outward by a dozen pixels or more. The farther you go, the more Tux + Paint can scale down without creating ugly color fringes. For areas that + are more than a few pixels away from the object edge, you should use the + pencil tool (or sloppy select with drag-and-drop color) to ensure that the + result will compress well. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Save the image for Tux Paint - It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, you - can try saving your image directly as a PNG. Be sure to read it back in - again to verify that the 0% opaque areas didn't turn black or white, - which would create fringes when Tux Paint scales the image down. If you - need to scale your image to save space (and hide your mistakes), you are - almost certain to destroy all the 0% opaque areas. So here is a better - way... + It is very easy to ruin your hard work. Image editors can silently destroy + pixels in 0% opaque areas. The conditions under which this happens may vary + from version to version. If you are very trusting, you can try saving your + image directly as a PNG. Be sure to read it back in again to verify that + the 0% opaque areas didn't turn black or white, which would create fringes + when Tux Paint scales the image down. If you need to scale your image to + save space (and hide your mistakes), you are almost certain to destroy all + the 0% opaque areas. So here is a better way... - A Safer Way to Save + A Safer Way to Save - Drag the mask from the layers dialog to the unused portion of the - toolbar (right after the last drawing tool). This will create a new - image consisting of one layer that contains the mask data. Scale this - as desired, remembering the settings you use. Often you should start - with an image that is about 700 to 1500 pixels across, and end up with - one that is 300 to 400. + Drag the mask from the layers dialog to the unused portion of the + toolbar (right after the last drawing tool). This will create a new + image consisting of one layer that contains the mask data. Scale this + as desired, remembering the settings you use. Often you should start + with an image that is about 700 to 1500 pixels across, and end up with + one that is 300 to 400. - Save the mask image as a NetPBM portable greymap (".pgm") file. (If - you are using an old release of The GIMP, you might need to convert - the image to greyscale before you can save it.) Choose the more - compact "RAW PGM" format. (The second character of the file should be - the ASCII digit "5", hex byte 0x35.) + Save the mask image as a NetPBM portable greymap (".pgm") file. (If you + are using an old release of The GIMP, you might need to convert the + image to greyscale before you can save it.) Choose the more compact + "RAW PGM" format. (The second character of the file should be the ASCII + 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 - did with the mask, drag this from the layers dialog to the toolbar. - You 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 - painted-away surroundings, without any mask thumbnail in the layers - dialog. If you scaled the mask, then scale this image in exactly the - same way. Save this image as a NetPBM portable pixmap (".ppm") file. - (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.) + 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. You + 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 + painted-away surroundings, without any mask thumbnail in the layers + dialog. If you scaled the mask, then scale this image in exactly the + same way. Save this image as a NetPBM portable pixmap (".ppm") file. + (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.) - Now you need to merge the two files into one. Do that with the - pnmtopng command, like this: + Now you need to merge the two files into one. Do that with the pnmtopng + command, like this: + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/es_ES.UTF-8/ENVVARS.txt b/docs/es_ES.UTF-8/ENVVARS.txt index 1c5be3248..74e384004 100644 --- a/docs/es_ES.UTF-8/ENVVARS.txt +++ b/docs/es_ES.UTF-8/ENVVARS.txt @@ -1,97 +1,103 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 Environment Variables Documentation Copyright © 2021-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - mayo 5, 2023 + mayo 5, 2023 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint understands a number of environment variables, either directly, - or indirectly by the libraries that it utilizes. +Tux Paint understands a number of environment variables, either directly, or +indirectly by the libraries that it utilizes. Storage-related environment variables - HOME +HOME - Specifies the user's "home directory", which is used to locate - numerous other files or directories. In some cases, it is utilized - as part of a fall-back location, when other environment variables - (elsewhere in this documentation) are not set. Sometimes, the - location to use can be overridden by options provided on the - command-line or via Tux Paint's configuration file. See the - "OPTIONS" documentation for details. + Specifies the user's "home directory", which is used to locate numerous + other files or directories. In some cases, it is utilized as part of a + fall-back location, when other environment variables (elsewhere in this + documentation) are not set. Sometimes, the location to use can be + overridden by options provided on the command-line or via Tux Paint's + configuration file. See the "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 basis of where Tux Paint saves and loads users' drawings - * The location of a user's private collection of data files — - stamps, brushes, etc. — (versus those available system wide) + + The location of Tux Paint's configuration file + + The basis of where Tux Paint saves and loads users' drawings + + The location of a user's private collection of data files — stamps, + brushes, etc. — (versus those available system wide) - XDG_CONFIG_HOME - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's configuration files. - Specifically, where to find "user-dirs.dirs", where the - "XDG_PICTURES_DIR" might be defined. It is used for exporting - drawings and animated GIFs. Generally it's set to something like - "$HOME/Pictures/". If not specified, Tux Paint checks in the - directory "$HOME/.config/". If the configuration cannot be found, - Tux Paint simply exports drawings and GIFs to "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's configuration files. Specifically, where to find + "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used + for exporting drawings and animated GIFs. Generally it's set to something + like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory + "$HOME/.config/". If the configuration cannot be found, Tux Paint simply + exports drawings and GIFs to "$HOME". - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's data directories. - Specifically, where to find the "Trash" directory. It is used when - deleting images from Tux Paint's "Open" dialog. If not set, the - location "$HOME/.local/share/Trash/" is used, if available. If - not, images are simply deleted, rather than moved anywhere. - TEMP - Specifies the location where temporary files may be created. Only - used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if - not set. +XDG_DATA_HOME + + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's data directories. Specifically, where to find + the "Trash" directory. It is used when deleting images from Tux Paint's + "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is + used, if available. If not, images are simply deleted, rather than moved + anywhere. + + + +TEMP + + Specifies the location where temporary files may be created. Only used by + Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set. Language-related environment variables - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Specify the language Tux Paint should utilize in its user interface. + Overridde by the "--lang" and "--locale" command-line options or their + configuration file counterparts. The "LANGUAGE" environment variable is + used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES", + and finally "LANG". - LC_ALL - LC_MESSAGES - Specify the language Tux Paint should utilize in its user - interface. Overridde by the "--lang" and "--locale" command-line - options or their configuration file counterparts. The "LANGUAGE" - environment variable is used, if set. If not, "LC_ALL" is used as - a fallback. Then "LC_MESSAGES", and finally "LANG". Display-related environment variables - The following are a few of the environment variables supported by Simple - DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying - graphics, playing sounds, and receiving mouse, keyboard, and joystick - input — and which may be useful to users of Tux Paint. +The following are a few of the environment variables supported by Simple +DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics, +playing sounds, and receiving mouse, keyboard, and joystick input — and which +may be useful to users of Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Specifies whether Tux Paint should allow a screensaver to run. Can be set + to '1' (true) by Tux Paint itself by issuing the command-line option + "--allowscreensaver" or its configuration file counterpart. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Specifies whether Tux Paint should allow a screensaver to run. Can - be set to '1' (true) by Tux Paint itself by issuing the - command-line option "--allowscreensaver" or its configuration file - counterpart. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/es_ES.UTF-8/EXTENDING.txt b/docs/es_ES.UTF-8/EXTENDING.txt index 463e84cee..51907338e 100644 --- a/docs/es_ES.UTF-8/EXTENDING.txt +++ b/docs/es_ES.UTF-8/EXTENDING.txt @@ -1,1054 +1,1071 @@ Extending Tux Paint - versión 0.9.31 + versión 0.9.31 Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ mayo 29, 2023 - +------------------------------------------+ - |Table of Contents | - |------------------------------------------| - | * Where Files Go | - | * Standard Files | - | * Personal Files | - | * Brushes | - | * Brush Options | - | * Stamps | - | * Stamp Images | - | * Stamp Descriptive Text | - | * Stamp Sound Effects | - | * Stamp Descriptive Sound | - | * Stamp Options | - | * Pre-Mirrored and Flipped Stamps | - | * Fonts | - | * 'Starters' | - | * Coloring-Book Style Starters | - | * Scene-Style Starters | - | * Starter Options | - | * 'Templates' | - | * Template Options | - | * Translations | - | * Alternative Input Methods | - | * On-screen Keyboard | - | * Magic Tools | - +------------------------------------------+ ++-----------------------------------------+ +| Table of Contents | +|-----------------------------------------| +| * Where Files Go | +| + Standard Files | +| + Personal Files | +| * Brushes | +| + Brush Options | +| * Stamps | +| + Stamp Images | +| + Stamp Descriptive Text | +| + Stamp Sound Effects | +| + Stamp Descriptive Sound | +| + Stamp Options | +| + Pre-Mirrored and Flipped Stamps | +| * Fonts | +| * 'Starters' | +| + Coloring-Book Style Starters | +| + Scene-Style Starters | +| + Starter Options | +| * 'Templates' | +| + Template Options | +| * Translations | +| * Alternative Input Methods | +| * On-screen Keyboard | +| * Magic Tools | ++-----------------------------------------+ - If you wish to add or change things like Brushes, Starters, Rubber Stamps, - and other content used by Tux Paint, you can do so fairly easily by simply - adding, changing, or removing files where Tux Paint looks for them. +If you wish to add or change things like Brushes, Starters, Rubber Stamps, and +other content used by Tux Paint, you can do so fairly easily by simply adding, +changing, or removing files where Tux Paint looks for them. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Where Files Go +Where Files Go Standard Files - Tux Paint looks for its various data files in its 'data' directory. +Tux Paint looks for its various data files in its 'data' directory. - Linux and Unix +Linux and Unix - Where this directory goes depends on what value was set for - "DATA_PREFIX" when Tux Paint was built. See 'Install - documentation' for details. + Where this directory goes depends on what value was set for "DATA_PREFIX" + when Tux Paint was built. See 'Install documentation' for details. - By default, though, the directory is: + By default, though, the directory is: - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - If you installed from a package, it is more likely to be: + If you installed from a package, it is more likely to be: - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint looks for a directory called 'data' in the same - directory as the executable. This is the directory that the - installer used when installing Tux Paint e.g.: - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint looks for a directory called 'data' in the same directory as the + executable. This is the directory that the installer used when installing + Tux Paint e.g.: - Tux Paint stores its data files inside the "Tux Paint" application - icon (which is actually a special kind of folder on macOS & Mac OS - X before it). The following steps explain how to get to the - folders within it: + C:\Program Files\TuxPaint\data - 1. Bring up a 'context' menu by holding the [Control] key and - clicking the Tux Paint icon the in Finder. (If you have a - mouse with more than one button, you can simply right-click - the icon.) - 2. Select "Show Contents" from the menu that appears. A new - Finder window will appear with a folder inside called - "Contents". - 3. Open the "Contents" folder and open the "Resources" folder - found inside. - 4. There, you will find various sub-folders, such as "starters", - "stamps", "brushes", etc. Adding new content to these folders - will make the content available to any user that launches - this copy (icon) of Tux Paint. - 💡 Note: If you install a newer version of Tux Paint and replace or - discard the old version, you will lose changes made by following - the instructions above, so keep backups of your new content - (stamps, brushes, etc.). - Tux Paint also looks for files in a "TuxPaint" folder that you can - place in your system's "Application Support" folder (found under - "Library" at the root of your filesystem): +macOS + + Tux Paint stores its data files inside the "Tux Paint" application icon + (which is actually a special kind of folder on macOS & Mac OS X before it). + The following steps explain how to get to the folders within it: + + 1. Bring up a 'context' menu by holding the [Control] key and clicking the + Tux Paint icon the in Finder. (If you have a mouse with more than one + button, you can simply right-click the icon.) + 2. Select "Show Contents" from the menu that appears. A new Finder window + will appear with a folder inside called "Contents". + 3. Open the "Contents" folder and open the "Resources" folder found + inside. + 4. There, you will find various sub-folders, such as "starters", "stamps", + "brushes", etc. Adding new content to these folders will make the + content available to any user that launches this copy (icon) of Tux + Paint. + + 💡 Note: If you install a newer version of Tux Paint and replace or discard + the old version, you will lose changes made by following the instructions + above, so keep backups of your new content (stamps, brushes, etc.). + + Tux Paint also looks for files in a "TuxPaint" folder that you can place in + your system's "Application Support" folder (found under "Library" at the + root of your filesystem): + + /Library/Application Support/TuxPaint/ + + When you upgrade to a newer version of Tux Paint, the contents of this + "TuxPaint" folder will stay the same, and remain accessible by all users of + Tux Paint. + - /Library/Application Support/TuxPaint/ - When you upgrade to a newer version of Tux Paint, the contents of - this "TuxPaint" folder will stay the same, and remain accessible - by all users of Tux Paint. Personal Files - You can also create brushes, stamps, 'starters', templates, and fonts in - your own user account directory (folder) for Tux Paint to find. +You can also create brushes, stamps, 'starters', templates, and fonts in your +own user account directory (folder) for Tux Paint to find. - Windows +Windows - Your personal Tux Paint folder is stored in your personal - "Application Data". For example, on newer Windows: + Your personal Tux Paint folder is stored in your personal "Application + Data". For example, on newer Windows: - C:\Documents and Settings\(username)\Application Data\TuxPaint\ + C:\Documents and Settings\(username)\Application Data\TuxPaint\ - macOS - Your personal Tux Paint folder is stored in your personal - "Application Support" folder: - /Users/(username)/Library/Application Support/TuxPaint/ +macOS - Linux and Unix + Your personal Tux Paint folder is stored in your personal "Application + Support" folder: - Your personal Tux Paint files go into a 'hidden directory' found - in your account's home directory: "$(HOME)/.tuxpaint/" (also known - as "~/.tuxpaint/"). + /Users/(username)/Library/Application Support/TuxPaint/ - That is, if your home directory is "/home/tux", then your personal - Tux Paint files go in "/home/tux/.tuxpaint/". - Don't forget the period (".") before the "tuxpaint"! - To add your own brushes, stamps, 'starters,' templates, and fonts, create - subdirectories under your personal Tux Paint directory named "brushes", - "stamps", "starters", "templates", "fonts", respectively. +Linux and Unix - (For example, if you created a brush named "flower.png", you would put it - in "~/.tuxpaint/brushes/" under Linux or Unix.) + Your personal Tux Paint files go into a 'hidden directory' found in your + account's home directory: "$(HOME)/.tuxpaint/" (also known as "~/.tuxpaint/ + "). - Brushes + That is, if your home directory is "/home/tux", then your personal Tux + Paint files go in "/home/tux/.tuxpaint/". - The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux - Paint are simply PNG image files. + Don't forget the period (".") before the "tuxpaint"! - The alpha (transparency) of the PNG image is used to determine the shape - of the brush, which means that the shape can be 'anti-aliased' and even - partially-transparent! - Greyscale pixels in the brush PNG will be drawn using the - currently-selected color in Tux Paint. Color pixels will be tinted. + + +To add your own brushes, stamps, 'starters,' templates, and fonts, create +subdirectories under your personal Tux Paint directory named "brushes", "stamps +", "starters", "templates", "fonts", respectively. + +(For example, if you created a brush named "flower.png", you would put it in "~ +/.tuxpaint/brushes/" under Linux or Unix.) + +Brushes + +The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux Paint +are simply PNG image files. + +The alpha (transparency) of the PNG image is used to determine the shape of the +brush, which means that the shape can be 'anti-aliased' and even +partially-transparent! + +Greyscale pixels in the brush PNG will be drawn using the currently-selected +color in Tux Paint. Color pixels will be tinted. Brush Options - Aside from a graphical shape, brushes can also be given other attributes. - To do this, you need to create a 'data file' for the brush. +Aside from a graphical shape, brushes can also be given other attributes. To do +this, you need to create a 'data file' for the brush. - A brush's data file is simply a plain ASCII text file containing the - options for the brush. +A brush's data file is simply a plain ASCII text file containing the options +for the brush. - The file has the same name as the PNG image, but a ".dat" extension. - (e.g., "brush.png"'s data file is the text file "brush.dat", found in the - same directory.) +The file has the same name as the PNG image, but a ".dat" extension. (e.g., +"brush.png"'s data file is the text file "brush.dat", found in the same +directory.) - Brush Spacing +Brush Spacing - As of Tux Paint version 0.9.16, you can now specify the spacing - for brushes (that is, how often they are drawn). By default, the - spacing will be the brush's height, divided by 4. + As of Tux Paint version 0.9.16, you can now specify the spacing for brushes + (that is, how often they are drawn). By default, the spacing will be the + brush's height, divided by 4. - Add a line containing the line "spacing=N" to the brush's data - file, where "N" is the spacing you want for the brush. (The lower - the number, the more often the brush is drawn.) + Add a line containing the line "spacing=N" to the brush's data file, where + "N" is the spacing you want for the brush. (The lower the number, the more + often the brush is drawn.) - Animated Brushes - As of Tux Paint version 0.9.16, you may now create animated - brushes. As the brush is used, each frame of the animation is - drawn. - Lay each frame out across a wide PNG image. For example, if your - brush is 30x30 and you have 5 frames, the image should be 150x30. +Animated Brushes - Add a line containing the line "frames=N" to the brush's data - file, where "N" is the number of frames in the brush. + As of Tux Paint version 0.9.16, you may now create animated brushes. As the + brush is used, each frame of the animation is drawn. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Lay each frame out across a wide PNG image. For example, if your brush is + 30x30 and you have 5 frames, the image should be 150x30. - Directional Brushes + Add a line containing the line "frames=N" to the brush's data file, where " + N" is the number of frames in the brush. - As of Tux Paint version 0.9.16, you may now create directional - brushes. As the brush is used, different shapes are drawn, - depending on the direction the brush is going. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - The directional shapes are divided into a 3x3 square in a PNG - image. For example, if your brush is 30x30, the image should be - 90x90, and each of the direction's shapes placed in a 3x3 grid. - The center region is used for no motion. The top right is used for - motion that's both up, and to the right. And so on. - Add a line containing the word "directional" to the brush's data - file. - Rotating Brushes +Directional Brushes - As of Tux Paint version 0.9.27, you may now create rotating - brushes. As the brush is used, it is rotated 360 degrees, - depending on the direction the brush is going. + As of Tux Paint version 0.9.16, you may now create directional brushes. As + the brush is used, different shapes are drawn, depending on the direction + the brush is going. - Add a line containing the word "rotate" to the brush's data file. + The directional shapes are divided into a 3x3 square in a PNG image. For + example, if your brush is 30x30, the image should be 90x90, and each of the + direction's shapes placed in a 3x3 grid. The center region is used for no + motion. The top right is used for motion that's both up, and to the right. + And so on. - Animated Directional or Rotating Brushes + Add a line containing the word "directional" to the brush's data file. - You may mix both animated and either directional or rotating - features into one brush. Use both options desired ("frames=N" and - "directional" or "rotate"), in separate lines in the brush's - ".dat" file. - For directional brushes, lay the brush out so that each 3x3 set of - directional shapes are laid out across a wide PNG image. For - example, if the brush is 30x30 and there are 5 frames, it would be - 450x90. (The leftmost 150x90 pixels of the image represent the 9 - direction shapes for the first frame, for example.) - Place the brush image PNGs (and any data text files) in the "brushes" - directory. +Rotating Brushes - 💡 Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + As of Tux Paint version 0.9.27, you may now create rotating brushes. As the + brush is used, it is rotated 360 degrees, depending on the direction the + brush is going. - Stamps + Add a line containing the word "rotate" to the brush's data file. - All stamp-related files go in the "stamps" directory. It's useful to - create subdirectories and sub-subdirectories there to organize the stamps. - (For example, you can have a "holidays" folder with "halloween" and - "christmas" sub-folders.) + + +Animated Directional or Rotating Brushes + + You may mix both animated and either directional or rotating features into + one brush. Use both options desired ("frames=N" and "directional" or " + rotate"), in separate lines in the brush's ".dat" file. + + For directional brushes, lay the brush out so that each 3x3 set of + directional shapes are laid out across a wide PNG image. For example, if + the brush is 30x30 and there are 5 frames, it would be 450x90. (The + leftmost 150x90 pixels of the image represent the 9 direction shapes for + the first frame, for example.) + + + + +Place the brush image PNGs (and any data text files) in the "brushes" +directory. + +💡 Note: If your new brushes all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +Stamps + +All stamp-related files go in the "stamps" directory. It's useful to create +subdirectories and sub-subdirectories there to organize the stamps. (For +example, you can have a "holidays" folder with "halloween" and "christmas" +sub-folders.) Stamp Images - Rubber Stamps in Tux Paint can be made up of a number of separate files. - The one file that is required is, of course, the picture itself. +Rubber Stamps in Tux Paint can be made up of a number of separate files. The +one file that is required is, of course, the picture itself. - As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or - SVG vector images. They can be full-color or greyscale. The alpha - (transparency) channel of PNGs is used to determine the actual shape of - the picture (otherwise you'll stamp a large rectangle on your drawings). +As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or SVG +vector images. They can be full-color or greyscale. The alpha (transparency) +channel of PNGs is used to determine the actual shape of the picture (otherwise +you'll stamp a large rectangle on your drawings). - PNGs can be any size, and Tux Paint (by default) provides a set of sizing - buttons to let the user scale the stamp up (larger) and down (smaller). +PNGs can be any size, and Tux Paint (by default) provides a set of sizing +buttons to let the user scale the stamp up (larger) and down (smaller). - SVGs are vector-based, and will be scaled appropriately for the canvas - size being used in Tux Paint. +SVGs are vector-based, and will be scaled appropriately for the canvas size +being used in Tux Paint. - 💡 Note: If your new PNG-based stamps all come out as solid squares or - rectangles, it's because you forgot to use alpha transparency! See the - 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new PNG-based stamps all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in - detail, how to make PNG images which will scale perfectly when used as - stamps in Tux Paint. +⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in detail, +how to make PNG images which will scale perfectly when used as stamps in Tux +Paint. Stamp Descriptive Text - Tux Paint will display descriptive text when a stamp is selected. These - are placed in plain text files with the same name as the PNG or SVG, but - with a ".txt" filename extension. (e.g., "stamp.png"'s description is - stored in "stamp.txt" in the same directory.) +Tux Paint will display descriptive text when a stamp is selected. These are +placed in plain text files with the same name as the PNG or SVG, but with a +".txt" filename extension. (e.g., "stamp.png"'s description is stored in +"stamp.txt" in the same directory.) - The first line of the text file will be used as the US English description - of the stamp's image. It must be encoded in UTF-8. +The first line of the text file will be used as the US English description of +the stamp's image. It must be encoded in UTF-8. - Localization Support +Localization Support - Additional lines can be added to the text file to provide - translations of the description, to be displayed when Tux Paint is - running in a different locale (like French or Spanish). + Additional lines can be added to the text file to provide translations of + the description, to be displayed when Tux Paint is running in a different + locale (like French or Spanish). - The beginning of the line should correspond to the language code - of the language in question (e.g., "fr" for French, and "zh_TW" - for Traditional Chinese), followed by ".utf8=" and the translated - description (Unicode, encoded in UTF-8). + The beginning of the line should correspond to the language code of the + language in question (e.g., "fr" for French, and "zh_TW" for Traditional + Chinese), followed by ".utf8=" and the translated description (Unicode, + encoded in UTF-8). - For Tux Paint developers: There are scripts in the "po" directory - for converting the text files to PO format (and back) for easy - translation to different languages. Therefore you should never add - or change translations in the ".txt" files directly. + For Tux Paint developers: There are scripts in the "po" directory for + converting the text files to PO format (and back) for easy translation to + different languages. Therefore you should never add or change translations + in the ".txt" files directly. + + If no translation is available for the language Tux Paint is currently + running in, the US English text is used. + + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. - If no translation is available for the language Tux Paint is - currently running in, the US English text is used. - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. Stamp Sound Effects - Tux Paint can play a sound effect when a stamp is selected. For example, - the sound of a duck quaking when selecting a duck, or a brief piece of - music when a musical instrument is chosen. Files may be in "WAVE (".wav")" - or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG or - SVG image. (e.g., "stamp.svg"'s sound effect is the sound file "stamp.ogg" - in the same directory.) +Tux Paint can play a sound effect when a stamp is selected. For example, the +sound of a duck quaking when selecting a duck, or a brief piece of music when a +musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis +(".ogg")" formats, and are given same name as the PNG or SVG image. (e.g., +"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same +directory.) - Localization Support +Localization Support - For sounds for different locales (e.g., if the sound is someone - saying a word, and you want translated versions of the word said), - also create WAV or OGG files with the locale's label in the - filename, in the form: "stamp_LOCALE.EXT" + For sounds for different locales (e.g., if the sound is someone saying a + word, and you want translated versions of the word said), also create WAV + or OGG files with the locale's label in the filename, in the form: + "stamp_LOCALE.EXT" - The sound effect that will be played when the stamp corresponding - to the image file "stamp.png" is selected, and when Tux Paint is - using the Spanish locale, would be "stamp_es.wav". Under the - French locale, it would be "stamp_fr.wav". Under the Brazilian - Portuguese locale, "stamp_pt_BR.wav". And so on... + The sound effect that will be played when the stamp corresponding to the + image file "stamp.png" is selected, and when Tux Paint is using the Spanish + locale, would be "stamp_es.wav". Under the French locale, it would be + "stamp_fr.wav". Under the Brazilian Portuguese locale, "stamp_pt_BR.wav". + And so on... - If no localized sound effect can be loaded, Tux Paint will attempt - to load the 'default' sound file. (e.g., "stamp.wav") + If no localized sound effect can be loaded, Tux Paint will attempt to load + the 'default' sound file. (e.g., "stamp.wav") - 💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive - Sound', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound', +below. Stamp Descriptive Sound - Tux Paint can also play a descriptive sound when a stamp is selected. For - example, the sound of someone saying the word "duck" when selecting a - duck, or the name of a musical instrument when one is chosen. Files may be - in "WAVE (".wav")" or "OGG Vorbis (".ogg")" formats, and are given same - name as the PNG or SVG image, with "_desc" at the end. (e.g., - "stamp.svg"'s descriptive sound is the sound file "stamp_desc.ogg" in the - same directory.) +Tux Paint can also play a descriptive sound when a stamp is selected. For +example, the sound of someone saying the word "duck" when selecting a duck, or +the name of a musical instrument when one is chosen. Files may be in "WAVE +(".wav")" or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG +or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound +is the sound file "stamp_desc.ogg" in the same directory.) - Localization Support +Localization Support + + For descriptive sounds for different locales, also create WAV or OGG files + with both "_desc" and the locale's label in the filename, in the form: + "stamp_desc_LOCALE.EXT" + + The descriptive sound that will be played when the stamp corresponding to + the image file "stamp.png" is selected, and when Tux Paint is using the + Spanish locale, would be "stamp_desc_es.wav". Under the French locale, it + would be "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, + "stamp_desc_pt_BR.wav". And so on... + + If no localized descriptive sound can be loaded, Tux Paint will attempt to + load the 'default' sound file. (e.g., "stamp_desc.wav") - For descriptive sounds for different locales, also create WAV or - OGG files with both "_desc" and the locale's label in the - filename, in the form: "stamp_desc_LOCALE.EXT" - The descriptive sound that will be played when the stamp - corresponding to the image file "stamp.png" is selected, and when - Tux Paint is using the Spanish locale, would be - "stamp_desc_es.wav". Under the French locale, it would be - "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, - "stamp_desc_pt_BR.wav". And so on... - If no localized descriptive sound can be loaded, Tux Paint will - attempt to load the 'default' sound file. (e.g., "stamp_desc.wav") Stamp Options - Aside from a graphical shape, a textual description, a sound effect, and a - descriptive sound, stamps can also be given other attributes. To do this, - you need to create a 'data file' for the stamp. +Aside from a graphical shape, a textual description, a sound effect, and a +descriptive sound, stamps can also be given other attributes. To do this, you +need to create a 'data file' for the stamp. - A stamp's data file is simply a plain ASCII text file containing the - options for the stamp. +A stamp's data file is simply a plain ASCII text file containing the options +for the stamp. - The file has the same name as the PNG or SVG image, but a ".dat" - extension. (e.g., "stamp.png"'s data file is the text file "stamp.dat", - found in the same directory.) +The file has the same name as the PNG or SVG image, but a ".dat" extension. +(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same +directory.) - Colored Stamps +Colored Stamps - Stamps can be made to be either "colorable" or "tintable." + Stamps can be made to be either "colorable" or "tintable." - Colorable + Colorable - "Colorable" stamps they work much like brushes - you - pick the stamp to get the shape, and then pick the - color you want it to be. (Symbol stamps, like the - mathematical and musical ones, are an example.) + "Colorable" stamps they work much like brushes - you pick the stamp to + get the shape, and then pick the color you want it to be. (Symbol + stamps, like the mathematical and musical ones, are an example.) - Nothing about the original image is used except the - transparency (from "alpha" channel). The color of the - stamp comes out solid. + Nothing about the original image is used except the transparency (from + "alpha" channel). The color of the stamp comes out solid. - Add a line containing the word "colorable" to the - stamp's data file. + Add a line containing the word "colorable" to the stamp's data file. - Tinted - "Tinted" stamps are similar to "colorable" ones, - except the details of the original image are kept. - (To put it technically, the original image is used, - but its hue is changed, based on the - currently-selected color.) - Add a line containing the word "tintable" to the - stamp's data file. + Tinted - Tinting Options: + "Tinted" stamps are similar to "colorable" ones, except the details of + the original image are kept. (To put it technically, the original image + is used, but its hue is changed, based on the currently-selected + color.) - Depending on the contents of your stamp, you might - want to have Tux Paint use one of a number of methods - when tinting it. Add one of the following lines to - the stamp's data file: + Add a line containing the word "tintable" to the stamp's data file. - Normal tinter — "tinter=normal" (the default) - This is the normal tinting mode. First, - the primary hue of the stamp is - determined. (For example, a picture of a - flower with a stem will have the petal - color seen as the primary hue of the - overall image.) Next, the most highly - saturated part of the picture is found. - With "normal tinter", the range of hue - used to do this starts out within ±18° - of the pimary hue found in step 1. (If - none can be found, it widens the range - by 50% and tries again.) Finally, the - image is tinted. Anything falling within - 50% of the range (e.g., ±27°) is altered - to have the hue of the color chosen by - the user. - Narrow tinter — "tinter=narrow" - This like the "normal" option described - above, but starts a narrower hue range - of ±6°. Anything found within 50% of the - range (e.g. ±9°) is tinted. If too much - of your stamp is being tinted, try this - option. - 'Any hue' tinter — "tinter=anyhue" - This remaps all hues in the stamp. It - works similarly to the "anyhue" and - "narrow" options described above, but - the hue range is ±180°. + Tinting Options: - Vector tinter — "tinter=vector" - This maps 'black through white' to - 'black through destination'. + Depending on the contents of your stamp, you might want to have Tux + Paint use one of a number of methods when tinting it. Add one of the + following lines to the stamp's data file: - Unalterable Stamps + Normal tinter — "tinter=normal" (the default) + This is the normal tinting mode. First, the primary hue of the + stamp is determined. (For example, a picture of a flower with a + stem will have the petal color seen as the primary hue of the + overall image.) Next, the most highly saturated part of the picture + is found. With "normal tinter", the range of hue used to do this + starts out within ±18° of the pimary hue found in step 1. (If none + can be found, it widens the range by 50% and tries again.) Finally, + the image is tinted. Anything falling within 50% of the range + (e.g., ±27°) is altered to have the hue of the color chosen by the + user. - By default, a stamp can be flipped upside down, shown as a mirror - image, or both. This is done using the control buttons below the - stamp selector, at the lower right side of the screen in Tux - Paint. + Narrow tinter — "tinter=narrow" + This like the "normal" option described above, but starts a + narrower hue range of ±6°. Anything found within 50% of the range + (e.g. ±9°) is tinted. If too much of your stamp is being tinted, + try this option. - Sometimes, it doesn't make sense for a stamp to be flippable or - mirrored; for example, stamps of letters or numbers. Sometimes - stamps are symmetrical, so letting the user flip or mirror them - isn't useful. + 'Any hue' tinter — "tinter=anyhue" + This remaps all hues in the stamp. It works similarly to the + "anyhue" and "narrow" options described above, but the hue range is + ±180°. - To prevent a stamp from being flipped vertically, add the option - "noflip" to the stamp's data file. + Vector tinter — "tinter=vector" + This maps 'black through white' to 'black through destination'. - To prevent a stamp from being mirrored horizontally, add the - option "nomirror" to the stamp's data file. - Initial Stamp Size - By default, Tux Paint assumes that your stamp is sized - appropriately for unscaled display on a 608x472 canvas. This was - the original Tux Paint canvas size, provided by a 640x480 screen. - Tux Paint will then adjust the stamp according to the current - canvas size and, if enabled, the user's stamp size controls. - If your stamp would be too big or too small, you can specify a - scale factor. If your stamp would be 2.5 times as wide (or tall) - as it should be, add one of the following options, which represent - the same adjustment, to the stamp's data file. (An equals sign, - "=", may be included after the word "scale".) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. +Unalterable Stamps + + By default, a stamp can be flipped upside down, shown as a mirror image, or + both. This is done using the control buttons below the stamp selector, at + the lower right side of the screen in Tux Paint. + + Sometimes, it doesn't make sense for a stamp to be flippable or mirrored; + for example, stamps of letters or numbers. Sometimes stamps are + symmetrical, so letting the user flip or mirror them isn't useful. + + To prevent a stamp from being flipped vertically, add the option "noflip" + to the stamp's data file. + + To prevent a stamp from being mirrored horizontally, add the option " + nomirror" to the stamp's data file. + + + +Initial Stamp Size + + By default, Tux Paint assumes that your stamp is sized appropriately for + unscaled display on a 608x472 canvas. This was the original Tux Paint + canvas size, provided by a 640x480 screen. Tux Paint will then adjust the + stamp according to the current canvas size and, if enabled, the user's + stamp size controls. + + If your stamp would be too big or too small, you can specify a scale + factor. If your stamp would be 2.5 times as wide (or tall) as it should be, + add one of the following options, which represent the same adjustment, to + the stamp's data file. (An equals sign, "=", may be included after the word + "scale".) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. + + + Pre-Mirrored and Flipped Stamps - In some cases, you may wish to provide a pre-drawn version of a stamp's - mirror-image, flipped image, or even both. For example, imagine a picture - of a fire truck with the words "Fire Department" written across the side. - You probably do not want that text to appear backwards when the image is - flipped! +In some cases, you may wish to provide a pre-drawn version of a stamp's +mirror-image, flipped image, or even both. For example, imagine a picture of a +fire truck with the words "Fire Department" written across the side. You +probably do not want that text to appear backwards when the image is flipped! - To create a mirrored version of a stamp that you want Tux Paint to use, - rather than mirroring one on its own, simply create a second ".png" or - ".svg" graphics file with the same name, except with "_mirror" before the - filename extension. +To create a mirrored version of a stamp that you want Tux Paint to use, rather +than mirroring one on its own, simply create a second ".png" or ".svg" graphics +file with the same name, except with "_mirror" before the filename extension. - For example, for the stamp "stamp.png" you would create another file named - "stamp_mirror.png", which will be used when the stamp is mirrored (rather - than using a backwards version of "stamp.png"). +For example, for the stamp "stamp.png" you would create another file named +"stamp_mirror.png", which will be used when the stamp is mirrored (rather than +using a backwards version of "stamp.png"). - As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with - "_flip" in the name, and/or an image that is both mirrored and flipped, by - naming it "_mirror_flip". +As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with " +_flip" in the name, and/or an image that is both mirrored and flipped, by +naming it "_mirror_flip". - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - Fonts +Fonts - The fonts used by Tux Paint are TrueType Fonts (TTF). +The fonts used by Tux Paint are TrueType Fonts (TTF). - Simply place them in the "fonts" directory. Tux Paint will load the font - and provide four different sizes in the 'Letters' selector when using the - 'Text' and 'Label' tools. +Simply place them in the "fonts" directory. Tux Paint will load the font and +provide four different sizes in the 'Letters' selector when using the 'Text' +and 'Label' tools. - 'Starters' +'Starters' - 'Starter' images appear in the 'New' dialog, along with solid color - background choices. +'Starter' images appear in the 'New' dialog, along with solid color background +choices. - When you use a 'starter' image, make modifications, and save it, the - original 'starter' image is not overwritten. Additionally, as you edit - your new picture, the contents of the original 'starter' can affect it. +When you use a 'starter' image, make modifications, and save it, the original +'starter' image is not overwritten. Additionally, as you edit your new picture, +the contents of the original 'starter' can affect it. Coloring-Book Style Starters - The most basic kind of 'starter' is similar to a picture in a coloring - book. It's an outline of a shape which you can then color in and add - details to. In Tux Paint, as you draw, type text, or stamp stamps, the - outline remains 'above' what you draw. You can erase the parts of the - drawing you made, but you can't erase the outline. +The most basic kind of 'starter' is similar to a picture in a coloring book. +It's an outline of a shape which you can then color in and add details to. In +Tux Paint, as you draw, type text, or stamp stamps, the outline remains 'above' +what you draw. You can erase the parts of the drawing you made, but you can't +erase the outline. - To create this kind of 'starter' image, simply create an outlined black - and white picture in a paint program, and save it as a raster PNG file, or - vector SVG. If saving as a PNG, you may optionally render the image as - black-and-transparent, rather than black-and-white, but (as of Tux Paint - 0.9.21) this is not required. +To create this kind of 'starter' image, simply create an outlined black and +white picture in a paint program, and save it as a raster PNG file, or vector +SVG. If saving as a PNG, you may optionally render the image as +black-and-transparent, rather than black-and-white, but (as of Tux Paint +0.9.21) this is not required. Scene-Style Starters - Along with the 'coloring-book' style overlay, you can also provide a - separate background image as part of a 'starter' picture. The overlay acts - the same: it can't be drawn over, erased, or affected by 'Magic' tools. - However, the background can be! +Along with the 'coloring-book' style overlay, you can also provide a separate +background image as part of a 'starter' picture. The overlay acts the same: it +can't be drawn over, erased, or affected by 'Magic' tools. However, the +background can be! - When the 'Eraser' tool is used on a picture based on this kind of - 'starter' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'starter' image. +When the 'Eraser' tool is used on a picture based on this kind of 'starter' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'starter' image. - By creating both an overlay and a background, you can create a 'starter' - which simulates depth. Imagine a background that shows the ocean, and an - overlay that's a picture of a reef. You can then draw (or stamp) fish in - the picture. They'll appear in the ocean, but never 'in front of' the - reef. +By creating both an overlay and a background, you can create a 'starter' which +simulates depth. Imagine a background that shows the ocean, and an overlay +that's a picture of a reef. You can then draw (or stamp) fish in the picture. +They'll appear in the ocean, but never 'in front of' the reef. - To create this kind of 'starter' picture, simply create an overlay (with - transparency) and save it as a PNG. Then create another image (without - transparency), and save it with the same filename, but with "-back" (short - for 'background') appended to the name. (e.g., "starter-back.png" would be - the background ocean picture that corresponds to the overlay, or - foreground.) +To create this kind of 'starter' picture, simply create an overlay (with +transparency) and save it as a PNG. Then create another image (without +transparency), and save it with the same filename, but with "-back" (short for +'background') appended to the name. (e.g., "starter-back.png" would be the +background ocean picture that corresponds to the overlay, or foreground.) - For best results, 'starter' images should be at least the same size as Tux - Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" - section of Tux Paint's main documentation (README) for details on sizing.) - If they are not, they will be stretched or scaled. This is done without - affecting the shape ("aspect ratio"); however some smudging may be applied - to the edges. +For best results, 'starter' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. - Place them in the "starters" directory. When the 'New' dialog is accessed - in Tux Paint, the 'starter' images will appear in the screen that appears, - after the various solid color choices. +Place them in the "starters" directory. When the 'New' dialog is accessed in +Tux Paint, the 'starter' images will appear in the screen that appears, after +the various solid color choices. - 💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'starter' image, it - will always be affected by it.) +💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a 'starter' image, it will always be affected by it.) Starter Options - Aside from an image, starters can also be given other attributes. To do - this, you need to create a 'data file' for the starter. (Note: Tux Paint - prior to version 0.9.29 did not support starter options.) +Aside from an image, starters can also be given other attributes. To do this, +you need to create a 'data file' for the starter. (Note: Tux Paint prior to +version 0.9.29 did not support starter options.) - A starter's data file is simply a plain ASCII text file containing the - options for the starter. +A starter's data file is simply a plain ASCII text file containing the options +for the starter. - The file has the same name as the image, but a ".dat" extension. (e.g., - "starter.png"'s data file is the text file "starter.dat", found in the - same directory.) +The file has the same name as the image, but a ".dat" extension. (e.g., +"starter.png"'s data file is the text file "starter.dat", found in the same +directory.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + Colors may be listed using three decimal numbers (e.g., "255 68 136") or a + 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "#F48"). - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - 'Templates' + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - 'Template' images also appear in the 'New' dialog, along with solid color - background choices and 'Starters'. (Note: Tux Paint prior to version - 0.9.22 did not have the 'Template' feature.) + Focusing on the top of a starter image stretched to fit the width of the + canvas. - Unlike pictures drawn in Tux Paint by users and then opened later, opening - a 'template' creates a new drawing. When you save, the 'template' image is - not overwritten. Unlike 'starters', there is no immutable 'layer' above - the canvas. You may draw over any part of it. - When the 'Eraser' tool is used on a picture based on this kind of - 'template' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'template' image. + [ Landscape-shaped image of the ground with the sun at the top. ] - 'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) - format). No preparation or conversion should be required. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - For best results, 'template' images should be at least the same size as - Tux Paint's drawing canvas. (See the "Loading Other Pictures into Tux - Paint" section of Tux Paint's main documentation (README) for details on - sizing.) If they are not, they will be stretched or scaled. This is done - without affecting the shape ("aspect ratio"); however some smudging may be - applied to the edges. - Place them in the "templates" directory. When the 'New' dialog is accessed - in Tux Paint, the 'template' images will appear in the screen that - appears, after the various solid color choices. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +'Templates' + +'Template' images also appear in the 'New' dialog, along with solid color +background choices and 'Starters'. (Note: Tux Paint prior to version 0.9.22 did +not have the 'Template' feature.) + +Unlike pictures drawn in Tux Paint by users and then opened later, opening a +'template' creates a new drawing. When you save, the 'template' image is not +overwritten. Unlike 'starters', there is no immutable 'layer' above the canvas. +You may draw over any part of it. + +When the 'Eraser' tool is used on a picture based on this kind of 'template' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'template' image. + +'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) format). +No preparation or conversion should be required. + +For best results, 'template' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. + +Place them in the "templates" directory. When the 'New' dialog is accessed in +Tux Paint, the 'template' images will appear in the screen that appears, after +the various solid color choices. + +💡 Note: 'Templates' are 'attached' to saved pictures, via a small text file +that has the same name as the saved file, but with ".dat" as the extension. +This allows it to continue to affect the drawing even after Tux Paint has been +quit, or another picture is loaded or a new image is created. (In other words, +if you base a drawing on a 'template' image, it will always be affected by it.) - 💡 Note: 'Templates' are 'attached' to saved pictures, via a small text - file that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'template' image, it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Translations +Translations - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - To translate Tux Paint to a new language, copy the translation template - file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder - "src/po/"). Rename the copy as a ".po" file, with an appropriate name for - the locale you're translating to (e.g., "es.po" for Spanish; or "pt_BR.po" - for Brazilian Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese - spoken in Portugal.) +To translate Tux Paint to a new language, copy the translation template file, +"tuxpaint.pot" (found in Tux Paint's source code, in the folder "src/po/"). +Rename the copy as a ".po" file, with an appropriate name for the locale you're +translating to (e.g., "es.po" for Spanish; or "pt_BR.po" for Brazilian +Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese spoken in Portugal.) - Open the newly-created ".po" file — you can edit in a plain text edtior, - such as Emacs, Pico or VI on Linux, or NotePad on Windows. The original - English text used in Tux Paint is listed in lines starting with "msgid". - Enter your translations of each of these pieces of text in the empty - "msgstr" lines directly below the corresponding "msgid" lines. (Note: Do - not remove the quotes.) +Open the newly-created ".po" file — you can edit in a plain text edtior, such +as Emacs, Pico or VI on Linux, or NotePad on Windows. The original English text +used in Tux Paint is listed in lines starting with "msgid". Enter your +translations of each of these pieces of text in the empty "msgstr" lines +directly below the corresponding "msgid" lines. (Note: Do not remove the +quotes.) - Example: +Example: - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - Various tools exist to manage gettext translation catalogs, so you don't - have to edit them by hand in a text editor. Here are a few: - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +Various tools exist to manage gettext translation catalogs, so you don't have +to edit them by hand in a text editor. Here are a few: - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - To edit an existing translation, download the latest ".po" file for that - language, and edit it as described above. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - You may send new or edited translation files to Bill Kendrick, lead - developer of Tux Paint, at: bill@newbreedsoftware.com, or post them to the - "tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). +To edit an existing translation, download the latest ".po" file for that +language, and edit it as described above. - Alternatively, if you have an account with SourceForge.net, you can - request to be added to the "tuxpaint" project and receive write-access to - the Git source code repository so that you may commit your changes - directly. +You may send new or edited translation files to Bill Kendrick, lead developer +of Tux Paint, at: bill@newbreedsoftware.com, or post them to the +"tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). - 💡 Note: Support for new locales requires making additions to Tux Paint's - source code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the - Makefile, to ensure the ".po" files are compiled into ".mo" files, and - available for use at runtime. +Alternatively, if you have an account with SourceForge.net, you can request to +be added to the "tuxpaint" project and receive write-access to the Git source +code repository so that you may commit your changes directly. - Alternative Input Methods +💡 Note: Support for new locales requires making additions to Tux Paint's source +code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the Makefile, +to ensure the ".po" files are compiled into ".mo" files, and available for use +at runtime. - Tux Paint's 'Text' and 'Label' tools can provide alternative input methods - for some languages. For example, when Tux Paint is running with a Japanese - locale, the right [Alt] key can be pressed to cycle between Latin, - Romanized Hiragana and Romanized Katakana modes. This allows native - characters and words to be entered into the 'Text' and 'Label' tools by - typing one or more keys on a keyboard with Latin characters (e.g., a US - QWERTY keyboard). +Alternative Input Methods - To create an input method for a new locale, create a text file with a name - based on the locale (e.g., "ja" for Japanese), with ".im" as the extension - (e.g., "ja.im"). +Tux Paint's 'Text' and 'Label' tools can provide alternative input methods for +some languages. For example, when Tux Paint is running with a Japanese locale, +the right [Alt] key can be pressed to cycle between Latin, Romanized Hiragana +and Romanized Katakana modes. This allows native characters and words to be +entered into the 'Text' and 'Label' tools by typing one or more keys on a +keyboard with Latin characters (e.g., a US QWERTY keyboard). - The ".im" file can have multiple character mapping sections for different - character mapping modes. For example, on a Japanese typing system, typing - [K] [A] in Hiragana mode generates a different Unicode character ("か") - than typing [K] [A] in Katakana mode ("カ"). +To create an input method for a new locale, create a text file with a name +based on the locale (e.g., "ja" for Japanese), with ".im" as the extension +(e.g., "ja.im"). - List the character mappings in this file, one per line. Each line should - contain (separated by whitespace): +The ".im" file can have multiple character mapping sections for different +character mapping modes. For example, on a Japanese typing system, typing [K] +[A] in Hiragana mode generates a different Unicode character ("か") than typing +[K] [A] in Katakana mode ("カ"). - * the Unicode value of the character, in hexadecimal (more than one - character can be listed, separated by a colon (':'), this allowing - some sequences to map to words) - * the keycode sequence (the ASCII characters that must be entered to - generate the Unicode character) - * a flag (or "-" if none) +List the character mappings in this file, one per line. Each line should +contain (separated by whitespace): - Start additional character mapping sections with a line containign the - word "section". + * the Unicode value of the character, in hexadecimal (more than one character + can be listed, separated by a colon (':'), this allowing some sequences to + map to words) + * the keycode sequence (the ASCII characters that must be entered to generate + the Unicode character) + * a flag (or "-" if none) - Example: +Start additional character mapping sections with a line containign the word +"section". - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +Example: - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new input methods requires making additions to Tux - Paint's source code ("/src/im.c"), and requires updates to the Makefile, - to ensure the ".im" files are available for use at runtime. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - On-screen Keyboard +💡 Note: Support for new input methods requires making additions to Tux Paint's +source code ("/src/im.c"), and requires updates to the Makefile, to ensure the +".im" files are available for use at runtime. - As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an - on-screen keyboard that allows the pointer (via a mouse, eye-tracking - systems, etc.) to be used to input characters. Files that describe the - layout and available keys are stored in Tux Paint "osk" directory. Each - keyboard layout is defined by a number of files (some of which may be - shared by different layouts). +On-screen Keyboard - We'll use the QWERTY keyboard as an example: +As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an +on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, +etc.) to be used to input characters. Files that describe the layout and +available keys are stored in Tux Paint "osk" directory. Each keyboard layout is +defined by a number of files (some of which may be shared by different +layouts). + +We'll use the QWERTY keyboard as an example: Layout overview file ("qwerty.layout") - This is a text file that specifies the other files used to describe the - layout and key mappings. +This is a text file that specifies the other files used to describe the layout +and key mappings. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - The "keyboardlist" line describes which layouts to switch to, when the - user clicks the left and right buttons on the keyboard. (See below.) +The "keyboardlist" line describes which layouts to switch to, when the user +clicks the left and right buttons on the keyboard. (See below.) Keyboard layout file ("qwerty.h_layout") - This describes how big the keyboard is (as a "width × height" grid), and - lists each key with its numeric keycode (see the "keymap" file, below), - the width it should be drawn at (typically "1.0", to take one space on the - keyboard, but in the example below, notice the "TAB" and "SPACE" keys are - much wider), the character or text to display on the key, depending on - which modifier keys have been pressed (one each for: no modifiers, - [Shift], [AltGr], and [Shift] + [AltGr]), and finally whether or not the - key is affected by the [CapsLock] key (use "1") or [AltGr] (alternate - graphics) key (use "2"), or not at all (use "0"). +This describes how big the keyboard is (as a "width × height" grid), and lists +each key with its numeric keycode (see the "keymap" file, below), the width it +should be drawn at (typically "1.0", to take one space on the keyboard, but in +the example below, notice the "TAB" and "SPACE" keys are much wider), the +character or text to display on the key, depending on which modifier keys have +been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] + +[AltGr]), and finally whether or not the key is affected by the [CapsLock] key +(use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use +"0"). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # Arrow to left will change to the previous keyboard - KEY 2 1.0 <- <- <- <- 0 + # Arrow to left will change to the previous keyboard + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # The ALT or ALTGR keys are used in im to switch the input mode - KEY 64 2.0 Alt Alt Alt Alt 0 + # The ALT or ALTGR keys are used in im to switch the input mode + KEY 64 2.0 Alt Alt Alt Alt 0 - # Space - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Space + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # Arrow to right will change to the next keyboard - KEY 1 1.0 -> -> -> -> 0 + # Arrow to right will change to the next keyboard + KEY 1 1.0 -> -> -> -> 0 - Notice here that alphabetic keys ([Q], [W], etc.) will be affected by - [CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will - not. +Notice here that alphabetic keys ([Q], [W], etc.) will be affected by +[CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will not. - Keycodes up to "8" are reserved for internal use. The ones currently used - are described below. +Keycodes up to "8" are reserved for internal use. The ones currently used are +described below. - * 0 — empty button - * 1 — next layout (per the layout file's "keyboardlist" setting) - * 2 — previous layout (per the layout file's "keyboardlist" setting) + * 0 — empty button + * 1 — next layout (per the layout file's "keyboardlist" setting) + * 2 — previous layout (per the layout file's "keyboardlist" setting) Keymap file ("us-intl-altgr-dead-keys.keymap") - This file defines which numeric keycodes (seen in the keyboard layout - files, such as "qwerty.h_layout" described above) should be mapped to - which actual characters that an application such as Tux Paint expects to - receive when keys (e.g., on a real keyboard) are pressed. +This file defines which numeric keycodes (seen in the keyboard layout files, +such as "qwerty.h_layout" described above) should be mapped to which actual +characters that an application such as Tux Paint expects to receive when keys +(e.g., on a real keyboard) are pressed. - If you're using an operating system such as Linux, which runs X-Window and - has the "xmodmap" command-line tool available, you can run it with the - ("print keymap expressions" option, "-pke", to generate a keymap file. +If you're using an operating system such as Linux, which runs X-Window and has +the "xmodmap" command-line tool available, you can run it with the ("print +keymap expressions" option, "-pke", to generate a keymap file. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Composemap file ("en_US.UTF-8_Compose") - This file describes single characters that can be composed by multiple - inputs. For example, "[Compose]" followed by "[A]" and "[E]" can be used - to create the "æ" character. +This file describes single characters that can be composed by multiple inputs. +For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the +"æ" character. - The file that comes with Tux Paint is based on the US English UTF-8 - (Unicode) composemap that comes with X.Org's X Window system. The current - version from the Xlib library has a web located page at - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +The file that comes with Tux Paint is based on the US English UTF-8 (Unicode) +composemap that comes with X.Org's X Window system. The current version from +the Xlib library has a web located page at https://www.x.org/releases/current/ +doc/libX11/i18n/compose/en_US.UTF-8.html. Keysym definitions file ("keysymdef.h") - This file (which is a C programming language header file) is also from the - X Window System. It defines the Unicode values of each keycap (e.g., - "XK_equal" corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). +This file (which is a C programming language header file) is also from the X +Window System. It defines the Unicode values of each keycap (e.g., "XK_equal" +corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - It is unlikely that any modification will be required of this file. +It is unlikely that any modification will be required of this file. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/es_ES.UTF-8/FAQ.txt b/docs/es_ES.UTF-8/FAQ.txt index de20cd6ef..ca9454a63 100644 --- a/docs/es_ES.UTF-8/FAQ.txt +++ b/docs/es_ES.UTF-8/FAQ.txt @@ -4,612 +4,614 @@ Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - julio 13, 2023 + julio 13, 2023 - ---------------------------------------------------------------------- - - +------------------------------+ - |Table of Contents | - |------------------------------| - | * Drawing-related | - | * Interface Problems | - | * Printing | - | * Saving | - | * Audio Problems | - | * Fullscreen Mode Problems | - | * Other Problems | - | * Help / Contact | - +------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++------------------------------+ +| Table of Contents | +|------------------------------| +| * Drawing-related | +| * Interface Problems | +| * Printing | +| * Saving | +| * Audio Problems | +| * Fullscreen Mode Problems | +| * Other Problems | +| * Help / Contact | ++------------------------------+ +------------------------------------------------------------------------------- Drawing-related - Fonts I added to Tux Paint only show squares - The TrueType Font you're using might have the wrong encoding. If - it's 'custom' encoded, for example, you can try running it through - FontForge (http://fontforge.sourceforge.net/) to convert it to an - ISO-8859 format. (Email us if you need help with special fonts.) +Fonts I added to Tux Paint only show squares + The TrueType Font you're using might have the wrong encoding. If it's + 'custom' encoded, for example, you can try running it through FontForge ( + http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format. + (Email us if you need help with special fonts.) - The Rubber Stamp tool is greyed out! +The Rubber Stamp tool is greyed out! - This means that Tux Paint either couldn't find any stamp images, - or was asked not to load them. + This means that Tux Paint either couldn't find any stamp images, or was + asked not to load them. - If you installed Tux Paint, but did not install the separate, - optional "Stamps" collection, quit Tux Paint and install it now. - It should be available from the same place you got the main Tux - Paint program. (Note: As of version 0.9.14, Tux Paint comes with a - small collection of example stamps.) + If you installed Tux Paint, but did not install the separate, optional + "Stamps" collection, quit Tux Paint and install it now. It should be + available from the same place you got the main Tux Paint program. (Note: As + of version 0.9.14, Tux Paint comes with a small collection of example + stamps.) - If you don't want to install the default collection of stamps, you - can just create your own. See the "Extending Tux Paint" - documentation for more on creating PNG and SVG image files, TXT - text description files, Ogg Vorbis, MP3 or WAV sound files, and - DAT text data files that make up stamps. + If you don't want to install the default collection of stamps, you can just + create your own. See the "Extending Tux Paint" documentation for more on + creating PNG and SVG image files, TXT text description files, Ogg Vorbis, + MP3 or WAV sound files, and DAT text data files that make up stamps. - 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.) + 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. + 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 - Tux Paint was built with low-quality (but faster) stamp outlines. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: +Stamp outlines are always rectangles - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint was built with low-quality (but faster) stamp outlines. - in the "tuxpaint.c" file in the "src" directory. + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + in the "tuxpaint.c" file in the "src" directory. + + + + +------------------------------------------------------------------------------- Interface Problems - Stamp thumbnails in the Stamp Selector look bad +Stamp thumbnails in the Stamp Selector look bad - Tux Paint was probably compiled with the faster, lower quality - thumbnail code enabled. Run the command: "tuxpaint - --verbose-version" from a command line. If, amongst the other - output, you see the text: "Low Quality Thumbnails enabled", then - this is what's happening. + Tux Paint was probably compiled with the faster, lower quality thumbnail + code enabled. Run the command: "tuxpaint --verbose-version" from a command + line. If, amongst the other output, you see the text: "Low Quality + Thumbnails enabled", then this is what's happening. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - #define LOW_QUALITY_THUMBNAILS + #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 - "Low Quality Thumbnails" is probably enabled. See: "Stamp - thumbnails in the Stamp Selector look bad", above. - All of the text is in uppercase! - The "uppercase" option is on. +Pictures in the 'Open' dialog look bad + "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the + Stamp Selector look bad", above. - Either change/remove the "uppercase" option, or you can override - it with "--mixedcase" on the command line or either "uppercase=no" - or "mixedcase=yes" in a configuration file. +All of the text is in uppercase! - Tux Paint is in a different language - Make sure your locale setting is correct. See "Tux Paint won't - switch to my language", below. + The "uppercase" option is on. - Tux Paint won't switch to my language - * Linux and Unix users: Make sure the locale is available + Either change/remove the "uppercase" option, or you can override it with + "--mixedcase" on the command line or either "uppercase=no" or "mixedcase= + yes" in a configuration file. - Make sure the locale you want is available. Check your - "/etc/locale.gen" file. See the "Options Documentation" for - the locales Tux Paint uses (especially when using the - "--lang" option). +Tux Paint is in a different language + Make sure your locale setting is correct. See "Tux Paint won't switch to my + language", below. - Note: Debian and derivative (e.g., Ubuntu) users can simply - run "dpkg-reconfigure locales" if the locales are managed by - "dpkg". +Tux Paint won't switch to my language + + Linux and Unix users: Make sure the locale is available - * If you're using the "--lang" command-line option + Make sure the locale you want is available. Check your "/etc/ + locale.gen" file. See the "Options Documentation" for the locales Tux + Paint uses (especially when using the "--lang" option). - Try using the "--locale" command-line option, or your - operating system's locale settings (e.g., the "$LANG" - environment variable), and please e-mail us regarding your - trouble. + Note: Debian and derivative (e.g., Ubuntu) users can simply run + "dpkg-reconfigure locales" if the locales are managed by "dpkg". - * If you're using the "--locale" command-line option + + If you're using the "--lang" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + Try using the "--locale" command-line option, or your operating + system's locale settings (e.g., the "$LANG" environment variable), and + please e-mail us regarding your trouble. - * If you're trying to use your Operating System's locale + + If you're using the "--locale" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + If this doesn't work, please e-mail us regarding your trouble. - * Make sure you have the necessary font + + If you're trying to use your Operating System's locale - Some translations require their own font. Chinese and Korean, - for example, need Chinese and Korean TrueType Fonts installed - and placed in the proper location, respectively. + If this doesn't work, please e-mail us regarding your trouble. - The appropriate fonts for such locales can be downloaded from - the Tux Paint website: + + Make sure you have the necessary font - https://tuxpaint.org/download/fonts/ + Some translations require their own font. Chinese and Korean, for + example, need Chinese and Korean TrueType Fonts installed and placed in + the proper location, respectively. - ---------------------------------------------------------------------- + The appropriate fonts for such locales can be downloaded from the Tux + Paint website: + + https://tuxpaint.org/download/fonts/ + + + + +------------------------------------------------------------------------------- Printing - Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) +Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) - Tux Paint prints by creating a PostScript rendition of the picture - and sending it to an external command. By default, this command is - the "lpr" printing tool. + Tux Paint prints by creating a PostScript rendition of the picture and + sending it to an external command. By default, this command is the "lpr" + printing tool. - If that program is not available (for example, you're using CUPS, - the Common Unix Printing System, and do not have "cups-lpr" - installed), you will need to specify an appropriate command using - the "printcommand" option in Tux Paint's configuration file. (See - the "Options Documentation".) + If that program is not available (for example, you're using CUPS, the + Common Unix Printing System, and do not have "cups-lpr" installed), you + will need to specify an appropriate command using the "printcommand" option + in Tux Paint's configuration file. (See the "Options Documentation".) - 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. + 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. + 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 - The "print delay" option is on. You can only print once every X - seconds. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--printdelay=..." option. +I get the message "You can't print yet!" when I go to print - 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 - command-line argument. + The "print delay" option is on. You can only print once every X seconds. - If a "--printdelay=..." option isn't being sent on the command - line, check Tux Paint's configuration file for a line reading: - "printdelay=...". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--printdelay=..." option. - Either remove that line, set the delay value to 0 (no delay), or - decrease the delay to a value you prefer. (See the "Options - Documentation".) + 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 + command-line argument. - Or, you can simply run Tux Paint with the command-line argument: - "--printdelay=0", which will override the configuration file's - setting, and allow unlimited printing. (You won't have to wait - between prints.) + If a "--printdelay=..." option isn't being sent on the command line, check + Tux Paint's configuration file for a line reading: "printdelay=...". - I simply can't print! The button is greyed out! + Either remove that line, set the delay value to 0 (no delay), or decrease + the delay to a value you prefer. (See the "Options Documentation".) - The "no print" option is on. + Or, you can simply run Tux Paint with the command-line argument: + "--printdelay=0", which will override the configuration file's setting, and + allow unlimited printing. (You won't have to wait between prints.) - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noprint" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--noprint" is listed as a - command-line argument. - If a "--noprint" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "noprint=yes". +I simply can't print! The button is greyed out! - Either remove that line, or simply run Tux Paint with the - command-line argument: "--print", which will override the - configuration file's setting. + The "no print" option is on. - Or use Tux Paint Config. and make sure "Allow Printing" (under - "Printing") is checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noprint" option. - ---------------------------------------------------------------------- + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--noprint" is listed as a command-line + argument. + + If a "--noprint" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noprint=yes". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--print", which will override the configuration file's setting. + + Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing") + is checked. + + + + +------------------------------------------------------------------------------- Saving - Where does Tux Paint save my drawings? +Where does Tux Paint save my drawings? - Unless you asked Tux Paint to save into a specific location (using - the "savedir" option), Tux Paint saves into a standard location on - your local drive: + Unless you asked Tux Paint to save into a specific location (using the + "savedir" option), Tux Paint saves into a standard location on your local + drive: - Windows Vista, Windows 8, Windows 10, Windows 11 - In the user's "AppData" folder: - e.g., - C:\Users\Username\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + In the user's "AppData" folder: + e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved - macOS - In the user's "Application Support" folder: - e.g., /Users/Username/Library/Applicaton - Support/TuxPaint/saved/ + macOS + In the user's "Application Support" folder: + e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - In the user's home directory ("$HOME"), under a - ".tuxpaint" subfolder: - e.g., /home/username/.tuxpaint/saved/ + Linux / Unix + In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder: + e.g., /home/username/.tuxpaint/saved/ - The images are stored as PNG bitmaps, which most modern programs - should be able to load (image editors, word processors, web - browsers, etc.) - Tux Paint always saves over my old picture + The images are stored as PNG bitmaps, which most modern programs should be + able to load (image editors, word processors, web browsers, etc.) - The "save over" option is enabled. (This disables the prompt that - would appear when you click 'Save.') - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveover" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--saveover" is listed as a - command-line argument. +Tux Paint always saves over my old picture - If a "--saveover" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=yes". + The "save over" option is enabled. (This disables the prompt that would + appear when you click 'Save.') - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveover" option. - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + 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 command-line + argument. - Also, see "Tux Paint always saves a new picture!", below. + If a "--saveover" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=yes". - Tux Paint always saves a new picture! + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. - The "never save over" option is enabled. (This disables the prompt - that would appear when you click 'Save.') + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveovernew" option. + Also, see "Tux Paint always saves a new picture!", below. - 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 - command-line argument. - If a "--saveovernew" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=new". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. +Tux Paint always saves a new picture! - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + The "never save over" option is enabled. (This disables the prompt that + would appear when you click 'Save.') - Also, see "Tux Paint always saves over my old picture!", above. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveovernew" option. - ---------------------------------------------------------------------- + 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 + command-line argument. + + If a "--saveovernew" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=new". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. + + Also, see "Tux Paint always saves over my old picture!", above. + + + + +------------------------------------------------------------------------------- Audio Problems - There's no sound! - * First, check the obvious: - * Are your speakers connected and turned on? - * Is the volume turned up on your speakers? - * Is the volume turned up in your Operating System's - "mixer?" - * Are you certain you're using a computer with a sound - card? - * Are any other programs running that use sound? (They may - be 'blocking' Tux Paint from accessing your sound - device) - * (Unix/Linux) Are you using a sound system, such as aRts, - ESD or GStreamer? If so, try setting the - "SDL_AUDIODRIVER" environment variable before running - Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run - 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? +There's no sound! + + First, check the obvious: + o Are your speakers connected and turned on? + o Is the volume turned up on your speakers? + o Is the volume turned up in your Operating System's "mixer?" + o Are you certain you're using a computer with a sound card? + o Are any other programs running that use sound? (They may be + 'blocking' Tux Paint from accessing your sound device) + o (Unix/Linux) Are you using a sound system, such as aRts, ESD or + GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment + variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER= + arts"). Or, run 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 - program is "blocking" the sound device), then Tux Paint may - be running with a "no sound" option. + If sound seems to work otherwise (and you're sure no other program is + "blocking" the sound device), then Tux Paint may be running with a "no + sound" option. - If you're running Tux Paint from a command-line, make sure - you're not giving it a "--nosound" option. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--nosound" option. - If you're running Tux Paint by double-clicking an icon, check - the properties of the icon to see if "--nosound" is listed as - a command-line argument. + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--nosound" is listed as a + command-line argument. - If a "--nosound" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "nosound=yes". + If a "--nosound" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "nosound=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--sound", which will override the - configuration file's setting. + Either remove that line, or simply run Tux Paint with the command-line + argument: "--sound", which will override the configuration file's + setting. - Or, you can simply run Tux Paint with the command-line - argument: "Enable Sound Effects", which will override the - configuration file's setting, and allow unlimited printing. - (You won't have to wait between prints.) + Or, you can simply run Tux Paint with the command-line argument: + "Enable Sound Effects", which will override the configuration file's + setting, and allow unlimited printing. (You won't have to wait between + prints.) - * Were sounds temporarily disabled? + + Were sounds temporarily disabled? - Even if sounds are enabled in Tux Paint, it is possible to - disable and re-enable them temporarily using the [Alt] + [S] - key sequence. Try pressing those keys to see if sounds begin - working again. + Even if sounds are enabled in Tux Paint, it is possible to disable and + re-enable them temporarily using the [Alt] + [S] key sequence. Try + pressing those keys to see if sounds begin 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. - To test whether sound support was enabled when Tux Paint was - compiled, run Tux Paint from a command line, like so: + Tux Paint may have been compiled with sound support disabled. To test + whether sound support was enabled when Tux Paint was compiled, run Tux + Paint from a command line, like so: - tuxpaint --verbose-version + tuxpaint --verbose-version - If, amongst the other information, you see "Sound disabled", - then the version of Tux Paint you're running has sound - disabled. Recompile Tux Paint, and be sure NOT to build the - "nosound" target. (i.e., don't run "make nosound") Be sure - the SDL_mixer library and its development headers are - available! + If, amongst the other information, you see "Sound disabled", then the + version of Tux Paint you're running has sound disabled. Recompile Tux + Paint, and be sure NOT to build the "nosound" target. (i.e., don't run + "make nosound") Be sure the SDL_mixer library and its development + headers are available! - Tux Paint makes too much noise! Can I turn them off? - Yes, there are a number of ways to disable sounds in Tux Paint: - * Press [Alt] + [S] while in Tux Paint to temporarily disable - sounds. (Press that key sequence again to re-enable sounds.) - * Run Tux Paint with the "no sound" option: - * Run "tuxpaint --nosound" from the command line or - shortcut or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nosound=yes". - * Or use Tux Paint Config. and make sure "Enable Sound - Effects" (under "Video & Sound") is not checked. - * Alternatively, recompile Tux Paint with sound support - disabled. (See above, and the 'Install' documentation. +Tux Paint makes too much noise! Can I turn them off? - The stereo panning of sound effects is bothersome; can sound effects be - monophonic? + Yes, there are a number of ways to disable sounds in Tux Paint: - Run Tux Paint with the "no stereo" option: + + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds. + (Press that key sequence again to re-enable sounds.) + + Run Tux Paint with the "no sound" option: + o Run "tuxpaint --nosound" from the command line or shortcut or + desktop icon. + o Edit Tux Paint's configuration file (see "Options Documentation" + for details) and add a line containing "nosound=yes". + o Or use Tux Paint Config. and make sure "Enable Sound Effects" + (under "Video & Sound") is not checked. + o Alternatively, recompile Tux Paint with sound support disabled. + (See above, and the 'Install' documentation. - * Run "tuxpaint --nostereo" from the command line or shortcut - or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nostereo=yes". - * Or use Tux Paint Config. and make sure "Enable Stereo - Effects" (under "Video & Sound") is not checked. - The sound effects sound strange +The stereo panning of sound effects is bothersome; can sound effects be + monophonic? - This could have to do with how SDL and SDL_mixer were initialized. - (The buffer size chosen.) + Run Tux Paint with the "no stereo" option: - Please e-mail us with details about your computer system. - (Operating system and version, sound card, which version of Tux - Paint you're running (run "tuxpaint --version" to verify), and so - on.) + + Run "tuxpaint --nostereo" from the command line or shortcut or desktop + icon. + + Edit Tux Paint's configuration file (see "Options Documentation" for + details) and add a line containing "nostereo=yes". + + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under + "Video & Sound") is not checked. - ---------------------------------------------------------------------- + +The sound effects sound strange + + This could have to do with how SDL and SDL_mixer were initialized. (The + buffer size chosen.) + + Please e-mail us with details about your computer system. (Operating system + and version, sound card, which version of Tux Paint you're running (run + "tuxpaint --version" to verify), and so on.) + + + + +------------------------------------------------------------------------------- Fullscreen Mode Problems - When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns - black! - This is apparently a bug in the SDL library. Sorry. +When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black! + This is apparently a bug in the SDL library. Sorry. - When I run Tux Paint full-screen, it has large borders around it +When I run Tux Paint full-screen, it has large borders around it - Linux users - Your X-Window server is probably not set with the - ability to switch to the desired resolution: 800×600. (or whatever - resolution you have Tux Paint set to run at.) (This is typically - done manually under the X-Window server by pressing [Control] + - [Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus - (-)].) + Linux users - Your X-Window server is probably not set with the ability to + switch to the desired resolution: 800×600. (or whatever resolution you have + Tux Paint set to run at.) (This is typically done manually under the + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and + [Control] + [Alt] + [Keypad Minus (-)].) - For this to work, your monitor must support that resolution, and - you need to have it listed in your X server configuration. + For this to work, your monitor must support that resolution, and you need + to have it listed in your X server configuration. - Check the "Display" subsection of the "Screen" section of your - XFree86 or X.org configuration file (typically - "/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the - version of XFree86 you're using; 3.x or 4.x, respectively, or - "/etc/X11/xorg.conf" for X.org). + Check the "Display" subsection of the "Screen" section of your XFree86 or + X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/ + XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x, + respectively, or "/etc/X11/xorg.conf" for X.org). - Add "800x600" (or whatever resolution(s) you want) to the - appropriate "Modes" line. (e.g., in the "Display" subsection that - contains 24-bit color depth ("Depth 24"), which is what Tux Paint - tries to use.) + Add "800x600" (or whatever resolution(s) you want) to the appropriate + "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color + depth ("Depth 24"), which is what Tux Paint tries to use.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Note that some Linux distributions have tools that can make these - changes for you. Debian users can run the command - "dpkg-reconfigure xserver-xfree86" as root, for example. + Note that some Linux distributions have tools that can make these changes + for you. Debian users can run the command "dpkg-reconfigure + xserver-xfree86" as root, for example. - Tux Paint keeps running in Full Screen mode - I want it windowed! - The "fullscreen" option is set. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--fullscreen" option. +Tux Paint keeps running in Full Screen mode - I want it windowed! - 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 - command-line argument. + The "fullscreen" option is set. - If a "--fullscreen" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "fullscreen=yes". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--fullscreen" option. - Either remove that line, or simply run Tux Paint with the - command-line argument: "--windowed", which will override the - configuration file's setting. + 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 command-line + argument. - Or use Tux Paint Config. and make sure "Fullscreen" (under "Video - & Sound") is not checked. + If a "--fullscreen" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "fullscreen=yes". - ---------------------------------------------------------------------- + Either remove that line, or simply run Tux Paint with the command-line + argument: "--windowed", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound") + is not checked. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint won't run +Tux Paint won't run - If Tux Paint aborts with the message: "You're already running a - copy of Tux Paint!", this means it has been launched in the last - 30 seconds. (On Unix/Linux, this message would appear in a - terminal console if you ran Tux Paint from a command-line. On - Windows, this message would appear in a file named "stdout.txt" in - the same folder where TuxPaint.exe resides (e.g., in "C:\Program - Files\TuxPaint"). + If Tux Paint aborts with the message: "You're already running a copy of Tux + Paint!", this means it has been launched in the last 30 seconds. (On Unix/ + Linux, this message would appear in a terminal console if you ran Tux Paint + from a command-line. On Windows, this message would appear in a file named + "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\ + Program Files\TuxPaint"). - A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, - "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint - isn't run too many times at once (e.g., due to a child impatiently - clicking its icon more than once). + A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\ + lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many + times at once (e.g., due to a child impatiently clicking its icon more than + once). - Even if the lockfile exists, it contains the 'time' Tux Paint was - last run. If it's been more than 30 seconds, Tux Paint should run - fine, and simply update the lockfile with the current time. + Even if the lockfile exists, it contains the 'time' Tux Paint was last run. + If it's been more than 30 seconds, Tux Paint should run fine, and simply + 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. + 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. + To disable the lockfile, add the "--nolockfile" argument to Tux Paint's + command-line, or "nolockfile=yes" to the configuration file. - I can't quit Tux Paint - The "no quit" option is set. This disables the "Quit" button in - Tux Paint's toolbar (greying it out), and prevents Tux Paint from - being exited via the [Escape] key. - If Tux Paint is not in fullscreen mode, simply click the window - close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper - right.) +I can't 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. + The "no quit" option is set. This disables the "Quit" button in Tux Paint's + toolbar (greying it out), and prevents Tux Paint from being exited via the + [Escape] key. - (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 not in fullscreen mode, simply click the window close + button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.) - I don't want "no quit" mode enabled! + If Tux Paint is in fullscreen mode, you will need to use the [Shift] + + [Control] + [Escape] sequence on the keyboard to quit Tux Paint. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noquit" option. + (Note: with or without "no quit" set, you can always use the [Alt] + [F4] + combination on your keyboard to quit Tux Paint.) - 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 - command-line argument. - If a "--noquit" option isn't being sent on the command line, check - Tux Paint's configuration file for a line reading: "noquit=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--quit", which will override the - configuration file's setting. +I don't want "no quit" mode enabled! - Or use Tux Paint Config. and make sure "Disable Quit Button and - [Escape] Key" (under "Simplification") is not checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noquit" option. - Tux Paint keeps writing weird messages to the screen / to a text file + 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 command-line + argument. - A few messages are normal, but if Tux Paint is being extremely - verbose (like listing the name of every rubber-stamp image it - finds while loading them), then it was probably compiled with - debugging output turned on. + If a "--noquit" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noquit=yes". - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + Either remove that line, or simply run Tux Paint with the command-line + argument: "--quit", which will override the configuration file's setting. - #define DEBUG + Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape] + Key" (under "Simplification") is not checked. - in the "tuxpaint.c" file in the "src" directory. - Tux Paint is using options I didn't specify! - By default, Tux Paint first looks at configuration files for - options. +Tux Paint keeps writing weird messages to the screen / to a text file - * Windows + A few messages are normal, but if Tux Paint is being extremely verbose + (like listing the name of every rubber-stamp image it finds while loading + them), then it was probably compiled with debugging output turned on. - Under Windows, Tux Paint first examines the configuration - file: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - tuxpaint.cfg + #define DEBUG - Finally, any options sent as command-line arguments are used. + in the "tuxpaint.c" file in the "src" directory. - * macOS - * Unix and Linux - Under Unix and Linux, it first examines the system-wide - configuration file, located here: +Tux Paint is using options I didn't specify! - /etc/tuxpaint/tuxpaint.conf + By default, Tux Paint first looks at configuration files for options. - It then examines the user's personal configuration file: + + Windows - ~/.tuxpaintrc + Under Windows, Tux Paint first examines the configuration file: - Finally, any options sent as command-line arguments are used. + tuxpaint.cfg - * Haiku + Finally, any options sent as command-line arguments are used. - This means that if anything is set in a configuration file that - you don't want set, you'll need to either change the config. file - (if you can), or override the option on the command-line. + + macOS - For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" - includes this option to disable sound... + + Unix and Linux - nosound=yes + Under Unix and Linux, it first examines the system-wide configuration + file, located here: - ...then you can reenable sound by either adding this option to - your own ".tuxpaintrc" file: + /etc/tuxpaint/tuxpaint.conf - sound=yes + It then examines the user's personal configuration file: - ...or by using this command-line argument: + ~/.tuxpaintrc - --sound + Finally, any options sent as command-line arguments are used. - Linux and Unix users can also disable the system-wide - configuration file by including the following command-line - argument: + + Haiku - --nosysconfig + This means that if anything is set in a configuration file that you don't + want set, you'll need to either change the config. file (if you can), or + override the option on the command-line. - Tux Paint will then only look at "~/.tuxpaintrc" and command-line - arguments to determine what options should be set. + For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes + this option to disable sound... - ---------------------------------------------------------------------- + nosound=yes + + ...then you can reenable sound by either adding this option to your own + ".tuxpaintrc" file: + + sound=yes + + ...or by using this command-line argument: + + --sound + + Linux and Unix users can also disable the system-wide configuration file by + including the following command-line argument: + + --nosysconfig + + Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments + to determine what options should be set. + + + + +------------------------------------------------------------------------------- Help / Contact - Any questions you don't see answered? Please let us know! You can - subscribe and post to our "tuxpaint-users" mailing list: +Any questions you don't see answered? Please let us know! You can subscribe and +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 diff --git a/docs/es_ES.UTF-8/INSTALL.txt b/docs/es_ES.UTF-8/INSTALL.txt index 3e9ce04cc..84cf00f24 100644 --- a/docs/es_ES.UTF-8/INSTALL.txt +++ b/docs/es_ES.UTF-8/INSTALL.txt @@ -1,936 +1,935 @@ Tux Paint - versión 0.9.31 - Installation Documentation + versión 0.9.31 + Installation Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ mayo 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Requirements | - | * Simple DirectMedia Layer library (libSDL) | - | * Other Libraries | - | * Compiling and Installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Debugging | - | * Uninstalling Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +----------------------------------------------------+ ++---------------------------------------------------+ +| Table of Contents | +|---------------------------------------------------| +| * Requirements | +| + Simple DirectMedia Layer library (libSDL) | +| + Other Libraries | +| * Compiling and Installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Debugging | +| * Uninstalling Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++---------------------------------------------------+ - Requirements +Requirements Simple DirectMedia Layer library (libSDL) - Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open - Source multimedia programming library available under the GNU Lesser - General Public License (LGPL). +Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open +Source multimedia programming library available under the GNU Lesser General +Public License (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - The SDL libraries are available as source-code, or as RPM or Debian - packages for various distributions of Linux. They can be downloaded from: +The SDL libraries are available as source-code, or as RPM or Debian packages +for various distributions of Linux. They can be downloaded from: - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) - They are also typically available along with your Linux distribution (e.g. - on an installation media, or available via package maintainance software - like Debian's "apt"). +They are also typically available along with your Linux distribution (e.g. on +an installation media, or available via package maintainance software like +Debian's "apt"). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Other Libraries +Other Libraries - Tux Paint also takes advantage of a number of other free, LGPL'd - libraries. Under Linux, just like SDL, they should either already be - installed, or are readily available for installation as part of your Linux - distribution. +Tux Paint also takes advantage of a number of other free, LGPL'd libraries. +Under Linux, just like SDL, they should either already be installed, or are +readily available for installation as part of your Linux distribution. - libPNG +libPNG - Tux Paint uses PNG (Portable Network Graphics) format for its data - files. SDL_image will require libPNG be installed. + Tux Paint uses PNG (Portable Network Graphics) format for its data files. + SDL_image will require libPNG be installed. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint uses your system's locale settings along with the - "gettext" library to support various languages (e.g., Spanish). - You'll need the gettext library installed. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Linux/Unix only) + Tux Paint uses your system's locale settings along with the "gettext" + library to support various languages (e.g., Spanish). You'll need the + gettext library installed. - As of Tux Paint 0.9.17, Tux Paint can determine your system's - default paper size (e.g., A4 or Letter), or can be told to use a - particular paper size, thanks to "libpaper". + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - Tux Paint's "Text" and also "Label" tools support bidirectional - languages, thanks to the "FriBiDi" library. +libpaper (Linux/Unix only) - http://fribidi.org/ + As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper + size (e.g., A4 or Letter), or can be told to use a particular paper size, + thanks to "libpaper". - SVG graphics support + https://github.com/naota/libpaper - As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector - Graphics) images as stamps. Two sets of libraries are supported, - and SVG support can be completely disabled (via "make SVG_LIB:=") - librsvg-2 & libCairo2 (newer libraries) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * These also depend on the following: - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Older SVG libraries - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * These also depend on the following: - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Animated GIF Export feature + Tux Paint's "Text" and also "Label" tools support bidirectional languages, + thanks to the "FriBiDi" library. - To support export of animated GIFs (slideshows), the - "libimagequant" library (from the "pngquant2" project) is - required. + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - NetPBM Tools (optional) No longer used, by default - 📜 Under Linux and Unix, earlier versions of Tux Paint used the - NetPBM tools to assist with printing. (A PNG is generated by Tux - Paint, and converted into a PostScript using the 'pngtopnm' and - 'pnmtops' NetPBM command-line tools.) +SVG graphics support - http://netpbm.sourceforge.net/ + As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics) + images as stamps. Two sets of libraries are supported, and SVG support can + be completely disabled (via "make SVG_LIB:=") - Compiling and Installation + librsvg-2 & libCairo2 (newer libraries) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o These also depend on the following: + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint is released under the GNU General Public License (GPL) (see - "COPYING.txt" for details), and therefore the 'source code' to the program - is available freely. - ------------------------------------------------------------------ + Older SVG libraries + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o These also depend on the following: + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Animated GIF Export feature + + To support export of animated GIFs (slideshows), the "libimagequant" + library (from the "pngquant2" project) is required. + + https://github.com/ImageOptim/libimagequant + + + +NetPBM Tools (optional) No longer used, by default + + 📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools + to assist with printing. (A PNG is generated by Tux Paint, and converted + into a PostScript using the 'pngtopnm' and 'pnmtops' NetPBM command-line + tools.) + + http://netpbm.sourceforge.net/ + + + + +Compiling and Installation + +Tux Paint is released under the GNU General Public License (GPL) (see +"COPYING.txt" for details), and therefore the 'source code' to the program is +available freely. + + ----------------------------------------------------------------------- Windows - julio 10, 2022 Shin-ichi TOYAMA +julio 10, 2022 Shin-ichi TOYAMA - Compiling Set-Up +Compiling Set-Up - As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" - includes support for building on a Windows system using MinGW/MSYS - (https://sourceforge.net/projects/msys2/). +As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes +support for building on a Windows system using MinGW/MSYS (https:// +sourceforge.net/projects/msys2/). - Many tools and libraries are required to build Tux Paint. The package - management system "pacman" helps you install them automatically solving - complicated dependencies. +Many tools and libraries are required to build Tux Paint. The package +management system "pacman" helps you install them automatically solving +complicated dependencies. - MYSYS2 +MYSYS2 - Download the latest MSYS2 environment from https://www.msys2.org/ and - install it where you'd like (the default is "C:\msys64") +Download the latest MSYS2 environment from https://www.msys2.org/ and install +it where you'd like (the default is "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Within the MSYS2 shell, run the following command to install basic - development tools: +Within the MSYS2 shell, run the following command to install basic development +tools: - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to - the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build - environment. +Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to the " +MinGW 32bit (i686) toolchains" section if you need only a 32bit build +environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Within the MSYS2 shell, run the following command to install 64bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 64bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to - the "ImageMagick" section if you need only a 64bit build environment. +Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to the " +ImageMagick" section if you need only a 64bit build environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Within the MSYS2 shell, run the following command to install 32bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 32bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick is a compilation of command line tools to create, edit, - compose, or convert bitmap images supporting quite a large number of image - formats. Tux Paint uses two functions ("convert" and "composite") in it to - generate thumbnails for startar images and templates during the build - process. +ImageMagick is a compilation of command line tools to create, edit, compose, or +convert bitmap images supporting quite a large number of image formats. Tux +Paint uses two functions ("convert" and "composite") in it to generate +thumbnails for startar images and templates during the build process. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - Do not forget to enable "Install legacy utilities (e.g. convert)" while - installing it, because Tux Paint's build process uses them. +Do not forget to enable "Install legacy utilities (e.g. convert)" while +installing it, because Tux Paint's build process uses them. - Add the path to the directory in which ImageMagick is installed at the top - of your "PATH" environment variable. For example: +Add the path to the directory in which ImageMagick is installed at the top of +your "PATH" environment variable. For example: - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - You can make this permanent by adding the above to your the BASH shell - configuration file, "~/.bash_profile". +You can make this permanent by adding the above to your the BASH shell +configuration file, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - All the files needed for starting Tux Paint (and Tux Paint Config.) are - collected in the directory for binary distribution "bdist" directory under - "win32". You can start them by double-clicking their executable (.exe) - files in the "bdist" directory. +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup is used to build executable installer for Tux Paint. Therefore - you have to install it in the first place. +All the files needed for starting Tux Paint (and Tux Paint Config.) are +collected in the directory for binary distribution "bdist" directory under +"win32". You can start them by double-clicking their executable (.exe) files in +the "bdist" directory. - Inno Setup officially supports translations for only about 20 languages. - However, one of the great points of Tux Paint is it supports so many - languages. Therefore, the set up script "tuxpaint.iss" to build the - installer is written to use much more translations including unofficial - one which are available on "Inno Setup Translations". You have to download - translation files (.isl) required and put them in "Languages" directory - under the directory in which Inno Setup is installed. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup is used to build executable installer for Tux Paint. Therefore you +have to install it in the first place. - Then, you can easily build an executable installer by right-clicking on - the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" - on the list. It will run for a while, and eventually you will find a - "tuxpaint-X.Y.Z-windows--installer.exe" file in the same directory. +Inno Setup officially supports translations for only about 20 languages. +However, one of the great points of Tux Paint is it supports so many languages. +Therefore, the set up script "tuxpaint.iss" to build the installer is written +to use much more translations including unofficial one which are available on " +Inno Setup Translations". You have to download translation files (.isl) +required and put them in "Languages" directory under the directory in which +Inno Setup is installed. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Double-click the Tux Paint installer executable (.EXE file) and follow the - instructions. +Then, you can easily build an executable installer by right-clicking on the +"tuxpaint.iss" icon in the "win32" directory and selecting "Compile" on the +list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z +-windows--installer.exe" file in the same directory. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - You will then be asked whether you want to install shortcuts to Tux Paint - in your Windows Start Menu and on your Windows Desktop. (Both options are - set by default.) +Double-click the Tux Paint installer executable (.EXE file) and follow the +instructions. - Then you will be asked where you wish to install Tux Paint. The default - should be suitable, as long as there is space available. Otherwise, pick a - different location. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - At this point, you can click 'Install' to install Tux Paint! +You will then be asked whether you want to install shortcuts to Tux Paint in +your Windows Start Menu and on your Windows Desktop. (Both options are set by +default.) - Changing the Settings Using the Shortcut +Then you will be asked where you wish to install Tux Paint. The default should +be suitable, as long as there is space available. Otherwise, pick a different +location. - To change program settings, right-click on the TuxPaint shortcut and - select 'Properties' (at the bottom). +At this point, you can click 'Install' to install Tux Paint! - Make sure the 'Shortcut' tab is selected in the window that appears, and - examine the 'Target:' field. You should see something like this: +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +To change program settings, right-click on the TuxPaint shortcut and select +'Properties' (at the bottom). - You can now add command-line options which will be enabled when you - double-click the icon. +Make sure the 'Shortcut' tab is selected in the window that appears, and +examine the 'Target:' field. You should see something like this: - For example, to make the game run in fullscreen mode, with simple shapes - (no rotation option) and in French, add the options (after - 'TuxPaint.exe'), like so: + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +You can now add command-line options which will be enabled when you +double-click the icon. - (See the main documentation for a full list of available command-line - options.) +For example, to make the game run in fullscreen mode, with simple shapes (no +rotation option) and in French, add the options (after 'TuxPaint.exe'), like +so: - If you make a mistake or it all disappears use [Control] + [Z] to undo or - just hit the [Esc] key and the box will close with no changes made (unless - you pushed the "Apply" button!). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - When you have finished, click "OK." +(See the main documentation for a full list of available command-line options.) - If Something Goes Wrong +If you make a mistake or it all disappears use [Control] + [Z] to undo or just +hit the [Esc] key and the box will close with no changes made (unless you +pushed the "Apply" button!). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +When you have finished, click "OK." - It will contain a description of what was wrong. Usually it will just be - due to incorrect character-case (capital 'Z' instead of lowercase 'z') or - a missing (or extra) '-' (dash). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +It will contain a description of what was wrong. Usually it will just be due to +incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing +(or extra) '-' (dash). + + ----------------------------------------------------------------------- Linux/Unix - Compiling: +Compiling: - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - To compile the program from source, simply run the following command from - a shell prompt (e.g., "$"): +To compile the program from source, simply run the following command from a +shell prompt (e.g., "$"): - $ make + $ make - Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): +Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): - To disable SVG support (e.g., if your system is not currently supported by - the Cairo library or other SVG-related dependencies), you can run "make" - with "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: +To disable SVG support (e.g., if your system is not currently supported by the +Cairo library or other SVG-related dependencies), you can run "make" with +"SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - If you don't have a sound card, or would prefer to build the program with - no sound support (and therefore without a the SDL_mixer dependency), you - can run "make" with "SDL_MIXER_LIB=" added: +If you don't have a sound card, or would prefer to build the program with no +sound support (and therefore without a the SDL_mixer dependency), you can run +"make" with "SDL_MIXER_LIB=" added: - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Various other options (e.g., installation paths) may be overridden; see - them in "Makefile" for further details. +Various other options (e.g., installation paths) may be overridden; see them in +"Makefile" for further details. - If you get errors +If you get errors - If you receive any errors during compile-time, make sure you have the - appropriate libraries installed (see above). If using packaged versions of - the libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to - get the corresponding "-dev" or "-devel" packages as well, otherwise you - won't be able to compile Tux Paint (and other programs) from source! +If you receive any errors during compile-time, make sure you have the +appropriate libraries installed (see above). If using packaged versions of the +libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the +corresponding "-dev" or "-devel" packages as well, otherwise you won't be able +to compile Tux Paint (and other programs) from source! - Installng +Installng - Assuming no fatal errors occured, you can now install the program so that - it can be run by users on the system. By default, this must be done by the - "root" user ('superuser'). Switch to "root" by typing the command: +Assuming no fatal errors occured, you can now install the program so that it +can be run by users on the system. By default, this must be done by the "root" +user ('superuser'). Switch to "root" by typing the command: - $ su + $ su - Enter "root"'s password at the prompt. You should now be "root" (with a - prompt like "#"). To install the program and its data files, type: +Enter "root"'s password at the prompt. You should now be "root" (with a prompt +like "#"). To install the program and its data files, type: - # make install + # make install - Finally, you can switch back to your regular user by exiting superuser - mode: +Finally, you can switch back to your regular user by exiting superuser mode: - # exit + # exit - Alternatively, you may be able to simply use the "sudo" command (e.g., on - Ubuntu Linux): +Alternatively, you may be able to simply use the "sudo" command (e.g., on +Ubuntu Linux): - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Changing Where Things Go +Changing Where Things Go - You can change where things will go by setting "Makefile"variables on the - command line. "DESTDIR" is used to place output in a staging area for - package creation. "PREFIX" is the basis of where all other files go, and - is, by default, set to "/usr/local". +You can change where things will go by setting "Makefile"variables on the +command line. "DESTDIR" is used to place output in a staging area for package +creation. "PREFIX" is the basis of where all other files go, and is, by +default, set to "/usr/local". - Other variables are: +Other variables are: - BIN_PREFIX - Where the "tuxpaint" binary will be installed. (Set to - "$(PREFIX)/bin" by default - e.g., "/usr/local/bin") +BIN_PREFIX + Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by + default - e.g., "/usr/local/bin") - DATA_PREFIX - Where the data files (sound, graphics, brushes, stamps, fonts) - will go, and where Tux Paint will look for them when it's run. - (Set to "$(PREFIX)/share/tuxpaint") +DATA_PREFIX + Where the data files (sound, graphics, brushes, stamps, fonts) will go, and + where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/ + tuxpaint") - DOC_PREFIX - Where the documentation text files (the "docs" directory) will go. - (Set to "$(PREFIX)/share/doc/tuxpaint") +DOC_PREFIX + Where the documentation text files (the "docs" directory) will go. (Set to + "$(PREFIX)/share/doc/tuxpaint") - MAN_PREFIX - Where the manual page for Tux Paint will go. (Set to - "$(PREFIX)/share/man") +MAN_PREFIX + Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man") - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Where the icons and launchers (for GNOME and KDE) will go. - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Where the translation files for Tux Paint will go, and where Tux Paint will + look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a + translation file will be under the locale's directory (e.g., "es" for + Spanish), within the "LC_MESSAGES" subdirectory.) - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Where the icons and launchers (for GNOME and KDE) will go. +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Where the translation files for Tux Paint will go, and where Tux - Paint will look for them. (Set to "$(PREFIX)/share/locale/") - (Final location of a translation file will be under the locale's - directory (e.g., "es" for Spanish), within the "LC_MESSAGES" - subdirectory.) - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - junio 5, 2022 Mark Kim +junio 5, 2022 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prerequisites +Prerequisites - Although Tux Paint is built without the Xcode IDE, Xcode itself is still - required to build Tux Paint. Download it from the App Store, and launch it - once to accept its license agreements. You may also need to install the - Xcode command line tools using the command: +Although Tux Paint is built without the Xcode IDE, Xcode itself is still +required to build Tux Paint. Download it from the App Store, and launch it once +to accept its license agreements. You may also need to install the Xcode +command line tools using the command: - $ xcode-select --install + $ xcode-select --install - Building Tux Paint also requires various libraries. We install them from - MacPorts where possible, source code otherwise. Install MacPorts to the - default /opt/local path according to the instructions found on their - website: https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... but you should install any package that is required by the latest - version of Tux Paint. +Building Tux Paint also requires various libraries. We install them from +MacPorts where possible, source code otherwise. Install MacPorts to the default +/opt/local path according to the instructions found on their website: https:// +www.macports.org/ - ^* Not available from MacPorts as of this writing, see below. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... but you should install any package that is required by the latest version +of Tux Paint. - libimagequant is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. +^* Not available from MacPorts as of this writing, see below. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - WARNING: Having any UNIX-like toolset installed on your Mac besides - MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle - from being portable. Be sure Fink and Brew are not accessible from your - build environment. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - How to Build + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Simply, run: +WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts +and Xcode, such as Fink or Brew, will prevent your app bundle from being +portable. Be sure Fink and Brew are not accessible from your build environment. - % make - % make install +How to Build - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Simply, run: - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Known Issues +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * A macOS binary built on a specific version of macOS only runs on that - version of macOS or later. To ensure Tux Paint can run on the oldest - version of macOS possible, build it on the oldest version of macOS - available. As of this writing we know Tux Paint cannot be built to run - on macOS 10.7 or earlier. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - See "Old Versions of macOS" below for best-effort instructions on how - to obtain, install, and build Tux Paint on an old version of macOS. +Known Issues - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * A macOS binary built on a specific version of macOS only runs on that + version of macOS or later. To ensure Tux Paint can run on the oldest + version of macOS possible, build it on the oldest version of macOS + available. As of this writing we know Tux Paint cannot be built to run on + macOS 10.7 or earlier. - Old Versions of macOS + See "Old Versions of macOS" below for best-effort instructions on how to + obtain, install, and build Tux Paint on an old version of macOS. - Some old versions of macOS can be downloaded from Apple's support page: - https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Old Versions of macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Some old versions of macOS can be downloaded from Apple's support page: https:/ +/support.apple.com/en-us/HT211683 - As of this writing, the oldest version of macOS available on Apple's - support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" - partitioning scheme instead of the older MBR scheme, and "Mac OS Extended - (Journaled)" as the partition type instead of the newer APFS partition - type. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Upon launching the installer, if you get a popup about macOS being too old - or new to be installed, a bootable installer can be created using the - instructions found here: https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Once the old macOS is installed, you may find the Xcode on the App Store - is too new to run on the version of the old macOS. Old versions of Xcode - can be downloaded from Apple's Developer site in an area accessible with - free registration: https://developer.apple.com/download/more/ +As of this writing, the oldest version of macOS available on Apple's support +site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning +scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as +the partition type instead of the newer APFS partition type. - The list of macOS versions and the last version of Xcode compatible with - them are laid out nicely on the Wikipedia page on Xcode: - https://en.wikipedia.org/wiki/Xcode#Version_comparison_table +Upon launching the installer, if you get a popup about macOS being too old or +new to be installed, a bootable installer can be created using the instructions +found here: https://support.apple.com/en-mide/HT201372 - And because Xcode is being installed manually, you can skip the step to - install the Xcode command line tools (do not run "xcode-select --install") - but otherwise build Tux Paint using the same steps described in the - earlier part of this document. +Once the old macOS is installed, you may find the Xcode on the App Store is too +new to run on the version of the old macOS. Old versions of Xcode can be +downloaded from Apple's Developer site in an area accessible with free +registration: https://developer.apple.com/download/more/ - Recompiling MacPorts +The list of macOS versions and the last version of Xcode compatible with them +are laid out nicely on the Wikipedia page on Xcode: https://en.wikipedia.org/ +wiki/Xcode#Version_comparison_table - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +And because Xcode is being installed manually, you can skip the step to install +the Xcode command line tools (do not run "xcode-select --install") but +otherwise build Tux Paint using the same steps described in the earlier part of +this document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - marzo 29, 2023 Pere Pujal i Carabantes (Edited by - Bill Kendrick) +marzo 29, 2023 Pere Pujal i Carabantes (Edited by Bill +Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prerequisites +Prerequisites - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - mayo 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) +mayo 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) - Prerequisites +Prerequisites - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Debugging +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file - on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled - by setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines - in "src/debug.h" and (re)compiling Tux Paint. +Debugging - Uninstalling Tux Paint +⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file on +Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled by +setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src +/debug.h" and (re)compiling Tux Paint. + +Uninstalling Tux Paint Windows - Using the Uninstaller +Using the Uninstaller - If you installed the Start Menu shortcuts (the default), then go to the - TuxPaint folder and select "Uninstall". A box will be displayed that will - confirm that you are about to uninstall Tux Paint and, if you are certain - that you want to permanently remove Tux Paint, click on the 'Uninstall' - button. +If you installed the Start Menu shortcuts (the default), then go to the +TuxPaint folder and select "Uninstall". A box will be displayed that will +confirm that you are about to uninstall Tux Paint and, if you are certain that +you want to permanently remove Tux Paint, click on the 'Uninstall' button. - When it has finished, click on the close button. +When it has finished, click on the close button. - Using the Control Panel +Using the Control Panel - It is also possible to use the entry "TuxPaint (remove only)" in the - Control Panel Add/Remove programs section. +It is also possible to use the entry "TuxPaint (remove only)" in the Control +Panel Add/Remove programs section. macOS - Delete "TuxPaint.app" from the "Applications" folder. Data files, - including the configuration files, stamps, and saved pictures, may be - found in "/Library/Application Support/TuxPaint" (all users) and - "/Users/USERNAME/Library/Application Support/TuxPaint" (individual users). +Delete "TuxPaint.app" from the "Applications" folder. Data files, including the +configuration files, stamps, and saved pictures, may be found in "/Library/ +Application Support/TuxPaint" (all users) and "/Users/USERNAME/Library/ +Application Support/TuxPaint" (individual users). Linux - Within the Tux Paint source directory (where you compiled Tux Paint), you - can use the "make uninstall" target to uninstall Tux Paint. By default, - this must be done by the "root" user ('superuser'), but if you installed - Tux Paint somewhere else (e.g., using a "PREFIX=..." setting to "make" and - "make install"), you may not, and will want to provide those same settings - here. (See the installation instructions above for further information.) +Within the Tux Paint source directory (where you compiled Tux Paint), you can +use the "make uninstall" target to uninstall Tux Paint. By default, this must +be done by the "root" user ('superuser'), but if you installed Tux Paint +somewhere else (e.g., using a "PREFIX=..." setting to "make" and "make +install"), you may not, and will want to provide those same settings here. (See +the installation instructions above for further information.) + diff --git a/docs/es_ES.UTF-8/MAGIC-API.txt b/docs/es_ES.UTF-8/MAGIC-API.txt index f20c615a9..acceafbf0 100644 --- a/docs/es_ES.UTF-8/MAGIC-API.txt +++ b/docs/es_ES.UTF-8/MAGIC-API.txt @@ -1,1273 +1,1279 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Magic Tool Plugin API Documentation + Magic Tool Plugin API Documentation Copyright © 2007-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - abril 13, 2023 + abril 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Prequisites | - | * Interfaces | - | * 'Magic' tool plugin functions | - | * Common arguments to plugin functions | - | * Required Plugin Functions | - | * Plugin "housekeeping" functions | - | * Plugin event functions | - | * Tux Paint Functions and Data | - | * Pixel Manipulations | - | * Helper Functions | - | * Informational | - | * Tux Paint System Calls | - | * Color Conversions | - | * Helper Macros in "tp_magic_api.h" | - | * Constant Definitions in "tp_magic_api.h" | - | * Compiling | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Installing | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Creating plugins with multiple effects | - | * Example Code | - | * Getting Help | - | * Glossary | - +----------------------------------------------------+ ++--------------------------------------------------+ +| Table of Contents | +|--------------------------------------------------| +| * Prequisites | +| * Interfaces | +| + 'Magic' tool plugin functions | +| o Common arguments to plugin functions | +| o Required Plugin Functions | +| # Plugin "housekeeping" functions | +| # Plugin event functions | +| + Tux Paint Functions and Data | +| o Pixel Manipulations | +| o Helper Functions | +| o Informational | +| o Tux Paint System Calls | +| o Color Conversions | +| + Helper Macros in "tp_magic_api.h" | +| + Constant Definitions in "tp_magic_api.h" | +| * Compiling | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Installing | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Creating plugins with multiple effects | +| * Example Code | +| * Getting Help | +| * Glossary | ++--------------------------------------------------+ - Overview +Overview - Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted - from routines that lived within the application itself, to a set of - 'plugins' that are loaded when Tux Paint starts up. +Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted from +routines that lived within the application itself, to a set of 'plugins' that +are loaded when Tux Paint starts up. - This division allows more rapid development of 'Magic' tools, and allows - programmers to create and test new tools without needing to integrate them - within the main Tux Paint source code. (Users of more professional - graphics tools, such as GIMP, should be familiar with this plugin - concept.) +This division allows more rapid development of 'Magic' tools, and allows +programmers to create and test new tools without needing to integrate them +within the main Tux Paint source code. (Users of more professional graphics +tools, such as GIMP, should be familiar with this plugin concept.) - Prerequisites +Prerequisites - Tux Paint is written in the C programming language, and uses the Simple - DirectMedia Layer library ('libSDL', or simply 'SDL'; available from - https://www.libsdl.org/). Therefore, for the moment at least, one must - understand the C language and how to compile C-based programs. Familiarity - with the SDL API is highly recommended, but some basic SDL concepts will - be covered in this document. +Tux Paint is written in the C programming language, and uses the Simple +DirectMedia Layer library ('libSDL', or simply 'SDL'; available from https:// +www.libsdl.org/). Therefore, for the moment at least, one must understand the C +language and how to compile C-based programs. Familiarity with the SDL API is +highly recommended, but some basic SDL concepts will be covered in this +document. - Interfaces +Interfaces - Those who create 'Magic' tool plugins for Tux Paint must provide some - interfaces (C functions) that Tux Paint may invoke. +Those who create 'Magic' tool plugins for Tux Paint must provide some +interfaces (C functions) that Tux Paint may invoke. - Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" - routines to load plugins (shared objects files; e.g., ".so" files on Linux - or ".dll" files on Windows) and find the functions within. +Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" routines +to load plugins (shared objects files; e.g., ".so" files on Linux or ".dll" +files on Windows) and find the functions within. - In turn, Tux Paint provides a number of helper functions that the plugin - may (or sometimes is required to) use. This is exposed as a C structure - (or "struct") which contains pointers to functions and other data inside - Tux Paint. A pointer to this structure gets passed along to the plugin's - functions as an argument when Tux Paint invokes them. +In turn, Tux Paint provides a number of helper functions that the plugin may +(or sometimes is required to) use. This is exposed as a C structure (or +"struct") which contains pointers to functions and other data inside Tux Paint. +A pointer to this structure gets passed along to the plugin's functions as an +argument when Tux Paint invokes them. - Plugins should #include the C header file "tp_magic_api.h", which exposes - the 'Magic' tool plugin API. Also, when you run the C compiler to build a - plugin, you should use the command-line tool "tp-magic-config" to get the - appropriate compiler flags (such as where the compiler can find the Tux - Paint plugin header file, as well as SDL's header files) for building a - plugin. (See "Compiling", below.) +Plugins should #include the C header file "tp_magic_api.h", which exposes the +'Magic' tool plugin API. Also, when you run the C compiler to build a plugin, +you should use the command-line tool "tp-magic-config" to get the appropriate +compiler flags (such as where the compiler can find the Tux Paint plugin header +file, as well as SDL's header files) for building a plugin. (See "Compiling", +below.) - The C header file and command-line tool mentioned above are included with - Tux Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package". +The C header file and command-line tool mentioned above are included with Tux +Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin +Development package". 'Magic' tool plugin functions - 'Magic' tool plugins must contain the functions listed below. Note: To - avoid 'namespace' collisions, each function's name must start with the - shared object's filename (e.g., "blur.so" or "blur.dll" would have - functions whose names begin with "blur_"). This includes private functions - (ones not used by Tux Paint directly), unless you declare those as - 'static'. - - Common arguments to plugin functions - - Here is a description of arguments that many of your plugin's functions - will need to accept. - - magic_api * api - - Pointer to a C structure containing pointers to Tux Paint - functions and other data that the plugin can (and sometimes - should) use. The contents of this struct are described below. - - Note: The magic_api struct is defined in the C header file - "tp_magic_api.h", which you should include at the top of your - plugin's C source file: - - #include "tp_magic_api.h" - - int which - An index the plugin should use to differentiate different 'Magic' - tools, if the plugin provides more than one. (If not, "which" will - always be 0.) See "Creating plugins with multiple effects", below. +'Magic' tool plugins must contain the functions listed below. Note: To avoid +'namespace' collisions, each function's name must start with the shared +object's filename (e.g., "blur.so" or "blur.dll" would have functions whose +names begin with "blur_"). This includes private functions (ones not used by +Tux Paint directly), unless you declare those as 'static'. - SDL_Surface * snapshot - A snapshot of the previous Tux Paint canvas, taken when the the - mouse was first clicked to activate the current magic tool. If you - don't continuously affect the image during one hold of the mouse - button, you should base your effects off the contents of this - canvas. (That is, read from "snapshot" and write to "canvas", - below.) - - SDL_Surface * canvas - The current Tux Paint drawing canvas. Your magical effects should - end up here! - - SDL_Rect * update_rect - A pointer to an SDL 'rectangle' structure that you use to tell Tux - Paint what part of the canvas has been updated. If your effect - affects a 32x32 area centered around the mouse pointer, you would - fill the SDL_Rect as follows: - - update_rect->x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Informational + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Informational - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Getting Help +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Getting Help - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Glossary +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Glossary + + * alpha: See "RGBA" + * &: See "ampersand" + * ampersand (pointers): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * ampersand (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bit" + * API: Application Programming Interface. TBD + * argument: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * backtick: See "grave" + * bit: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "byte" + * blue: See "RGBA" + * boolean 'or': A mathematical operation that results in a true value if + either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 + | 0" results in "0".) + * |: See "boolean 'or'" + * .: See "dot" + * `: See "grave" + * *: See "star" + * byte: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * callback: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * channel: TBD + * click: The action of pressing a button on a mouse. + * coordinates: A set of numbers corresponding to a physical position; for + example, in a two-dimensional (2D) image, "X" and "Y" coordinates specify + the position across (left-to-right) and down the image, respectively. In + SDL, the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * dimensions: The size of an object, in terms of its width (left to right) + and height (top to bottom). + * .dll: See "Shared Object" + * dot: ".". A symbol in C that references an element within a struct. + * drag: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "floating point" + * floating point: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * green: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * header: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * hue: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * linear: TBD + * macro: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Plugin: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * prototype: See "C function prototype" + * red: See "RGBA" + * release: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "ampersand" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * unsigned: In C, a variable that can store a numeric value can be declared + as either "signed" (the default), or "unsigned". In the former case, one + bit of the value is used to denote the sign of the value (either positive + or negative). In the latter case, the value can only be positive, but + benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * value: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Dimensions" + * (x,y): See "Coordinates" - * alpha: See "RGBA" - * &: See "ampersand" - * ampersand (pointers): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * ampersand (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bit" - * API: Application Programming Interface. TBD - * argument: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * backtick: See "grave" - * bit: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "byte" - * blue: See "RGBA" - * boolean 'or': A mathematical operation that results in a true value if - either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in - "1". "0 | 0" results in "0".) - * |: See "boolean 'or'" - * .: See "dot" - * `: See "grave" - * *: See "star" - * byte: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * callback: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * channel: TBD - * click: The action of pressing a button on a mouse. - * coordinates: A set of numbers corresponding to a physical position; - for example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * dimensions: The size of an object, in terms of its width (left to - right) and height (top to bottom). - * .dll: See "Shared Object" - * dot: ".". A symbol in C that references an element within a struct. - * drag: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "floating point" - * floating point: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * green: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * header: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * hue: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * linear: TBD - * macro: A C construct that looks similar to a C function, but is simply - a #define that is expanded 'inline'. For example, if you declared the - macro "#define ADD(A,B) ((A)+(B))", and then used it with "c = - ADD(1,2);", that line of code would literally expand to "c = ((1) + - (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Plugin: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * prototype: See "C function prototype" - * red: See "RGBA" - * release: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "ampersand" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * unsigned: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * value: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Dimensions" - * (x,y): See "Coordinates" diff --git a/docs/es_ES.UTF-8/OPTIONS.txt b/docs/es_ES.UTF-8/OPTIONS.txt index 426e7924e..e32c28ac3 100644 --- a/docs/es_ES.UTF-8/OPTIONS.txt +++ b/docs/es_ES.UTF-8/OPTIONS.txt @@ -1,2011 +1,2183 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 -Options Documentation + Options Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - julio 13, 2023 + julio 13, 2023 - +---------------------------------------------+ - |Table of Contents | - |---------------------------------------------| - | * Tux Paint Config. | - | * Configuration File | - | * Available Options | - | * Video/Sound | - | * Mouse/Keyboard | - | * Simplification | - | * Languages | - | * Printing | - | * Saving | - | * Data | - | * Accessibility | - | * Joystick | - | * Overriding System Config. Options | - | * Command-Line Options | - | * Command-Line Informational Options | - | * Choosing a Different Language | - | * Available Languages | - | * Setting Your Environment's Locale | - | * Special Fonts | - +---------------------------------------------+ ++--------------------------------------------+ +| Table of Contents | +|--------------------------------------------| +| * Tux Paint Config. | +| * Configuration File | +| * Available Options | +| + Video/Sound | +| + Mouse/Keyboard | +| + Simplification | +| + Languages | +| + Printing | +| + Saving | +| + Data | +| + Accessibility | +| + Joystick | +| * Overriding System Config. Options | +| * Command-Line Options | +| + Command-Line Informational Options | +| * Choosing a Different Language | +| + Available Languages | +| + Setting Your Environment's Locale | +| + Special Fonts | ++--------------------------------------------+ - Tux Paint Config. +Tux Paint Config. - A graphical tool is available that allows you to change Tux Paint's - behavior. However, if you'd rather not install and use this tool, or want - a better understanding of the available options, please continue reading. +A graphical tool is available that allows you to change Tux Paint's behavior. +However, if you'd rather not install and use this tool, or want a better +understanding of the available options, please continue reading. - Configuration File +Configuration File - You can create a simple configuration file for Tux Paint, which it will - read each time you start it up. +You can create a simple configuration file for Tux Paint, which it will read +each time you start it up. - The file is simply a plain text file containing the options you want - enabled: +The file is simply a plain text file containing the options you want enabled: Linux and Unix Users - The file you should create is called ".tuxpaintrc" and it should be placed - in your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") +The file you should create is called ".tuxpaintrc" and it should be placed in +your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf macOS Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in your home folder, under the sub-folder: Library/Application - Support/TuxPaint +The file you should create is called "tuxpaint.cfg" and it should be placed in +your home folder, under the sub-folder: Library/Application Support/TuxPaint - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Windows Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in in your personal AppData folder: - C:\Users\username\AppData\Roaming\TuxPaint\ +The file you should create is called "tuxpaint.cfg" and it should be placed in +in your personal AppData folder: C:\Users\username\AppData\Roaming\TuxPaint\ - You can use NotePad or WordPad to create this file. Be sure to save it as - Plain Text, and make sure the filename doesn't have ".txt" at the end... +You can use NotePad or WordPad to create this file. Be sure to save it as Plain +Text, and make sure the filename doesn't have ".txt" at the end... - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ You can disable reading of this file altogether, leaving the settings as - defaults (which can then be overridden by your personal config. file - and/or command-line arguments) by using the command-line option - "--nosysconfig". +⚙ You can disable reading of this file altogether, leaving the settings as +defaults (which can then be overridden by your personal config. file and/or +command-line arguments) by using the command-line option "--nosysconfig". - Available Options +Available Options - The following settings can be set in the configuration file. (Command-line - settings will override these. See the "Command-Line Options" section, - below.) +The following settings can be set in the configuration file. (Command-line +settings will override these. See the "Command-Line Options" section, below.) Video/Sound - Video +Video - fullscreen=yes +fullscreen=yes - Run the program in full screen mode, rather than in a window. + Run the program in full screen mode, rather than in a window. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "fullscreen=no". - In both cases, may be overridden by the command-line option - "--windowed". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "fullscreen=no". In both cases, may be + overridden by the command-line option "--windowed". - fullscreen=native - Run the program in full screen mode. Additionally, assume the - screen's current resolution (set by the operating system). - windowsize=SIZE +fullscreen=native - Run the program at a different size (in windowed mode) or at a - different screen resolution (in fullscreen mode), rather than the - default (usually 800x600). + Run the program in full screen mode. Additionally, assume the screen's + current resolution (set by the operating system). - The SIZE value should be presented in pixels, in 'width-by-height' - format, with an "x" (lowercase X) between the values. The size can - be anything that's at least 640 wide, and at least 480 tall. - Some examples: - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=SIZE - 💡 If only one display is available, and Tux Paint is being run in - windowed (not fullscreen) mode, and the chosen window size exceeds - the capabilities of the display, Tux Paint will fall back to the - display's dimensions. + Run the program at a different size (in windowed mode) or at a different + screen resolution (in fullscreen mode), rather than the default (usually + 800x600). - orient=portrait + The SIZE value should be presented in pixels, in 'width-by-height' format, + with an "x" (lowercase X) between the values. The size can be anything + that's at least 640 wide, and at least 480 tall. - Swaps the width/height options given to Tux Paint, useful for - rotating the window on portait displays, such as a tablet PC - that's in tablet orientation. + Some examples: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 If only one display is available, and Tux Paint is being run in windowed + (not fullscreen) mode, and the chosen window size exceeds the capabilities + of the display, Tux Paint will fall back to the display's dimensions. - When running Tux Paint in fullscreen mode, this assumes the - screen's current resolution (overriding any "windowsize" option), - as set by the operating system. - allowscreensaver=yes - By default, Tux Paint prevents your system's screensaver from - starting up. You can override this by using the "allowscreensaver" - option. Note: This requires version 1.2.12 or higher of the SDL - library. (You can also do this by setting the - "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your system - to "1".) +orient=portrait - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both cases, - may be overridden by the command-line option - "--disablescreensaver". + Swaps the width/height options given to Tux Paint, useful for rotating the + window on portait displays, such as a tablet PC that's in tablet + orientation. - Sound + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "orient=landscape". In both cases, may + be overridden by the command-line option "--orient=landscape". - nosound=yes - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used - to reenable sounds if they were disabled using this option.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" or - "sound=yes". In both cases, may be overridden by the command-line - option "--sound". +native=yes - nostereo=yes + When running Tux Paint in fullscreen mode, this assumes the screen's + current resolution (overriding any "windowsize" option), as set by the + operating system. - Disable stereo panning support. (Useful for users with hearing - impairment in one ear, or places where a single speaker or - headphone is being used.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" or - "stereo=yes". In both cases, may be overridden by the command-line - option "--stereo". - Interface Size +allowscreensaver=yes - buttonsize=SIZE + By default, Tux Paint prevents your system's screensaver from starting up. + You can override this by using the "allowscreensaver" option. Note: This + requires version 1.2.12 or higher of the SDL library. (You can also do this + by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your + system to "1".) - Set the pixel size of buttons in Tux Paint's user interface - (overriding the default of "48"). Useful when using very - high-density displays or coarse input devices, such as eye gaze - trackers. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "allowscreensaver=no" or + "disablescreensaver=yes". In both cases, may be overridden by the + command-line option "--disablescreensaver". - The SIZE value should be presented in pixels, and can be anything - between 24 and 192, inclusive. Most buttons are square, and this - will affect their width and height. - A value of "auto" may be provided, and Tux Paint will choose a - suitable button size based on the size of Tux Paint's window (or - fullscreen display). (For the default screen size of 800x600, it - will be the default button size: "48".) - 💡 Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux Paint's - chosen window size, the largest possible button size will be used. - (A note will appear in stderr.) - colorsrows=ROWS +Sound + +nosound=yes + + Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to + reenable sounds if they were disabled using this option.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nosound=no" or "sound=yes". In both + cases, may be overridden by the command-line option "--sound". + + + +nostereo=yes + + Disable stereo panning support. (Useful for users with hearing impairment + in one ear, or places where a single speaker or headphone is being used.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostereo=no" or "stereo=yes". In both + cases, may be overridden by the command-line option "--stereo". + + + + +Interface Size + +buttonsize=SIZE + + Set the pixel size of buttons in Tux Paint's user interface (overriding the + default of "48"). Useful when using very high-density displays or coarse + input devices, such as eye gaze trackers. + + The SIZE value should be presented in pixels, and can be anything between + 24 and 192, inclusive. Most buttons are square, and this will affect their + width and height. + + A value of "auto" may be provided, and Tux Paint will choose a suitable + button size based on the size of Tux Paint's window (or fullscreen + display). (For the default screen size of 800x600, it will be the default + button size: "48".) + + 💡 Note: If the chosen button size would cause the buttons to be too large + for all required UI elements to appear under Tux Paint's chosen window + size, the largest possible button size will be used. (A note will appear in + stderr.) + + + +colorsrows=ROWS + + How many rows of color palette buttons to show; useful when using a large + color palette (see "colorfile", above), and/or for use with coarse input + devices (like eyegaze trackers). "ROWS" may be between "1" (the default) + and "3". + + - How many rows of color palette buttons to show; useful when using - a large color palette (see "colorfile", above), and/or for use - with coarse input devices (like eyegaze trackers). "ROWS" may be - between "1" (the default) and "3". Mouse/Keyboard - Cursor +Cursor - nofancycursors=yes +nofancycursors=yes - This disables the fancy mouse pointer shapes in Tux Paint, and - uses your environment's normal mouse pointer. + This disables the fancy mouse pointer shapes in Tux Paint, and uses your + environment's normal mouse pointer. - In some enviornments, the fancy cursors cause problems. Use this - option to avoid them. + In some enviornments, the fancy cursors cause problems. Use this option to + avoid them. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nofancycursors=no" or "fancycursors= + yes". In both cases, may be overridden by the command-line option + "--fancycursors". - hidecursor=yes - This completely hides the mouse pointer shapes in Tux Paint. - This is useful for touchscreen devices, such as tablet PCs. +hidecursor=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "hidecursor=no" - or "showcursor=yes". In both cases, may be overridden by the - command-line option "--showcursor". + This completely hides the mouse pointer shapes in Tux Paint. - Keyboard + This is useful for touchscreen devices, such as tablet PCs. - noshortcuts=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "hidecursor=no" or "showcursor=yes". In + both cases, may be overridden by the command-line option "--showcursor". - This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, - [Ctrl]-[N] for a new image, etc.) - This is useful to prevent unwanted commands from being activated - by children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noshortcuts=no" - or "shortcuts=yes". In both cases, may be overridden by the - command-line option "--shortcuts". - Mouse +Keyboard - grab=yes +noshortcuts=yes - Tux Paint will attempt to 'grab' the mouse and keyboard, so that - the mouse is confined to Tux Paint's window, and nearly all - keyboard input is passed directly to it. + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for + a new image, etc.) - This is useful to disable operating system actions that could get - the user out of Tux Paint [Alt]-[Tab] window cycling, - [Ctrl]-[Escape], etc. This is especially useful in fullscreen - mode. + This is useful to prevent unwanted commands from being activated by + children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In + both cases, may be overridden by the command-line option "--shortcuts". - nowheelmouse=yes - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the right.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". - nobuttondistinction=yes +Mouse + +grab=yes + + Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse + is confined to Tux Paint's window, and nearly all keyboard input is passed + directly to it. + + This is useful to disable operating system actions that could get the user + out of Tux Paint [Alt]-[Tab] window cycling, [Ctrl]-[Escape], etc. This is + especially useful in fullscreen mode. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "grab=no" or "dontgrab=yes". In both + cases, may be overridden by the command-line option "--dontgrab". + + + +nowheelmouse=yes + + This disables support for the wheel on mice that have it. (Normally, the + wheel will scroll the selector menu on the right.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". + In both cases, may be overridden by the command-line option "--wheelmouse". + + + +nobuttondistinction=yes + + Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could + also be used for clicking. In version 0.9.15, it was changed so that only + the left mouse button worked, so as to not train children to use the wrong + button. + + However, for children who have trouble with the mouse, this distinction + between the two or three buttons on a mouse can be disabled (returning Tux + Paint to its old behavior) by using this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobuttondistinction=no" or + "buttondistinction=yes". In both cases, may be overridden by the + command-line option "--buttondistinction". - Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse - could also be used for clicking. In version 0.9.15, it was changed - so that only the left mouse button worked, so as to not train - children to use the wrong button. - However, for children who have trouble with the mouse, this - distinction between the two or three buttons on a mouse can be - disabled (returning Tux Paint to its old behavior) by using this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". Simplification - Interface Simplification +Interface Simplification - simpleshapes=yes +simpleshapes=yes - Disable the rotation step of the 'Shape' tool. Click, drag and - release is all that will be needed to draw a shape. + Disable the rotation step of the 'Shape' tool. Click, drag and release is + all that will be needed to draw a shape. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "simpleshapes=no" or "complexshapes= + yes". In both cases, may be overridden by the command-line option + "--complexshapes". - nooutlines=yes - In this mode, much simpler outlines and 'rubber-band' lines are - displayed when using the Lines, Shapes, Stamps and Eraser tools. - This can help when Tux Paint is run on very slow computers, or - displayed on a remote X-Window display. +nooutlines=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nooutlines=no" - or "outlines=yes". In both cases, may be overridden by the - command-line option "--outlines". + In this mode, much simpler outlines and 'rubber-band' lines are displayed + when using the Lines, Shapes, Stamps and Eraser tools. - uppercase=yes + This can help when Tux Paint is run on very slow computers, or displayed on + a remote X-Window display. - All text will be rendered only in uppercase (e.g., "Brush" will be - "BRUSH"). Useful for children who can read, but who have only - learned uppercase letters so far. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nooutlines=no" or "outlines=yes". In + both cases, may be overridden by the command-line option "--outlines". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". - Initial Stamp Size - stampsize=SIZE +uppercase=yes - Use this option to force Tux Paint to set the starting size of all - stamps. The SIZE value should be between 0 (smallest) and 10 - (largest). The size is relative to the available sizes of the - stamp, which depends on the stamp itself, and Tux Paint's current - canvas size. + All text will be rendered only in uppercase (e.g., "Brush" will be + "BRUSH"). Useful for children who can read, but who have only learned + uppercase letters so far. - Specify "default" to let Tux Paint decide (its standard behavior). + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "uppercase=no" or "mixedcase=yes". In + both cases, may be overridden by the command-line option "--mixedcase". - Control Simplification - noquit=yes - Disable the on-screen "Quit" button and prevent the [Escape] key - from quitting Tux Paint. - Using the [Alt] + [F4] keyboard combination or clicking the - window's close button (assuming you're not in fullscreen mode) - still works to quit Tux Paint. +Initial Stamp Size - You can also use the following keyboard combination to quit: - [Shift] + [Control] + [Escape]. +stampsize=SIZE - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Use this option to force Tux Paint to set the starting size of all stamps. + The SIZE value should be between 0 (smallest) and 10 (largest). The size is + relative to the available sizes of the stamp, which depends on the stamp + itself, and Tux Paint's current canvas size. - nostamps=yes + Specify "default" to let Tux Paint decide (its standard behavior). - This option tells Tux Paint to not load any rubber stamp images, - which in turn ends up disabling the Stamps tool. - This can speed up Tux Paint when it first loads up, and reduce - memory usage while it's running. Of course, no stamps will be - available at all. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" or - "stamps=yes". In both cases, may be overridden by the command-line - option "--stamps". - nostampcontrols=yes +Control Simplification - Some images in the Stamps tool can be mirrored, flipped, and/or - have their size changed. This option disables the controls, and - only provides the basic stamps. +noquit=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be - overridden by the command-line option "--stampcontrols". + Disable the on-screen "Quit" button and prevent the [Escape] key from + quitting Tux Paint. - nostamprotation=yes + Using the [Alt] + [F4] keyboard combination or clicking the window's close + button (assuming you're not in fullscreen mode) still works to quit Tux + Paint. - This disables the rotation step of the Stamps tool, immediately - placing the stamp in its regular orientation (with any flipping or - mirroring applied) on the first click. + You can also use the following keyboard combination to quit: [Shift] + + [Control] + [Escape]. - 📜 Note: The stamp rotation feature was added to Tux Paint in - version 0.9.29. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noquit=no" or "quit=yes". In both + cases, may be overridden by the command-line option "--quit". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostamprotation=no" or "stamprotation=yes". In both cases, may be - overridden by the command-line option "--stamprotation". - nomagiccontrols=yes - Some Magic tools have the option of acting like a paintbrush, or - affecting the entire canvas at once. This option disables the - controls, and only provides the default functionality (usually - paint-mode). +nostamps=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be - overridden by the command-line option "--magiccontrols". + This option tells Tux Paint to not load any rubber stamp images, which in + turn ends up disabling the Stamps tool. - nomagicsizes=yes + This can speed up Tux Paint when it first loads up, and reduce memory usage + while it's running. Of course, no stamps will be available at all. - Some Magic tools offer various size settings. This option disables - the sizing control, and only provides the tools' default sizes. - (Some plugins may offer additional variations of a Magic tool, to - make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamps=no" or "stamps=yes". In both + cases, may be overridden by the command-line option "--stamps". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagicsizes=no" or "magicsizes=yes". In both cases, may be - overridden by the command-line option "--magicsizes". - noshapecontrols=yes - Disable the control buttons shown when using the Shapes tool that - allow changing how shapes are drawn — centered around the initial - mouse click, or with a corner at the initial mouse click. +nostampcontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be - overridden by the command-line option "--shapecontrols". + Some images in the Stamps tool can be mirrored, flipped, and/or have their + size changed. This option disables the controls, and only provides the + basic stamps. - nolabel=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostampcontrols=no" or "stampcontrols= + yes". In both cases, may be overridden by the command-line option + "--stampcontrols". - Disables the Label tool: the tool that allows text entry which can - be edited later. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" or - "label=yes". In both cases, may be overridden by the command-line - option "--label". - nobrushspacing=yes +nostamprotation=yes - Disables the brush spacing option of the Paint and Lines tools. - The brushes' default spacings will be used. + This disables the rotation step of the Stamps tool, immediately placing the + stamp in its regular orientation (with any flipping or mirroring applied) + on the first click. - 📜 Note: The brush spacing option was added to Tux Paint's user - interface in version 0.9.28. For more information on brush - spacing, see EXTENDING.html + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobrushspacing=no" or "brushspacing=yes". In both cases, may be - overridden by the command-line option "--brushspacing". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamprotation=no" or "stamprotation= + yes". In both cases, may be overridden by the command-line option + "--stamprotation". - notemplateexport=yes - Disables the ability to create a new Template image (based on a - saved drawing) from within the Open dialog. - 📜 Note: The Template creation feature was added to Tux Paint in - version 0.9.31. +nomagiccontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "notemplateexport=no" or "templateexport=yes". In both cases, may - be overridden by the command-line option "--templateexport". + Some Magic tools have the option of acting like a paintbrush, or affecting + the entire canvas at once. This option disables the controls, and only + provides the default functionality (usually paint-mode). - noerase=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagiccontrols=no" or "magiccontrols= + yes". In both cases, may be overridden by the command-line option + "--magiccontrols". + + + +nomagicsizes=yes + + Some Magic tools offer various size settings. This option disables the + sizing control, and only provides the tools' default sizes. (Some plugins + may offer additional variations of a Magic tool, to make a few sizes + possible, e.g. "Bricks" and "Googly Eyes".) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagicsizes=no" or "magicsizes=yes". + In both cases, may be overridden by the command-line option "--magicsizes". + + + +noshapecontrols=yes + + Disable the control buttons shown when using the Shapes tool that allow + changing how shapes are drawn — centered around the initial mouse click, or + with a corner at the initial mouse click. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshapecontrols=no" or "shapecontrols= + yes". In both cases, may be overridden by the command-line option + "--shapecontrols". + + + +nolabel=yes + + Disables the Label tool: the tool that allows text entry which can be + edited later. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nolabel=no" or "label=yes". In both + cases, may be overridden by the command-line option "--label". + + + +nobrushspacing=yes + + Disables the brush spacing option of the Paint and Lines tools. The + brushes' default spacings will be used. + + 📜 Note: The brush spacing option was added to Tux Paint's user interface in + version 0.9.28. For more information on brush spacing, see EXTENDING.html + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobrushspacing=no" or "brushspacing= + yes". In both cases, may be overridden by the command-line option + "--brushspacing". + + + +notemplateexport=yes + + Disables the ability to create a new Template image (based on a saved + drawing) from within the Open dialog. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "notemplateexport=no" or + "templateexport=yes". In both cases, may be overridden by the command-line + option "--templateexport". + + + +noerase=yes + + Disables the ability to erase saved drawings via the "Erase" button on the + Open dialog, or exported Template images (based on a saved drawing) via the + "Erase" button on the New dialog. Useful to prevent users from erasing + work, especially combined with the --saveovernew option. + + 📜 Note: This option was added to Tux Paint in version 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noerase=no" or "erase=yes". In both + cases, may be overridden by the command-line option "--erase". - Disables the ability to erase saved drawings via the "Erase" - button on the Open dialog, or exported Template images (based on a - saved drawing) via the "Erase" button on the New dialog. Useful to - prevent users from erasing work, especially combined with the - --saveovernew option. - 📜 Note: This option was added to Tux Paint in version 0.9.31. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noerase=no" or - "erase=yes". In both cases, may be overridden by the command-line - option "--erase". Languages - Language +Language - lang=LANGUAGE +lang=LANGUAGE - Run Tux Paint in one of the supported languages. Possible choices - for LANGUAGE currently include: + Run Tux Paint in one of the supported languages. Possible choices for + LANGUAGE currently include: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale LOCALE - Run Tux Paint in one of the support languages. See the "Choosing a - Different Language" section below for the locale strings (e.g., - "de_DE" for German) to use. - (If your locale is already set, e.g. with the "$LANG" environment - variable, this option is not necessary, since Tux Paint honors - your environment's setting, if possible.) +--locale LOCALE - mirrorstamps=yes + Run Tux Paint in one of the support languages. See the "Choosing a + Different Language" section below for the locale strings (e.g., "de_DE" for + German) to use. - For stamps that can be mirrored, this option sets them to their - mirrored shape by default. + (If your locale is already set, e.g. with the "$LANG" environment variable, + this option is not necessary, since Tux Paint honors your environment's + setting, if possible.) - This can be useful for people who prefer things right-to-left, - rather than left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be - overridden by the command-line option "--dontmirrorstamps". - Fonts +mirrorstamps=yes - sysfonts=yes + For stamps that can be mirrored, this option sets them to their mirrored + shape by default. - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. + This can be useful for people who prefer things right-to-left, rather than + left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" or - "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps= + yes". In both cases, may be overridden by the command-line option + "--dontmirrorstamps". - alllocalefonts=yes - Prior to version 0.9.21, Tux Paint loaded all fonts in its own - fonts directory, including locale-specific ones (e.g., the one for - Tibetan, which had no latin characters). As of 0.9.21, the only - font loaded from the locale-specific subdirectory, if any, is one - matching the locale Tux Paint is running on. - To load all locale-specific fonts (the old behavior), set this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may - be overridden by the command-line option "--currentlocalefont". +Fonts + +sysfonts=yes + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In + both cases, may be overridden by the command-line option "--nosysfonts". + + + +alllocalefonts=yes + + Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts + directory, including locale-specific ones (e.g., the one for Tibetan, which + had no latin characters). As of 0.9.21, the only font loaded from the + locale-specific subdirectory, if any, is one matching the locale Tux Paint + is running on. + + To load all locale-specific fonts (the old behavior), set this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "alllocalefonts=no" or + "currentlocalefont=yes". In both cases, may be overridden by the + command-line option "--currentlocalefont". + + + +uifont=FONT NAME + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + Specify "default" to let Tux Paint use its default font, "DejaVu Sans" (its + standard behavior). - uifont=FONT NAME - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. - Specify "default" to let Tux Paint use its default font, "DejaVu - Sans" (its standard behavior). Printing - Print Permissions +Print Permissions - noprint=yes +noprint=yes - Disable the printing feature. + Disable the printing feature. - printdelay=SECONDS - Restrict printing so that printing can occur only once every - SECONDS seconds. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printdelay=0". - In both cases, may be overridden by the command-line option - "--printdelay=0". +printdelay=SECONDS - Show Printer Dialog + Restrict printing so that printing can occur only once every SECONDS + seconds. - altprint=always + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "printdelay=0". In both cases, may be + overridden by the command-line option "--printdelay=0". - This causes Tux Paint to always show the printer dialog (or, on - Linux/Unix, run the "altprintcommand") when the 'Print' button is - clicked. In other words, it's like clicking 'Print' while holding - [Alt], except you don't need to hold [Alt] every time. - altprint=never - This prevents Tux Paint from ever showing the printer dialog (or, - on Linux/Unix, run the "altprintcommand") when the 'Print' button - is clicked. In other words, it makes the [Alt] key have no effect - when clicking the 'Print' button. - altprint=mod +Show Printer Dialog - This is the normal, default behavior. Tux Paint shows a printer - dialog (or, on Linux/Unix, runs the "altprintcommand"), when the - [Alt] key is pressed while the 'Print' button is clicked. Clicking - 'Print' without holding [Alt] prints without showing a dialog. +altprint=always - Save Printer Configuration + This causes Tux Paint to always show the printer dialog (or, on Linux/Unix, + run the "altprintcommand") when the 'Print' button is clicked. In other + words, it's like clicking 'Print' while holding [Alt], except you don't + need to hold [Alt] every time. - printcfg=yes - (Windows and macOS only) - Tux Paint will use a printer configuration file when printing. - Push the [Alt] key while clicking the 'Print' button in Tux - Paint to cause a Windows print dialog window to appear. +altprint=never - Any configuration changes made in this dialog will be saved to - the file "userdata/print.cfg" , and used again, as long as the - "printcfg" option is set. + This prevents Tux Paint from ever showing the printer dialog (or, on Linux/ + Unix, run the "altprintcommand") when the 'Print' button is clicked. In + other words, it makes the [Alt] key have no effect when clicking the + 'Print' button. - 💡 Note: This only works when not running Tux Paint in fullscreen - mode. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". - Print Commands +altprint=mod - printcommand=COMMAND + This is the normal, default behavior. Tux Paint shows a printer dialog (or, + on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed + while the 'Print' button is clicked. Clicking 'Print' without holding [Alt] + prints without showing a dialog. - (Linux and Unix only) - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked. If this option is not - specifically not set, the default command is: - lpr - 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format - data to the print command (which defaulted to "pngtopnm | - pnmtops | lpr"). +Save Printer Configuration - If you set an alternative printcommand in the configuration file - prior to version 0.9.15, you will need to change it. + printcfg=yes - altprintcommand=COMMAND + (Windows and macOS only) - (Linux and Unix only) + Tux Paint will use a printer configuration file when printing. Push the + [Alt] key while clicking the 'Print' button in Tux Paint to cause a + Windows print dialog window to appear. - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked while the [Alt] modifier key is - being held. (This is typically used for providing a print - dialog, similar to when pressing [Alt]+'Print' in Windows and - macOS.) + Any configuration changes made in this dialog will be saved to the file + "userdata/print.cfg" , and used again, as long as the "printcfg" option + is set. - If this option is not specifically not set, the default command - is KDE's graphical print dialog: + 💡 Note: This only works when not running Tux Paint in fullscreen mode. - kprinter + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "printcfg=no" or "noprintcfg= + yes". In both cases, may be overridden by the command-line option + "--noprintcfg". - Paper Size - papersize=PAPERSIZE - (Platforms that use Tux Paint's internal PostScript generator — - not Windows, macOS, BeOS, or Haiku.) - Tell Tux Paint what size PostScript to generate. If none is - specified, Tux Paint first checks your $PAPER environment - variable, then the file /etc/papersize, then uses the the - 'libpaper' library's default paper size. + Print Commands - Valid paper sizes include: letter, legal, tabloid, executive, - note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, - b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, - halfnote, folio, quarto, ledger, archA, archB, archC, archD, - archE, flsa, flse, csheet, dsheet, esheet. + printcommand=COMMAND -Saving + (Linux and Unix only) - Save Over Earlier Work + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked. If this option is not specifically not set, + the default command is: - saveover=yes + lpr - This disables the "Save over the old version...?" prompt when - saving an existing file. With this option, the older version - will always be replaced by the new version, automatically. + 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data to + the print command (which defaulted to "pngtopnm | pnmtops | lpr"). - saveover=new + If you set an alternative printcommand in the configuration file prior + to version 0.9.15, you will need to change it. - This also disables the "Save over the old version...?" prompt - when saving an existing file. This option, however, will always - save a new file, rather than overwrite the older version. - saveover=ask - (This option is redundant, since this is the default.) When - saving an existing drawing, you will be first asked whether to - save over the older version or not. + altprintcommand=COMMAND - Starting Out + (Linux and Unix only) - startblank=yes + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked while the [Alt] modifier key is being held. + (This is typically used for providing a print dialog, similar to when + pressing [Alt]+'Print' in Windows and macOS.) - This causes Tux Paint to display a blank canvas when it first - starts up, rather than loading the last image that was being - edited. + If this option is not specifically not set, the default command is + KDE's graphical print dialog: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". + kprinter - newcolorslast=yes - Places the blank color options in the New dialog at the end, so - that any Starters and/or Templates are shown first. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". - Save and Export Directories + Paper Size - savedir=DIRECTORY + papersize=PAPERSIZE - Use this option to change where Tux Paint's "saved" - directory/folder is located, which is where Tux Paint saves and - opens pictures. + (Platforms that use Tux Paint's internal PostScript generator — not + Windows, macOS, BeOS, or Haiku.) - If you do not override it, the default location is: + Tell Tux Paint what size PostScript to generate. If none is specified, + Tux Paint first checks your $PAPER environment variable, then the file + /etc/papersize, then uses the the 'libpaper' library's default paper + size. - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/saved/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/saved/ + Valid paper sizes include: letter, legal, tabloid, executive, note, + statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, + b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, + ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, + esheet. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - 📜 Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - Example: savedir=Z:\tuxpaint\ - exportdir=DIRECTORY + Saving - Use this option to change where Tux Paint exports files — single - images, or animated GIF slideshows — for external use. + Save Over Earlier Work - If you do not override it, the default location is: + saveover=yes - * Linux & Unix — If available, wherever your desktop - environment is configured for pictures to be stored, based - on your XDG (X Desktop Group) configuration. (Try running - the command-line "xdg-user-dir PICTURES" to find out.) - Typically (in an English locale), this will be a "Pictures" - subdirectory in your home directory (i.e., "$HOME/Pictures" - aka "~/Pictures"). - Tux Paint will fall back to using that typical directory, - of no XDG configuration can be read, or nothing is set for - "XDG_PICTURES_DIR". - * Windows - "My Pictures" directory for each user (normaly - "c:\Users\USERNAME\Pictures"). - You can directly open the folder as follows: - * Press "[Windows]+[R]" key to open "Run ..." dialogue. - * Enter "Shell:My Pictures" in the text box and push - [OK]. - * macOS — TBD! + This disables the "Save over the old version...?" prompt when saving an + existing file. With this option, the older version will always be + replaced by the new version, automatically. - 💡 Note: When the defaults are used, a new "TuxPaint" - subdirectory will be created and used. (e.g., - "~/Pictures/TuxPaint") When the "--exportdir" option is used, - the exact path specified will be used (no "TuxPaint" - subdirectory is created). - The directory itself (e.g., "~/Pictures/TuxPaint") will be - created, if it doesn't exist. - If the parent directory (e.g., "~/Pictures/TuxPaint") also does - not exist, Tux Paint will attempt to create it as well (but not - any directories higher than that). + saveover=new - Example: exportdir=/home/penguin/TuxPaintExports + This also disables the "Save over the old version...?" prompt when + saving an existing file. This option, however, will always save a new + file, rather than overwrite the older version. - More Saving Options - nosave=yes - This disables Tux Paint's ability to save files (and therefore - disables the on-screen "Save" button). It can be used in - situations where the program is only being used for fun, or in a - test environment. + saveover=ask - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". + (This option is redundant, since this is the default.) When saving an + existing drawing, you will be first asked whether to save over the + older version or not. - autosave=yes - This prevents Tux Paint from asking whether you want to save the - current picture when quitting, and assumes you do. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - reversesort=yes + Starting Out - This reverses the sorting of the Open and Slideshow dialogs, - placing the newest images at the top of the list. + startblank=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "reversesort=no" or "noreversesort=yes". In both cases, may be - overridden by the command-line option "--noreversesort". + This causes Tux Paint to display a blank canvas when it first starts + up, rather than loading the last image that was being edited. -Data + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "startblank=no" or "startlast= + yes". In both cases, may be overridden by the command-line option + "--startlast". - Lockfile - nolockfile=yes - By default, Tux Paint uses what's known as a 'lockfile' to - prevent it from being launched more than once in 30 seconds. - (This is to avoid accidentally running multiple copies; for - example, by double-clicking a single-click launcher, or simply - impatiently clicking the icon multiple times.) + newcolorslast=yes - To make Tux Paint ignore the lockfile, allowing it to run again, - even if it was just launched less than 30 seconds ago, enable - this setting in the configuration file, or run Tux Paint with - the --nolockfile option on the command-line. + Places the blank color options in the New dialog at the end, so that + any Starters and/or Templates are shown first. - By default, the lockfile is stored in "~/.tuxpaint/" under Linux - and Unix, and "userdata\" under Windows. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "newcolorslast=no" or + "newcolorsfirst=yes". In both cases, may be overridden by the + command-line option "--newcolorsfirst". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". - Data Directory - datadir=DIRECTORY - Use this option to change where Tux Paint looks for personal - data files (brushes, stamps, starters, templates, and fonts - specific to the current user). - - Tux Paint will search for subdirectories/subfolders named - "brushes", "stamps", "starters", "templates", and "fonts" under - the specified data directory. - - If you do not override it, the default location is: - - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/brushes/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/brushes/ + Save and Export Directories - 📜 Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. + savedir=DIRECTORY - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. + Use this option to change where Tux Paint's "saved" directory/folder is + located, which is where Tux Paint saves and opens pictures. - Example: datadir=/home/johnny/tuxpaint-data/ + If you do not override it, the default location is: - Color Palette File + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/saved/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\saved\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/saved + / - colorfile=FILENAME + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - You may override Tux Paint's default color palette by creating a - plain ASCII text file that describes the colors you want, and - pointing to that file using the "colorfile" option. + 📜 Note: Prior to version 0.9.18, Tux Paint would also use the setting + or default for "savedir" as the place to search for personal data files + (brushes, stamps, starters and fonts). As of version 0.9.18, they may + be specified separately (see the "datadir" option, below). - The file should list one color per line. Colors are defined in - terms of their Red, Green and Blue values, each from 0 (off) to - 255 (brightest). (For more information, try Wikipedia's "RGB - color model" article.) + Example: savedir=Z:\tuxpaint\ - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). - After the color definition (on the same line) you may enter text - to describe the color. Tux will display this text when the color - is clicked. (For example, "#FFF White as snow.") - As an example, you can see the default colors currently used in - Tux Paint in: "default_colors.txt". + exportdir=DIRECTORY - NOTES: You must separate decimal values with spaces, and begin - hexadecimal values with a pound/number-sign character ("#"). In - 3-digit hexadecimal, each digit is used for both the high and - low halves of the byte, so "#FFF" is the same as "#FFFFFF", not - "#F0F0F0". + Use this option to change where Tux Paint exports files — single + images, or animated GIF slideshows — for external use. -Accessibility + If you do not override it, the default location is: - Mouse + o Linux & Unix — If available, wherever your desktop environment is + configured for pictures to be stored, based on your XDG (X Desktop + Group) configuration. (Try running the command-line "xdg-user-dir + PICTURES" to find out.) + Typically (in an English locale), this will be a "Pictures" + subdirectory in your home directory (i.e., "$HOME/Pictures" aka "~/ + Pictures"). + Tux Paint will fall back to using that typical directory, of no XDG + configuration can be read, or nothing is set for + "XDG_PICTURES_DIR". + o Windows - "My Pictures" directory for each user (normaly "c:\Users\ + USERNAME\Pictures"). + You can directly open the folder as follows: + # Press "[Windows]+[R]" key to open "Run ..." dialogue. + # Enter "Shell:My Pictures" in the text box and push [OK]. + o macOS — TBD! - mouse-accessibility=yes + 💡 Note: When the defaults are used, a new "TuxPaint" subdirectory will + be created and used. (e.g., "~/Pictures/TuxPaint") When the + "--exportdir" option is used, the exact path specified will be used (no + "TuxPaint" subdirectory is created). - In this mode, instead of clicking, dragging and releasing (e.g., - to draw), you click, move, and click again to end the motion. + The directory itself (e.g., "~/Pictures/TuxPaint") will be created, if + it doesn't exist. - Keyboard + If the parent directory (e.g., "~/Pictures/TuxPaint") also does not + exist, Tux Paint will attempt to create it as well (but not any + directories higher than that). - keyboard=yes + Example: exportdir=/home/penguin/TuxPaintExports - This allows the keyboard arrow keys to be used to control the - mouse pointer. (e.g., for mouseless environments, or - handicapped/accessibility purposes) - Features: - * Fine movement within canvas, or coarse movement if Shift is - held. - * Coarse movement within tool button areas. - * Key controls: - * [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move - mouse - * [Space]/[5]: Click mouse (except when using "Text" or - "Label" tools) - * [Insert]/[F5]: Click mouse (always) - * [F4] jump mouse between "Tools", "Colors" and canvas - areas - * If mouse is within "Tools" section on the left, or - "Colors" section at the bottom: - * [F7], [F8]: Move down/up between buttons, - respectively (Tools section, only) - * [F11], [F12]: Move to previous/next button, - respectively - * To click-and-drag, hold one of the 'click' keys (e.g., - [Insert]), and use the movement keys (e.g., [Left]). - 💡 Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a 'click' - key to start clicking, movement keys to move around (which - will draw), and another 'click' key to end the click (stop - drawing). + More Saving Options - * A regular mouse and/or joystick may still be used (so you - can, e.g., move with the mouse, and click with the - keyboard, or vice-versa) + nosave=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "mouse=yes". In both cases, may be overridden by the - command-line option "--mouse". + This disables Tux Paint's ability to save files (and therefore disables + the on-screen "Save" button). It can be used in situations where the + program is only being used for fun, or in a test environment. - Onscreen Keyboard + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nosave=no" or "save=yes". In + both cases, may be overridden by the command-line option "--save". - onscreen-keyboard=yes - Presents a clickable on-screen keyboard when using the Text and - Label tools. - onscreen-keyboard-layout=LAYOUTNAME + autosave=yes - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. + This prevents Tux Paint from asking whether you want to save the + current picture when quitting, and assumes you do. - onscreen-keyboard-disable-change=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "autosave=no" or "noautosave= + yes". In both cases, may be overridden by the command-line option + "--noautosave". - Disables the possibility for changing the layout of the - on-screen keyboard when using the Text and Label tools, useful - for simplifying things for the small children. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". -Joystick + reversesort=yes - Main Device + This reverses the sorting of the Open and Slideshow dialogs, placing + the newest images at the top of the list. - joystick-dev=N + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "reversesort=no" or + "noreversesort=yes". In both cases, may be overridden by the + command-line option "--noreversesort". - Specify which joystick device should be used by Tux Paint. - Default value is 0 (the first joystick). - joystick-slowness=SPEED - Sets a delay at each axis motion, allowing to slow the joystick. - Allowed values are from 0 to 500. Default value is 15. - joystick-threshold=THRESHOLD + Data - Sets the minimum level of axis motion to start moving the - pointer. Allowed values are from 0 to 32766. Default value is - 3200. + Lockfile - joystick-maxsteps=STEPS + nolockfile=yes - Sets the maximum pixels the pointer will move at once. Allowed - values are from 1 to 7. Default value is 7. + By default, Tux Paint uses what's known as a 'lockfile' to prevent it + from being launched more than once in 30 seconds. (This is to avoid + accidentally running multiple copies; for example, by double-clicking a + single-click launcher, or simply impatiently clicking the icon multiple + times.) - Hat + To make Tux Paint ignore the lockfile, allowing it to run again, even + if it was just launched less than 30 seconds ago, enable this setting + in the configuration file, or run Tux Paint with the --nolockfile + option on the command-line. - joystick-hat-slowness=SPEED + By default, the lockfile is stored in "~/.tuxpaint/" under Linux and + Unix, and "userdata\" under Windows. - Sets a delay at each automatic motion, allowing to slow the - speed of the hat. Allowed values are from 0 to 500. Default - value is 15. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nolockfile=no" or "lockfile= + yes". In both cases, may be overridden by the command-line option + "--lockfile". - joystick-hat-timeout=MILLISECONDS - Sets the delay after wich the pointer will start moving - automatically if the hat is keeped pushed. Allowed values are - from 0 to 3000. Default value is 1000. - Buttons to Disable - joystick-buttons-ignore=BUTTON1,BUTTON2,... + Data Directory - A set of joystick button numbers, as seen by SDL, that should be - ignored. Otherwise, unless they are used by one of the - "joystick-btn-" options above, buttons will be seen as a mouse - left-click. + datadir=DIRECTORY - Button Shortcuts + Use this option to change where Tux Paint looks for personal data files + (brushes, stamps, starters, templates, and fonts specific to the + current user). - joystick-btn-escape=BUTTON NUMBER + Tux Paint will search for subdirectories/subfolders named "brushes", + "stamps", "starters", "templates", and "fonts" under the specified data + directory. - Selects the joystick button number, as seen by SDL, that will be - used to generate a escape event. Useful to dismiss dialogs and - quit. + If you do not override it, the default location is: - joystick-btn-brush=BUTTON NUMBER + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/brushes/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\brushes\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/ + brushes/ - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the brush tool. + 📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting + or default as for "savedir" to search for data files. As of version + 0.9.18, they may be specified separately. - joystick-btn-stamp=BUTTON NUMBER + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the stamp tool. + Example: datadir=/home/johnny/tuxpaint-data/ - joystick-btn-lines=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the lines tool. - joystick-btn-shapes=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the shapes tool. + Color Palette File - joystick-btn-text=BUTTON NUMBER + colorfile=FILENAME - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the text tool. + You may override Tux Paint's default color palette by creating a plain + ASCII text file that describes the colors you want, and pointing to + that file using the "colorfile" option. - joystick-btn-label=BUTTON NUMBER + The file should list one color per line. Colors are defined in terms of + their Red, Green and Blue values, each from 0 (off) to 255 (brightest). + (For more information, try Wikipedia's "RGB color model" article.) - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the label tool. + Colors may be listed using three decimal numbers (e.g., "255 68 136") + or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "# + F48"). - joystick-btn-fill=BUTTON NUMBER + After the color definition (on the same line) you may enter text to + describe the color. Tux will display this text when the color is + clicked. (For example, "#FFF White as snow.") - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the fill tool. + As an example, you can see the default colors currently used in Tux + Paint in: "default_colors.txt". - joystick-btn-magic=BUTTON NUMBER + NOTES: You must separate decimal values with spaces, and begin + hexadecimal values with a pound/number-sign character ("#"). In 3-digit + hexadecimal, each digit is used for both the high and low halves of the + byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the magic tool. - joystick-btn-undo=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to invoke the undo tool. - joystick-btn-redo=BUTTON NUMBER + Accessibility - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select redo tool. + Mouse - joystick-btn-eraser=BUTTON NUMBER + mouse-accessibility=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select eraser tool. + In this mode, instead of clicking, dragging and releasing (e.g., to + draw), you click, move, and click again to end the motion. - joystick-btn-new=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for creating a new drawing. - joystick-btn-open=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for opening an existing drawing. + Keyboard - joystick-btn-save=BUTTON NUMBER + keyboard=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to save the drawing. + This allows the keyboard arrow keys to be used to control the mouse + pointer. (e.g., for mouseless environments, or handicapped/ + accessibility purposes) - joystick-btn-pgsetup=BUTTON NUMBER + Features: - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the page setup dialog for printing. + o Fine movement within canvas, or coarse movement if Shift is held. + o Coarse movement within tool button areas. + o Key controls: + # [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move mouse + # [Space]/[5]: Click mouse (except when using "Text" or "Label" + tools) + # [Insert]/[F5]: Click mouse (always) + # [F4] jump mouse between "Tools", "Colors" and canvas areas + # If mouse is within "Tools" section on the left, or "Colors" + section at the bottom: + @ [F7], [F8]: Move down/up between buttons, respectively + (Tools section, only) + @ [F11], [F12]: Move to previous/next button, respectively + o To click-and-drag, hold one of the 'click' keys (e.g., [Insert]), + and use the movement keys (e.g., [Left]). - joystick-btn-print=BUTTON NUMBER + 💡 Note: The "mouse accessibility" feature works with the keyboard + mouse controls. With both options enabled, painting tools can be + used to draw by pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another 'click' key to + end the click (stop drawing). - Selects the joystick button number, as seen by SDL, that will be - a shortcut to print. - - Overriding System Config. Options - - (For Linux and Unix users) - - If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", - you can override them in your own "~/.tuxpaintrc" file. - - For true/false options, like "noprint" and "grab", you can simply say - they equal 'no' in your "~/.tuxpaintrc" file: - - noprint=no - uppercase=no - - Or, you can use options similar to the command-line override options - described below. For example: - - print=yes - mixedcase=yes - - Command-Line Options - - Options may also be issued on the command-line when you go to launch Tux - Paint. - - --fullscreen - --WIDTHxHEIGHT - --buttonsize=SIZE - --colorsrows=ROWS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDS - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --printcommand=COMMAND - --altprintcommand=COMMAND - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang LANGUAGE - --colorfile FILE - - These enable or correspond to the configuration file options - described above. - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - These options can be used to override any settings made in the - configuration file. (If the option isn't set in the - configuration file(s), no overriding option is necessary.) - - --nosysconfig - - Under Linux and Unix, this prevents the system-wide - configuration file, "/etc/tuxpaint/tuxpaint.conf", from being - read. - - Only your own configuration file, "~/.tuxpaintrc", if it exists, - will be used. - -Command-Line Informational Options - - The following options display some informative text on the screen. Tux - Paint doesn't actually start up and run afterwards, however. - - --version - --verbose-version - - Display the version number and date of the copy of Tux Paint you - are running. The "--verbose-version" also lists what - compile-time options were set. (See INSTALL and FAQ). - - --copying - - Show brief license information about copying Tux Paint. - - --usage - - Display the list of available command-line options. - - --help - - Display brief help on using Tux Paint. - - --lang help - - Display a list of available languages in Tux Paint. - - --joystick-dev list - - Display list of attached joysticks available to Tux Paint. - - Choosing a Different Language - - Tux Paint has been translated into a number of languages. To access the - translations, you can use the "--lang" option on the command-line to set - the language (e.g. "--lang spanish") or use the "lang=" setting in the - configuration file (e.g., "lang=spanish"). - - Tux Paint also honors your environment's current locale. (You can - override it on the command-line using the "--locale" option; see above.) - - Use the option "--lang help" to list the language options available. - -Available Languages - - +----------------------------------------------------------------------+ - | |Language |Language |Input Method | - |Locale Code |(native name) |(English name) |Cycle Key | - | | | |Combination | - |----------------+-------------------+-----------------+---------------| - |C | |English | | - |----------------+-------------------+-----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+-------------------+-----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+-------------------+-----------------+---------------| - |ak_GH | |Akan | | - |----------------+-------------------+-----------------+---------------| - |am_ET | |Amharic | | - |----------------+-------------------+-----------------+---------------| - |an_ES | |Aragones | | - |----------------+-------------------+-----------------+---------------| - |ar_SA | |Arabic | | - |----------------+-------------------+-----------------+---------------| - |as_IN | |Assamese | | - |----------------+-------------------+-----------------+---------------| - |ast_ES | |Asturian | | - |----------------+-------------------+-----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+-------------------+-----------------+---------------| - |bm_ML | |Bambara | | - |----------------+-------------------+-----------------+---------------| - |bn_IN | |Bengali | | - |----------------+-------------------+-----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+-------------------+-----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+-------------------+-----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+-------------------+-----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+-------------------+-----------------+---------------| - |brx_IN | |Bodo | | - |----------------+-------------------+-----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+-------------------+-----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+-------------------+-----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+-------------------+-----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+-------------------+-----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+-------------------+-----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+-------------------+-----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+-------------------+-----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+-------------------+-----------------+---------------| - |doi_IN | |Dogri | | - |----------------+-------------------+-----------------+---------------| - |et_EE | |Estonian | | - |----------------+-------------------+-----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+-------------------+-----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |en_CA | |Canadian English | | - |----------------+-------------------+-----------------+---------------| - |en_GB | |British English | | - |----------------+-------------------+-----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |eo | |Esperanto | | - |----------------+-------------------+-----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+-------------------+-----------------+---------------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+-------------------+-----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+-------------------+-----------------+---------------| - |fa_IR | |Persian | | - |----------------+-------------------+-----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+-------------------+-----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+-------------------+-----------------+---------------| - |fo_FO | |Faroese | | - |----------------+-------------------+-----------------+---------------| - |fr_FR |Français |French | | - |----------------+-------------------+-----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+-------------------+-----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+-------------------+-----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+-------------------+-----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+-------------------+-----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+-------------------+-----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+-------------------+-----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+-------------------+-----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+-------------------+-----------------+---------------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+-------------------+-----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+-------------------+-----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+-------------------+-----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+-------------------+-----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |ka_GE | |Georgian | | - |----------------+-------------------+-----------------+---------------| - |kab | |Kabyle | | - |----------------+-------------------+-----------------+---------------| - |km_KH | |Khmer | | - |----------------+-------------------+-----------------+---------------| - |kn_IN | |Kannada | | - |----------------+-------------------+-----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+-------------------+-----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+-------------------+-----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+-------------------+-----------------+---------------| - |lg_UG | |Luganda | | - |----------------+-------------------+-----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+-------------------+-----------------+---------------| - |lv_LV | |Latvian | | - |----------------+-------------------+-----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+-------------------+-----------------+---------------| - |mai_IN | |Maithili | | - |----------------+-------------------+-----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+-------------------+-----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+-------------------+-----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+-------------------+-----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+-------------------+-----------------+---------------| - |mr_IN | |Marathi | | - |----------------+-------------------+-----------------+---------------| - |ms_MY | |Malay | | - |----------------+-------------------+-----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+-------------------+-----------------+---------------| - |ne_NP |Nepali | | | - |----------------+-------------------+-----------------+---------------| - |nl_NL | |Dutch | | - |----------------+-------------------+-----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk| | - |----------------+-------------------+-----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+-------------------+-----------------+---------------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+-------------------+-----------------+---------------| - |oc_FR | |Occitan | | - |----------------+-------------------+-----------------+---------------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+-------------------+-----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+-------------------+-----------------+---------------| - |or_IN |Odia |Oriya | | - |----------------+-------------------+-----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+-------------------+-----------------+---------------| - |pt_BR |Portugês Brazileiro|Brazilian | | - | | |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |ro_RO | |Romanian | | - |----------------+-------------------+-----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+-------------------+-----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+-------------------+-----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+-------------------+-----------------+---------------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+-------------------+-----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+-------------------+-----------------+---------------| - |si_LK | |Sinhala | | - |----------------+-------------------+-----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+-------------------+-----------------+---------------| - |sk_SK | |Slovak | | - |----------------+-------------------+-----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+-------------------+-----------------+---------------| - |son | |Songhay | | - |----------------+-------------------+-----------------+---------------| - |sq_AL | |Albanian | | - |----------------+-------------------+-----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+-------------------+-----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+-------------------+-----------------+---------------| - |su_ID | |Sundanese | | - |----------------+-------------------+-----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+-------------------+-----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+-------------------+-----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+-------------------+-----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+-------------------+-----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+-------------------+-----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+-------------------+-----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+-------------------+-----------------+---------------| - |tr_TR | |Turkish | | - |----------------+-------------------+-----------------+---------------| - |tw_GH | |Twi | | - |----------------+-------------------+-----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+-------------------+-----------------+---------------| - |ur_IN | |Urdu | | - |----------------+-------------------+-----------------+---------------| - |ve_ZA | |Venda | | - |----------------+-------------------+-----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+-------------------+-----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+-------------------+-----------------+---------------| - |wa_BE | |Walloon | | - |----------------+-------------------+-----------------+---------------| - |wo_SN | |Wolof | | - |----------------+-------------------+-----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+-------------------+-----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+-------------------+-----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+-------------------+-----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+-------------------+-----------------+---------------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - These languages require their own fonts, since they are not - represented using a Latin character set, like the others. See the - "Special Fonts" section, below. - - 💡 Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods while - the Text tool is active. - -Setting Your Environment's Locale - - Changing your locale will affect much of your environment. - - As stated above, along with letting you choose the language at runtime - using command-line options ("--lang" and "--locale"), Tux Paint honors - the global locale setting in your environment. - - If you haven't already set your environment's locale, the following will - briefly explain how: - - Linux/Unix Users - - First, be sure the locale you want to use is enabled by editing the file - "/etc/locale.gen" on your system and then running the program - "locale-gen" as root. - - 💡 Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration dialog. - Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the - "localeconf" package may need to be installed first), or you may need to - edit the file "/var/lib/locales/supported.d/local" first, and add - locales they want, from the list found in "/usr/share/i18n/SUPPORTED". - - Then, before running Tux Paint, set your "$LANG" environment variable to - one of the locales listed above. (If you want all programs that can be - translated to be, you may wish to place the following in your login - script; e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) - - For example, in a Bourne Shell (like BASH): - - export LANG=es_ES ; \ - tuxpaint - - And in a C Shell (like TCSH): - - setenv LANG es_ES ; \ - tuxpaint - - Windows Users - - Tux Paint will recognize the current locale and use the appropriate - files by default. So this section is only for people trying different - languages. - - The simplest thing to do is to use the "--lang" switch in the shortcut - (see "INSTALL"). However, by using an MSDOS Prompt window, it is also - possible to issue a command like this: - - set LANG=es_ES - - ...which will set the language for the lifetime of that DOS window. - - For something more permanent, you can set an 'environment variable' - using the "System properties" dialogue as follows: - - * Press the "[Windows]+[R]" key combination to open the "Run ..." - dialogue. - * Enter "sysdm.cpl" in the text box and click the "[OK]" button to - open the "System properties" dialogue. - * Select the "Advanced" tab. - * Click the "Environment Variables..." button. - * Edit the value of the parameter "LANG" (create it, if it doesn't - exists). - -Special Fonts - - Some languages require special fonts be installed. These font files - (which are in TrueType format (TTF)), are much too large to include with - the Tux Paint download, and are available separately. (See the table - above, under the "Choosing a Different Language" section.) - - 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user interface, - rather than using "SDL_ttf" directly. Unless your copy of Tux Paint was - built without Pango support, special fonts should no longer be - necessary. + o A regular mouse and/or joystick may still be used (so you can, + e.g., move with the mouse, and click with the keyboard, or + vice-versa) - When running Tux Paint in a language that requires its own font, Tux - Paint will try to load the font file from its system-wide "fonts" - directory (under a "locale" subdirectory). The name of the file - corresponds to the first two letters in the 'locale' code of the - language (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for - Traditional Chinese). + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "keyboard=no" or "mouse=yes". In + both cases, may be overridden by the command-line option "--mouse". - For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., - with the option "--lang korean"), Tux Paint will attempt to load the - following font file: - /usr/share/tuxpaint/fonts/locale/ko.ttf - You can download fonts for supported languages from Tux Paint's website, - https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') - Under Unix and Linux, you can use the Makefile that comes with the font - to install the font in the appropriate location. + Onscreen Keyboard + + onscreen-keyboard=yes + + Presents a clickable on-screen keyboard when using the Text and Label + tools. + + + + onscreen-keyboard-layout=LAYOUTNAME + + Selects the initial layout for the on-screen keyboard when using the + Text and Label tools. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + + + onscreen-keyboard-disable-change=yes + + Disables the possibility for changing the layout of the on-screen + keyboard when using the Text and Label tools, useful for simplifying + things for the small children. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be overridden + by the command-line option "--onscreen-keyboard-disable-change=no". + + + + + Joystick + + Main Device + + joystick-dev=N + + Specify which joystick device should be used by Tux Paint. Default + value is 0 (the first joystick). + + + + joystick-slowness=SPEED + + Sets a delay at each axis motion, allowing to slow the joystick. + Allowed values are from 0 to 500. Default value is 15. + + + + joystick-threshold=THRESHOLD + + Sets the minimum level of axis motion to start moving the pointer. + Allowed values are from 0 to 32766. Default value is 3200. + + + + joystick-maxsteps=STEPS + + Sets the maximum pixels the pointer will move at once. Allowed values + are from 1 to 7. Default value is 7. + + + + + Hat + + joystick-hat-slowness=SPEED + + Sets a delay at each automatic motion, allowing to slow the speed of + the hat. Allowed values are from 0 to 500. Default value is 15. + + + + joystick-hat-timeout=MILLISECONDS + + Sets the delay after wich the pointer will start moving automatically + if the hat is keeped pushed. Allowed values are from 0 to 3000. Default + value is 1000. + + + + + Buttons to Disable + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + A set of joystick button numbers, as seen by SDL, that should be + ignored. Otherwise, unless they are used by one of the "joystick-btn-" + options above, buttons will be seen as a mouse left-click. + + + + +Button Shortcuts + + joystick-btn-escape=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be used + to generate a escape event. Useful to dismiss dialogs and quit. + + + + joystick-btn-brush=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the brush tool. + + + + joystick-btn-stamp=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the stamp tool. + + + + joystick-btn-lines=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the lines tool. + + + + joystick-btn-shapes=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the shapes tool. + + + + joystick-btn-text=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the text tool. + + + + joystick-btn-label=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the label tool. + + + + joystick-btn-fill=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the fill tool. + + + + joystick-btn-magic=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the magic tool. + + + + joystick-btn-undo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to invoke the undo tool. + + + + joystick-btn-redo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select redo tool. + + + + joystick-btn-eraser=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select eraser tool. + + + + joystick-btn-new=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for creating a new drawing. + + + + joystick-btn-open=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for opening an existing drawing. + + + + joystick-btn-save=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to save the drawing. + + + + joystick-btn-pgsetup=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the page setup dialog for printing. + + + + joystick-btn-print=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to print. + + + + + Overriding System Config. Options + + (For Linux and Unix users) + + If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", you + can override them in your own "~/.tuxpaintrc" file. + + For true/false options, like "noprint" and "grab", you can simply say they + equal 'no' in your "~/.tuxpaintrc" file: + + noprint=no + uppercase=no + + Or, you can use options similar to the command-line override options + described below. For example: + + print=yes + mixedcase=yes + + Command-Line Options + + Options may also be issued on the command-line when you go to launch Tux + Paint. + + --fullscreen + --WIDTHxHEIGHT + --buttonsize=SIZE + --colorsrows=ROWS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDS + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --printcommand=COMMAND + --altprintcommand=COMMAND + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang LANGUAGE + --colorfile FILE + + These enable or correspond to the configuration file options described + above. + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + These options can be used to override any settings made in the + configuration file. (If the option isn't set in the configuration file + (s), no overriding option is necessary.) + + + + --nosysconfig + + Under Linux and Unix, this prevents the system-wide configuration file, + "/etc/tuxpaint/tuxpaint.conf", from being read. + + Only your own configuration file, "~/.tuxpaintrc", if it exists, will + be used. + + + + + Command-Line Informational Options + + The following options display some informative text on the screen. Tux + Paint doesn't actually start up and run afterwards, however. + + --version + --verbose-version + + Display the version number and date of the copy of Tux Paint you are + running. The "--verbose-version" also lists what compile-time options + were set. (See INSTALL and FAQ). + + + + --copying + + Show brief license information about copying Tux Paint. + + + + --usage + + Display the list of available command-line options. + + + + --help + + Display brief help on using Tux Paint. + + + + --lang help + + Display a list of available languages in Tux Paint. + + + + --joystick-dev list + + Display list of attached joysticks available to Tux Paint. + + + + + Choosing a Different Language + + Tux Paint has been translated into a number of languages. To access the + translations, you can use the "--lang" option on the command-line to set + the language (e.g. "--lang spanish") or use the "lang=" setting in the + configuration file (e.g., "lang=spanish"). + + Tux Paint also honors your environment's current locale. (You can override + it on the command-line using the "--locale" option; see above.) + + Use the option "--lang help" to list the language options available. + + Available Languages + + +-------------------------------------------------------------------------+ + | | Language | Language | Input Method | + | Locale Code | (native name) | (English name) | Cycle Key | + | | | | Combination | + |------------------+------------------+----------------+------------------| + | C | | English | | + |------------------+------------------+----------------+------------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+----------------+------------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+----------------+------------------| + | ak_GH | | Akan | | + |------------------+------------------+----------------+------------------| + | am_ET | | Amharic | | + |------------------+------------------+----------------+------------------| + | an_ES | | Aragones | | + |------------------+------------------+----------------+------------------| + | ar_SA | | Arabic | | + |------------------+------------------+----------------+------------------| + | as_IN | | Assamese | | + |------------------+------------------+----------------+------------------| + | ast_ES | | Asturian | | + |------------------+------------------+----------------+------------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+----------------+------------------| + | bm_ML | | Bambara | | + |------------------+------------------+----------------+------------------| + | bn_IN | | Bengali | | + |------------------+------------------+----------------+------------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+----------------+------------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+----------------+------------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+----------------+------------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+----------------+------------------| + | brx_IN | | Bodo | | + |------------------+------------------+----------------+------------------| + | bs_BA | | Bosnian | | + |------------------+------------------+----------------+------------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+----------------+------------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+----------------+------------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+----------------+------------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+----------------+------------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+----------------+------------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+----------------+------------------| + | de_DE | Deutsch | German | | + |------------------+------------------+----------------+------------------| + | doi_IN | | Dogri | | + |------------------+------------------+----------------+------------------| + | et_EE | | Estonian | | + |------------------+------------------+----------------+------------------| + | el_GR (*) | | Greek | | + |------------------+------------------+----------------+------------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_GB | | British | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+----------------+------------------| + | eo | | Esperanto | | + |------------------+------------------+----------------+------------------| + | es_ES | Español | Spanish | | + |------------------+------------------+----------------+------------------| + | es_MX | Español-Mejicano | Mexican | | + | | | Spanish | | + |------------------+------------------+----------------+------------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+----------------+------------------| + | fa_IR | | Persian | | + |------------------+------------------+----------------+------------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+----------------+------------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+----------------+------------------| + | fo_FO | | Faroese | | + |------------------+------------------+----------------+------------------| + | fr_FR | Français | French | | + |------------------+------------------+----------------+------------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+----------------+------------------| + | gd_GB | Ghaidhlig | Scottish | | + | | | Gaelic | | + |------------------+------------------+----------------+------------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+----------------+------------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+----------------+------------------| + | gu_IN | | Gujarati | | + |------------------+------------------+----------------+------------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+----------------+------------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+----------------+------------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+----------------+------------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+----------------+------------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+----------------+------------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+----------------+------------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+----------------+------------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+----------------+------------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+----------------+------------------| + | ja_JP (*) | | Japanese | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | ka_GE | | Georgian | | + |------------------+------------------+----------------+------------------| + | kab | | Kabyle | | + |------------------+------------------+----------------+------------------| + | km_KH | | Khmer | | + |------------------+------------------+----------------+------------------| + | kn_IN | | Kannada | | + |------------------+------------------+----------------+------------------| + | ko_KR (*) | | Korean | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | kok@roman | | Konkani | | + | | | (Roman) | | + |------------------+------------------+----------------+------------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+----------------+------------------| + | ku_TR | | Kurdish | | + |------------------+------------------+----------------+------------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+----------------+------------------| + | lg_UG | | Luganda | | + |------------------+------------------+----------------+------------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+----------------+------------------| + | lv_LV | | Latvian | | + |------------------+------------------+----------------+------------------| + | mk_MK | | Macedonian | | + |------------------+------------------+----------------+------------------| + | mai_IN | | Maithili | | + |------------------+------------------+----------------+------------------| + | ml_IN | | Malayalam | | + |------------------+------------------+----------------+------------------| + | mn_MN | | Mongolian | | + |------------------+------------------+----------------+------------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+----------------+------------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+----------------+------------------| + | mr_IN | | Marathi | | + |------------------+------------------+----------------+------------------| + | ms_MY | | Malay | | + |------------------+------------------+----------------+------------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+----------------+------------------| + | ne_NP | Nepali | | | + |------------------+------------------+----------------+------------------| + | nl_NL | | Dutch | | + |------------------+------------------+----------------+------------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+----------------+------------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+----------------+------------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+----------------+------------------| + | oc_FR | | Occitan | | + |------------------+------------------+----------------+------------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+----------------+------------------| + | pa_IN | | Punjabi | | + |------------------+------------------+----------------+------------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+----------------+------------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+----------------+------------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+----------------+------------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+----------------+------------------| + | ro_RO | | Romanian | | + |------------------+------------------+----------------+------------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+----------------+------------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+----------------+------------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+----------------+------------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+----------------+------------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+----------------+------------------| + | si_LK | | Sinhala | | + |------------------+------------------+----------------+------------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sd_IN | | Sindhi | | + |------------------+------------------+----------------+------------------| + | sk_SK | | Slovak | | + |------------------+------------------+----------------+------------------| + | sl_SI | | Slovenian | | + |------------------+------------------+----------------+------------------| + | son | | Songhay | | + |------------------+------------------+----------------+------------------| + | sq_AL | | Albanian | | + |------------------+------------------+----------------+------------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+----------------+------------------| + | sr_RS@latin | | Serbian | | + | | | (latin) | | + |------------------+------------------+----------------+------------------| + | su_ID | | Sundanese | | + |------------------+------------------+----------------+------------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+----------------+------------------| + | sw_TZ | | Swahili | | + |------------------+------------------+----------------+------------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+----------------+------------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+----------------+------------------| + | th_TH (*) | | Thai | | + |------------------+------------------+----------------+------------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+----------------+------------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+----------------+------------------| + | tr_TR | | Turkish | | + |------------------+------------------+----------------+------------------| + | tw_GH | | Twi | | + |------------------+------------------+----------------+------------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+----------------+------------------| + | ur_IN | | Urdu | | + |------------------+------------------+----------------+------------------| + | ve_ZA | | Venda | | + |------------------+------------------+----------------+------------------| + | vec | Venèto | Venetian | | + |------------------+------------------+----------------+------------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+----------------+------------------| + | wa_BE | | Walloon | | + |------------------+------------------+----------------+------------------| + | wo_SN | | Wolof | | + |------------------+------------------+----------------+------------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+----------------+------------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+----------------+------------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+----------------+------------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+----------------+------------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - These languages require their own fonts, since they are not + represented using a Latin character set, like the others. See the "Special + Fonts" section, below. + + 💡 Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) listed + can be used to cycle through the supported input methods while the Text + tool is active. + + Setting Your Environment's Locale + + Changing your locale will affect much of your environment. + + As stated above, along with letting you choose the language at runtime + using command-line options ("--lang" and "--locale"), Tux Paint honors the + global locale setting in your environment. + + If you haven't already set your environment's locale, the following will + briefly explain how: + + Linux/Unix Users + + First, be sure the locale you want to use is enabled by editing the file "/ + etc/locale.gen" on your system and then running the program "locale-gen" as + root. + + 💡 Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration dialog. + Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the + "localeconf" package may need to be installed first), or you may need to + edit the file "/var/lib/locales/supported.d/local" first, and add locales + they want, from the list found in "/usr/share/i18n/SUPPORTED". + + Then, before running Tux Paint, set your "$LANG" environment variable to + one of the locales listed above. (If you want all programs that can be + translated to be, you may wish to place the following in your login script; + e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) + + For example, in a Bourne Shell (like BASH): + + export LANG=es_ES ; \ + tuxpaint + + And in a C Shell (like TCSH): + + setenv LANG es_ES ; \ + tuxpaint + + Windows Users + + Tux Paint will recognize the current locale and use the appropriate files + by default. So this section is only for people trying different languages. + + The simplest thing to do is to use the "--lang" switch in the shortcut (see + "INSTALL"). However, by using an MSDOS Prompt window, it is also possible + to issue a command like this: + + set LANG=es_ES + + ...which will set the language for the lifetime of that DOS window. + + For something more permanent, you can set an 'environment variable' using + the "System properties" dialogue as follows: + + + Press the "[Windows]+[R]" key combination to open the "Run ..." + dialogue. + + Enter "sysdm.cpl" in the text box and click the "[OK]" button to open + the "System properties" dialogue. + + Select the "Advanced" tab. + + Click the "Environment Variables..." button. + + Edit the value of the parameter "LANG" (create it, if it doesn't + exists). + + Special Fonts + + Some languages require special fonts be installed. These font files (which + are in TrueType format (TTF)), are much too large to include with the Tux + Paint download, and are available separately. (See the table above, under + the "Choosing a Different Language" section.) + + 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, which + utilizes the "Pango" library to render text in the user interface, rather + than using "SDL_ttf" directly. Unless your copy of Tux Paint was built + without Pango support, special fonts should no longer be necessary. + + When running Tux Paint in a language that requires its own font, Tux Paint + will try to load the font file from its system-wide "fonts" directory + (under a "locale" subdirectory). The name of the file corresponds to the + first two letters in the 'locale' code of the language (e.g., "ko" for + Korean, "ja" for Japanese, "zh_tw" for Traditional Chinese). + + For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., + with the option "--lang korean"), Tux Paint will attempt to load the + following font file: + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + You can download fonts for supported languages from Tux Paint's website, + https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + + Under Unix and Linux, you can use the Makefile that comes with the font to + install the font in the appropriate location. + diff --git a/docs/es_ES.UTF-8/PNG.txt b/docs/es_ES.UTF-8/PNG.txt index 55c78f246..83e68a9c4 100644 --- a/docs/es_ES.UTF-8/PNG.txt +++ b/docs/es_ES.UTF-8/PNG.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 PNG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. @@ -7,82 +7,86 @@ junio 4, 2022 - About PNGs +About PNGs - 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 - not "lossy" like JPEGs - lossiness allows files to be much smaller, but - introduces 'mistakes' in the image when saved), and supports 24-bit color - (16.7 million colors) as well as a full "alpha channel" - that is, each - pixel can have a varying degree of transparency. +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 not +"lossy" like JPEGs - lossiness allows files to be much smaller, but introduces +'mistakes' in the image when saved), and supports 24-bit color (16.7 million +colors) as well as a full "alpha channel" - that is, each pixel can have a +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) - make it the best choice for Tux Paint. (Tux Paint's support for the PNG - format comes from the Open Source SDL_Image library, which in turn gets it - from the libPNG library.) +These features (openness, losslessness, compression, transparency/alpha) make +it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes +from the Open Source SDL_Image library, which in turn gets it from the libPNG +library.) - Support for many colors allows photo-quality "rubber stamp" images to be - used in Tux Paint, and alpha transparency allows for high-quality brushes. +Support for many colors allows photo-quality "rubber stamp" images to be used +in Tux Paint, and alpha transparency allows for high-quality brushes. How To Make PNGs - The following is a very brief list of ways to create PNGs or convert - existing images into PNGs. +The following is a very brief list of ways to create PNGs or convert existing +images into PNGs. - GIMP & Krita +GIMP & Krita - Excellent tools with which to create PNG images for use in Tux - Paint are GIMP and Krita, both high-quality Open Source - interactive drawing and photo editing programs. + Excellent tools with which to create PNG images for use in Tux Paint are + GIMP and Krita, both high-quality Open Source interactive drawing and photo + 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 - NetPBM - The Portable Bitmap tools (collectively known as - "NetPBM") is a collection of Open Source command-line - tools which convert to and from various formats, - including GIF, TIFF, BMP, PNG, and many more. +Command-line Tools - 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/. + NetPBM - cjpeg/djpeg + The Portable Bitmap tools (collectively known as "NetPBM") is a + collection of Open Source command-line tools which convert to and from + various formats, 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/. + + + + cjpeg/djpeg + + The "cjpeg" and "djpeg" command-line programs convert between the + NetPBM Portable Any Map (PNM) format and JPEGs. 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 https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Macintosh Users + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - The "cjpeg" and "djpeg" command-line programs convert - between the NetPBM Portable Any Map (PNM) format and - JPEGs. 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 - https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Macintosh Users - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/es_ES.UTF-8/README.txt b/docs/es_ES.UTF-8/README.txt index 57b628cdc..50408b91e 100644 --- a/docs/es_ES.UTF-8/README.txt +++ b/docs/es_ES.UTF-8/README.txt @@ -1,1350 +1,1339 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 A simple drawing program for children Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - julio 13, 2023 + julio 13, 2023 - +------------------------------------------------------+ - |Table of Contents | - |------------------------------------------------------| - |I. About Tux Paint | - |II. Using Tux Paint | - | A. Launching Tux Paint | - | B. Title Screen | - | C. Main Screen | - | D. Available Tools | - | 1. Drawing Tools | - | a. "Paint" Tool (Brush) | - | b. "Stamp" Tool (Rubber Stamps) | - | c. "Lines" Tool | - | d. "Shapes" Tool | - | e. "Text" and "Label" Tools | - | f. "Fill" Tool | - | g. "Magic" Tool (Special Effects) | - | h. "Eraser" Tool | - | 2. Other Controls | - | a. "Undo" and "Redo" Commands | - | b. "New" Command | - | c. "Open" Command | - | d. "Save" Command | - | e. "Print" Command | - | f. "Slides" Command (under "Open") | - | g. "Quit" Command | - | h. Sound Muting | - | E. Controlling Tux Paint | - |III. Loading Other Pictures into Tux Paint | - |IV. Further Reading | - |V. How to Get Help | - |VI. How to Participate | - +------------------------------------------------------+ ++-------------------------------------------------+ +| Table of Contents | +|-------------------------------------------------| +| I. About Tux Paint | +| II. Using Tux Paint | +| A. Launching Tux Paint | +| B. Title Screen | +| C. Main Screen | +| D. Available Tools | +| 1. Drawing Tools | +| a. "Paint" Tool (Brush) | +| b. "Stamp" Tool (Rubber Stamps) | +| c. "Lines" Tool | +| d. "Shapes" Tool | +| e. "Text" and "Label" Tools | +| f. "Fill" Tool | +| g. "Magic" Tool (Special Effects) | +| h. "Eraser" Tool | +| 2. Other Controls | +| a. "Undo" and "Redo" Commands | +| b. "New" Command | +| c. "Open" Command | +| d. "Save" Command | +| e. "Print" Command | +| f. "Slides" Command (under "Open") | +| g. "Quit" Command | +| h. Sound Muting | +| E. Controlling Tux Paint | +| III. Loading Other Pictures into Tux Paint | +| IV. Further Reading | +| V. How to Get Help | +| VI. How to Participate | ++-------------------------------------------------+ - I. About Tux Paint +I. About Tux Paint A. What Is "Tux Paint"? - Tux Paint is a free drawing program designed for young children (kids ages - 3 and up). It has a simple, easy-to-use interface, fun sound effects, and - an encouraging cartoon mascot who helps guide children as they use the - program. It provides a blank canvas and a variety of drawing tools to help - your child be creative. +Tux Paint is a free drawing program designed for young children (kids ages 3 +and up). It has a simple, easy-to-use interface, fun sound effects, and an +encouraging cartoon mascot who helps guide children as they use the program. It +provides a blank canvas and a variety of drawing tools to help your child be +creative. B. Objectives - Easy and Fun - Tux Paint is meant to be a simple drawing program for young - children. It is not meant as a general-purpose drawing tool. It is - meant to be fun and easy to use. Sound effects and a cartoon - character help let the user know what's going on, and keeps them - entertained. There are also extra-large cartoon-style mouse - pointer shapes. +Easy and Fun + Tux Paint is meant to be a simple drawing program for young children. It is + not meant as a general-purpose drawing tool. It is meant to be fun and easy + to use. Sound effects and a cartoon character help let the user know what's + going on, and keeps them entertained. There are also extra-large + cartoon-style mouse pointer shapes. - Extensibility - Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be - dropped in and pulled out. For example, a teacher can drop in a - collection of animal shapes and ask their students to draw an - ecosystem. Each shape can have a sound which is played, and - textual facts which are displayed, when the child selects the - shape. +Extensibility + Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped + in and pulled out. For example, a teacher can drop in a collection of + animal shapes and ask their students to draw an ecosystem. Each shape can + have a sound which is played, and textual facts which are displayed, when + the child selects the shape. - Portability - Tux Paint is portable among various computer platforms: Windows, - Macintosh, Linux, etc. The interface looks the same among them - all. Tux Paint runs suitably well on older systems, and can be - built to run better on slow systems. +Portability + Tux Paint is portable among various computer platforms: Windows, Macintosh, + Linux, etc. The interface looks the same among them all. Tux Paint runs + suitably well on older systems, and can be built to run better on slow + systems. - Simplicity - There is no direct access to the computer's underlying - intricacies. The current image is kept when the program quits, and - reappears when it is restarted. Saving images requires no need to - create filenames or use the keyboard. Opening an image is done by - selecting it from a collection of thumbnails. Access to other - files on the computer is restricted. +Simplicity + There is no direct access to the computer's underlying intricacies. The + current image is kept when the program quits, and reappears when it is + restarted. Saving images requires no need to create filenames or use the + keyboard. Opening an image is done by selecting it from a collection of + thumbnails. Access to other files on the computer is restricted. + +Accessibility + Tux Paint offers a number of accessibility options, including increasing + the size of control buttons, changing the UI font, options to control the + cursor (mouse pointer) using the keyboard or other input devices (joystick, + gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks. - Accessibility - Tux Paint offers a number of accessibility options, including - increasing the size of control buttons, changing the UI font, - options to control the cursor (mouse pointer) using the keyboard - or other input devices (joystick, gamepad, etc.), an on-screen - keyboard, and "stick" mouse clicks. C. License - Tux Paint is an Open Source project, Free Software released under the GNU - General Public License (GPL). It is free, and the 'source code' behind the - program is available. (This allows others to add features, fix bugs, and - use parts of the program in their own GPL'd software.) +Tux Paint is an Open Source project, Free Software released under the GNU +General Public License (GPL). It is free, and the 'source code' behind the +program is available. (This allows others to add features, fix bugs, and use +parts of the program in their own GPL'd software.) - See COPYING.txt for the full text of the GPL license. +See COPYING.txt for the full text of the GPL license. D. What's New in Tux Paint version 0.9.31? - Fuzzy Erasers - Fuzzy-edged round erasers have been added to the Eraser tool +Fuzzy Erasers + Fuzzy-edged round erasers have been added to the Eraser tool - New Magic tools - Loops, Ribbon, Smooth, and Squiggles +New Magic tools + Loops, Ribbon, Smooth, and Squiggles - Create templates from Open dialog - Saved drawings can be turned into templates (used to make new - drawings) via a new option in the Open dialog. (This feature may - be deactivated using the "notemplateexport" simplification - option.) +Create templates from Open dialog + Saved drawings can be turned into templates (used to make new drawings) via + a new option in the Open dialog. (This feature may be deactivated using the + "notemplateexport" simplification option.) - User interface font may be overridden - The font used for the user interface (button labels, dialog - pop-ups, and instructions) can be overridden from its default - ("DejaVu Sans"). (See the "uifont" configuration option. Use - "--listfonts" to see a list of available fonts.) +User interface font may be overridden + The font used for the user interface (button labels, dialog pop-ups, and + instructions) can be overridden from its default ("DejaVu Sans"). (See the + "uifont" configuration option. Use "--listfonts" to see a list of available + fonts.) - File Erase may be disabled - Controls to erase saved work — saved drawings (via the Open - dialog) and exported templates (via the New dialog) — can be - disabled. (See the "noerase" configuration option.) +File Erase may be disabled - "Controlling Tux Paint" documentation - A brief overview of how Tux Paint can be controlled — mouse, - tablet, touchscreen, joystick, and keyboard — has been added to - the README documentation. + Controls to erase saved work — saved drawings (via the Open dialog) and + exported templates (via the New dialog) — can be disabled. (See the + "noerase" configuration option.) - See CHANGES.txt for the complete list of changes. +"Controlling Tux Paint" documentation - II. Using Tux Paint + A brief overview of how Tux Paint can be controlled — mouse, tablet, + touchscreen, joystick, and keyboard — has been added to the README + documentation. + + +See CHANGES.txt for the complete list of changes. + +II. Using Tux Paint A. Launching Tux Paint - 1. Linux/Unix Users +1. Linux/Unix Users - Tux Paint should have placed a launcher icon in your KDE and/or GNOME - menus, under 'Graphics.' +Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus, +under 'Graphics.' - Alternatively, you can run the following command at a shell prompt (e.g., - "$"): +Alternatively, you can run the following command at a shell prompt (e.g., "$"): - $ tuxpaint + $ tuxpaint - If any errors occur, they will be displayed on the terminal (to STDERR). +If any errors occur, they will be displayed on the terminal (to STDERR). - 2. Windows Users +2. Windows Users - [Tux Paint Icon] - Tux Paint +[Tux Paint Icon] + Tux Paint - If you installed Tux Paint on your computer using the 'Tux Paint - Installer,' it will have asked you whether you wanted a 'Start' menu - short-cut, and/or a desktop shortcut. If you agreed, you can simply run - Tux Paint from the 'Tux Paint' section of your 'Start' menu (e.g., under - 'All Programs'), or by double-clicking the 'Tux Paint' icon on your - desktop, if you had the installer place one there. +If you installed Tux Paint on your computer using the 'Tux Paint Installer,' it +will have asked you whether you wanted a 'Start' menu short-cut, and/or a +desktop shortcut. If you agreed, you can simply run Tux Paint from the 'Tux +Paint' section of your 'Start' menu (e.g., under 'All Programs'), or by +double-clicking the 'Tux Paint' icon on your desktop, if you had the installer +place one there. - If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you - used the 'Tux Paint Installer,' but chose not to have shortcuts installed, - you'll need to double-click the "tuxpaint.exe" icon in the "Tux Paint" - folder on your computer. +If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you used +the 'Tux Paint Installer,' but chose not to have shortcuts installed, you'll +need to double-click the "tuxpaint.exe" icon in the "Tux Paint" folder on your +computer. - By default, the 'Tux Paint Installer' will put Tux Paint's folder in - "C:\Program Files\", though you may have changed this when you ran the - installer. +By default, the 'Tux Paint Installer' will put Tux Paint's folder in "C:\ +Program Files\", though you may have changed this when you ran the installer. - If you used the 'ZIP-file' download, Tux Paint's folder will be wherever - you extracted the contents of the ZIP file. +If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you +extracted the contents of the ZIP file. - 3. macOS Users +3. macOS Users - Simply double-click the "Tux Paint" icon. +Simply double-click the "Tux Paint" icon. - [Title screen] +[Title screen] B. Title Screen - When Tux Paint first loads, a title/credits screen will appear. +When Tux Paint first loads, a title/credits screen will appear. - Once loading is complete, press a key or click or tap in the Tux Paint - window to continue. (Or, after about 5 seconds, the title screen will go - away automatically.) +Once loading is complete, press a key or click or tap in the Tux Paint window +to continue. (Or, after about 5 seconds, the title screen will go away +automatically.) C. Main Screen - The main screen is divided into the following sections: +The main screen is divided into the following sections: - [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, - Eraser, New, Open, Save, Print, Quit] +[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, + New, Open, Save, Print, Quit] +Left Side: Toolbar - Left Side: Toolbar + The toolbar contains the drawing and editing controls. - The toolbar contains the drawing and editing controls. - [Canvas] - Middle: Drawing Canvas + [Canvas] +Middle: Drawing Canvas - The largest part of the screen, in the center, is the drawing - canvas. This is, obviously, where you draw! + The largest part of the screen, in the center, is the drawing canvas. This + is, obviously, where you draw! - 💡 Note: The size of the drawing canvas depends on the size of Tux - Paint. You can change the size of Tux Paint using the Tux Paint - Config. configuration tool, or by other means. See the Options - documentation for more details. + 💡 Note: The size of the drawing canvas depends on the size of Tux Paint. + You can change the size of Tux Paint using the Tux Paint Config. + configuration tool, or by other means. See the Options documentation for + more details. - [Selectors - Brushes, Letters, Shapes, Stamps] - Right Side: Selector - Depending on the current tool, the selector shows different - things. e.g., when the Paint Brush or Line tool is selected, it - shows the various brushes available. When the Rubber Stamp tool is - selected, it shows the different shapes you can use. When the Text - or Label tool is selected, it shows various fonts. + [Selectors - Brushes, Letters, Shapes, Stamps] +Right Side: Selector - [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, - Blue, Purple, Brown, Grey] + Depending on the current tool, the selector shows different things. e.g., + when the Paint Brush or Line tool is selected, it shows the various brushes + available. When the Rubber Stamp tool is selected, it shows the different + shapes you can use. When the Text or Label tool is selected, it shows + various fonts. - Lower: Colors - When the active tool supports colors, a palette of colors choices - will be shown near the bottom of the screen. Click one to choose a - color, and it will be used by the active tool. (For example, the - "Paint" tool will use it as the color to draw with the chosen - brush, and the "Fill" tool will use it as the color to use when - flood-filling an area of the picture.) - On the far right are three special color options: - * Color Picker - The "color picker" (which has an outline of an eye-dropper) - allows you to pick a color found within your drawing. - (A shortcut key is available to access this feature quickly; - see below.) - * Rainbow Palette - The rainbow palette allows you to pick any color by choosing - the hue, saturation, and value of the color you want. A box - on the left displays hundreds of hues — from red at the top - through to violet at the bottom — at hundreds of - saturation/intensity levels — from pale & washed-out on the - left through to pure on the right. A grey vertical bar - provides access to hundreds of value levels — from lighest at - the top through to darkest at the bottom. - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. - You may also set this tool's color to that of other color - choices: - * Whichever built-in color is selected, if any - * The Color Picker's current color - * The Color Mixer's current color - * Color Mixer - The "color mixer" (which has silhouette of a paint palette) - allows you to create colors by blending primary additive - colors — red, yellow, and blue — along with white (to - "tint"), grey (to "tone"), and black (to "shade"). - You may click any button multiple times (for example, red + - red + yellow results in a red-orange color). The ratios of - colors added are shown at the bottom. - You can start over (reset to no colors in your picture) by - clicking the "Clear" button. You can also undo or redo - multiple steps of mixing, in case you made a mistake (without - having to start over). - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. + [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, + Purple, Brown, Grey] +Lower: Colors - ⌨ When the active tool supports colors, a shortcut may be used for - quick access to the "color picker" option. Hold the [Control] key - while clicking, and the color under the mouse cursor will be shown - at the bottom. You may drag around to canvas to find the color you - want. When you release the mouse button, the color under the - cursor will be selected. If you release the mouse outside of the - canvas (e.g., over the "Tools" area), the color selection will be - left unchanged. (This is similar to clicking the "Back" button - that's available when bringing up the "color picker" option via - its button the color palette.) + When the active tool supports colors, a palette of colors choices will be + shown near the bottom of the screen. Click one to choose a color, and it + will be used by the active tool. (For example, the "Paint" tool will use it + as the color to draw with the chosen brush, and the "Fill" tool will use it + as the color to use when flood-filling an area of the picture.) - ⚙ Note: You can define your own colors for Tux Paint. See the - "Options" documentation. + On the far right are three special color options: + + Color Picker + The "color picker" (which has an outline of an eye-dropper) allows you + to pick a color found within your drawing. + (A shortcut key is available to access this feature quickly; see + below.) + + Rainbow Palette + The rainbow palette allows you to pick any color by choosing the hue, + saturation, and value of the color you want. A box on the left displays + hundreds of hues — from red at the top through to violet at the bottom + — at hundreds of saturation/intensity levels — from pale & washed-out + on the left through to pure on the right. A grey vertical bar provides + access to hundreds of value levels — from lighest at the top through to + darkest at the bottom. + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + You may also set this tool's color to that of other color choices: + o Whichever built-in color is selected, if any + o The Color Picker's current color + o The Color Mixer's current color + + Color Mixer + The "color mixer" (which has silhouette of a paint palette) allows you + to create colors by blending primary additive colors — red, yellow, and + blue — along with white (to "tint"), grey (to "tone"), and black (to + "shade"). + You may click any button multiple times (for example, red + red + + yellow results in a red-orange color). The ratios of colors added are + shown at the bottom. + You can start over (reset to no colors in your picture) by clicking the + "Clear" button. You can also undo or redo multiple steps of mixing, in + case you made a mistake (without having to start over). + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + + ⌨ When the active tool supports colors, a shortcut may be used for quick + access to the "color picker" option. Hold the [Control] key while clicking, + and the color under the mouse cursor will be shown at the bottom. You may + drag around to canvas to find the color you want. When you release the + mouse button, the color under the cursor will be selected. If you release + the mouse outside of the canvas (e.g., over the "Tools" area), the color + selection will be left unchanged. (This is similar to clicking the "Back" + button that's available when bringing up the "color picker" option via its + button the color palette.) + + ⚙ Note: You can define your own colors for Tux Paint. See the "Options" + documentation. + + + + (Example tip: 'Pick a shape. Click to pick the center, drag, then let go + when it is the size you want. Move around to rotate it, and click to draw + it.') +Bottom: Help Area + + At the very bottom of the screen, Tux, the Linux Penguin, provides tips and + other information while you use Tux Paint. - (Example tip: 'Pick a shape. Click to pick the center, drag, then - let go when it is the size you want. Move around to rotate it, and - click to draw it.') - Bottom: Help Area - At the very bottom of the screen, Tux, the Linux Penguin, provides - tips and other information while you use Tux Paint. D. Available Tools - 1. Drawing Tools - - a. "Paint" Tool (Brush) - - The Paint Brush tool lets you draw freehand, using various brushes - (chosen in the Selector on the right) and colors (chosen in the - Color palette towards the bottom). - - If you hold the mouse button down, and move the mouse, it will - draw as you move. - - Some brushes are animated — they change their shape as you draw - them. A good example of this is the vines brush that ships with - Tux Paint. These brushes will have a small "filmstrip" icon drawn - on their Selector buttons. - - Other brushes are directional — they will draw a different shape - depending on what direction you are painting with them. An example - of this is the arrow brush that ships with Tux Paint. These - brushes have a small 8-way arrow icon drawn on their Selector - buttons. - - Finally, some brushes can be both direction and animated. Examples - of this are the cat and squirrel brushes that ship with Tux Paint. - These brushes will have both the "filmstrip" and 8-way arrow - icons. - - As you draw, a sound is played. The bigger the brush, the lower - the pitch. - - Brush Spacing - - The space between each position where a brush is applied to the - canvas can vary. Some brushes (such as the footprints and - flower) are spaced, by default, far enough apart that they don't - overlap. Other brushes (such as the basic circular ones) are - spaced closely, so they make a continuous stroke. - - The default spacing of brushes may be overridden using by - clicking within the triangular-shaped series of bars at the - bottom right; the larger the bar, the wider the spacing. Brush - spacing affects both tools that use the brushes: the "Paint" - tool and the "Lines" tool. - - ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't - display the brush spacing controls. See the "Options" - documentation. - - b."Stamp" Tool (Rubber Stamps) - - The Stamp tool is like a set of rubber stamps or stickers. It lets - you paste pre-drawn or photographic images (like a picture of a - horse, or a tree, or the moon) in your picture. - - As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be. Click on the canvas where you wish to place the stamp. - - Stamp Categories - There can be numerous categories of stamps (e.g., - animals, plants, outer space, vehicles, people, - etc.). Use the Left and Right arrows near the bottom - of the Selector to cycle through the collections. - - Stamp Rotation - - Using the rotation toggle button near the bottom - right, you can enable a rotation step when placing - stamps. Once you've placed the stamp, choose the - angle to rotate it by moving the mouse around the - canvas. Click the mouse button again and the stamp - will be added to the drawing. - - ⚙ Note: If "stamp rotation" option is disabled, the - stamp will be drawn on the canvas when you let go of - the mouse button. (There's no rotation step.) See the - "Options" documentation to learn about the "stamp - rotation" ("stamprotation") option. - - 📜 Note: The stamp rotation feature was added to Tux - Paint in version 0.9.29. +1. Drawing Tools - Stamp Controls - - Prior to 'stamping' an image onto your drawing, - various effects can sometimes be applied (depending - on the stamp): - - * Some stamps can be colored or tinted. If the - color palette below the canvas is activated, you - can click the colors to change the tint or color - of the stamp before placing it in the picture. - * Stamps can be shrunk and expanded, by clicking - within the triangular-shaped series of bars at - the bottom right; the larger the bar, the larger - the stamp will appear in your picture. - * Many stamps may be flipped vertically, or - displayed as a mirror-image, using the control - buttons at the bottom right. +a. "Paint" Tool (Brush) - ⚙ Note: If the "nostampcontrols" option is set, Tux - Paint won't display the Rotation, Mirror, Flip, or - sizing controls for stamps. See the "Options" - documentation. - - Stamp Sounds - - Different stamps can have different sound effects - and/or descriptive (spoken) sounds. Buttons in the - Help Area at the lower left (near Tux, the Linux - penguin) allow you to re-play the sound effects and - descriptive sounds for the currently-selected stamp. - - c."Lines" Tool - - This tool lets you draw straight lines using the various brushes - and colors you normally use with the Paint Brush. - - Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line will - show where the line will be drawn. At the bottom, you'll see the - angle of your line, in degrees. A line going straight to the right - is 0°, a line going straight up is 90°, a line going straight left - is 180°, a line going straight down is 270°, and so on. - - Let go of the mouse to complete the line. A "sproing!" sound will - play. - - Some brushes are animated, and will show a pattern of shapes along - the line. Others are directional, and will show a different shape - depending on the angle of the brush. And finally some are both - animated and directional. See "Paint", above, to learn more. - - Different brushes have different spacing, leaving either a series - of individual shapes, or a continuous stroke of the brush shape. - Brush spacing may be adjusted. See the brush spacing section of - the "Paint" tool, above, to learn more. - - d."Shapes" Tool - - This tool lets you draw some simple filled, and un-filled shapes. - - Select a shape from the selector on the right (circle, square, - oval, etc.). - - Use the options at the bottom right to choose the shape tool's - behavior: - - Shapes from center - The shape will expand from where you initially - clicked, and will be centered around that position. - - 📜 This was Tux Paint's only behavior through version - 0.9.24.) - - Shapes from corner - The shape will extend with one corner starting from - where you initially clicked. This is the default - method of most other traditional drawing software. - - 📜 This option was added starting with Tux Paint - version 0.9.25. - - ⚙ Note: If shape controls are disabled (e.g., with the - "noshapecontrols" option), the controls will not be presented, and - the "shapes from center" method will be used. - - In the canvas, click the mouse and hold it to stretch the shape - out from where you clicked. Some shapes can change proportion - (e.g., rectangle and oval may be wider than tall, or taller than - wide), others cannot (e.g., square and circle). - - For shapes that can change proportion, the aspect ratio of the - shape will be shown at the bottom. For example: "1:1" will be - shown if it is "square" (as tall as it is wide); "2:1" if it is - either twice as wide as it is tall, or twice as tall as it is - wide; and so on. - - Let go of the mouse when you're done stretching. - - Normal Shapes Mode - - Now you can move the mouse around the canvas to - rotate the shape. The angle your shape is rotated - will be shown at the bottom, in degrees (similar to - the "Lines" tool, described above). - - Click the mouse button again and the shape will be - drawn in the current color. - - Simple Shapes Mode - If the "simple shapes" option is enabled, the shape - will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) - - ⚙ See the "Options" documentation to learn about the - "simple shapes" ("simpleshapes") option. - - e."Text" and "Label" Tools - - Choose a font (from the 'Letters' available on the right) and a - color (from the color palette near the bottom). You may also apply - a bold, and/or an italic styling effect to the text. Click on the - screen and a cursor will appear. Type text and it will show up on - the screen. (You can change the font, color, and styling while - entering the text, before it is applied to the canvas.) - - Press [Enter] or [Return] and the text will be drawn onto the - picture and the cursor will move down one line. - - Alternatively, press [Tab] and the text will be drawn onto the - picture, but the cursor will move to the right of the text, rather - than down a line, and to the left. (This can be useful to create a - line of text with mixed colors, fonts, styles and sizes.) - - Clicking elsewhere in the picture while the text entry is still - active causes the current line of text to move to that location - (where you can continue editing it). - - "Text" versus "Label" - - The Text tool is the original text-entry tool in Tux - Paint. Text entered using this tool can't be modified - or moved later, since it becomes part of the drawing. - However, because the text becomes part of the - picture, it can be drawn over or modified using Magic - tool effects (e.g., smudged, tinted, embossed, etc.) - - When using the Label tool (which was added to Tux - Paint in version 0.9.22), the text 'floats' over the - image, and the details of the label (the text, the - position of the label, the font choice and the color) - get stored separately. This allows the label to be - repositioned or edited later. - - To edit a label, click the label selection button. - All labels in the drawing will appear highlighted. - Click one — or use the [Tab] key to cycle through all - the labels, and the [Enter] or [Return] key to select - one — and you may then edit the label. (Use they - [Backspace] key to erase characters, and other keys - to add text to the label; click in the canvas to - reposition the label; click in the palette to change - the color of the text in the label; etc.) - - You may "apply" a label to the canvas, painting the - text into the picture as if it had been added using - the Text tool, by clicking the label application - button. (This feature was added in Tux Paint version - 0.9.28.) All labels in the drawing will appear - highlighted, and you select one just as you do when - selecting a label to edit. The chosen label will be - removed, and the text will be added directly to the - canvas. - - ⚙ The Label tool can be disabled (e.g., by selecting - "Disable 'Label' Tool" in Tux Paint Config. or - running Tux Paint with the "nolabel" option). - - International Character Input - - Tux Paint allows inputting characters in different - languages. Most Latin characters (A-Z, ñ, è, etc.) - can by entered directly. Some languages require that - Tux Paint be switched into an alternate input mode - before entering, and some characters must be composed - using numerous keypresses. - - When Tux Paint's locale is set to one of the - languages that provide alternate input modes, a key - is used to cycle through normal (Latin character) and - locale-specific mode or modes. - - Currently supported locales, the input methods - available, and the key to toggle or cycle modes, are - listed below. - - * Japanese — Romanized Hiragana and Romanized - Katakana — right [Alt] key or left [Alt] key - * Korean — Hangul 2-Bul — right [Alt] key or left - [Alt] key - * Traditional Chinese — right [Alt] key or left - [Alt] key - * Thai — right [Alt] key - - 💡 Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change - fonts to see the characters you're trying to type. - - On-screen Keyboard - - An optional on-screen keyboard is available for the - Text and Label tools, which can provide a variety of - layouts and character composition (e.g., composing - "a" and "e" into "æ"). - - ⚙ See the "Options" and "Extending Tux Paint" - documentation for more information. - - f."Fill" Tool - - The 'Fill' tool 'flood-fills' a contiguous area of your drawing - with a color of your choice. Three fill options are offered: - * Solid — click once to fill an area with a solid color. - * Brush — click and drag to fill an area with a solid color - using freehand painting. - * Linear — click and then drag to fill the area with color that - fades away (a gradient) towards where you drag the mouse. - * Radial — click once to fill an area with a color that fades - away (a gradient) radially, centered on where you clicked. - * Shaped — click once to fill an area with a color that fades - away (a gradient), following the contours of the shape you're - filling. - - 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see - below). Prior to Tux Paint 0.9.26, the "Fill" tool only offered - the 'Solid' method of filling. 'Shaped' fill was introduced in Tux - Paint 0.9.29. - - g."Magic" Tool (Special Effects) - - The Magic tool is actually a set of special tools. Select one of - the 'magic' effects from the selector on the right. Then, - depending on the tool, you can either click and drag around the - picture, and/or simply click the picture once, to apply the - effect. - - Magic Controls - - If the tool can be used by clicking and dragging, a 'painting' - button will be available on the left, below the list of Magic - tools on the right side of the screen. If the tool can affect - the entire picture at once, an 'entire picture' button will be - available on the right. - - ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't - display the painting or entire picture controls. See the - "Options" documentation. - - 💡 If the magic controls are disabled, the Magic plugin may make - separate tools available, one for painting and one that affects - the entire pictre. - - Magic Sizing - - Some tools offer different sizing options. If so, a slider will - appear at the bottom right side of the screen. This may affect - the radius of a special effect (e.g., Darken) or painted object - (e.g., Patterns), or other attributes (e.g., large versus small - Brick shapes). - - ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't - display the sizing controls. See the "Options" documentation. - - 💡 If the sizing option is disabled, the Magic plugin may simply - offer a default size (e.g., Patterns), or it may make separate - tools available with different pre-set sizes (e.g., Bricks and - Googly Eyes). - - 📜 This option was added starting with Tux Paint version 0.9.30. - - See the instructions for each Magic tool (in the 'magic-docs' - folder). - - h."Eraser" Tool - - This tool is similar to the Paint Brush. Wherever you click (or - click and drag), the picture will be erased. (This may be white, - some other color, or to a background picture, depending on the - picture.) - - A number of eraser sizes are available, with both square and round - shapes. Fuzzy-edged round shapes are also available. - - As you move the mouse around, a square outline follows the - pointer, showing what part of the picture will be erased to white. - - As you erase, a 'squeaky clean' eraser wiping sound is played. - - ⌨ Hold the [X] key while clicking for quick access to a small - sharp round eraser (not available when the Text or Label tools are - selected, when you're in the process of rotating a stamp or shape, - or when using an interactive magic tool). Release the mouse to - return to your currently-selected tool. - - 2. Other Controls - - a."Undo" and "Redo" Commands - - Clicking the "Undo" button will undo (revert) the last drawing - action. You can even undo more than once! - - ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to - Undo. - - Clicking the "Redo" button will redo the drawing action you just - un-did via the "Undo" command. - - As long as you don't draw again, you can redo as many times as you - had undone! - - ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to - Redo. - - b."New" Command - - Clicking the 'New' button will start a new drawing. A dialog will - appear where you may choose to start a new picture using a solid - background color, or using a 'Starter' or 'Template' image (see - below). You will first be asked whether you really want to do - this. - - ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to - start a new drawing. - - Special Solid Background Color Choices - Along with the preset solid colors, you can also - choose colors using a rainbow palette or a "color - mixer". These operate identically to the options - found in the color palette shown below the canvas - when drawing a picture. See Main Screen > Lower: - Colors > Special color options for details. - - 'Starter' & Template Images - * 'Starters' can behave like a page from a - coloring book — a black-and-white outline of a - picture, which you can then color in, and the - black outline remains intact — or like a 3D - photograph, where you draw in between a - foreground and background layer. - * 'Templates' are similar, but simply provide a - background drawing to work off of. Unlike - 'Starters', there is no layer that remains in - the foreground of anything you draw in the - picture. + The Paint Brush tool lets you draw freehand, using various brushes (chosen + in the Selector on the right) and colors (chosen in the Color palette + towards the bottom). - When using the 'Eraser' tool, the original image from - the 'Starter' or 'Template' will reappear. The 'Flip' - and 'Mirror' Magic tools affect the orientation of - the 'Starter' or 'Template', as well. + If you hold the mouse button down, and move the mouse, it will draw as you + move. - When you load a 'Starter' or 'Template', draw on it, - and then click 'Save,' it creates a new picture file - — it doesn't overwrite the original, so you can use - it again later (by accessing it from the 'New' - dialog). + Some brushes are animated — they change their shape as you draw them. A + good example of this is the vines brush that ships with Tux Paint. These + brushes will have a small "filmstrip" icon drawn on their Selector buttons. - ⚙ You can create your own 'Starter' and Template - images. See the Extending Tux Paint documentation's - sections on 'Starters' and Templates. + Other brushes are directional — they will draw a different shape depending + on what direction you are painting with them. An example of this is the + arrow brush that ships with Tux Paint. These brushes have a small 8-way + arrow icon drawn on their Selector buttons. - 💡 You can also convert your saved drawings into - Templates directly within Tux Paint, from the 'Open' - dialog. See "Open", below. + Finally, some brushes can be both direction and animated. Examples of this + are the cat and squirrel brushes that ship with Tux Paint. These brushes + will have both the "filmstrip" and 8-way arrow icons. - Erasing Exported Template Images + As you draw, a sound is played. The bigger the brush, the lower the pitch. - If you've selected a Template in your personal - templates folder, and it was created from within Tux - Paint (using the "Template" button in the "Open" - dialog), you may remove it from within Tux Paint, - too. An 'Erase' (trash can) button will appear at the - lower right of the list. Click it to erase the - selected template. (You will be asked to confirm.) + Brush Spacing - 💡 Note: On Linux, Windows, and macOS, the picture - will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you - change your mind). - ⚙ Note: The 'Erase' button may be disabled, via the - "noerase" option. + The space between each position where a brush is applied to the canvas + can vary. Some brushes (such as the footprints and flower) are spaced, + by default, far enough apart that they don't overlap. Other brushes + (such as the basic circular ones) are spaced closely, so they make a + continuous stroke. - ⚙ Note: The solid colors can be placed at the end of the 'New' - dialog (below the Starters and Templates), via the "newcolorslast" - option. + The default spacing of brushes may be overridden using by clicking + within the triangular-shaped series of bars at the bottom right; the + larger the bar, the wider the spacing. Brush spacing affects both tools + that use the brushes: the "Paint" tool and the "Lines" tool. - c."Open" Command + ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't display + the brush spacing controls. See the "Options" documentation. - This shows you a list of all of the pictures you've saved. If - there are more than can fit on the screen, use the up and down - arrows at the top and bottom of the list to scroll through the - list of pictures. - Click a picture to select it, and then... - * Click the green 'Open' button at the lower left of the list - to load the selected picture. You will then be able to edit - it. - (Alternatively, you can double-click a picture's icon to load - it.) +b."Stamp" Tool (Rubber Stamps) - 💡 If choose to open a picture, and your current drawing - hasn't been saved, you will be prompted as to whether you - want to save it or not. (See "Save," below.) + The Stamp tool is like a set of rubber stamps or stickers. It lets you + paste pre-drawn or photographic images (like a picture of a horse, or a + tree, or the moon) in your picture. - * Click the brown 'Erase' (trash can) button at the lower right - of the list to erase the selected picture. (You will be asked - to confirm.) + As you move the mouse around the canvas, an outline follows the mouse, + showing where the stamp will be placed, and how big it will be. Click on + the canvas where you wish to place the stamp. - 📜 Note: On Linux (as of version 0.9.22), Windows (as of - version 0.9.27), and macOS (as of version 0.9.29), the - picture will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you change your - mind). + Stamp Categories + There can be numerous categories of stamps (e.g., animals, plants, + outer space, vehicles, people, etc.). Use the Left and Right arrows + near the bottom of the Selector to cycle through the collections. - ⚙ Note: The 'Erase' button may be disabled, via the "noerase" - option. + Stamp Rotation - * Click the 'Export' button near the lower right to export the - selected picture to your export folder. (e.g., - "~/Pictures/TuxPaint/") + Using the rotation toggle button near the bottom right, you can enable + a rotation step when placing stamps. Once you've placed the stamp, + choose the angle to rotate it by moving the mouse around the canvas. + Click the mouse button again and the stamp will be added to the + drawing. - From the "Open" screen you can also: - * Click the blue 'Slides' (slide projector) button at the lower - left to go to slideshow mode. See "Slides", below, for - details. + ⚙ Note: If "stamp rotation" option is disabled, the stamp will be drawn + on the canvas when you let go of the mouse button. (There's no rotation + step.) See the "Options" documentation to learn about the "stamp + rotation" ("stamprotation") option. - * Click the blue 'Template' button at the lower left to go to - convert the selected picture into a new template, which can - be used as the basis for new drawings. + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - 📜 Note: The Template creation feature was added to Tux Paint - in version 0.9.31. To learn how to create Templates outside - of Tux Paint, see Extending Tux Paint - ⚙ The Template creation feature can be disabled (e.g., by - selecting "Disable 'Make Template'" in Tux Paint Config. or - running Tux Paint with the "notemplateexport" option). - * Click the red 'Back' arrow button at the lower right of the - list to cancel and return to the picture you were drawing. + Stamp Controls - ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to - bring up the 'Open' dialog. + Prior to 'stamping' an image onto your drawing, various effects can + sometimes be applied (depending on the stamp): - d."Save" Command + o Some stamps can be colored or tinted. If the color palette below + the canvas is activated, you can click the colors to change the + tint or color of the stamp before placing it in the picture. + o Stamps can be shrunk and expanded, by clicking within the + triangular-shaped series of bars at the bottom right; the larger + the bar, the larger the stamp will appear in your picture. + o Many stamps may be flipped vertically, or displayed as a + mirror-image, using the control buttons at the bottom right. - This saves your current picture. + ⚙ Note: If the "nostampcontrols" option is set, Tux Paint won't display + the Rotation, Mirror, Flip, or sizing controls for stamps. See the " + Options" documentation. - If you haven't saved it before, it will create a new entry in the - list of saved images. (i.e., it will create a new file) - 💡 Note: It won't ask you anything (e.g., for a filename). It will - simply save the picture, and play a "camera shutter" sound effect. - If you have saved the picture before, or this is a picture you - just loaded using the "Open" command, you will first be asked - whether you want to save over the old version, or create a new - entry (a new file). + Stamp Sounds - ⚙ Note: If either the "saveover" or "saveovernew" options are set, - it won't ask before saving over. See the "Options" documentation. + Different stamps can have different sound effects and/or descriptive + (spoken) sounds. Buttons in the Help Area at the lower left (near Tux, + the Linux penguin) allow you to re-play the sound effects and + descriptive sounds for the currently-selected stamp. - ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to - save. - e."Print" Command - Click this button and your picture will be printed! - On most platforms, you can also hold the [Alt] key (called - [Option] on Macs) while clicking the 'Print' button to get a - printer dialog. Note that this may not work if you're running Tux - Paint in fullscreen mode. See below. - Disabling Printing - The "noprint" option can be set, which will disable - Tux Paint's 'Print' button. +c."Lines" Tool - ⚙ See the "Options" documentation. + This tool lets you draw straight lines using the various brushes and colors + you normally use with the Paint Brush. - Restricting Printing + Click the mouse and hold it to choose the starting point of the line. As + you move the mouse around, a thin 'rubber-band' line will show where the + line will be drawn. At the bottom, you'll see the angle of your line, in + degrees. A line going straight to the right is 0°, a line going straight up + is 90°, a line going straight left is 180°, a line going straight down is + 270°, and so on. - The "printdelay" option can be set, which will only - allow occasional printing — once every so many - seconds, as configured by you. + Let go of the mouse to complete the line. A "sproing!" sound will play. - For example, with "printdelay=60" in Tux Paint's - configuration file, printing can only occur once per - minute (60 seconds). + Some brushes are animated, and will show a pattern of shapes along the + line. Others are directional, and will show a different shape depending on + the angle of the brush. And finally some are both animated and directional. + See "Paint", above, to learn more. - ⚙ See the "Options" documentation. + Different brushes have different spacing, leaving either a series of + individual shapes, or a continuous stroke of the brush shape. Brush spacing + may be adjusted. See the brush spacing section of the "Paint" tool, above, + to learn more. - Printing Commands - (Linux and Unix only) - Tux Paint prints by generating a PostScript - representation of the drawing and sending it to an - external program. By default, the program is: +d."Shapes" Tool - lpr + This tool lets you draw some simple filled, and un-filled shapes. - This command can be changed by setting a - "printcommand" option in Tux Paint's configuration - file. + Select a shape from the selector on the right (circle, square, oval, etc.). - An alternative print command can be invoked by - holding the "[Alt]" key on the keyboard while - clicking clicking the 'Print' button, as long as - you're not in fullscreen mode, an alternative program - is run. By default, the program is KDE's graphical - print dialog: + Use the options at the bottom right to choose the shape tool's behavior: - kprinter + Shapes from center + The shape will expand from where you initially clicked, and will be + centered around that position. - This command can be changed by setting a - "altprintcommand" option in Tux Paint's configuration - file. + 📜 This was Tux Paint's only behavior through version 0.9.24.) - ⚙ See the "Options" documentation. - Printer Settings - (Windows and macOS) + Shapes from corner + The shape will extend with one corner starting from where you initially + clicked. This is the default method of most other traditional drawing + software. - By default, Tux Paint simply prints to the default - printer with default settings when the 'Print' button - is pushed. + 📜 This option was added starting with Tux Paint version 0.9.25. - However, if you hold the [Alt] (or [Option]) key on - the keyboard while clicking the 'Print' button, as - long as you're not in fullscreen mode, your operating - system's printer dialog will appear, where you can - change the settings. - You can have the printer configuration changes stored - between Tux Paint sessions by setting the "printcfg" - option. - If the "printcfg" option is used, printer settings - will be loaded from the file "printcfg.cfg" in your - personal folder (see below). Any changes will be - saved there as well. - ⚙ See the "Options" documentation. + ⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols" + option), the controls will not be presented, and the "shapes from center" + method will be used. - Printer Dialog Options + In the canvas, click the mouse and hold it to stretch the shape out from + where you clicked. Some shapes can change proportion (e.g., rectangle and + oval may be wider than tall, or taller than wide), others cannot (e.g., + square and circle). - By default, Tux Paint only shows the printer dialog - (or, on Linux/Unix, runs the "altprintcommand"; e.g., - "kprinter" instead of "lpr") if the [Alt] (or - [Option]) key is held while clicking the 'Print' - button. + For shapes that can change proportion, the aspect ratio of the shape will + be shown at the bottom. For example: "1:1" will be shown if it is "square" + (as tall as it is wide); "2:1" if it is either twice as wide as it is tall, + or twice as tall as it is wide; and so on. - However, this behavior can be changed. You can have - the printer dialog always appear by using - "--altprintalways" on the command-line, or - "altprint=always" in Tux Paint's configuration file. - Conversely, you can prevent the [Alt]/[Option] key - from having any effect by using "--altprintnever", or - "altprint=never". + Let go of the mouse when you're done stretching. - ⚙ See the "Options" documentation. + Normal Shapes Mode - f."Slides" Command (under "Open") + Now you can move the mouse around the canvas to rotate the shape. The + angle your shape is rotated will be shown at the bottom, in degrees + (similar to the "Lines" tool, described above). - The 'Slides' button is available in the 'Open' dialog. It can be - used to play a simple animation within Tux Paint, or a slideshow - of pictures. It can also export an animated GIF based on the - chosen images. + Click the mouse button again and the shape will be drawn in the current + color. - Chosing pictures - When you enter the 'Slides' section of Tux Paint, it - displays a list of your saved files, just like the - 'Open' dialog. - Click each of the images you wish to display in a - slideshow-style presentation, one by one. A digit - will appear over each image, letting you know in - which order they will be displayed. + Simple Shapes Mode + If the "simple shapes" option is enabled, the shape will be drawn on + the canvas when you let go of the mouse button. (There's no rotation + step.) - You can click a selected image to unselect it (take - it out of your slideshow). Click it again if you wish - to add it to the end of the list. + ⚙ See the "Options" documentation to learn about the "simple shapes" + ("simpleshapes") option. - Set playback speed - A sliding scale at the lower left of the screen (next - to the 'Play' button) can be used to adjust the speed - of the slideshow or animated GIF, from slowest to - fastest. Choose the leftmost setting to disable - automatic advancement during playback within Tux - Paint — you will need to press a key or click to go - to the next slide (see below). - 💡 Note: The slowest setting does not automatically - advance through the slides. Use it for when you want - to step through them manually. (This does not apply - to an exported animated GIF.) - Playback in Tux Paint - To play a slideshow within Tux Paint, click the - 'Play' button. - 💡 Note: If you hadn't selected any images, then all - of your saved images will be played in the slideshow! +e."Text" and "Label" Tools - During the slideshow, press [Space], [Enter] or - [Return], or the [Right arrow] — or click the 'Next' - button at the lower left — to manually advance to the - next slide. Press [Left arrow] to go back to the - previous slide. + Choose a font (from the 'Letters' available on the right) and a color (from + the color palette near the bottom). You may also apply a bold, and/or an + italic styling effect to the text. Click on the screen and a cursor will + appear. Type text and it will show up on the screen. (You can change the + font, color, and styling while entering the text, before it is applied to + the canvas.) - Press [Escape], or click the 'Back' button at the - lower right, to exit the slideshow and return to the - slideshow image selection screen. + Press [Enter] or [Return] and the text will be drawn onto the picture and + the cursor will move down one line. - Exporting an animated GIF + Alternatively, press [Tab] and the text will be drawn onto the picture, but + the cursor will move to the right of the text, rather than down a line, and + to the left. (This can be useful to create a line of text with mixed + colors, fonts, styles and sizes.) - Click the 'GIF Export' button near the lower right to - have Tux Paint generate an animated GIF file based on - the selected images. + Clicking elsewhere in the picture while the text entry is still active + causes the current line of text to move to that location (where you can + continue editing it). - 💡 Note: At least two images must be selected. (To - export a single image, use the 'Export' option from - the main 'Open' dialog.) If no images are selected, - Tux Paint will not attempt to generate a GIF based on - all saved images. + "Text" versus "Label" - Pressing [Escape] during the export process will - abort the process, and return you to the 'Slideshow' - dialog. + The Text tool is the original text-entry tool in Tux Paint. Text + entered using this tool can't be modified or moved later, since it + becomes part of the drawing. However, because the text becomes part of + the picture, it can be drawn over or modified using Magic tool effects + (e.g., smudged, tinted, embossed, etc.) - Click 'Back' in the slideshow image selection screen to return to - the 'Open' dialog. + When using the Label tool (which was added to Tux Paint in version + 0.9.22), the text 'floats' over the image, and the details of the label + (the text, the position of the label, the font choice and the color) + get stored separately. This allows the label to be repositioned or + edited later. - g."Quit" Command + To edit a label, click the label selection button. All labels in the + drawing will appear highlighted. Click one — or use the [Tab] key to + cycle through all the labels, and the [Enter] or [Return] key to select + one — and you may then edit the label. (Use they [Backspace] key to + erase characters, and other keys to add text to the label; click in the + canvas to reposition the label; click in the palette to change the + color of the text in the label; etc.) - Clicking the 'Quit' button, closing the Tux Paint window, or - pushing the [Escape] key will quit Tux Paint. + You may "apply" a label to the canvas, painting the text into the + picture as if it had been added using the Text tool, by clicking the + label application button. (This feature was added in Tux Paint version + 0.9.28.) All labels in the drawing will appear highlighted, and you + select one just as you do when selecting a label to edit. The chosen + label will be removed, and the text will be added directly to the + canvas. - You will first be prompted as to whether you really want to quit. + ⚙ The Label tool can be disabled (e.g., by selecting "Disable 'Label' + Tool" in Tux Paint Config. or running Tux Paint with the "nolabel" + option). - If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new - image, you will then be asked if you want to save over the old - version, or create a new entry. (See "Save" above.) - ⚙ Note: If the image is saved, it will be reloaded automatically - the next time you run Tux Paint -- unless the "startblank" option - is set. - ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the - [Escape] key, may be disabled, via the "noquit" option. + International Character Input - In that case, the "window close" button on Tux Paint's title bar - (if not in fullscreen mode) or the [Alt] + [F4] key sequence may - be used to quit. + Tux Paint allows inputting characters in different languages. Most + Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some + languages require that Tux Paint be switched into an alternate input + mode before entering, and some characters must be composed using + numerous keypresses. - If neither of those are possible, the key sequence of [Shift] + - [Control / ⌘] + [Escape] may be used to quit. + When Tux Paint's locale is set to one of the languages that provide + alternate input modes, a key is used to cycle through normal (Latin + character) and locale-specific mode or modes. - ⚙ See the "Options" documentation. + Currently supported locales, the input methods available, and the key + to toggle or cycle modes, are listed below. - h.Sound Muting + o Japanese — Romanized Hiragana and Romanized Katakana — right [Alt] + key or left [Alt] key + o Korean — Hangul 2-Bul — right [Alt] key or left [Alt] key + o Traditional Chinese — right [Alt] key or left [Alt] key + o Thai — right [Alt] key + + 💡 Note: Many fonts do not include all characters for all languages, so + sometimes you'll need to change fonts to see the characters you're + trying to type. + + + + On-screen Keyboard + + An optional on-screen keyboard is available for the Text and Label + tools, which can provide a variety of layouts and character composition + (e.g., composing "a" and "e" into "æ"). + + ⚙ See the "Options" and "Extending Tux Paint" documentation for more + information. + + + + + + +f."Fill" Tool + + The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a + color of your choice. Three fill options are offered: + + Solid — click once to fill an area with a solid color. + + Brush — click and drag to fill an area with a solid color using + freehand painting. + + Linear — click and then drag to fill the area with color that fades + away (a gradient) towards where you drag the mouse. + + Radial — click once to fill an area with a color that fades away (a + gradient) radially, centered on where you clicked. + + Shaped — click once to fill an area with a color that fades away (a + gradient), following the contours of the shape you're filling. + + 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see below). + Prior to Tux Paint 0.9.26, the "Fill" tool only offered the 'Solid' method + of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29. + + + +g."Magic" Tool (Special Effects) + + The Magic tool is actually a set of special tools. Select one of the + 'magic' effects from the selector on the right. Then, depending on the + tool, you can either click and drag around the picture, and/or simply click + the picture once, to apply the effect. + + Magic Controls + + + If the tool can be used by clicking and dragging, a 'painting' button + will be available on the left, below the list of Magic tools on the + right side of the screen. If the tool can affect the entire picture at + once, an 'entire picture' button will be available on the right. + + ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't display + the painting or entire picture controls. See the "Options" + documentation. + + 💡 If the magic controls are disabled, the Magic plugin may make + separate tools available, one for painting and one that affects the + entire pictre. + + Magic Sizing + + + Some tools offer different sizing options. If so, a slider will appear + at the bottom right side of the screen. This may affect the radius of a + special effect (e.g., Darken) or painted object (e.g., Patterns), or + other attributes (e.g., large versus small Brick shapes). + + ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't display + the sizing controls. See the "Options" documentation. + + 💡 If the sizing option is disabled, the Magic plugin may simply offer a + default size (e.g., Patterns), or it may make separate tools available + with different pre-set sizes (e.g., Bricks and Googly Eyes). + + 📜 This option was added starting with Tux Paint version 0.9.30. + + See the instructions for each Magic tool (in the 'magic-docs' folder). + + + +h."Eraser" Tool + + This tool is similar to the Paint Brush. Wherever you click (or click and + drag), the picture will be erased. (This may be white, some other color, or + to a background picture, depending on the picture.) + + A number of eraser sizes are available, with both square and round shapes. + Fuzzy-edged round shapes are also available. + + As you move the mouse around, a square outline follows the pointer, showing + what part of the picture will be erased to white. + + As you erase, a 'squeaky clean' eraser wiping sound is played. + + ⌨ Hold the [X] key while clicking for quick access to a small sharp round + eraser (not available when the Text or Label tools are selected, when + you're in the process of rotating a stamp or shape, or when using an + interactive magic tool). Release the mouse to return to your + currently-selected tool. + + + + +2. Other Controls + +a."Undo" and "Redo" Commands + + Clicking the "Undo" button will undo (revert) the last drawing action. You + can even undo more than once! + + ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to Undo. + + Clicking the "Redo" button will redo the drawing action you just un-did via + the "Undo" command. + + As long as you don't draw again, you can redo as many times as you had + undone! + + ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo. + + + +b."New" Command + + Clicking the 'New' button will start a new drawing. A dialog will appear + where you may choose to start a new picture using a solid background color, + or using a 'Starter' or 'Template' image (see below). You will first be + asked whether you really want to do this. + + ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a + new drawing. + + Special Solid Background Color Choices + Along with the preset solid colors, you can also choose colors using a + rainbow palette or a "color mixer". These operate identically to the + options found in the color palette shown below the canvas when drawing + a picture. See Main Screen > Lower: Colors > Special color options for + details. + + 'Starter' & Template Images + o 'Starters' can behave like a page from a coloring book — a + black-and-white outline of a picture, which you can then color in, + and the black outline remains intact — or like a 3D photograph, + where you draw in between a foreground and background layer. + o 'Templates' are similar, but simply provide a background drawing to + work off of. Unlike 'Starters', there is no layer that remains in + the foreground of anything you draw in the picture. + + When using the 'Eraser' tool, the original image from the 'Starter' or + 'Template' will reappear. The 'Flip' and 'Mirror' Magic tools affect + the orientation of the 'Starter' or 'Template', as well. + + When you load a 'Starter' or 'Template', draw on it, and then click + 'Save,' it creates a new picture file — it doesn't overwrite the + original, so you can use it again later (by accessing it from the 'New' + dialog). + + ⚙ You can create your own 'Starter' and Template images. See the + Extending Tux Paint documentation's sections on 'Starters' and + Templates. + + 💡 You can also convert your saved drawings into Templates directly + within Tux Paint, from the 'Open' dialog. See "Open", below. + + + + Erasing Exported Template Images + + If you've selected a Template in your personal templates folder, and it + was created from within Tux Paint (using the "Template" button in the + "Open" dialog), you may remove it from within Tux Paint, too. An + 'Erase' (trash can) button will appear at the lower right of the list. + Click it to erase the selected template. (You will be asked to + confirm.) + + 💡 Note: On Linux, Windows, and macOS, the picture will be placed in + your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + + + ⚙ Note: The solid colors can be placed at the end of the 'New' dialog + (below the Starters and Templates), via the "newcolorslast" option. + + + +c."Open" Command + + This shows you a list of all of the pictures you've saved. If there are + more than can fit on the screen, use the up and down arrows at the top and + bottom of the list to scroll through the list of pictures. + + Click a picture to select it, and then... + + Click the green 'Open' button at the lower left of the list to load the + selected picture. You will then be able to edit it. + + (Alternatively, you can double-click a picture's icon to load it.) + + 💡 If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.) + + + Click the brown 'Erase' (trash can) button at the lower right of the + list to erase the selected picture. (You will be asked to confirm.) + + 📜 Note: On Linux (as of version 0.9.22), Windows (as of version + 0.9.27), and macOS (as of version 0.9.29), the picture will be placed + in your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + Click the 'Export' button near the lower right to export the selected + picture to your export folder. (e.g., "~/Pictures/TuxPaint/") + + From the "Open" screen you can also: + + Click the blue 'Slides' (slide projector) button at the lower left to + go to slideshow mode. See "Slides", below, for details. + + + Click the blue 'Template' button at the lower left to go to convert the + selected picture into a new template, which can be used as the basis + for new drawings. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. To learn how to create Templates outside of Tux Paint, see + Extending Tux Paint + + ⚙ The Template creation feature can be disabled (e.g., by selecting + "Disable 'Make Template'" in Tux Paint Config. or running Tux Paint + with the "notemplateexport" option). + + + Click the red 'Back' arrow button at the lower right of the list to + cancel and return to the picture you were drawing. + + ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to bring up + the 'Open' dialog. + + + +d."Save" Command + + This saves your current picture. + + If you haven't saved it before, it will create a new entry in the list of + saved images. (i.e., it will create a new file) + + 💡 Note: It won't ask you anything (e.g., for a filename). It will simply + save the picture, and play a "camera shutter" sound effect. + + If you have saved the picture before, or this is a picture you just loaded + using the "Open" command, you will first be asked whether you want to save + over the old version, or create a new entry (a new file). + + ⚙ Note: If either the "saveover" or "saveovernew" options are set, it won't + ask before saving over. See the "Options" documentation. + + ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save. + + + +e."Print" Command + + Click this button and your picture will be printed! + + On most platforms, you can also hold the [Alt] key (called [Option] on + Macs) while clicking the 'Print' button to get a printer dialog. Note that + this may not work if you're running Tux Paint in fullscreen mode. See + below. + + Disabling Printing + + The "noprint" option can be set, which will disable Tux Paint's 'Print' + button. + + ⚙ See the "Options" documentation. + + + + Restricting Printing + + The "printdelay" option can be set, which will only allow occasional + printing — once every so many seconds, as configured by you. + + For example, with "printdelay=60" in Tux Paint's configuration file, + printing can only occur once per minute (60 seconds). + + ⚙ See the "Options" documentation. + + + + Printing Commands + + (Linux and Unix only) + + Tux Paint prints by generating a PostScript representation of the + drawing and sending it to an external program. By default, the program + is: + + lpr + + This command can be changed by setting a "printcommand" option in Tux + Paint's configuration file. + + An alternative print command can be invoked by holding the "[Alt]" key + on the keyboard while clicking clicking the 'Print' button, as long as + you're not in fullscreen mode, an alternative program is run. By + default, the program is KDE's graphical print dialog: + + kprinter + + This command can be changed by setting a "altprintcommand" option in + Tux Paint's configuration file. + + ⚙ See the "Options" documentation. + + + + Printer Settings + + (Windows and macOS) + + By default, Tux Paint simply prints to the default printer with default + settings when the 'Print' button is pushed. + + However, if you hold the [Alt] (or [Option]) key on the keyboard while + clicking the 'Print' button, as long as you're not in fullscreen mode, + your operating system's printer dialog will appear, where you can + change the settings. + + You can have the printer configuration changes stored between Tux Paint + sessions by setting the "printcfg" option. + + If the "printcfg" option is used, printer settings will be loaded from + the file "printcfg.cfg" in your personal folder (see below). Any + changes will be saved there as well. + + ⚙ See the "Options" documentation. + + + + Printer Dialog Options + + By default, Tux Paint only shows the printer dialog (or, on Linux/Unix, + runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the + [Alt] (or [Option]) key is held while clicking the 'Print' button. + + However, this behavior can be changed. You can have the printer dialog + always appear by using "--altprintalways" on the command-line, or + "altprint=always" in Tux Paint's configuration file. Conversely, you + can prevent the [Alt]/[Option] key from having any effect by using + "--altprintnever", or "altprint=never". + + ⚙ See the "Options" documentation. + + + + + + +f."Slides" Command (under "Open") + + The 'Slides' button is available in the 'Open' dialog. It can be used to + play a simple animation within Tux Paint, or a slideshow of pictures. It + can also export an animated GIF based on the chosen images. + + Chosing pictures + + When you enter the 'Slides' section of Tux Paint, it displays a list of + your saved files, just like the 'Open' dialog. + + Click each of the images you wish to display in a slideshow-style + presentation, one by one. A digit will appear over each image, letting + you know in which order they will be displayed. + + You can click a selected image to unselect it (take it out of your + slideshow). Click it again if you wish to add it to the end of the + list. + + + + Set playback speed + + A sliding scale at the lower left of the screen (next to the 'Play' + button) can be used to adjust the speed of the slideshow or animated + GIF, from slowest to fastest. Choose the leftmost setting to disable + automatic advancement during playback within Tux Paint — you will need + to press a key or click to go to the next slide (see below). + + 💡 Note: The slowest setting does not automatically advance through the + slides. Use it for when you want to step through them manually. (This + does not apply to an exported animated GIF.) + + + + Playback in Tux Paint + + To play a slideshow within Tux Paint, click the 'Play' button. + + 💡 Note: If you hadn't selected any images, then all of your saved + images will be played in the slideshow! + + During the slideshow, press [Space], [Enter] or [Return], or the [Right + arrow] — or click the 'Next' button at the lower left — to manually + advance to the next slide. Press [Left arrow] to go back to the + previous slide. + + Press [Escape], or click the 'Back' button at the lower right, to exit + the slideshow and return to the slideshow image selection screen. + + + + Exporting an animated GIF + + Click the 'GIF Export' button near the lower right to have Tux Paint + generate an animated GIF file based on the selected images. + + 💡 Note: At least two images must be selected. (To export a single + image, use the 'Export' option from the main 'Open' dialog.) If no + images are selected, Tux Paint will not attempt to generate a GIF based + on all saved images. + + Pressing [Escape] during the export process will abort the process, and + return you to the 'Slideshow' dialog. + + + + + Click 'Back' in the slideshow image selection screen to return to the + 'Open' dialog. + + + +g."Quit" Command + + Clicking the 'Quit' button, closing the Tux Paint window, or pushing the + [Escape] key will quit Tux Paint. + + You will first be prompted as to whether you really want to quit. + + If you choose to quit, and you haven't saved the current picture, you will + first be asked if wish to save it. If it's not a new image, you will then + be asked if you want to save over the old version, or create a new entry. + (See "Save" above.) + + ⚙ Note: If the image is saved, it will be reloaded automatically the next + time you run Tux Paint -- unless the "startblank" option is set. + + ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the [Escape] + key, may be disabled, via the "noquit" option. + + In that case, the "window close" button on Tux Paint's title bar (if not in + fullscreen mode) or the [Alt] + [F4] key sequence may be used to quit. + + If neither of those are possible, the key sequence of [Shift] + [Control / + ⌘] + [Escape] may be used to quit. + + ⚙ See the "Options" documentation. + + + +h.Sound Muting + + There is no on-screen control button at this time, but by using the [Alt] + + [S] keyboard sequence, sound effects can be disabled and re-enabled (muted + and unmuted) while the program is running. + + Note that if sounds are completely disabled via the "nosound" option, the + [Alt] + [S] key combination has no effect. (i.e., it cannot be used to turn + on sounds when the parent/teacher wants them disabled.) + + ⚙ See the "Options" documentation. - There is no on-screen control button at this time, but by using - the [Alt] + [S] keyboard sequence, sound effects can be disabled - and re-enabled (muted and unmuted) while the program is running. - Note that if sounds are completely disabled via the "nosound" - option, the [Alt] + [S] key combination has no effect. (i.e., it - cannot be used to turn on sounds when the parent/teacher wants - them disabled.) - ⚙ See the "Options" documentation. E. Controlling Tux Paint - 1. Using a Mouse or Trackball +1. Using a Mouse or Trackball - Tux Paint's main mode of operation is via any device that appears to your - operating system as a mouse, including standard mice, trackballs, and - trackpads, as well as drawing tablets (usually operated with a stylus) and - touch screens (operated with a finger and/or a stylus) (see "Using a - Tablet or Touchscreen" below for more information). +Tux Paint's main mode of operation is via any device that appears to your +operating system as a mouse, including standard mice, trackballs, and +trackpads, as well as drawing tablets (usually operated with a stylus) and +touch screens (operated with a finger and/or a stylus) (see "Using a Tablet or +Touchscreen" below for more information). - For drawing and controlling Tux Paint, only a single mouse button is used - — typically, on multi-button mice, this will the left mouse button, but - this can usually be configured at the operating system level. By default, - Tux Paint will ignore input from the other button(s). If a user attempts - to use the other button(s), a pop-up dialog will eventually appear - reminding them that only one button is recognized Tux Paint. However, you - may configure Tux Paint to accept any button as input (see the Options - documentation). +For drawing and controlling Tux Paint, only a single mouse button is used — +typically, on multi-button mice, this will the left mouse button, but this can +usually be configured at the operating system level. By default, Tux Paint will +ignore input from the other button(s). If a user attempts to use the other +button(s), a pop-up dialog will eventually appear reminding them that only one +button is recognized Tux Paint. However, you may configure Tux Paint to accept +any button as input (see the Options documentation). - a. Scrolling +a. Scrolling - Many input devices offer a way to quickly scroll within applications — - many mice have a scroll wheel, trackballs have scroll rings, and trackpads - recognize certain "scroll" gestures (e.g., two-finger vertical motion, or - vertical motion on the edge of the trackpad). Tux Paint supports scrolling - input to allow quick scrolling through certain lists (e.g., Stamps, Magic - tools, and the New and Open dialogs). +Many input devices offer a way to quickly scroll within applications — many +mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize +certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion +on the edge of the trackpad). Tux Paint supports scrolling input to allow quick +scrolling through certain lists (e.g., Stamps, Magic tools, and the New and +Open dialogs). - Tux Paint will also automatically scroll if you click and hold the mouse - down on an scroll button — the "up" and "down" arrow buttons that appear - above and below scrolling lists. +Tux Paint will also automatically scroll if you click and hold the mouse down +on an scroll button — the "up" and "down" arrow buttons that appear above and +below scrolling lists. - b. Mouse Accessibility +b. Mouse Accessibility - Other devices that appear as a mouse can be used to control Tux Paint. For - example: - * Head pointing/tracking devices - * Eye gaze trackers - * Foot mice +Other devices that appear as a mouse can be used to control Tux Paint. For +example: - Tux Paint offers a "sticky mouse click" accessibility setting, where a - single click begins a click-and-drag operation, and a subsequent click - ends it. (See the Options documentation.) + * Head pointing/tracking devices + * Eye gaze trackers + * Foot mice - 2. Using a Tablet or Touchscreen +Tux Paint offers a "sticky mouse click" accessibility setting, where a single +click begins a click-and-drag operation, and a subsequent click ends it. (See +the Options documentation.) - As noted above, Tux Paint recognizes any device that appears as a mouse. - This means drawing tablets and touchscreens may be used. However, these - devices often support other features beyond X/Y motion, button clicks, and - scroll-wheel motion. Currently, those additional features are not - supported by Tux Paint. Some examples: - * Pressure and angle - * Eraser tip - * Multi-touch gestures +2. Using a Tablet or Touchscreen - 3. Using a Joystick-like Device +As noted above, Tux Paint recognizes any device that appears as a mouse. This +means drawing tablets and touchscreens may be used. However, these devices +often support other features beyond X/Y motion, button clicks, and scroll-wheel +motion. Currently, those additional features are not supported by Tux Paint. +Some examples: - Tux Paint may be configured to recognize input from any game controller - that appears to your operating system as a joystick. That even includes - modern game console controllers connected via USB or Bluetooth (e.g., - Nintendo Switch or Microsoft Xbox game pads)! + * Pressure and angle + * Eraser tip + * Multi-touch gestures - Numerous configuration options are available to best suit the device being - used, and the user's needs. Analog input will be used for coarse movement, - and digital "hat" input for fine movement. Buttons on the controller can - be mapped to different Tux Paint controls (e.g., acting as the [Escape] - key, switching to the Paint tool, invoking Undo and Redo operations, - etc.). See the Options documentation for more details. +3. Using a Joystick-like Device - 4. Using the Keyboard +Tux Paint may be configured to recognize input from any game controller that +appears to your operating system as a joystick. That even includes modern game +console controllers connected via USB or Bluetooth (e.g., Nintendo Switch or +Microsoft Xbox game pads)! - Tux Paint offers an option to allow the keyboard to be used to control the - mouse pointer. This includes motion and clicking, as well as shortcuts to - navigate between and within certain parts of the interface. See the - Options documentation for more details. +Numerous configuration options are available to best suit the device being +used, and the user's needs. Analog input will be used for coarse movement, and +digital "hat" input for fine movement. Buttons on the controller can be mapped +to different Tux Paint controls (e.g., acting as the [Escape] key, switching to +the Paint tool, invoking Undo and Redo operations, etc.). See the Options +documentation for more details. - III. Loading Other Pictures into Tux Paint +4. Using the Keyboard + +Tux Paint offers an option to allow the keyboard to be used to control the +mouse pointer. This includes motion and clicking, as well as shortcuts to +navigate between and within certain parts of the interface. See the Options +documentation for more details. + +III. Loading Other Pictures into Tux Paint A. Overview - Tux Paint's 'Open' dialog only displays pictures you created with Tux - Paint. So what do you do if you want to load some other drawinng or even a - photograph into Tux Paint, so you can edit or draw on it? +Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So +what do you do if you want to load some other drawinng or even a photograph +into Tux Paint, so you can edit or draw on it? - You can simply convert the picture to the format Tux Paint uses — PNG - (Portable Network Graphic) — and place it in Tux Paint's "saved" - directory/folder. Here is where to find it (by default): +You can simply convert the picture to the format Tux Paint uses — PNG (Portable +Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here +is where to find it (by default): - Windows 10, 8, 7, Vista - Inside the user's "AppData" folder, e.g.: - "C:\Users\username\AppData\Roaming\TuxPaint\saved\". +Windows 10, 8, 7, Vista + Inside the user's "AppData" folder, e.g.: "C:\Users\username\AppData\ + Roaming\TuxPaint\saved\". - Windows 2000, XP - Inside the user's "Application Data" folder, e.g.: "C:\Documents - and Settings\username\Application Data\TuxPaint\saved\". +Windows 2000, XP + Inside the user's "Application Data" folder, e.g.: "C:\Documents and + Settings\username\Application Data\TuxPaint\saved\". - macOS - Inside the user's "Library" folder, e.g.: - "/Users/username/Library/Application Support/Tux Paint/saved/". +macOS + Inside the user's "Library" folder, e.g.: "/Users/username/Library/ + Application Support/Tux Paint/saved/". - Linux/Unix - Inside a hidden ".tuxpaint" directory, in the user's home - directory ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". +Linux/Unix + Inside a hidden ".tuxpaint" directory, in the user's home directory + ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". - 💡 Note: It is also from this folder that you can copy or open pictures - drawn in Tux Paint using other applications, though the 'Export' option - from Tux Paint's 'Open' dialog can be used to copy them to a location - that's easier and safer to access. + +💡 Note: It is also from this folder that you can copy or open pictures drawn in +Tux Paint using other applications, though the 'Export' option from Tux Paint's +'Open' dialog can be used to copy them to a location that's easier and safer to +access. B. Using the import script, "tuxpaint-import" - Linux and Unix users can use the "tuxpaint-import" shell script which gets - installed when you install Tux Paint. It uses some NetPBM tools to convert - the image ("anytopnm"), resize it so that it will fit in Tux Paint's - canvas ("pnmscale"), and convert it to a PNG ("pnmtopng"). +Linux and Unix users can use the "tuxpaint-import" shell script which gets +installed when you install Tux Paint. It uses some NetPBM tools to convert the +image ("anytopnm"), resize it so that it will fit in Tux Paint's canvas +("pnmscale"), and convert it to a PNG ("pnmtopng"). - It also uses the "date" command to get the current time and date, which is - the file-naming convention Tux Paint uses for saved files. (Remember, you - are never asked for a 'filename' when you go to save or open pictures!) +It also uses the "date" command to get the current time and date, which is the +file-naming convention Tux Paint uses for saved files. (Remember, you are never +asked for a 'filename' when you go to save or open pictures!) - To use this script, simply run it from a command-line prompt, and provide - it the name(s) of the file(s) you wish to convert. +To use this script, simply run it from a command-line prompt, and provide it +the name(s) of the file(s) you wish to convert. - They will be converted and placed in your Tux Paint "saved" directory. +They will be converted and placed in your Tux Paint "saved" directory. - 💡 Note: If you're doing this for a different user (e.g., your child) - you'll need to make sure to run the command under their account.) +💡 Note: If you're doing this for a different user (e.g., your child) you'll +need to make sure to run the command under their account.) - Example: +Example: - $ tuxpaint-import grandma.jpg - grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import grandma.jpg + grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - The first line ("tuxpaint-import grandma.jpg") is the command to run. The - following two lines are output from the program while it's working. +The first line ("tuxpaint-import grandma.jpg") is the command to run. The +following two lines are output from the program while it's working. - Now you can load Tux Paint, and a version of that original picture will be - available under the 'Open' dialog. Just double-click its icon! +Now you can load Tux Paint, and a version of that original picture will be +available under the 'Open' dialog. Just double-click its icon! C. Importing Pictures Manually - Windows, macOS, and Haiku users who wish to import arbitrary images into - Tux Paint must do so via a manual process. +Windows, macOS, and Haiku users who wish to import arbitrary images into Tux +Paint must do so via a manual process. - Load a graphics program that is capable of both loading your picture and - saving a PNG format file. (See the documentation file "PNG.html" for a - list of suggested software, and other references.) +Load a graphics program that is capable of both loading your picture and saving +a PNG format file. (See the documentation file "PNG.html" for a list of +suggested software, and other references.) - When Tux Paint loads an image that's not the same size as its drawing - canvas, it scales (and sometimes smears the edges of) the image so that it - fits within the canvas. +When Tux Paint loads an image that's not the same size as its drawing canvas, +it scales (and sometimes smears the edges of) the image so that it fits within +the canvas. - To avoid having the image stretched or smeared, you can resize it to Tux - Paint's canvas size. This size depends on the size of the Tux Paint - window, or resolution at which Tux Paint is run, if in fullscreen. (Note: - The default resolution is 800x600.) See "Calculating Image Dimensions", - below. +To avoid having the image stretched or smeared, you can resize it to Tux +Paint's canvas size. This size depends on the size of the Tux Paint window, or +resolution at which Tux Paint is run, if in fullscreen. (Note: The default +resolution is 800x600.) See "Calculating Image Dimensions", below. - 1. Naming the File +1. Naming the File - Save the picture in PNG format. It is highly recommended that you name the - filename using the current date and time, since that's the convention Tux - Paint uses: +Save the picture in PNG format. It is highly recommended that you name the +filename using the current date and time, since that's the convention Tux Paint +uses: - YYYYMMDDhhmmss.png + YYYYMMDDhhmmss.png - * YYYY = Year - * MM = Month (two digits, "01"-"12") - * DD = Day of month (two digits, "01"-"31") - * HH = Hour (two digits, in 24-hour format, "00"-"23") - * mm = Minute (two digits, "00"-"59") - * ss = Seconds (two digits, "00"-"59") + * YYYY = Year + * MM = Month (two digits, "01"-"12") + * DD = Day of month (two digits, "01"-"31") + * HH = Hour (two digits, in 24-hour format, "00"-"23") + * mm = Minute (two digits, "00"-"59") + * ss = Seconds (two digits, "00"-"59") - Example: "20210731110500.png", for July 31, 2021 at 11:05am. +Example: "20210731110500.png", for July 31, 2021 at 11:05am. - Place this PNG file in your Tux Paint "saved" directory/folder. (See - above.) +Place this PNG file in your Tux Paint "saved" directory/folder. (See above.) - 2. Calculating Image Dimensions +2. Calculating Image Dimensions - This part of the documentation needs to be rewritten, since the new - "buttonsize" option was added. For now, try drawing and saving an image - within Tux Paint, then determine what size (pixel width and height) it - came out to, and try to match that when scaling the picture(s) you're - importing into Tux Paint. +This part of the documentation needs to be rewritten, since the new +"buttonsize" option was added. For now, try drawing and saving an image within +Tux Paint, then determine what size (pixel width and height) it came out to, +and try to match that when scaling the picture(s) you're importing into Tux +Paint. - IV.Further Reading +IV.Further Reading - Other documentation included with Tux Paint (found in the "docs" - folder/directory) includes: +Other documentation included with Tux Paint (found in the "docs" folder/ +directory) includes: - Using Tux Paint: - * OPTIONS.html - Detailed instructions on command-line and configuration-file - options, for those who don't want to use the Tux Paint - Config. tool to manage Tux Paint's configuration. - * 'Magic' Tool Documentation ("magic-docs") - Documentation for each of the currently-installed 'Magic' - tools. +Using Tux Paint: + + OPTIONS.html + Detailed instructions on command-line and configuration-file options, + for those who don't want to use the Tux Paint Config. tool to manage + Tux Paint's configuration. + + 'Magic' Tool Documentation ("magic-docs") + Documentation for each of the currently-installed 'Magic' tools. - How to extend Tux Paint: - * EXTENDING.html - Detailed instructions on extending Tux Paint: creating - brushes, stamps, starters, and templates; adding fonts; and - creating new on-screen keyboard layouts and input methods. - * PNG.html - Notes on creating PNG format bitmapped (raster) images for - use in Tux Paint. - * SVG.html - Notes on creating SVG format vector images for use in Tux - Paint. - Technical information: - * INSTALL.html - Instructions for compiling and installing Tux Paint, when - applicable. - * SIGNALS.html - Information about the POSIX signals that Tux Paint responds - to. - * MAGIC-API.html - Creating new Magic tools using Tux Paint's plugin API. +How to extend Tux Paint: + + EXTENDING.html + Detailed instructions on extending Tux Paint: creating brushes, stamps, + starters, and templates; adding fonts; and creating new on-screen + keyboard layouts and input methods. + + PNG.html + Notes on creating PNG format bitmapped (raster) images for use in Tux + Paint. + + SVG.html + Notes on creating SVG format vector images for use in Tux Paint. - Development history and license: - * AUTHORS.txt - List of authors and contributors. - * CHANGES.txt - Summary of what has changed between releases of Tux Paint. - * COPYING.txt - Tux Paint's software license, the GNU General Public License - (GPL) - V.How to Get Help +Technical information: + + INSTALL.html + Instructions for compiling and installing Tux Paint, when applicable. + + SIGNALS.html + Information about the POSIX signals that Tux Paint responds to. + + MAGIC-API.html + Creating new Magic tools using Tux Paint's plugin API. - If you need help, there are numerous ways to interact with Tux Paint - developers and other users: - * Report bugs or request new features via the project's bug-tracking - system - * Participate in the various project mailing lists - * Contact the developers directly - To learn more, visit the "Contact" page of the official Tux Paint website: - https://tuxpaint.org/contact/ +Development history and license: + + AUTHORS.txt + List of authors and contributors. + + CHANGES.txt + Summary of what has changed between releases of Tux Paint. + + COPYING.txt + Tux Paint's software license, the GNU General Public License (GPL) - VI.How to Participate - Tux Paint is a volunteer-driven project, and we're happy to accept your - help in a variety of ways: - * Translate Tux Paint to another language - * Improve existing translations - * Create artwork (stamps, starters, templates, brushes) - * Add or improve features or magic tools - * Create classroom curriculum - * Promote or help support others using Tux Paint - To learn more, visit the "Help Us" page of the official Tux Paint website: - https://tuxpaint.org/help/ +V.How to Get Help - VII.Follow the Tux Paint project on social media +If you need help, there are numerous ways to interact with Tux Paint developers +and other users: - Tux Paint maintains a presence on a variety of social media networks, - where we post updates and artwork. - * Join the Tux Paint page on Facebook - * Follow @TuxPaintDevs on Instagram - * Follow @tuxpaint@floss.social on Mastodon - * Follow u/TuxPaintDevs on Reddit - * Follow @TuxPaintDevs on Threads - * Follow Tux Paint on Tumblr - * Follow @TuxPaintTweets on Twitter + * Report bugs or request new features via the project's bug-tracking system + * Participate in the various project mailing lists + * Contact the developers directly - VIII. Trademark notices +To learn more, visit the "Contact" page of the official Tux Paint website: +https://tuxpaint.org/contact/ + +VI.How to Participate + +Tux Paint is a volunteer-driven project, and we're happy to accept your help in +a variety of ways: + + * Translate Tux Paint to another language + * Improve existing translations + * Create artwork (stamps, starters, templates, brushes) + * Add or improve features or magic tools + * Create classroom curriculum + * Promote or help support others using Tux Paint + +To learn more, visit the "Help Us" page of the official Tux Paint website: +https://tuxpaint.org/help/ + +VII.Follow the Tux Paint project on social media + +Tux Paint maintains a presence on a variety of social media networks, where we +post updates and artwork. + + * Join the Tux Paint page on Facebook + * Follow @TuxPaintDevs on Instagram + * Follow @tuxpaint@floss.social on Mastodon + * Follow u/TuxPaintDevs on Reddit + * Follow @TuxPaintDevs on Threads + * Follow Tux Paint on Tumblr + * Follow @TuxPaintTweets on Twitter + +VIII. Trademark notices + + * "Linux" is a registered trademark of Linus Torvalds. + * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. + * "Apple" and "macOS" are registered trademarks of Apple Inc. + * "Facebook", "Instagram", and "Threads" are registered trademarks of Meta + Platforms, Inc. + * "Mastodon" is a registered trademark of Mastodon gGmbH. + * "Reddit" is a registered trademark of Reddit, Inc. + * "Tumblr" is a registered trademark of Tumblr, Inc. + * "Twitter" is a registered trademark of X Corp. - * "Linux" is a registered trademark of Linus Torvalds. - * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. - * "Apple" and "macOS" are registered trademarks of Apple Inc. - * "Facebook", "Instagram", and "Threads" are registered trademarks of - Meta Platforms, Inc. - * "Mastodon" is a registered trademark of Mastodon gGmbH. - * "Reddit" is a registered trademark of Reddit, Inc. - * "Tumblr" is a registered trademark of Tumblr, Inc. - * "Twitter" is a registered trademark of X Corp. diff --git a/docs/es_ES.UTF-8/SIGNALS.txt b/docs/es_ES.UTF-8/SIGNALS.txt index 2554194b2..ad3909183 100644 --- a/docs/es_ES.UTF-8/SIGNALS.txt +++ b/docs/es_ES.UTF-8/SIGNALS.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 Signals Documentation Copyright © 2019-2022 by various contributors; see AUTHORS.txt. @@ -7,47 +7,51 @@ junio 4, 2022 - Tux Paint responds to the following signals (which can be sent to the - program's process via `kill` or `killall`, for example). +Tux Paint responds to the following signals (which can be sent to the program's +process via `kill` or `killall`, for example). - SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) +SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) - Tux Paint responds as if the "Quit" button were pressed, or the - desktop environment was told to close Tux Paint (e.g., by clicking - a window close button, or pressing [Alt] + [F4] on most systems). + Tux Paint responds as if the "Quit" button were pressed, or the desktop + environment was told to close Tux Paint (e.g., by clicking a window close + button, or pressing [Alt] + [F4] on most systems). - From the main interface, Tux Paint will prompt whether or not you - wish to quit, and (unless overridden by the auto-save option, e.g. - "--autosave") if you'd like to save the current drawing (if - unsaved), and if so, and it's a modified version of an existing - drawing (unless overridden by the options to save over old images, - or always save new images; e.g. "--saveover" and "--saveovernew", - respectively), whether or not to overwrite the existing drawing, - or save to a new file. + From the main interface, Tux Paint will prompt whether or not you wish to + quit, and (unless overridden by the auto-save option, e.g. "--autosave") if + you'd like to save the current drawing (if unsaved), and if so, and it's a + modified version of an existing drawing (unless overridden by the options + to save over old images, or always save new images; e.g. "--saveover" and + "--saveovernew", respectively), whether or not to overwrite the existing + drawing, or save to a new file. - Example: killall tuxpaint + Example: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint responds by setting its auto-save option (as if it had - been launched with "--autosave"), as well as either the option to - always save new images (as if launched with "--saveovernew") in - the case of receiving a SIGUSR1 signal, or to always save over the - existing image (as if launched with "--saveover") in the case of - receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, - in an attempt to quit. (See above.) - So, from the main interface, Tux Paint should quit almost - immediately, with no questions asked. +SIGUSR1 & SIGUSR2 + + Tux Paint responds by setting its auto-save option (as if it had been + launched with "--autosave"), as well as either the option to always save + new images (as if launched with "--saveovernew") in the case of receiving a + SIGUSR1 signal, or to always save over the existing image (as if launched + with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends + itself a SIGTERM signal, in an attempt to quit. (See above.) + + So, from the main interface, Tux Paint should quit almost immediately, with + no questions asked. + + Example: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - Example: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/es_ES.UTF-8/SVG.txt b/docs/es_ES.UTF-8/SVG.txt index dae5a9b86..1d157c038 100644 --- a/docs/es_ES.UTF-8/SVG.txt +++ b/docs/es_ES.UTF-8/SVG.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 SVG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. @@ -7,30 +7,31 @@ junio 4, 2022 - About SVGs +About SVGs - SVG (Scalable Vector Graphics) is an open standard used to describe - two-dimensional vector graphics. It is great for diagrams and shapes, - while PNGs are better for photographs. SVG files are a bit like - instructions on how to make an image. This means that they can be resized - without looking pixelated or blocky. +SVG (Scalable Vector Graphics) is an open standard used to describe +two-dimensional vector graphics. It is great for diagrams and shapes, while +PNGs are better for photographs. SVG files are a bit like instructions on how +to make an image. This means that they can be resized without looking pixelated +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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt b/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt index e5978644d..690b16491 100644 --- a/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt +++ b/docs/es_ES.UTF-8/tuxpaint-quickstart-guide.txt @@ -1,215 +1,210 @@ - Tux Paint 0.9.29 Quickstart Guide +Tux Paint 0.9.29 Quickstart Guide Tools (Drawing) - 🖌Paint +🖌Paint - * Choose a brush on the right. - * Some brushes are animated 🎞, some are directional ✲, some are both. - * Change brush spacing with the bars 📶 at the bottom right. - * Choose a color (see "Colors"). - * Click/tap and drag in the canvas to paint. + * Choose a brush on the right. + * Some brushes are animated 🎞, some are directional ✲, some are both. + * Change brush spacing with the bars 📶 at the bottom right. + * Choose a color (see "Colors"). + * Click/tap and drag in the canvas to paint. - ⌧Stamps +⌧Stamps - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Choose a stamp on the right. - * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near - the bottom right. - * Some stamps allow you to choose their color (see "Colors"). - * Change stamp size with the bars 📶 at the bottom right. - * Rotation ⟳ may be enabled, if desired. - * Click/tap in the canvas to place a stamp. - * If rotation is enabled, drag to rotate it, and click/tap again to - add it to the drawing. - * Some stamps play sound effects; press the speaker 🕪 button to hear it - again. - * Some stamps play descriptive sounds; press the headphones 🎧 button to - hear it again. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Choose a stamp on the right. + * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the + bottom right. + * Some stamps allow you to choose their color (see "Colors"). + * Change stamp size with the bars 📶 at the bottom right. + * Rotation ⟳ may be enabled, if desired. + * Click/tap in the canvas to place a stamp. + + If rotation is enabled, drag to rotate it, and click/tap again to add + it to the drawing. + * Some stamps play sound effects; press the speaker 🕪 button to hear it + again. + * Some stamps play descriptive sounds; press the headphones 🎧 button to hear + it again. - ⚟Lines +⚟Lines - * (See Paint) - * Click/tap and drag to draw a line. + * (See Paint) + * Click/tap and drag to draw a line. - ⭓Shapes +⭓Shapes - * Choose a shape on the right. - * Select whether you want to extend the shape from the center ⧈, or a - corner ◰, using controls at the bottom right. - * 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. + * Choose a shape on the right. + * Select whether you want to extend the shape from the center ⧈, or a corner + ◰, using controls at the bottom right. + * Click/tap to position, and drag to set the size of the shape. + * Drag to rotate it, and click/tap again to add it to the drawing. - 🄰Text +🄰Text - * Choose a font on the right. - * Select whether you want the text bold 𝗔 and/or italic 𝘈, using - controls near the bottom right. - * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom - right. - * Choose a color (see "Colors"). - * Click/tap the canvas to position an insertion cursor. - * Enter text via your keyboard or the on-screen keyboard. - * 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 - and begin entering more text one line down. - * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and - continue entering more text immediately to the right. - * Using the on-screen keyboard: - * "Cmp" can be used to compose characters, e.g. Cmp ' a results in - á. - * "AltGr" can be used to quickly access more characters. - * Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. - "ABC") + * Choose a font on the right. + * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls + near the bottom right. + * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom + right. + * Choose a color (see "Colors"). + * Click/tap the canvas to position an insertion cursor. + * Enter text via your keyboard or the on-screen keyboard. + * 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 and + begin entering more text one line down. + * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and + continue entering more text immediately to the right. + * Using the on-screen keyboard: + + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á. + + "AltGr" can be used to quickly access more characters. + + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC") - 🅰Label +🅰Label - * (See Text) - * Labels float 'above' the drawing; you cannot paint or stamp over them, - apply Magic effects, etc. - * Labels may be edited, repositioned, and styled after they've been - added to the drawing. - * Click/tap the ☝ button near the lower right to choose a label. - Click/tap the label you wish to modify, then click/tap somewhere else - in the canvas to reposition, or change the font/style, change color, - and/or type to edit the text. - * Or, use the 🖑 button near the lower right to "flatten" a label, - applying it to the canvas; it may no longer be edited with the Label - tool. + * (See Text) + * Labels float 'above' the drawing; you cannot paint or stamp over them, + apply Magic effects, etc. + * Labels may be edited, repositioned, and styled after they've been added to + the drawing. + * Click/tap the ☝ button near the lower right to choose a label. Click/tap + the label you wish to modify, then click/tap somewhere else in the canvas + to reposition, or change the font/style, change color, and/or type to edit + the text. + * Or, use the 🖑 button near the lower right to "flatten" a label, applying it + to the canvas; it may no longer be edited with the Label tool. - 🪣Fill +🪣Fill - * Choose a fill mode on the right. - * Choose a color (see "Colors"). - * Click/tap (and drag, with Brush and Linear modes) to fill an area of - the picture with a color. - * Solid - Flood-fills an area with a solid color - * Brush - Paints with a solid color, without drawing outside the - chosen area - * Linear - Fills the area with a linear gradient (drag to choose - angle and gradient) - * Radial - Fills the area with a radial gradient, centered where - you clicked/tapped - * Shaped - Fills the area with a gradient that follows the contours - of the area being filled + * Choose a fill mode on the right. + * Choose a color (see "Colors"). + * Click/tap (and drag, with Brush and Linear modes) to fill an area of the + picture with a color. + + Solid - Flood-fills an area with a solid color + + Brush - Paints with a solid color, without drawing outside the chosen + area + + Linear - Fills the area with a linear gradient (drag to choose angle + and gradient) + + Radial - Fills the area with a radial gradient, centered where you + clicked/tapped + + Shaped - Fills the area with a gradient that follows the contours of + the area being filled - 🪄Magic +🪄Magic - * Choose a magic tool on the right. - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some - affect the entire drawing 🖻🪄, and some offer both options; use the - controls at the bottom right. - * Some magic tools offer various sizes; change it with the bars 📶 at the - bottom right. - * Some magic tools allow you to choose their color. + * Choose a magic tool on the right. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some + affect the entire drawing 🖻🪄, and some offer both options; use the controls + at the bottom right. + * Some magic tools offer various sizes; change it with the bars 📶 at the + bottom right. + * Some magic tools allow you to choose their color. - 🖓Undo +🖓Undo - * Use to undo the most recent changes (multiple undo available). - * Shortcut: [Ctrl]+[Z] + * Use to undo the most recent changes (multiple undo available). + * Shortcut: [Ctrl]+[Z] - 🖒Redo +🖒Redo - * Use to redo the most recent undone change (multiple redo available). - * Shortcut: [Ctrl]+[R] + * Use to redo the most recent undone change (multiple redo available). + * Shortcut: [Ctrl]+[R] - ◪Eraser +◪Eraser - * Choose the size and shape of the eraser on the right. - * Click/tap and drag to erase parts of the picture (solid color, or - starter or template image). - * Shortcut: [X] and click/tap in the drawing (not always available) + * Choose the size and shape of the eraser on the right. + * Click/tap and drag to erase parts of the picture (solid color, or starter + or template image). + * Shortcut: [X] and click/tap in the drawing (not always available) Tools (Controls) - 🗏New +🗏New - * Choose a solid color, starter, or template image to start with. - * Starters allow drawing "under" a picture (e.g., a coloring book - outline), sometimes with a background layer, too. - * Templates are pictures to start with (background only). - * Eraser tool ◪ reveals the solid color, or starter/template - background. - * Click/tap "🕮⮫Open" to begin a new drawing. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Shortcut: [Ctrl]+[N] + * Choose a solid color, starter, or template image to start with. + + Starters allow drawing "under" a picture (e.g., a coloring book + outline), sometimes with a background layer, too. + + Templates are pictures to start with (background only). + + Eraser tool ◪ reveals the solid color, or starter/template background. + * Click/tap "🕮⮫Open" to begin a new drawing. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Shortcut: [Ctrl]+[N] - 🕮⮫Open +🕮⮫Open - * Choose a previously-saved drawing to open (or export or erase). - * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. - * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" - folder. - * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle - Bin. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Click/tap "📽Slides" to switch to slideshow mode: - * Click/tap two or more of your previously-saved drawings, in the - order you want them shown. Numbers will appear on them. - * Choose the playback speed using the bars 📶 near the lower left. - * Click/tap "⯈Play" to watch the slideshow/animation. - * Or, click/tap "🎞GIF Export" to save an animated GIF of the - animation to your system's "Pictures" folder. - * Click/tap "⤺Back" to return to the Open dialog. - * Shortcut: [Ctrl]+[O] + * Choose a previously-saved drawing to open (or export or erase). + * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. + * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" + folder. + * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Click/tap "📽Slides" to switch to slideshow mode: + + Click/tap two or more of your previously-saved drawings, in the order + you want them shown. Numbers will appear on them. + + Choose the playback speed using the bars 📶 near the lower left. + + Click/tap "⯈Play" to watch the slideshow/animation. + + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to + your system's "Pictures" folder. + + Click/tap "⤺Back" to return to the Open dialog. + * Shortcut: [Ctrl]+[O] - 🕮⮪Save +🕮⮪Save - * Click/tap to save your drawing. - * If you've saved previously, you'll be prompted whether to overwrite - the previously-saved drawing (a la "File→Save") or create a new saved - drawing (a la "File→Save As...") - * Shortcut: [Ctrl]+[S] + * Click/tap to save your drawing. + * If you've saved previously, you'll be prompted whether to overwrite the + previously-saved drawing (a la "File→Save") or create a new saved drawing + (a la "File→Save As...") + * Shortcut: [Ctrl]+[S] - 🖶Print +🖶Print - * Click/tap to print your drawing. - * Hold [Alt] or [Option] while clicking/tapping to bring up printer - dialog, if available. - * Shortcut: [Ctrl]+[P] + * Click/tap to print your drawing. + * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog, + if available. + * Shortcut: [Ctrl]+[P] - 🗙Quit +🗙Quit - * Click/tap to quit Tux Paint. - * Shortcut: [Esc] + * Click/tap to quit Tux Paint. + * Shortcut: [Esc] Colors - * Click/tap to choose a color to use with the Paint, Lines, and Shapes - tools, and Stamps and Magic tools that support colors. - * Use the pipette / color picker 💉 button to choose a color from a pixel - in your current drawing. - * Shortcut: When colors are available, press [Ctrl] and click/tap - in your drawing, to quickly pick a color from your drawing. - * Click/tap the rainbow 🌈 button to choose a arbitrary color. - * Click/tap in the rainbow square to pick a color (hue and - saturation). - * Click/tap in the grey gradient bar to adjust brightness (value). - * Click/tap the green checkbox ✓ to accept. - * Click/tap "⤺Back" to abort and dismiss the palette. - * You may grab the currently-chosen built-in color (if any), the - color in the pipette / color picker, or the color in the color - mixer, by clicking one of the colored arrow ⇫ buttons. - * Click/tap the paint palette 🎨 button to create a color by mixing - primary colors: red, yellow, and blue, and white (tint), grey (tone), - and black (shade). - * Click/tap the green checkbox ✓ to accept. - * Color mixing offers its own 🖓Undo and 🖒Redo options. - * Click/tap "🗑Clear" to start over with no mixed colors. - * Click/tap "⤺Back" to abort and dismiss the color mixer. + * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools, + and Stamps and Magic tools that support colors. + * Use the pipette / color picker 💉 button to choose a color from a pixel in + your current drawing. + + Shortcut: When colors are available, press [Ctrl] and click/tap in your + drawing, to quickly pick a color from your drawing. + * Click/tap the rainbow 🌈 button to choose a arbitrary color. + + Click/tap in the rainbow square to pick a color (hue and saturation). + + Click/tap in the grey gradient bar to adjust brightness (value). + + Click/tap the green checkbox ✓ to accept. + + Click/tap "⤺Back" to abort and dismiss the palette. + + You may grab the currently-chosen built-in color (if any), the color in + the pipette / color picker, or the color in the color mixer, by + clicking one of the colored arrow ⇫ buttons. + * Click/tap the paint palette 🎨 button to create a color by mixing primary + colors: red, yellow, and blue, and white (tint), grey (tone), and black + (shade). + + Click/tap the green checkbox ✓ to accept. + + Color mixing offers its own 🖓Undo and 🖒Redo options. + + Click/tap "🗑Clear" to start over with no mixed colors. + + Click/tap "⤺Back" to abort and dismiss the color mixer. Shortcuts while drawing: - * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access - * [X]+Click/tap - Quick eraser ◪ access - * [Ctrl]+[Z] - 🖓Undo - * [Ctrl]+[R] - 🖒Redo - * [Ctrl]+[N] - 🗏New - * [Ctrl]+[O] - 🕮⮫Open - * [Ctrl]+[S] - 🕮⮪Save - * [Ctrl]+[P] - 🖶Print - * [Alt]+[S] - Toggle sound effects on/off - * [Esc] - ⤺Back or 🗙Quit + * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access + * [X]+Click/tap - Quick eraser ◪ access + * [Ctrl]+[Z] - 🖓Undo + * [Ctrl]+[R] - 🖒Redo + * [Ctrl]+[N] - 🗏New + * [Ctrl]+[O] - 🕮⮫Open + * [Ctrl]+[S] - 🕮⮪Save + * [Ctrl]+[P] - 🖶Print + * [Alt]+[S] - Toggle sound effects on/off + * [Esc] - ⤺Back or 🗙Quit + +Last updated: mayo 9, 2023 - Last updated: mayo 9, 2023 diff --git a/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt index 16a5b9edf..e35e3e944 100644 --- a/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/fr_FR.UTF-8/ADVANCED-STAMPS-HOWTO.txt @@ -4,324 +4,315 @@ Copyright © 2006-2022 by Albert Cahalan et d'autres; see AUTHORS.txt. https://tuxpaint.org/ - juin 4, 2022 + juin 4, 2022 - ---------------------------------------------------------------------- - - +----------------------------------------------------+ - |Table des matières | - |----------------------------------------------------| - | * À propos de ce 'guide pratique' | - | * Le choix de l'image est crucial | - | * Préparez le masque | - | * Remplacer la frange et les pixels indésirables | - | * Sauvegarder l'image pour Tux Paint | - +----------------------------------------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++----------------------------------------------------+ +| Table des matières | +|----------------------------------------------------| +| * À propos de ce 'guide pratique' | +| * Le choix de l'image est crucial | +| * Préparez le masque | +| * Remplacer la frange et les pixels indésirables | +| * Sauvegarder l'image pour Tux Paint | ++----------------------------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- À propos de ce 'guide pratique' - Ce 'guide pratique' suppose que vous vouliez créer un excellent tampon - pour Tux Paint, au format bitmap PNG, à partir d'une image JPEG (par ex. - une photographie digitale). Il existe des méthodes plus faciles et plus - rapides donnant de moins bons résultats. + Ce 'guide pratique' suppose que vous vouliez créer un excellent tampon pour + Tux Paint, au format bitmap PNG, à partir d'une image JPEG (par ex. une + photographie digitale). Il existe des méthodes plus faciles et plus rapides + donnant de moins bons résultats. - Ce 'guide pratique' suppose que vous travaillez avec des objets - normalement opaques. Pour des objets semi-transparents (flamme, hélice - de ventilateur en mouvement) ou des objets luminescents (feu, ampoule, - soleil) mieux vaut travailler avec un logiciel adapté. Des images avec - de parfaits arrière-plans de couleur unie sont mieux réalisées avec un - logiciel adapté, mais ne posent pas de problèmes avec ce qui suit. + Ce 'guide pratique' suppose que vous travaillez avec des objets normalement + opaques. Pour des objets semi-transparents (flamme, hélice de ventilateur + en mouvement) ou des objets luminescents (feu, ampoule, soleil) mieux vaut + travailler avec un logiciel adapté. Des images avec de parfaits + arrière-plans de couleur unie sont mieux réalisées avec un logiciel adapté, + mais ne posent pas de problèmes avec ce qui suit. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Le choix de l'image est crucial - Licence + Licence - Si vous voulez présenter une oeuvre aux développeurs de Tux Paint - destinée à être incluse dans le projet officiel, ou si vous voulez - faire une version de Tux Paint pour votre seul usage avec vos propres - graphiques, vous devez avoir une image compatible avec la Licence - Publique Générale GNU utilisée par Tux Paint. + Si vous voulez présenter une oeuvre aux développeurs de Tux Paint + destinée à être incluse dans le projet officiel, ou si vous voulez + faire une version de Tux Paint pour votre seul usage avec vos propres + graphiques, vous devez avoir une image compatible avec la Licence + Publique Générale GNU utilisée par Tux Paint. - Les images produites par le gouvernement US sont dans le domaine - public, mais faites attention car le gouvernement US utilise parfois - des images provenant du web. Une demande incluant soit site:gov soit - site:mil sur Google image vous donnera beaucoup d'images qui - conviendront. (Note : les sites *.mil peuvent avoir aussi des contenus - non-militaires !) + Les images produites par le gouvernement US sont dans le domaine + public, mais faites attention car le gouvernement US utilise parfois + des images provenant du web. Une demande incluant soit site:gov soit + site:mil sur Google image vous donnera beaucoup d'images qui + conviendront. (Note : les sites *.mil peuvent avoir aussi des contenus + non-militaires !) - Vos propres images peuvent être placées dans le domaine public, ou - sous une licence adéquate, telle que Google image en y faisant - référence. (Demandez à un avocat si vous pensez que vous avez besoin - d'un avis faisant autorité). + Vos propres images peuvent être placées dans le domaine public, ou sous + une licence adéquate, telle que Google image en y faisant référence. + (Demandez à un avocat si vous pensez que vous avez besoin d'un avis + faisant autorité). - Pour un usage personnel, toute image que vous pouvez légalement - modifier et utiliser pour vous-même devrait convenir. + Pour un usage personnel, toute image que vous pouvez légalement + modifier et utiliser pour vous-même devrait convenir. - Taille et orientation de l'image + Taille et orientation de l'image - Vous aurez besoin d'une image ayant une bonne orientation. La - perspective est notre ennemie. Les images montrant un objet à partir - d'un coin sont difficiles à intégrer pour obtenir un dessin correct. - En règle générale, les photos prises au téléobjectif sont les - meilleures. L'idéal, impossible à tenir, serait que deux roues d'une - même voiture soient cachées derrière les deux autres. + Vous aurez besoin d'une image ayant une bonne orientation. La + perspective est notre ennemie. Les images montrant un objet à partir + d'un coin sont difficiles à intégrer pour obtenir un dessin correct. En + règle générale, les photos prises au téléobjectif sont les meilleures. + L'idéal, impossible à tenir, serait que deux roues d'une même voiture + soient cachées derrière les deux autres. - 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 - celles où il n'y a pas de rotation, et celles qui nécessitent beaucoup - de rotation (30à 60 degrés) ne sont pas loin des meilleures, et celles - qui ne nécessitent que quelques degrés sont les pires. La rotation - rendra également l'image plus sombre car la plupart des logiciels de - manipulation d'images sont très mauvais quant au traitement du gamma. - (Le rotation ne se justifie qu'avec des images ayant un gamma de 1.0) + 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 + celles où il n'y a pas de rotation, et celles qui nécessitent beaucoup + de rotation (30à 60 degrés) ne sont pas loin des meilleures, et celles + qui ne nécessitent que quelques degrés sont les pires. La rotation + rendra également l'image plus sombre car la plupart des logiciels de + manipulation d'images sont très mauvais quant au traitement du gamma. + (Le rotation ne se justifie qu'avec des images ayant un gamma de 1.0) - De très grandes images pardonnent plus facilement les erreurs, et sont - donc plus faciles pour travailler. Choisissez une image avec un objet - de plus de 1 000 pixels si possible. Vous pourrez ainsi la réduire et - cacher vos erreurs. + De très grandes images pardonnent plus facilement les erreurs, et sont + donc plus faciles pour travailler. Choisissez une image avec un objet + de plus de 1 000 pixels si possible. Vous pourrez ainsi la réduire et + cacher vos erreurs. - Vérifiez bien que l'image ne soit pas trop granuleuse, pâle ou - délavée. + Vérifiez bien que l'image ne soit pas trop granuleuse, pâle ou délavée. - 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 - camouflée, vous devriez pouvoir effectuer un copié-collé pour le - remplacement. + 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 + camouflée, vous devriez pouvoir effectuer un copié-collé pour le + remplacement. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Préparez l'image - Tout d'abord, ne re-sauvegardez pas une image au format JPEG. Cela - induit une perte de qualité. Il existe un outil spécial appelé jpegtran - qui vous permet de découper une image sans la perte de qualité - habituelle. + Tout d'abord, ne re-sauvegardez pas une image au format JPEG. Cela induit + une perte de qualité. Il existe un outil spécial appelé jpegtran qui vous + permet de découper une image sans la perte de qualité habituelle. - jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - Importez votre image dans votre éditeur d'image. Si vous n'avez pas - encore recadré votre image, vous pouvez trouver que votre éditeur est - très lent. Faites une rotation et recadrer l'image comme vous voulez. - Sauvegardez l'image -- choisissez tout format supportant les calques, - les masques, alpha, etc... Les utilisateurs de GIMP choisiront le format - XCF, et les utilisateurs de Adobe Photoshop choisiront PSD, à titre - d'exemple. + Importez votre image dans votre éditeur d'image. Si vous n'avez pas encore + recadré votre image, vous pouvez trouver que votre éditeur est très lent. + Faites une rotation et recadrer l'image comme vous voulez. Sauvegardez + l'image -- choisissez tout format supportant les calques, les masques, + alpha, etc... Les utilisateurs de GIMP choisiront le format XCF, et les + utilisateurs de Adobe Photoshop choisiront PSD, à titre d'exemple. - 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 - ou canal alpha. + 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 ou + canal alpha. - 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 - chose comme cela : + 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 + chose comme cela : - 1. image non-modifiée (protégez la en écriture, si possible) - 2. une image que vous modifierez -- c'est la couche "travail en cours" - 3. vert 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) + 1. image non-modifiée (protégez la en écriture, si possible) + 2. une image que vous modifierez -- c'est la couche "travail en cours" + 3. vert 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) - Donnez au calque 'travail en cours' (WIP) un masque initial - approximatif. Vous pouvez démarrer avec une sélection, ou en utilisant - la valeur de niveaux de gris du calque WIP. Vous pouvez inverser le - masque. + Donnez au calque 'travail en cours' (WIP) un masque initial approximatif. + Vous pouvez démarrer avec une sélection, ou en utilisant la valeur de + niveaux de gris du calque WIP. Vous pouvez inverser le masque. - 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 - de données. On vous donnera plus tard des instructions pour la mise à - l'échelle. + 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 de + données. On vous donnera plus tard des instructions pour la mise à + l'échelle. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Préparez le masque - 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 - faire pour vérifier ce que vous voyez et ce que vous éditez. Parfois - vous éditerez des choses que vous ne pouvez pas voir. Par exemple, vous - pouvez éditer le masque du masque WIP, tout en regardant l'image non - modifiée. Faites attention à ne pas vous tromper. Vérifiez toujours que - vous éditez ce qu'il faut. + 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 faire + pour vérifier ce que vous voyez et ce que vous éditez. Parfois vous + éditerez des choses que vous ne pouvez pas voir. Par exemple, vous pouvez + éditer le masque du masque WIP, tout en regardant l'image non modifiée. + Faites attention à ne pas vous tromper. Vérifiez toujours que vous éditez + ce qu'il faut. - 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 - comme étant ce que vous allez éditer. À un moment donné, vous devriez - agrandir l'image à environ 400 % (chaque pixel de l'image est vu et - représenté par un bloc de 4x4 pixels sur votre écran. + 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 comme + étant ce que vous allez éditer. À un moment donné, vous devriez agrandir + l'image à environ 400 % (chaque pixel de l'image est vu et représenté par + un bloc de 4x4 pixels sur votre écran. - 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 - bonne précision, faites le. Si nécessaire, pour éviter de sélectionner - des pixels devant être partiellement opaques (en général sur les bords - de l'objet), vous devriez agrandir, réduire et inverser la sélection. + 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 + bonne précision, faites le. Si nécessaire, pour éviter de sélectionner des + pixels devant être partiellement opaques (en général sur les bords de + l'objet), vous devriez agrandir, réduire et inverser la sélection. - Remplissez les zones 100 % opaques avec du blanc, et les 0 % opaques - avec du noir. On le fait facilement en glissant-déposant depuis - l'indicateur de couleur de premier plan. Vous ne devriez rien voir se - produire, car vous voyez le calque de l'image non modifiée quand vous - éditez le masque du calque WIP. Les changements importants peuvent être - vus sur la vignette. + Remplissez les zones 100 % opaques avec du blanc, et les 0 % opaques avec + du noir. On le fait facilement en glissant-déposant depuis l'indicateur de + couleur de premier plan. Vous ne devriez rien voir se produire, car vous + voyez le calque de l'image non modifiée quand vous éditez le masque du + calque WIP. Les changements importants peuvent être 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. - N'affichez que le masque, qui devrait être un objet blanc sur un fond - noir (probablement avec du gris non édité sur les bords). Maintenant - affichez le calque WIP normalement, pour que le masque soit actif. Cela - devrait montrer votre objet par dessus le prochain calque activé le plus - élevé, et qui devrait être vert ou magenta, suivant le cas, pour avoir - un contraste maximum. Vous pourriez basculer entre ces arrière-plans en - cliquant plusieurs fois pour activer/désactiver le calque vert. Corrigez - tous les problèmes évidents et faciles en éditant le masque. + 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 noir + (probablement avec du gris non édité sur les bords). Maintenant affichez le + calque WIP normalement, pour que le masque soit actif. Cela devrait montrer + votre objet par dessus le prochain calque activé le plus élevé, et qui + devrait être vert ou magenta, suivant le cas, pour avoir un contraste + maximum. Vous pourriez basculer entre ces arrière-plans en cliquant + plusieurs fois pour activer/désactiver le calque vert. Corrigez tous les + problèmes évidents et faciles en éditant le masque. - Revenez à l'affichage du calque supérieur non modifié lors de l'édition - du masque WIP. Ajustez le pinceau dans l'outil de dessin. Pour la - brosse, choisissez un petit cercle flou. Une taille de 5x5 convient dans - la plupart des cas. + Revenez à l'affichage du calque supérieur non modifié lors de l'édition du + masque WIP. Ajustez le pinceau dans l'outil de dessin. Pour la brosse, + choisissez un petit cercle flou. Une taille de 5x5 convient dans la plupart + des cas. - 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 - par couleur. + 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 + par couleur. - 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 - voir un tout petit peu de l'arrière-plan initial ressemblant à une - vilaine frange près du bord. Si la frange est absente, c'est que le - masque d'objet est trop petit. La frange est constituée de pixels qui ne - sont ni à un objet à 100 % ni un objet à 0 %. Pour eux, le masque ne - devrait être ni à 100 % ni à 0 %. La frange disparaîtra bientôt. + 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 + voir un tout petit peu de l'arrière-plan initial ressemblant à une vilaine + frange près du bord. Si la frange est absente, c'est que le masque d'objet + est trop petit. La frange est constituée de pixels qui ne sont ni à un + objet à 100 % ni un objet à 0 %. Pour eux, le masque ne devrait être ni à + 100 % ni à 0 %. La frange disparaîtra bientôt. - Affichez et modifiez le masque. Sélectionnez par couleur, en choisissant - le noir ou le blanc. Vous verrez sûrement des tâches non sélectionnées - qui ne sont pas tout à fait à la couleur attendue. Inversez la - sélection, et coloriez les avec l'outil crayon. Faites ces opérations - pour le blanc et le noir. + Affichez et modifiez le masque. Sélectionnez par couleur, en choisissant le + noir ou le blanc. Vous verrez sûrement des tâches non sélectionnées qui ne + sont pas tout à fait à la couleur attendue. Inversez la sélection, et + coloriez les avec l'outil crayon. Faites ces opérations pour le blanc et le + noir. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Remplacer la frange et les pixels indésirables - Toujours en regardant le masque, sélectionnez par couleur. Choisissez le - noir. Réduisez la sélection de plusieurs pixels, en veillant à NE PAS - rétrécir par rapport aux bords du masque (le rétrécissement vous aide à - éviter et à récupérer des erreurs). + Toujours en regardant le masque, sélectionnez par couleur. Choisissez le + noir. Réduisez la sélection de plusieurs pixels, en veillant à NE PAS + rétrécir par rapport aux bords du masque (le rétrécissement vous aide à + éviter et à récupérer des erreurs). - 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 - couleur moyenne pour l'objet. Faites glisser et déposez cette couleur - dans la sélection, supprimant ainsi la plupart des pixels non-objets. + 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 + couleur moyenne pour l'objet. Faites glisser et déposez cette couleur dans + la sélection, supprimant ainsi la plupart des pixels non-objets. - Cette couleur unie se compressera bien et aidera à éviter les franges 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 - votre sélection afin de pouvoir colorer l'arrière-plan voisin d'une - teinte similaire. + Cette couleur unie se compressera bien et aidera à éviter les franges 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 votre + sélection afin de pouvoir colorer l'arrière-plan voisin d'une teinte + similaire. - Vous allez maintenant peindre la frange de bord existante. Assurez-vous - que vous modifiez et visualisez l'image WIP. En changeant fréquemment de - calque, vous verrez mieux à voir ce que vous faites. Vous êtes - susceptible d'utiliser tous ceux-ci : + Vous allez maintenant peindre la frange de bord existante. Assurez-vous que + vous modifiez et visualisez l'image WIP. En changeant fréquemment de + calque, vous verrez mieux à voir ce que vous faites. Vous êtes susceptible + d'utiliser tous ceux-ci : - * composite sur vert (masque activé) - * composite sur magenta (masque activé) - * original (calque supérieur ou inférieur) - * composite sur l'original (masque activé) - * calque WIP brut (masque désactivé + + composite sur vert (masque activé) + + composite sur magenta (masque activé) + + original (calque supérieur ou inférieur) + + composite sur l'original (masque activé) + + calque WIP brut (masque désactivé - Pour réduire les accidents, vous souhaiterez peut-être sélectionner - uniquement les pixels qui ne sont pas gris dans le masque. (Sélectionnez - par couleur dans le masque, choisissez le noir, ajoutez le mode, - choisissez le blanc, inversez. Ou bien : sélectionnez tout, sélectionnez - par couleur dans le masque, soustrayez le mode, choisissez le noir, - choisissez le blanc.) Si vous faites cela, vous voudrez probablement - élargir un peu la sélection et / ou masquer la ligne "fourmis rampantes" - qui marque la sélection. + Pour réduire les accidents, vous souhaiterez peut-être sélectionner + uniquement les pixels qui ne sont pas gris dans le masque. (Sélectionnez + par couleur dans le masque, choisissez le noir, ajoutez le mode, choisissez + le blanc, inversez. Ou bien : sélectionnez tout, sélectionnez par couleur + dans le masque, soustrayez le mode, choisissez le noir, choisissez le + blanc.) Si vous faites cela, vous voudrez probablement élargir un peu la + sélection et / ou masquer la ligne "fourmis rampantes" qui marque la + sélection. - 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 - generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy - brushes with about 70% opacity.) Unusual drawing modes can be helpful - with semi-transparent objects. + 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 + generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy + brushes with about 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. - 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 - est 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 - 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 - 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 - fond noir. Lorsque Tux Paint redimensionne cela à 50% (une zone de 1 x 1 - pixel), le résultat sera un pixel opaque gris à 50%. Le résultat correct - devrait être un pixel blanc opaque à 50%. Pour obtenir ce résultat, nous - devrions peindre les pixels noirs. Ils comptent, bien qu'ils soient à 0 - % d'opacité. + 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 est + 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 + 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 + 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 fond + noir. Lorsque Tux Paint redimensionne cela à 50% (une zone de 1 x 1 pixel), + le résultat sera un pixel opaque gris à 50%. Le résultat correct devrait + être un pixel blanc opaque à 50%. Pour obtenir ce résultat, nous devrions + peindre les pixels noirs. Ils comptent, bien qu'ils soient à 0 % d'opacité. - Tux Paint peut réduire considérablement la taille des images, il est - donc 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 - sur ce point. Lorsque vous vous éloignez de l'objet, cela risque de - faire négligé. Il est raisonnable de peindre vers l'extérieur sur une - douzaine de pixels ou plus. Plus vous irez loin, plus Tux Paint pourra - réduire la taille sans créer de franges avec des couleurs moches. Pour - les zones situées à plus de quelques pixels du bord, vous devez utiliser - l'outil Crayon (ou une vague sélection avec une couleur en - glisser-déposer) pour vous assurer que le résultat se compressera bien. + Tux Paint peut réduire considérablement la taille des images, il est donc + 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 sur + ce point. Lorsque vous vous éloignez de l'objet, cela risque de faire + négligé. Il est raisonnable de peindre vers l'extérieur sur une douzaine de + pixels ou plus. Plus vous irez loin, plus Tux Paint pourra réduire la + taille sans créer de franges avec des couleurs moches. Pour les zones + situées à plus de quelques pixels du bord, vous devez utiliser l'outil + Crayon (ou une vague sélection avec une couleur en glisser-déposer) pour + vous assurer que le résultat se compressera bien. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Sauvegarder l'image pour Tux Paint - It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, you - can try saving your image directly as a PNG. Be sure to read it back in - again to verify that the 0% opaque areas didn't turn black or white, - which would create fringes when Tux Paint scales the image down. If you - need to scale your image to save space (and hide your mistakes), you are - almost certain to destroy all the 0% opaque areas. So here is a better - way... + It is very easy to ruin your hard work. Image editors can silently destroy + pixels in 0% opaque areas. The conditions under which this happens may vary + from version to version. If you are very trusting, you can try saving your + image directly as a PNG. Be sure to read it back in again to verify that + the 0% opaque areas didn't turn black or white, which would create fringes + when Tux Paint scales the image down. If you need to scale your image to + save space (and hide your mistakes), you are almost certain to destroy all + the 0% opaque areas. So here is a better 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 - partie inutilisée de la barre d'outils (juste après le dernier outil - de dessin). Cela créera une nouvelle image composée d'un calque - contenant les données du masque. Mettez-le à l'échelle comme vous le - souhaitez, en vous souvenant des paramètres que vous utilisez. - Souvent, vous devriez commencer par une image d'environ 700 à 1500 - pixels de diamètre et finir par une image de 300 à 400. + 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 de + dessin). Cela créera une nouvelle image composée d'un calque contenant + les données du masque. Mettez-le à l'échelle comme vous le souhaitez, + en vous souvenant des paramètres que vous utilisez. Souvent, vous + devriez commencer par une image d'environ 700 à 1500 pixels de diamètre + et finir par une image de 300 à 400. - Enregistrez l'image de masque en tant que fichier portable NetPBM - (".pgm"). (Si vous utilisez une ancienne version de The GIMP, vous - devrez peut-être convertir l'image en niveaux de gris avant de pouvoir - l'enregistrer.) Choisissez le format "RAW PGM" le plus compact. (Le - deuxième caractère du fichier doit être le chiffre ASCII "5", octet - hexadécimal 0x35.) + Enregistrez l'image de masque en tant que fichier portable NetPBM + (".pgm"). (Si vous utilisez une ancienne version de The GIMP, vous + devrez peut-être convertir l'image en niveaux de gris avant de pouvoir + l'enregistrer.) Choisissez le format "RAW PGM" le plus compact. (Le + deuxième caractère du fichier doit être le chiffre ASCII "5", octet + hexadécimal 0x35.) - Vous pouvez fermer l'image du masque. + Vous pouvez fermer l'image du masque. - Pour revenir à l'image multicouche, sélectionnez maintenant le calque - WIP. Comme vous l'avez fait avec le masque, faites-le glisser de la - boîte de dialogue des calques vers la barre d'outils. Vous devriez - obtenir une image monocouche de vos données WIP. Si le masque est venu - aussi, débarrassez-vous-en. Vous devriez voir l'objet et les environs - peints, sans aucune vignette de masque dans la boîte de dialogue des - calques. Si vous avez mis à l'échelle le masque, mettez cette image à - l'échelle exactement de la même manière. Enregistrez cette image en - tant que pixmap portable NetPBM (".ppm"). (Remarque : .ppm, .pgm.) (Si - vous choisissez le format RAW PPM, le deuxième octet du fichier doit - être le chiffre ASCII «6», octet hexadécimal 0x36.) + Pour revenir à l'image multicouche, sélectionnez maintenant le calque + WIP. Comme vous l'avez fait avec le masque, faites-le glisser de la + boîte de dialogue des calques vers la barre d'outils. Vous devriez + obtenir une image monocouche de vos données WIP. Si le masque est venu + aussi, débarrassez-vous-en. Vous devriez voir l'objet et les environs + peints, sans aucune vignette de masque dans la boîte de dialogue des + calques. Si vous avez mis à l'échelle le masque, mettez cette image à + l'échelle exactement de la même manière. Enregistrez cette image en + tant que pixmap portable NetPBM (".ppm"). (Remarque : .ppm, .pgm.) (Si + vous choisissez le format RAW PPM, le deuxième octet du fichier doit + être le chiffre ASCII «6», octet hexadécimal 0x36.) - Vous devez maintenant fusionner les deux fichiers en un seul. Faites - cela avec la commande pnmtopng, comme ceci : + Vous devez maintenant fusionner les deux fichiers en un seul. Faites + cela avec la commande pnmtopng, comme ceci : + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/fr_FR.UTF-8/ENVVARS.txt b/docs/fr_FR.UTF-8/ENVVARS.txt index 9cb55855a..5da8f2c8c 100644 --- a/docs/fr_FR.UTF-8/ENVVARS.txt +++ b/docs/fr_FR.UTF-8/ENVVARS.txt @@ -1,5 +1,5 @@ Tux Paint - version 0.9.31 + version 0.9.31 Documentation sur les variables d'environnement Copyright © 2021-2023 by divers contributeurs; see AUTHORS.txt. @@ -7,101 +7,104 @@ mai 5, 2023 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint interprète plusieurs variables d'environnement, soit - directement, soit indirectement par le biais des bibliothèques qu'il - utilise. +Tux Paint interprète plusieurs variables d'environnement, soit directement, +soit indirectement par le biais des bibliothèques qu'il utilise. Variables d'environnement relatives au stockage - HOME +HOME - Spécifie le répertoire personnel de l'utilisateur, qui sert à - accueillir de nombreux autres fichiers ou répertoires. Dans - quelques cas, il sert de solution de repli, quand d'autres - variables d'environnement (autre part dans cette documentation) - n'ont pas été positionnées. Parfois, l'endroit à utiliser peut - être changer par des options fournies en ligne de commande ou via - le fichier de configuration de Tux Paint. Voir le document - "OPTIONS" pour les détails. + Spécifie le répertoire personnel de l'utilisateur, qui sert à accueillir de + nombreux autres fichiers ou répertoires. Dans quelques cas, il sert de + solution de repli, quand d'autres variables d'environnement (autre part + dans cette documentation) n'ont pas été positionnées. Parfois, l'endroit à + utiliser peut être changer par des options fournies en ligne de commande ou + via le fichier de configuration de Tux Paint. Voir le document "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 - * La base où Tux Paint sauvegarde et lit les dessins des - utilisateurs - * L'endroit où se situent les fichiers privés d'un utilisateur - (— tampons, pinceaux, etc, —) (par opposition aux fichiers - accessibles à tout le monde) + + L'emplacement du fichier de configuration de Tux Paint + + La base où Tux Paint sauvegarde et lit les dessins des utilisateurs + + L'endroit où se situent les fichiers privés d'un utilisateur (— + tampons, pinceaux, etc, —) (par opposition aux fichiers accessibles à + tout le monde) - XDG_CONFIG_HOME - Sur Linux et d'autres plateformes où les standards du XDG (X - Desktop Group) sont appliqués, c'est l'endroit où se trouvent les - fichiers de configuration de l'utilisateur. Plus précisément, - c'est où trouver "user-dirs.dirs", où le "XDG_PICTURES_DIR" - devrait être défini. Il est utilisé pour exporter les dessins et - GIF animés. En général, il est égal à quelque chose comme - "$HOME/Pictures/". S'il n'est pas spécifié, Tux Paint vérifie le - répertoire "$HOME/.config/". Si la configuration ne peut être - trouvée, Tux Paint exporte simplement les dessins et GIF animés - vers "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) + sont appliqués, c'est l'endroit où se trouvent les fichiers de + configuration de l'utilisateur. Plus précisément, c'est où trouver + "user-dirs.dirs", où le "XDG_PICTURES_DIR" devrait être défini. Il est + utilisé pour exporter les dessins et GIF animés. En général, il est égal à + quelque chose comme "$HOME/Pictures/". S'il n'est pas spécifié, Tux Paint + vérifie le répertoire "$HOME/.config/". Si la configuration ne peut être + trouvée, Tux Paint exporte simplement les dessins et GIF animés vers + "$HOME". - Sur Linux et d'autres plateformes où les standards du XDG (X - Desktop Group) sont appliqués, c'est l'endroit où se trouvent les - fichiers de données de l'utilisateur. Plus précisément, c'est où - trouver le répertoire "Trash". Il est utilisé quand on supprime - des images à partir de la boîte de dialogue "Ouvrir". Si ce n'est - pas défini, le répertoire "$HOME/.local/share/Trash/" est utilisé, - s'il existe. Sinon, les images sont simplement supprimées, plutôt - que déplacées quelque part. - TEMP - Spécifie l'endroit où les fichiers temporaires peuvent être créés. - Tux Paint l'utilise seulement sous Microsoft Windows. Utilise - "userdata" si non spécifié. +XDG_DATA_HOME + + Sur Linux et d'autres plateformes où les standards du XDG (X Desktop Group) + sont appliqués, c'est l'endroit où se trouvent les fichiers de données de + l'utilisateur. Plus précisément, c'est où trouver le répertoire "Trash". Il + est utilisé quand on supprime des images à partir de la boîte de dialogue + "Ouvrir". Si ce n'est pas défini, le répertoire "$HOME/.local/share/Trash/" + est utilisé, s'il existe. Sinon, les images sont simplement supprimées, + plutôt que déplacées quelque part. + + + +TEMP + + Spécifie l'endroit où les fichiers temporaires peuvent être créés. Tux + Paint l'utilise seulement sous Microsoft Windows. Utilise "userdata" si non + spécifié. Variables d'environnement relatives aux langues - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Spécifie la langue utilisée par Tux Paint sur l'interface utilisateur. + Remplacé par les options en ligne de commande "--lang" et --locale, ou bien + leurs équivalents dans le fichier de configuration. La variable + d'environnement "LANGUAGE" est utilisée (si elle est activée. Sinon, + "LC_ALL' est utilisé comme solution de repli. Puis "LC_MESSAGES" et enfin + "LANG". - LC_ALL - LC_MESSAGES - Spécifie la langue utilisée par Tux Paint sur l'interface - utilisateur. Remplacé par les options en ligne de commande - "--lang" et --locale, ou bien leurs équivalents dans le fichier de - configuration. La variable d'environnement "LANGUAGE" est utilisée - (si elle est activée. Sinon, "LC_ALL' est utilisé comme solution - de repli. Puis "LC_MESSAGES" et enfin "LANG". Variables d'environnement en rapport avec l'affichage - Ce qui suit donne quelques variables d'environnement supportées par Simple - DirectMedia Layer (libSDL) — que Tux Paint utilise pour l'affichage des - dessins, pour jouer des sons et traiter les saisies de la souris, du - clavier et du joystick — et qui peuvent être utiles aux utilisateurs de - Tux Paint. +Ce qui suit donne quelques variables d'environnement supportées par Simple +DirectMedia Layer (libSDL) — que Tux Paint utilise pour l'affichage des +dessins, pour jouer des sons et traiter les saisies de la souris, du clavier et +du joystick — et qui peuvent être utiles aux utilisateurs de Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Spécifie si Tux Paint autorise l'utilisation d'un économiseur d'écran. Peut + être mis à '1' (vrai) par Tux Paint lui-même avec l'option en ligne de + commande "--allowscreensaver" ou dans son fichier de configuration. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Spécifie si Tux Paint autorise l'utilisation d'un économiseur - d'écran. Peut être mis à '1' (vrai) par Tux Paint lui-même avec - l'option en ligne de commande "--allowscreensaver" ou dans son - fichier de configuration. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/fr_FR.UTF-8/EXTENDING.txt b/docs/fr_FR.UTF-8/EXTENDING.txt index ed4dc6aa6..8aea5d101 100644 --- a/docs/fr_FR.UTF-8/EXTENDING.txt +++ b/docs/fr_FR.UTF-8/EXTENDING.txt @@ -1,1120 +1,1120 @@ Extension Tux Paint - version 0.9.31 + version 0.9.31 Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - mai 29, 2023 + mai 29, 2023 - +--------------------------------------------------------------+ - |Table des matières | - |--------------------------------------------------------------| - | * Où vont les fichiers | - | * Fichiers standards | - | * Fichiers personnels | - | * Pinceaux | - | * Options de pinceau | - | * Tampons | - | * Images des tampons | - | * Texte de description des tampons | - | * Effets sonores des tampons | - | * Son descriptif du tampon | - | * Options des tampons | - | * Mise en miroir et retournement | - | * Polices | - | * 'Images de démarrage' | - | * Images de démarrage avec style 'livre de coloriage' | - | * Images de démarrage avec 'style scénique' | - | * Starter Options | - | * 'Modèles' | - | * Template Options | - | * Traductions | - | * Méthodes alternatives de saisie | - | * Clavier virtuel sur écran | - | * Magic Tools | - +--------------------------------------------------------------+ ++-------------------------------------------------------------+ +| Table des matières | +|-------------------------------------------------------------| +| * Où vont les fichiers | +| + Fichiers standards | +| + Fichiers personnels | +| * Pinceaux | +| + Options de pinceau | +| * Tampons | +| + Images des tampons | +| + Texte de description des tampons | +| + Effets sonores des tampons | +| + Son descriptif du tampon | +| + Options des tampons | +| + Mise en miroir et retournement | +| * Polices | +| * 'Images de démarrage' | +| + Images de démarrage avec style 'livre de coloriage' | +| + Images de démarrage avec 'style scénique' | +| + Starter Options | +| * 'Modèles' | +| + Template Options | +| * Traductions | +| * Méthodes alternatives de saisie | +| * Clavier virtuel sur écran | +| * Magic Tools | ++-------------------------------------------------------------+ - Si vous souhaitez ajouter ou modifier des éléments tels que des pinceaux, - des images de démarrage, des tampons en caoutchouc et d'autres contenus - utilisés par Tux Paint , vous pouvez le faire assez facilement en - ajoutant, modifiant ou supprimant simplement des fichiers là où Tux Paint - les recherche. +Si vous souhaitez ajouter ou modifier des éléments tels que des pinceaux, des +images de démarrage, des tampons en caoutchouc et d'autres contenus utilisés +par Tux Paint , vous pouvez le faire assez facilement en ajoutant, modifiant ou +supprimant simplement des fichiers là où Tux Paint les recherche. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Où vont les fichiers +Où vont les fichiers Fichiers standards - Tux Paint recherche ses différents fichiers de données dans son répertoire - 'data'. +Tux Paint recherche ses différents fichiers de données dans son répertoire +'data'. - Linux et Unix +Linux et Unix - L'emplacement de ce répertoire dépend de la valeur définie pour - "DATA_PREFIX" lors de la construction de Tux Paint . Voir INSTALL. - pour plus de détails. + L'emplacement de ce répertoire dépend de la valeur définie pour + "DATA_PREFIX" lors de la construction de Tux Paint . Voir INSTALL. pour + plus de détails. - Par défaut, ce répertoire est : + Par défaut, ce répertoire est : - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - Si vous l'avez installé à partir d'un paquetage, c'est plutôt : + Si vous l'avez installé à partir d'un paquetage, c'est plutôt : - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint recherche un répertoire appelé 'data' dans le même - répertoire que l'exécutable. C'est le répertoire que - l'installateur a utilisé lors de l'installation de Tux Paint, par - exemple : - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint recherche un répertoire appelé 'data' dans le même répertoire que + l'exécutable. C'est le répertoire que l'installateur a utilisé lors de + l'installation de Tux Paint, par exemple : - Tux Paint stocke ses fichiers de données dans l'icône de - l'application "Tux Paint" (qui est en fait un type spécial de - dossier sur macOS & Mac OS X avant lui). Les étapes suivantes - expliquent comment accéder aux dossiers qu'il contient : + C:\Program Files\TuxPaint\data - 1. Affichez un menu «contextuel» en maintenant la touche - [Control] enfoncée et en cliquant sur l' icône Tux Paint dans - le Finder . (Si vous avez une souris avec plus d'un bouton, - vous pouvez simplement cliquer avec le bouton droit de la - souris sur l'icône.) - 2. Sélectionnez "Afficher le contenu" dans le menu qui apparaît. - Une nouvelle fenêtre du Finder apparaîtra avec un dossier à - l'intérieur appelé " Contents". - 3. Ouvrez le dossier "Contents " et ouvrez le dossier - "Resources" qui se trouve à l'intérieur. - 4. Vous y trouverez divers sous-dossiers, tels que " starters", - "stamps", " brushes", etc. Ajouter du nouveau contenu à ces - dossiers rendra celui-ci disponible pour tout utilisateur qui - lance cette copie (icône) de Tux Paint . - 💡 Remarque : Si vous installez une version plus récente de Tux - Paint et remplacez ou supprimez l'ancienne version, vous perdrez - les modifications apportées avec les instructions ci-dessus, - faites donc des sauvegardes de votre nouveau contenu - (tampons,pinceaux, etc.). - Tux Paint recherche également les fichiers dans un dossier "Tux - Paint" que vous pouvez placer dans votre dossier système - "Application Support" (situé sous "Library" à la racine de votre - système de fichiers) : +macOS + + Tux Paint stocke ses fichiers de données dans l'icône de l'application "Tux + Paint" (qui est en fait un type spécial de dossier sur macOS & Mac OS X + avant lui). Les étapes suivantes expliquent comment accéder aux dossiers + qu'il contient : + + 1. Affichez un menu «contextuel» en maintenant la touche [Control] + enfoncée et en cliquant sur l' icône Tux Paint dans le Finder . (Si + vous avez une souris avec plus d'un bouton, vous pouvez simplement + cliquer avec le bouton droit de la souris sur l'icône.) + 2. Sélectionnez "Afficher le contenu" dans le menu qui apparaît. Une + nouvelle fenêtre du Finder apparaîtra avec un dossier à l'intérieur + appelé " Contents". + 3. Ouvrez le dossier "Contents " et ouvrez le dossier "Resources" qui se + trouve à l'intérieur. + 4. Vous y trouverez divers sous-dossiers, tels que " starters", "stamps", + " brushes", etc. Ajouter du nouveau contenu à ces dossiers rendra + celui-ci disponible pour tout utilisateur qui lance cette copie (icône) + de Tux Paint . + + 💡 Remarque : Si vous installez une version plus récente de Tux Paint et + remplacez ou supprimez l'ancienne version, vous perdrez les modifications + apportées avec les instructions ci-dessus, faites donc des sauvegardes de + votre nouveau contenu (tampons,pinceaux, etc.). + + Tux Paint recherche également les fichiers dans un dossier "Tux Paint" que + vous pouvez placer dans votre dossier système "Application Support" (situé + sous "Library" à la racine de votre système de fichiers) : + + /Library/Application Support/TuxPaint/ + + Lorsque vous passez à une version plus récente de Tux Paint , le contenu de + ce dossier "TuxPaint" restera à la même place et restera accessible à tous + les utilisateurs de Tux Paint . + - /Library/Application Support/TuxPaint/ - Lorsque vous passez à une version plus récente de Tux Paint , le - contenu de ce dossier "TuxPaint" restera à la même place et - restera accessible à tous les utilisateurs de Tux Paint . Fichiers personnels - Vous pouvez également créer des pinceaux, des images de démarrage, des - modèles et des polices dans votre propre répertoire où Tux Paint les - retrouvera. +Vous pouvez également créer des pinceaux, des images de démarrage, des modèles +et des polices dans votre propre répertoire où Tux Paint les retrouvera. - Windows +Windows - Votre dossier personnel Tux Paint est stocké dans votre dossier - "Application Data". Par exemple, sur un Windows plus récent : + Votre dossier personnel Tux Paint est stocké dans votre dossier + "Application Data". Par exemple, sur un Windows plus récent : - C:\Documents and Settings\(nom d'utilisateur)\Application - Data\TuxPaint\ + C:\Documents and Settings\(nom d'utilisateur)\Application Data\TuxPaint + \ - macOS - Votre dossier personnel Tux Paint est stocké dans votre dossier - «Application Support» : - /Users/(nom d'utilisateur)/Library/Application Support/TuxPaint/ +macOS - Linux et Unix + Votre dossier personnel Tux Paint est stocké dans votre dossier + «Application Support» : - Vos fichiers personnels Tux Paint vont dans un 'répertoire caché' - que l'on trouve dans votre répertoire personnel - "$(HOME)/.tuxpaint/" (également appelé "~/.tuxpaint/". + /Users/(nom d'utilisateur)/Library/Application Support/TuxPaint/ - Autrement dit, si votre répertoire personnel est "/home/tux", - alors votre répertoire Tux Paint est "/home/tux/.tuxpaint/". - N'oubliez pas le point (" .") avant le "tuxpaint" ! - Pour ajouter des pinceaux, des tampons, des 'images de démarrage',des - modèles et des polices créez des sous-répertoires dans votre répertoire - personnel Tux Paint nommés respectivement "brushes", "stamps", "starters", - "templates", "fonts". +Linux et Unix - (Par exemple, si vous avez créé un pinceau nommé "flower.png", vous le - mettrez dans "~/.tuxpaint/brushes/" sous Linux ou Unix.) + Vos fichiers personnels Tux Paint vont dans un 'répertoire caché' que l'on + trouve dans votre répertoire personnel "$(HOME)/.tuxpaint/" (également + appelé "~/.tuxpaint/". - Pinceaux + Autrement dit, si votre répertoire personnel est "/home/tux", alors votre + répertoire Tux Paint est "/home/tux/.tuxpaint/". - Les pinceaux utilisés pour dessiner avec les outils "Pinceau" et "Lignes" - dans Tux Paint sont tout simplement des fichiers image PNG. + N'oubliez pas le point (" .") avant le "tuxpaint" ! - L'alpha (transparence) de l'image PNG est utilisée pour déterminer la - forme du pinceau, ce qui signifie que la forme peut être «anti-crénelée» - et même partiellement transparente ! - Les pixels en niveaux de gris dans le pinceau PNG seront dessinés en - utilisant la couleur actuellement sélectionnée dans Tux Paint . Les pixels - de couleur seront teintés. + + +Pour ajouter des pinceaux, des tampons, des 'images de démarrage',des modèles +et des polices créez des sous-répertoires dans votre répertoire personnel Tux +Paint nommés respectivement "brushes", "stamps", "starters", "templates", " +fonts". + +(Par exemple, si vous avez créé un pinceau nommé "flower.png", vous le mettrez +dans "~/.tuxpaint/brushes/" sous Linux ou Unix.) + +Pinceaux + +Les pinceaux utilisés pour dessiner avec les outils "Pinceau" et "Lignes" dans +Tux Paint sont tout simplement des fichiers image PNG. + +L'alpha (transparence) de l'image PNG est utilisée pour déterminer la forme du +pinceau, ce qui signifie que la forme peut être «anti-crénelée» et même +partiellement transparente ! + +Les pixels en niveaux de gris dans le pinceau PNG seront dessinés en utilisant +la couleur actuellement sélectionnée dans Tux Paint . Les pixels de couleur +seront teintés. Options de pinceau - Outre une une forme graphique, les pinceaux peuvent également recevoir - d'autres attributs. Pour ce faire, vous devez créer un «fichier de - données» pour brosse. +Outre une une forme graphique, les pinceaux peuvent également recevoir d'autres +attributs. Pour ce faire, vous devez créer un «fichier de données» pour brosse. - Un fichier de données de brush's est simplement un fichier texte ASCII - contenant les options pour le brush. +Un fichier de données de brush's est simplement un fichier texte ASCII +contenant les options pour le brush. - Le fichier porte le même nom que l'image PNG , mais une extension ".dat". - (par exemple, le fichier de données "brush.png" est le fichier texte - "brush.dat" qui se trouve dans le même répertoire.) +Le fichier porte le même nom que l'image PNG , mais une extension ".dat". (par +exemple, le fichier de données "brush.png" est le fichier texte "brush.dat" qui +se trouve dans le même répertoire.) - Espacement des pinceaux +Espacement des pinceaux - Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais - spécifier l'espacement des pinceaux (c'est-à-dire la fréquence à - laquelle ils sont dessinés). Par défaut, l'espacement correspond à - la hauteur du pinceau, divisée par 4. + Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais spécifier + l'espacement des pinceaux (c'est-à-dire la fréquence à laquelle ils sont + dessinés). Par défaut, l'espacement correspond à la hauteur du pinceau, + divisée par 4. - Ajoutez une ligne contenant la ligne "spacing=N" au fichier de - données du pinceau, où "N" est l'espacement souhaité pour le - pinceau. (Plus le nombre est bas, plus le pinceau est dessiné - souvent.) + Ajoutez une ligne contenant la ligne "spacing=N" au fichier de données du + pinceau, où "N" est l'espacement souhaité pour le pinceau. (Plus le nombre + est bas, plus le pinceau est dessiné souvent.) - Pinceaux animés - Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais - créer des pinceaux animés. Au fur et à mesure que le pinceau est - utilisé, chaque image de l'animation est dessinée. - Disposez chaque trame sur une grande image PNG. Par exemple, si - votre pinceau mesure 30x30 et que vous avez 5 trames, l'image doit - être 150x30. +Pinceaux animés - Ajoutez une ligne contenant la ligne "frames=N" au fichier de - données du pinceau, où"N" est le nombre d'images dans le pinceau. + Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des + pinceaux animés. Au fur et à mesure que le pinceau est utilisé, chaque + image de l'animation est dessinée. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Disposez chaque trame sur une grande image PNG. Par exemple, si votre + pinceau mesure 30x30 et que vous avez 5 trames, l'image doit être 150x30. - Pinceaux directionnels + Ajoutez une ligne contenant la ligne "frames=N" au fichier de données du + pinceau, où"N" est le nombre d'images dans le pinceau. - Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais - créer des pinceaux orientables. Au fur et à mesure que le pinceau - est utilisé, différentes formes sont dessinées, en fonction de la - direction du pinceau. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - Les formes orientables sont divisées en carrés de 3x3 dans une - image PNG. Par exemple, si votre pinceau fait 30x30, l'image doit - être de 90x90 et chacune des formes orientables est placée dans - une grille de 3x3. La région centrale n'est pas orientable. Le - haut à droite est utilisé pour le mouvement vers le haut, et vers - la droite. Etc ... - Ajoute une ligne contenant le mot "directional" au fichier de - données brosse. - Pinceaux tournants +Pinceaux directionnels - Depuis la version 0.9.27 de Tux Paint , vous pouvez désormais - créer des pinceaux tournants. Au fur et à mesure que le pinceau - est utilisé, il tourne de 360 degrés, en fonction de la direction - du pinceau. + Depuis la version 0.9.16 de Tux Paint , vous pouvez désormais créer des + pinceaux orientables. Au fur et à mesure que le pinceau est utilisé, + différentes formes sont dessinées, en fonction de la direction du pinceau. - Ajoute une ligne contenant le mot "rotate" au fichier de données - brosse. + Les formes orientables sont divisées en carrés de 3x3 dans une image PNG. + Par exemple, si votre pinceau fait 30x30, l'image doit être de 90x90 et + chacune des formes orientables est placée dans une grille de 3x3. La région + centrale n'est pas orientable. Le haut à droite est utilisé pour le + mouvement vers le haut, et vers la droite. Etc ... - Pinceaux animés orientables ou tournants + Ajoute une ligne contenant le mot "directional" au fichier de données + brosse. - Vous pouvez mélanger animation et orientation (ou rotation) dans - un même pinceau. Utilisez les deux options ("frames=N" et - "directional" ou "rotate) en deux lignes séparées dans le fichier - ".dat" qui concerne le pinceau. - Pour les pinceaux directionnels, disposez le pinceau de manière à - ce que chaque ensemble 3x3 de formes orientables soit disposé sur - une grande image PNG. Par exemple, si le pinceau mesure 30x30 et - qu'il y a 5 cadres, ce sera 450x90. (Les 150x90 pixels les plus à - gauche de l'image représentent les 9 formes de direction pour la - première image, par exemple). - Placez les PNG de l'image du pinceau (et tous les fichiers texte de - données) dans le répertoire "brushes". +Pinceaux tournants - 💡 Note: If your new pinceaux all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + Depuis la version 0.9.27 de Tux Paint , vous pouvez désormais créer des + pinceaux tournants. Au fur et à mesure que le pinceau est utilisé, il + tourne de 360 degrés, en fonction de la direction du pinceau. - Tampons + Ajoute une ligne contenant le mot "rotate" au fichier de données brosse. - Tous les fichiers liés aux tampons vont dans le répertoire "stamps". Il - est utile de créer des sous-sous-répertoires pour organiser les tampons. - (Par exemple, vous pouvez avoir un dossier "holidays" avec "halloween" et - "christmas" comme sous-dossiers.) + + +Pinceaux animés orientables ou tournants + + Vous pouvez mélanger animation et orientation (ou rotation) dans un même + pinceau. Utilisez les deux options ("frames=N" et "directional" ou "rotate) + en deux lignes séparées dans le fichier ".dat" qui concerne le pinceau. + + Pour les pinceaux directionnels, disposez le pinceau de manière à ce que + chaque ensemble 3x3 de formes orientables soit disposé sur une grande image + PNG. Par exemple, si le pinceau mesure 30x30 et qu'il y a 5 cadres, ce sera + 450x90. (Les 150x90 pixels les plus à gauche de l'image représentent les 9 + formes de direction pour la première image, par exemple). + + + + +Placez les PNG de l'image du pinceau (et tous les fichiers texte de données) +dans le répertoire "brushes". + +💡 Note: If your new pinceaux all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +Tampons + +Tous les fichiers liés aux tampons vont dans le répertoire "stamps". Il est +utile de créer des sous-sous-répertoires pour organiser les tampons. (Par +exemple, vous pouvez avoir un dossier "holidays" avec "halloween" et +"christmas" comme sous-dossiers.) Images des tampons - Les tampons en caoutchouc dans Tux Paint peuvent être constitués d'un - certain nombre de fichiers séparés. Le seul fichier requis est, bien - entendu, l'image elle-même. +Les tampons en caoutchouc dans Tux Paint peuvent être constitués d'un certain +nombre de fichiers séparés. Le seul fichier requis est, bien entendu, l'image +elle-même. - Depuis la version 0.9.17 de Tux Paint , les tampons peuvent être des - images bitmap PNG ou bien des images vectorielles SVG. Ils peuvent être en - couleur ou en niveaux de gris. Le canal alpha (transparence) des PNG est - utilisé pour déterminer la forme réelle de l'image (sinon vous obtiendriez - un grand rectangle sur vos dessins). +Depuis la version 0.9.17 de Tux Paint , les tampons peuvent être des images +bitmap PNG ou bien des images vectorielles SVG. Ils peuvent être en couleur ou +en niveaux de gris. Le canal alpha (transparence) des PNG est utilisé pour +déterminer la forme réelle de l'image (sinon vous obtiendriez un grand +rectangle sur vos dessins). - Les fichiers PNG peuvent être de n'importe quelle taille, et Tux Paint - (par défaut) fournit un ensemble de boutons de redimensionnement pour - permettre à l'utilisateur d'ajuster le tampon vers le haut (plus grand) et - vers le bas (plus petits). +Les fichiers PNG peuvent être de n'importe quelle taille, et Tux Paint (par +défaut) fournit un ensemble de boutons de redimensionnement pour permettre à +l'utilisateur d'ajuster le tampon vers le haut (plus grand) et vers le bas +(plus petits). - Les SVG sont basés sur des vecteurs et seront mis à l'échelle de manière - adéquate pour le canevas utilisé. +Les SVG sont basés sur des vecteurs et seront mis à l'échelle de manière +adéquate pour le canevas utilisé. - 💡 Note: If your new des tampons basés sur PNG all come out as solid - squares or rectangles, it's because you forgot to use alpha transparency! - See the 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new des tampons basés sur PNG all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Utilisateurs avancés : Le HOWTO Advanced Stamps décrit, en détail, - comment créer des images PNG qui seront parfaitement mises à l'échelle - lorsqu'elles seront utilisées comme tampons dans Tux Paint . +⚙ Utilisateurs avancés : Le HOWTO Advanced Stamps décrit, en détail, comment +créer des images PNG qui seront parfaitement mises à l'échelle lorsqu'elles +seront utilisées comme tampons dans Tux Paint . Texte de description des tampons - Tux Paint affichera un texte descriptif quand un tampon est sélectionné. - Le texte est mis dans fichier (avec texte simple) ayant le même nom que le - PNG ou SVG, mais avec une extension ".txt". (par exemple, "stamp.png" dont - la description est "stamp.txt" est placée dans le même répertoire). +Tux Paint affichera un texte descriptif quand un tampon est sélectionné. Le +texte est mis dans fichier (avec texte simple) ayant le même nom que le PNG ou +SVG, mais avec une extension ".txt". (par exemple, "stamp.png" dont la +description est "stamp.txt" est placée dans le même répertoire). - La première ligne du fichier texte sera utilisée comme description de - l'image du tampon, en anglais américain. Il doit être encodé en UTF-8. +La première ligne du fichier texte sera utilisée comme description de l'image +du tampon, en anglais américain. Il doit être encodé en UTF-8. - Support pour la régionalisation +Support pour la régionalisation - Des lignes supplémentaires peuvent être ajoutées au fichier texte - pour fournir des traductions de la description, à afficher lorsque - Tux Paint s'exécute dans une langue différente (comme le français - ou l'espagnol). + Des lignes supplémentaires peuvent être ajoutées au fichier texte pour + fournir des traductions de la description, à afficher lorsque Tux Paint + s'exécute dans une langue différente (comme le français ou l'espagnol). - Le début de la ligne doit correspondre au code de langue de la - langue en question (par exemple, "fr" pour le français et "zh_TW" - pour le chinois traditionnel), suivi de ".utf8=" et de la - description traduite (codée en UTF-8). + Le début de la ligne doit correspondre au code de langue de la langue en + question (par exemple, "fr" pour le français et "zh_TW" pour le chinois + traditionnel), suivi de ".utf8=" et de la description traduite (codée en + UTF-8). - Pour les développeurs de Tux Paint : Il y a des scripts dans le - répertoire "po" pour convertir les fichiers texte au format PO (et - inversement) pour une traduction facile vers différentes langues. - Par conséquent, vous ne devez jamais ajouter ni modifier - directement les traductions dans les fichiers ".txt". + Pour les développeurs de Tux Paint : Il y a des scripts dans le répertoire + "po" pour convertir les fichiers texte au format PO (et inversement) pour + une traduction facile vers différentes langues. Par conséquent, vous ne + devez jamais ajouter ni modifier directement les traductions dans les + fichiers ".txt". + + Si aucune traduction n'est disponible pour la langue dans laquelle Tux + Paint est en cours d'exécution, le texte anglais américain sera utilisé. + + + +Utilisateurs de Windows + + Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. + Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont + une extension ".txt" à la fin du nom de fichier. - Si aucune traduction n'est disponible pour la langue dans laquelle - Tux Paint est en cours d'exécution, le texte anglais américain - sera utilisé. - Utilisateurs de Windows - Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. - Assurez-vous de les enregistrer en texte brut et assurez-vous - qu'ils ont une extension ".txt" à la fin du nom de fichier. Effets sonores des tampons - Tux Paint peut jouer un effet sonore quand un tampon est choisi. Par - exemple, le son d'un canard faisant coin-coin, ou un bref morceau de - musique quand un instrument est choisi. Les fichiers doivent être aux - formats "WAVE (".wav")" ou OGG Vorbis (".ogg"), et porter le même nom que - l'image PNG ou SVG.( par ex., l'effet sonore "stamp.ogg" est le son du - fichier "stamp.svg" qui est dans le même répertoire). +Tux Paint peut jouer un effet sonore quand un tampon est choisi. Par exemple, +le son d'un canard faisant coin-coin, ou un bref morceau de musique quand un +instrument est choisi. Les fichiers doivent être aux formats "WAVE (".wav")" ou +OGG Vorbis (".ogg"), et porter le même nom que l'image PNG ou SVG.( par ex., +l'effet sonore "stamp.ogg" est le son du fichier "stamp.svg" qui est dans le +même répertoire). - Support pour la régionalisation +Support pour la régionalisation - Pour les sons de différentes locales (par exemple, si le son est - quelqu'un qui dit un mot, et que vous voulez des versions - traduites du mot prononcé), créez également des fichiers WAV ou - OGG avec l'étiquette de la locale dans le nom de fichier, sous la - forme : "stamp_LOCALE.EXT" + Pour les sons de différentes locales (par exemple, si le son est quelqu'un + qui dit un mot, et que vous voulez des versions traduites du mot prononcé), + créez également des fichiers WAV ou OGG avec l'étiquette de la locale dans + le nom de fichier, sous la forme : "stamp_LOCALE.EXT" - L'effet sonore qui sera joué lorsque le tampon correspondant au - fichier image "stamp.png" est choisi, et que Tux Paint utilise la - langue espagnole, sera "stamp_es.wav". Avec la langue française, - ce sera "stamp_fr.wav". Avec le portugais brésilien, - "stamp_pt_BR.wav", etc ... + L'effet sonore qui sera joué lorsque le tampon correspondant au fichier + image "stamp.png" est choisi, et que Tux Paint utilise la langue espagnole, + sera "stamp_es.wav". Avec la langue française, ce sera "stamp_fr.wav". Avec + le portugais brésilien, "stamp_pt_BR.wav", etc ... - Si aucun effet sonore localisé ne peut être chargé, Tux Paint - tentera de charger le fichier son «par défaut». (par exemple, - "stamp.wav") + Si aucun effet sonore localisé ne peut être chargé, Tux Paint tentera de + charger le fichier son «par défaut». (par exemple, "stamp.wav") - 💡 Note: Also consider using descriptive sounds; see 'Son descriptif du - tampon', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Son descriptif du tampon', +below. Son descriptif du tampon - Tux Paint peut également jouer un son descriptif quand on choisit un - tampon. Par ex., une personne disant le mot "canard" quand on choisit un - canard, ou le nom d'un instrument de musique quand on en choisit un. Les - fichiers peuvent être au format "WAVE (".wav")" ou "OGG Vorbis (".ogg")", - et on le même nom que l'image PNG ou SVG, avec "_desc" à la fin (par ex., - le son descritid de "stamp.svg" est le fichier son "stamp_desc.ogg" dans - le même répertoire). +Tux Paint peut également jouer un son descriptif quand on choisit un tampon. +Par ex., une personne disant le mot "canard" quand on choisit un canard, ou le +nom d'un instrument de musique quand on en choisit un. Les fichiers peuvent +être au format "WAVE (".wav")" ou "OGG Vorbis (".ogg")", et on le même nom que +l'image PNG ou SVG, avec "_desc" à la fin (par ex., le son descritid de +"stamp.svg" est le fichier son "stamp_desc.ogg" dans le même répertoire). - Support pour la régionalisation +Support pour la régionalisation + + Pour les descriptions dans différentes langues, créez également des + fichiers WAV ou OGG avec à la fois "_desc" et le libellé des paramètres + régionaux dans le nom de fichier, sous la forme : "stamp_desc_LOCALE.EXT" + + L'son descriptif qui sera joué lorsque le tampon correspondant au fichier + image "stamp.png" est choisi, et que Tux Paint utilise la langue espagnole, + sera "stamp_desc_es.wav". Avec la langue française, ce sera + "stamp_desc_fr.wav". Avec le portugais brésilien, "stamp_desc_pt_BR.wav", + etc ... + + Si aucun son descriptif localisé ne peut être chargé, Tux Paint tentera de + charger le fichier son «par défaut». (par exemple, "stamp_desc.wav") - Pour les descriptions dans différentes langues, créez également - des fichiers WAV ou OGG avec à la fois "_desc" et le libellé des - paramètres régionaux dans le nom de fichier, sous la forme : - "stamp_desc_LOCALE.EXT" - L'son descriptif qui sera joué lorsque le tampon correspondant au - fichier image "stamp.png" est choisi, et que Tux Paint utilise la - langue espagnole, sera "stamp_desc_es.wav". Avec la langue - française, ce sera "stamp_desc_fr.wav". Avec le portugais - brésilien, "stamp_desc_pt_BR.wav", etc ... - Si aucun son descriptif localisé ne peut être chargé, Tux Paint - tentera de charger le fichier son «par défaut». (par exemple, - "stamp_desc.wav") Options des tampons - Outre une une forme graphique, un texte de description, un effet sonore et - une description orale, les tampons peuvent également recevoir d'autres - attributs. Pour ce faire, vous devez créer un «fichier de données» pour - tampon. +Outre une une forme graphique, un texte de description, un effet sonore et une +description orale, les tampons peuvent également recevoir d'autres attributs. +Pour ce faire, vous devez créer un «fichier de données» pour tampon. - Un fichier de données de tampon est simplement un fichier texte ASCII - contenant les options pour le tampon. +Un fichier de données de tampon est simplement un fichier texte ASCII contenant +les options pour le tampon. - Le fichier porte le même nom que l'image PNG ou SVG , mais une extension - ".dat". (par exemple, le fichier de données "stamp.png" est le fichier - texte "stamp.dat" qui se trouve dans le même répertoire.) +Le fichier porte le même nom que l'image PNG ou SVG , mais une extension +".dat". (par exemple, le fichier de données "stamp.png" est le fichier texte +"stamp.dat" qui se trouve dans le même répertoire.) - Tampons colorés +Tampons colorés - Les tampons peuvent être soit "colorables" soit '"teintables" + Les tampons peuvent être soit "colorables" soit '"teintables" - Colorable + Colorable - Les tampons "colorables" fonctionnent comme des - pinceaux - vous choisissez le tampon pour obtenir la - forme, puis choisissez la couleur que vous voulez. - (Les tampons de symboles, comme les tampons - mathématiques et musicaux, en sont un exemple.) + Les tampons "colorables" fonctionnent comme des pinceaux - vous + choisissez le tampon pour obtenir la forme, puis choisissez la couleur + que vous voulez. (Les tampons de symboles, comme les tampons + mathématiques et musicaux, en sont un exemple.) - Rien sur l'image d'origine n'est utilisé à - l'exception de la transparence (du canal "alpha"). La - couleur du tampon ressort unie. + Rien sur l'image d'origine n'est utilisé à l'exception de la + transparence (du canal "alpha"). La couleur du tampon ressort unie. - Ajoute une ligne contenant le mot "colorable" au - fichier de données tampon. + Ajoute une ligne contenant le mot "colorable" au fichier de données + tampon. - Teinté - Les tampons «teintés» sont similaires aux tampons - «colorables», sauf que les détails de l'image - originale sont conservés. (Pour le dire - techniquement, l'image d'origine est utilisée, mais - sa teinte est modifiée en fonction de la couleur - actuellement sélectionnée.) - Ajoute une ligne contenant le mot "tintable" au - fichier de données tampon. + Teinté - Options de teinture : + Les tampons «teintés» sont similaires aux tampons «colorables», sauf + que les détails de l'image originale sont conservés. (Pour le dire + techniquement, l'image d'origine est utilisée, mais sa teinte est + modifiée en fonction de la couleur actuellement sélectionnée.) - En fonction du contenu de votre tampon, vous - souhaiterez peut-être que Tux Paint utilise l'une des - nombreuses méthodes pour le teinter. Ajoutez l'une - des lignes suivantes au fichier de données du tampon - : + Ajoute une ligne contenant le mot "tintable" au fichier de données + tampon. - Coloriage normal — "tinter=normal" (par défaut) - C'est le mode normal de teinture. Tout - d'abord, la teinte primaire du tampon - est déterminée. (Par exemple, l'image - d'une fleur avec sa tige aura la couleur - des pétales considérée comme teinte - primaire de l'ensemble de l'image). Puis - on trouve la partie de l'image la plus - saturée. Avec "le mode de teinture - normal", l'étendue de la teinte utilisée - pour faire cela démarre dans un angle de - ±18° de la teinte primaire trouvée dans - l'étape 1. (Si aucune n'est trouvée, ce - sera dans une étendue de 50 %, puis on - réessaie). Tout ce qui est à l'intérieur - de l'étendue de 50 % (par ex. ±27°) est - modifié pour avoir la teinte de la - couleur choisie par l'utilisateur. - Coloriage étroit — "tinter=narrow" - C'est comme l'option "normal" décrite - plus haut, mais avec une étendue de - teinte plus faible de ±6°. Tout ce qui - est trouvé dans l'étendue (par ex. ±9°) - est teinté. Si une trop grande partie de - vitre image est teintée, essayez cette - option. - Coloriage 'toutes tonalités' — "tinter=anyhue" - Cela rempappe toutes les teintes du - tampon. C'est pareil que les options - "anyhue" et "narrow" décrites - auparavant, mais l'étendu de teinte est - ±180°. + Options de teinture : - Coloriage vectoriel — "tinter=vector" - Cela mappe «noir à blanc» à «noir à - destination». + En fonction du contenu de votre tampon, vous souhaiterez peut-être que + Tux Paint utilise l'une des nombreuses méthodes pour le teinter. + Ajoutez l'une des lignes suivantes au fichier de données du tampon : - Tampons inaltérables + Coloriage normal — "tinter=normal" (par défaut) + C'est le mode normal de teinture. Tout d'abord, la teinte primaire + du tampon est déterminée. (Par exemple, l'image d'une fleur avec sa + tige aura la couleur des pétales considérée comme teinte primaire + de l'ensemble de l'image). Puis on trouve la partie de l'image la + plus saturée. Avec "le mode de teinture normal", l'étendue de la + teinte utilisée pour faire cela démarre dans un angle de ±18° de la + teinte primaire trouvée dans l'étape 1. (Si aucune n'est trouvée, + ce sera dans une étendue de 50 %, puis on réessaie). Tout ce qui + est à l'intérieur de l'étendue de 50 % (par ex. ±27°) est modifié + pour avoir la teinte de la couleur choisie par l'utilisateur. - Par défaut, un tampon peut être retourné, affiché comme une image - miroir, ou les deux. Cela se fait à l'aide des boutons de commande - sous le sélecteur de tampon, en bas à droite de l'écran dans Tux - Paint . + Coloriage étroit — "tinter=narrow" + C'est comme l'option "normal" décrite plus haut, mais avec une + étendue de teinte plus faible de ±6°. Tout ce qui est trouvé dans + l'étendue (par ex. ±9°) est teinté. Si une trop grande partie de + vitre image est teintée, essayez cette option. - Parfois, cela n'a pas de sens pour un timbre d'être retourné ou - reflété; par exemple, des timbres de lettres ou de chiffres. - Parfois, les tampons sont symétriques, il n'est donc pas utile de - laisser l'utilisateur les retourner ou les refléter. + Coloriage 'toutes tonalités' — "tinter=anyhue" + Cela rempappe toutes les teintes du tampon. C'est pareil que les + options "anyhue" et "narrow" décrites auparavant, mais l'étendu de + teinte est ±180°. - Pour empêcher un tampon d'être qui a été inversé verticalement, - ajoutez une ligne contenant le mot «noflip» au fichier de données - du tampon. + Coloriage vectoriel — "tinter=vector" + Cela mappe «noir à blanc» à «noir à destination». - Pour empêcher un tampon d'être qui a été inversé horizontalement, - ajoutez une ligne contenant le mot «nomirror» au fichier de - données du tampon. - Taille initiale du tampon - Par défaut, Tux Paint suppose que votre tampon est dimensionné de - manière appropriée pour un affichage non mis à l'échelle sur une - toile de 608x472. Il s'agit de la taille originale de la toile - pour Tux Paint , pour un écran 640x480. Tux Paint ajustera ensuite - le tampon en fonction de la taille réelle du canevas et, si c'est - activé, des contrôles de taille du tampon définis par - l'utilisateur. - Si votre tampon est trop grand ou trop petit, vous pouvez - spécifier un facteur d'échelle. Si votre tampon est 2,5 fois plus - large (ou haut) qu'il devrait l'être, ajoutez une des options, - représentant toutes le même réglage, à votre fichier de données du - tampon.(Un signe égal,"=", peut être ajouté après le mot "scale".) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Utilisateurs de Windows - Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. - Assurez-vous de les enregistrer en texte brut et assurez-vous - qu'ils ont une extension ".txt" à la fin du nom de fichier. +Tampons inaltérables + + Par défaut, un tampon peut être retourné, affiché comme une image miroir, + ou les deux. Cela se fait à l'aide des boutons de commande sous le + sélecteur de tampon, en bas à droite de l'écran dans Tux Paint . + + Parfois, cela n'a pas de sens pour un timbre d'être retourné ou reflété; + par exemple, des timbres de lettres ou de chiffres. Parfois, les tampons + sont symétriques, il n'est donc pas utile de laisser l'utilisateur les + retourner ou les refléter. + + Pour empêcher un tampon d'être qui a été inversé verticalement, ajoutez une + ligne contenant le mot «noflip» au fichier de données du tampon. + + Pour empêcher un tampon d'être qui a été inversé horizontalement, ajoutez + une ligne contenant le mot «nomirror» au fichier de données du tampon. + + + +Taille initiale du tampon + + Par défaut, Tux Paint suppose que votre tampon est dimensionné de manière + appropriée pour un affichage non mis à l'échelle sur une toile de 608x472. + Il s'agit de la taille originale de la toile pour Tux Paint , pour un écran + 640x480. Tux Paint ajustera ensuite le tampon en fonction de la taille + réelle du canevas et, si c'est activé, des contrôles de taille du tampon + définis par l'utilisateur. + + Si votre tampon est trop grand ou trop petit, vous pouvez spécifier un + facteur d'échelle. Si votre tampon est 2,5 fois plus large (ou haut) qu'il + devrait l'être, ajoutez une des options, représentant toutes le même + réglage, à votre fichier de données du tampon.(Un signe égal,"=", peut être + ajouté après le mot "scale".) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Utilisateurs de Windows + + Utilisez NotePad ou WordPad pour modifier / créer ces fichiers. + Assurez-vous de les enregistrer en texte brut et assurez-vous qu'ils ont + une extension ".txt" à la fin du nom de fichier. + + + Mise en miroir et retournement - Dans certains cas, vous souhaiterez peut-être fournir une version - pré-dessinée de l'image miroir, de l'image inversée ou même des deux d'un - tampon. Par exemple, imaginez une photo d'un camion de pompiers avec les - mots Service d'incendie écrits sur le côté. Vous ne voulez probablement - pas que ce texte apparaisse à l'envers lorsque l'image est retournée ! +Dans certains cas, vous souhaiterez peut-être fournir une version pré-dessinée +de l'image miroir, de l'image inversée ou même des deux d'un tampon. Par +exemple, imaginez une photo d'un camion de pompiers avec les mots Service +d'incendie écrits sur le côté. Vous ne voulez probablement pas que ce texte +apparaisse à l'envers lorsque l'image est retournée ! - Pour créer une version miroir d'un tampon que vous voulez que Tux Paint - utilise, plutôt que d'en faire un miroir seul, créez simplement un - deuxième fichier graphique ".png" ou ".svg" avec le même nom, sauf avec - "_mirror" avant l'extension du nom de fichier. +Pour créer une version miroir d'un tampon que vous voulez que Tux Paint +utilise, plutôt que d'en faire un miroir seul, créez simplement un deuxième +fichier graphique ".png" ou ".svg" avec le même nom, sauf avec "_mirror" avant +l'extension du nom de fichier. - Par exemple, pour le tampon "stamp.png", vous créeriez un autre fichier - nommé "stamp_mirror.png", qui sera utilisé lorsque le tampon est mis en - miroir (plutôt que d'utiliser une version à l'envers de "stamp.png"). +Par exemple, pour le tampon "stamp.png", vous créeriez un autre fichier nommé +"stamp_mirror.png", qui sera utilisé lorsque le tampon est mis en miroir +(plutôt que d'utiliser une version à l'envers de "stamp.png"). - Depuis Tux Paint 0.9.18, vous pouvez également fournir une image - pré-retournée avec "_flip" dans le nom, et / ou une image qui est à la - fois en miroir et retournée, en la nommant " _mirror_flip". +Depuis Tux Paint 0.9.18, vous pouvez également fournir une image pré-retournée +avec "_flip" dans le nom, et / ou une image qui est à la fois en miroir et +retournée, en la nommant " _mirror_flip". - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - Polices +Polices - Les fontes utilisées par Tux Paint sont des fontes True Type Fonts (TTF). +Les fontes utilisées par Tux Paint sont des fontes True Type Fonts (TTF). - Placez-les simplement dans répertoire "fonts". Tux Paint chargera la - police et fournira quatre tailles différentes dans le sélecteur «Lettres» - lors de l'utilisation des outils "Texte" ou "Étiquette". +Placez-les simplement dans répertoire "fonts". Tux Paint chargera la police et +fournira quatre tailles différentes dans le sélecteur «Lettres» lors de +l'utilisation des outils "Texte" ou "Étiquette". - 'Images de démarrage' +'Images de démarrage' - Les images «de démarrage» apparaissent dans la boîte de dialogue - «Nouveau», avec des choix d'arrière-plan de couleur unie. +Les images «de démarrage» apparaissent dans la boîte de dialogue «Nouveau», +avec des choix d'arrière-plan de couleur unie. - Quand vous utilisez une 'image de démarrage', faites des modifications, - puis la sauvegardez, l'image d'origine n'est pas écrasée. De plus, quand - vous éditez votre nouvelle image, les contenus de 'l'image de démarrage' - initiale peuvent l'affecter. +Quand vous utilisez une 'image de démarrage', faites des modifications, puis la +sauvegardez, l'image d'origine n'est pas écrasée. De plus, quand vous éditez +votre nouvelle image, les contenus de 'l'image de démarrage' initiale peuvent +l'affecter. Images de démarrage avec style 'livre de coloriage' - Le type le plus élémentaire "d'image de démarrage" est similaire à une - image dans un livre de coloriage. C'est le contour d'une forme que vous - pouvez ensuite colorier et ajouter des détails. Dans Tux Paint , lorsque - vous dessinez, tapez du texte ou des tampons, le contour reste «au-dessus» - de ce que vous dessinez. Vous pouvez effacer des parties du dessin que - vous avez faites, mais vous ne pouvez pas effacer le contour. +Le type le plus élémentaire "d'image de démarrage" est similaire à une image +dans un livre de coloriage. C'est le contour d'une forme que vous pouvez +ensuite colorier et ajouter des détails. Dans Tux Paint , lorsque vous +dessinez, tapez du texte ou des tampons, le contour reste «au-dessus» de ce que +vous dessinez. Vous pouvez effacer des parties du dessin que vous avez faites, +mais vous ne pouvez pas effacer le contour. - Pour créer ce type "d'image de départ", dessinez simplement une image noir - et blanc avec contour dans un programme de dessin, et sauvegardez la en - tant fichier PNG ou SVG. Si vous sauvegardez en PNG, vous pouvez - optionellement rendre l'image noire et transparente, plutôt que noire et - blanche, mais ceci (depuis Tux Paint 0.9.21) n'est pas requis. +Pour créer ce type "d'image de départ", dessinez simplement une image noir et +blanc avec contour dans un programme de dessin, et sauvegardez la en tant +fichier PNG ou SVG. Si vous sauvegardez en PNG, vous pouvez optionellement +rendre l'image noire et transparente, plutôt que noire et blanche, mais ceci +(depuis Tux Paint 0.9.21) n'est pas requis. Images de démarrage avec 'style scénique' - En plus de la superposition de style `` livre de coloriage '', vous pouvez - également fournir une image d'arrière-plan séparée dans le cadre d'une - "image de démarrage''. La superposition agit de la même manière : elle ne - peut pas être dessinée, effacée ou affectée par les outils «Magie». - Cependant, l'arrière-plan peut l'être ! +En plus de la superposition de style `` livre de coloriage '', vous pouvez +également fournir une image d'arrière-plan séparée dans le cadre d'une "image +de démarrage''. La superposition agit de la même manière : elle ne peut pas +être dessinée, effacée ou affectée par les outils «Magie». Cependant, +l'arrière-plan peut l'être ! - Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type - d'image de démarrage, plutôt que de transformer la toile en une couleur - unie, telle que le blanc, il renvoie cette partie de la toile à l'image - d'arrière-plan d'origine à partir de image de démarrage. +Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type d'image de +démarrage, plutôt que de transformer la toile en une couleur unie, telle que le +blanc, il renvoie cette partie de la toile à l'image d'arrière-plan d'origine à +partir de image de démarrage. - En créant à la fois une superposition et un arrière-plan, vous pouvez - créer une «image de démarrage» qui simule la profondeur. Imaginez un - arrière-plan qui montre l'océan et une superposition qui est l'image d'un - récif. Vous pouvez ensuite dessiner (ou tamponner) des poissons sur - l'image. Ils apparaîtront dans l'océan, mais jamais «devant» le récif. +En créant à la fois une superposition et un arrière-plan, vous pouvez créer une +«image de démarrage» qui simule la profondeur. Imaginez un arrière-plan qui +montre l'océan et une superposition qui est l'image d'un récif. Vous pouvez +ensuite dessiner (ou tamponner) des poissons sur l'image. Ils apparaîtront dans +l'océan, mais jamais «devant» le récif. - Pour créer ce type d'image de départ, créez simplement une superposition - (avec transparence) comme décrit ci-dessus et enregistrez-la au format - PNG. Créez ensuite une autre image (sans transparence) et enregistrez-la - avec le même nom de fichier, mais avec "-back" ajouté au nom. (par - exemple, "starter-back.png" serait l'image d'arrière-plan de l'océan qui - correspond à la superposition ou au premier plan.) +Pour créer ce type d'image de départ, créez simplement une superposition (avec +transparence) comme décrit ci-dessus et enregistrez-la au format PNG. Créez +ensuite une autre image (sans transparence) et enregistrez-la avec le même nom +de fichier, mais avec "-back" ajouté au nom. (par exemple, "starter-back.png" +serait l'image d'arrière-plan de l'océan qui correspond à la superposition ou +au premier plan.) - Pour de meilleurs résultats, les images de démarrage doivent être de la - même taille que la toile de Tux Paint . (Voir la section "Chargement - d'autres images dans Tux Paint " du README pour plus de détails sur le - dimensionnement.) Si ce n'est pas le cas, elles seront étirées, sans - affecter la forme ("rapport hauteur / largeur"); cependant, des bavures - peuvent être apparaître sur les bords. +Pour de meilleurs résultats, les images de démarrage doivent être de la même +taille que la toile de Tux Paint . (Voir la section "Chargement d'autres images +dans Tux Paint " du README pour plus de détails sur le dimensionnement.) Si ce +n'est pas le cas, elles seront étirées, sans affecter la forme ("rapport +hauteur / largeur"); cependant, des bavures peuvent être apparaître sur les +bords. - Placez-les dans le répertoire "starters". Lorsque la boîte de dialogue - «Nouveau» est accessible dans Tux Paint , les images de démarrage - apparaîtront avec l'écran qui apparaît, suivant les différents choix de - couleurs unies. +Placez-les dans le répertoire "starters". Lorsque la boîte de dialogue +«Nouveau» est accessible dans Tux Paint , les images de démarrage apparaîtront +avec l'écran qui apparaît, suivant les différents choix de couleurs unies. - 💡 Note: 'Images de démarrage' are 'attached' to saved pictures, via a - small text file that has the same name as the saved file, but with ".dat" - as the extension. This allows it to continue to affect the drawing even - after Tux Paint has been quit, or another picture is loaded or a new image - is created. (In other words, if you base a drawing on a image de - démarrage, it will always be affected by it.) +💡 Note: 'Images de démarrage' are 'attached' to saved pictures, via a small +text file that has the same name as the saved file, but with ".dat" as the +extension. This allows it to continue to affect the drawing even after Tux +Paint has been quit, or another picture is loaded or a new image is created. +(In other words, if you base a drawing on a image de démarrage, it will always +be affected by it.) Starter Options - Outre une an image, les starters peuvent également recevoir d'autres - attributs. Pour ce faire, vous devez créer un «fichier de données» pour - starter. (Note: Tux Paint prior to version 0.9.29 did not support starter - options.) +Outre une an image, les starters peuvent également recevoir d'autres attributs. +Pour ce faire, vous devez créer un «fichier de données» pour starter. (Note: +Tux Paint prior to version 0.9.29 did not support starter options.) - Un fichier de données de starter's est simplement un fichier texte ASCII - contenant les options pour le starter. +Un fichier de données de starter's est simplement un fichier texte ASCII +contenant les options pour le starter. - Le fichier porte le même nom que l'image , mais une extension ".dat". (par - exemple, le fichier de données "starter.png" est le fichier texte - "starter.dat" qui se trouve dans le même répertoire.) +Le fichier porte le même nom que l'image , mais une extension ".dat". (par +exemple, le fichier de données "starter.png" est le fichier texte "starter.dat" +qui se trouve dans le même répertoire.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - Les couleurs peuvent être listées en utilisant trois nombres - décimaux (par exemple, "255 68 136") ou un 'triplet' hexadécimal - de 6 ou 3 chiffres (par exemple, " #ff4488" ou "#F48"). +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + Les couleurs peuvent être listées en utilisant trois nombres décimaux (par + exemple, "255 68 136") ou un 'triplet' hexadécimal de 6 ou 3 chiffres (par + exemple, " #ff4488" ou "#F48"). - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - 'Modèles' + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - Les images «Modèle» apparaissent également dans la boîte de dialogue - «Nouveau», avec les choix d'arrière-plan de couleur unie et les «Images de - démarrage». (Remarque: Tux Paint avant la version 0.9.22 ne disposait pas - de la fonctionnalité 'Template'.) + Focusing on the top of a starter image stretched to fit the width of the + canvas. - À la différence des images dessinées dans Tux Paint par les utilisateurs - puis réouvertes plus tard, l'ouverture d'un «modèle» crée un nouveau - dessin. Lorsque vous enregistrez, l'image «modèle» n'est pas écrasée. À la - différence des «images de démarrage», il n'y a pas de «calque» immuable - au-dessus du canevas. Vous pouvez dessiner sur n'importe quelle partie de - celui-ci. - Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type - d'image 'modèle', plutôt que de transformer la toile en une couleur unie, - telle que le blanc, il renvoie cette partie de la toile à l'image - d'arrière-plan d'origine à partir de image 'modèle'. + [ Landscape-shaped image of the ground with the sun at the top. ] - Les «modèles» sont simplement des fichiers image (au format PNG, JPG, SVG - ou KPX (KidPix)). Aucune préparation ou conversion n'est requise. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - Pour de meilleurs résultats, les images 'modèle' doivent être de la même - taille que la toile de Tux Paint . (Voir la section "Chargement d'autres - images dans Tux Paint " du README pour plus de détails sur le - dimensionnement.) Si ce n'est pas le cas, elles seront étirées, sans - affecter la forme ("rapport hauteur / largeur"); cependant, des bavures - peuvent être apparaître sur les bords. - Placez-les dans le répertoire "templates". Lorsque la boîte de dialogue - «Nouveau» est accessible dans Tux Paint , les images 'modèle' apparaîtront - avec l'écran qui apparaît, suivant les différents choix de couleurs unies. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +'Modèles' + +Les images «Modèle» apparaissent également dans la boîte de dialogue «Nouveau», +avec les choix d'arrière-plan de couleur unie et les «Images de démarrage». +(Remarque: Tux Paint avant la version 0.9.22 ne disposait pas de la +fonctionnalité 'Template'.) + +À la différence des images dessinées dans Tux Paint par les utilisateurs puis +réouvertes plus tard, l'ouverture d'un «modèle» crée un nouveau dessin. Lorsque +vous enregistrez, l'image «modèle» n'est pas écrasée. À la différence des +«images de démarrage», il n'y a pas de «calque» immuable au-dessus du canevas. +Vous pouvez dessiner sur n'importe quelle partie de celui-ci. + +Lorsque l'outil «Gomme» est utilisé sur une image basée sur ce type d'image +'modèle', plutôt que de transformer la toile en une couleur unie, telle que le +blanc, il renvoie cette partie de la toile à l'image d'arrière-plan d'origine à +partir de image 'modèle'. + +Les «modèles» sont simplement des fichiers image (au format PNG, JPG, SVG ou +KPX (KidPix)). Aucune préparation ou conversion n'est requise. + +Pour de meilleurs résultats, les images 'modèle' doivent être de la même taille +que la toile de Tux Paint . (Voir la section "Chargement d'autres images dans +Tux Paint " du README pour plus de détails sur le dimensionnement.) Si ce n'est +pas le cas, elles seront étirées, sans affecter la forme ("rapport hauteur / +largeur"); cependant, des bavures peuvent être apparaître sur les bords. + +Placez-les dans le répertoire "templates". Lorsque la boîte de dialogue +«Nouveau» est accessible dans Tux Paint , les images 'modèle' apparaîtront avec +l'écran qui apparaît, suivant les différents choix de couleurs unies. + +💡 Note: 'Modèles' are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a image 'modèle', it will always be affected by it.) - 💡 Note: 'Modèles' are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a image 'modèle', it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Traductions +Traductions - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - Pour traduire Tux Paint dans une nouvelle langue, copiez le fichier de - modèle de traduction, "tuxpaint.pot" (trouvé avec le code source de Tux - Paint , dans le dossier "src/po/"). Renommez la copie en tant que ".po", - avec le nom approprié aux paramètres régionaux de votre traduction (par - exemple, "es.po" pour l'espagnol; ou "pt_BR.po" pour le portugais - brésilien , contre "pt.po" ou "pt_PT.po" pour le portugais parlé au - Portugal). +Pour traduire Tux Paint dans une nouvelle langue, copiez le fichier de modèle +de traduction, "tuxpaint.pot" (trouvé avec le code source de Tux Paint , dans +le dossier "src/po/"). Renommez la copie en tant que ".po", avec le nom +approprié aux paramètres régionaux de votre traduction (par exemple, "es.po" +pour l'espagnol; ou "pt_BR.po" pour le portugais brésilien , contre "pt.po" ou +"pt_PT.po" pour le portugais parlé au Portugal). - Ouvrez le fichier nouvellement créé ".po - vous pouvez l'éditer à l'aide - d'un éditeur de texte simple comme Emacs, Pico ou vi sur Linux ou NotePad - sous Windows. Le texte anglais original utilisé dans Tux Paint se trouve - dans les lignes commençant par "msgid". Entrez vos traductions de chacune - de ces parties de texte dans les lignes vides "msgstr" directement sous - les lignes "msgid" correspondantes . ( Remarque : ne supprimez pas les - guillemets.) +Ouvrez le fichier nouvellement créé ".po - vous pouvez l'éditer à l'aide d'un +éditeur de texte simple comme Emacs, Pico ou vi sur Linux ou NotePad sous +Windows. Le texte anglais original utilisé dans Tux Paint se trouve dans les +lignes commençant par "msgid". Entrez vos traductions de chacune de ces parties +de texte dans les lignes vides "msgstr" directement sous les lignes "msgid" +correspondantes . ( Remarque : ne supprimez pas les guillemets.) - Exemple : +Exemple : - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - De nombreux outils existent pour gérer les catalogues de traduction - 'gettext', vous n'avez donc pas besoin de les éditer avec un éditeur de - texte. En voici quelques uns : - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +De nombreux outils existent pour gérer les catalogues de traduction 'gettext', +vous n'avez donc pas besoin de les éditer avec un éditeur de texte. En voici +quelques uns : - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - Pour modifier une traduction existante, téléchargez le dernier fichier - ".po" pour cette langue et modifiez-le comme décrit ci-dessus. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - Vous pouvez envoyer des fichiers de traduction nouveaux ou modifiés à Bill - Kendrick , responsable du développement principal de Tux Paint , à : - bill@newbreedsoftware.com, ou les poster sur la liste de diffusion - "tuxpaint-i18n" (voir : https://tuxpaint.org/lists/ ). +Pour modifier une traduction existante, téléchargez le dernier fichier ".po" +pour cette langue et modifiez-le comme décrit ci-dessus. - Autrement, si vous avez un compte chez SourceForge.net , vous pouvez - demander à être ajouté au projet "tuxpaint" et obtenir un accès en - écriture au référentiel de code source Git afin que vous puissiez valider - vos modifications directement. +Vous pouvez envoyer des fichiers de traduction nouveaux ou modifiés à Bill +Kendrick , responsable du développement principal de Tux Paint , à : +bill@newbreedsoftware.com, ou les poster sur la liste de diffusion +"tuxpaint-i18n" (voir : https://tuxpaint.org/lists/ ). - 💡 Note: Support for new locales requires making additions to Tux Paint's - source code ("/src/i18n.h" et "/src/i18n.c"), and requires updates to the - Makefile, pour s'assurer que les fichiers ".po" sont compilés en fichiers - ".mo", et utilisables pendant l'exécution. +Autrement, si vous avez un compte chez SourceForge.net , vous pouvez demander à +être ajouté au projet "tuxpaint" et obtenir un accès en écriture au référentiel +de code source Git afin que vous puissiez valider vos modifications +directement. - Méthodes alternatives de saisie +💡 Note: Support for new locales requires making additions to Tux Paint's source +code ("/src/i18n.h" et "/src/i18n.c"), and requires updates to the Makefile, +pour s'assurer que les fichiers ".po" sont compilés en fichiers ".mo", et +utilisables pendant l'exécution. - Les outils "Texte" et "Étiquette" de Tux Paint peuvent fournir des - méthodes de saisie alternatives pour certaines langues. Par exemple, - lorsque Tux Paint fonctionne avec un environnement local japonais, la - touche droite [Alt] droit peut être pressée pour basculer entre les modes - Latin, Romanized Hiragana et Romanized Katakana. Cela permet de saisir des - caractères et des mots natifs dans l'outil "Texte" ou 'Étiquette' en - tapant une ou plusieurs touches sur un clavier avec des caractères latins - (par exemple, un clavier US QWERTY ). +Méthodes alternatives de saisie - Pour créer une méthode d'entrée pour une nouvelle locale, créez un fichier - texte avec un nom basé sur la locale (par exemple, "ja" pour le japonais), - avec ".im" comme extension (par exemple, "ja.im"). +Les outils "Texte" et "Étiquette" de Tux Paint peuvent fournir des méthodes de +saisie alternatives pour certaines langues. Par exemple, lorsque Tux Paint +fonctionne avec un environnement local japonais, la touche droite [Alt] droit +peut être pressée pour basculer entre les modes Latin, Romanized Hiragana et +Romanized Katakana. Cela permet de saisir des caractères et des mots natifs +dans l'outil "Texte" ou 'Étiquette' en tapant une ou plusieurs touches sur un +clavier avec des caractères latins (par exemple, un clavier US QWERTY ). - Le fichier ".im" peut avoir plusieurs sections configuration de caractères - pour différents modes. Par exemple, sur un système de clavier japonais, la - saisie de [K] [A] en mode Hiragana génère un caractère Unicode "か" - différent de la saisie de [K] [A] en mode Katakana ("カ"). +Pour créer une méthode d'entrée pour une nouvelle locale, créez un fichier +texte avec un nom basé sur la locale (par exemple, "ja" pour le japonais), avec +".im" comme extension (par exemple, "ja.im"). - Répertoriez les configurations de caractères dans ce fichier, un par - ligne. Chaque ligne doit contenir (séparés par des espaces) : +Le fichier ".im" peut avoir plusieurs sections configuration de caractères pour +différents modes. Par exemple, sur un système de clavier japonais, la saisie de +[K] [A] en mode Hiragana génère un caractère Unicode "か" différent de la +saisie de [K] [A] en mode Katakana ("カ"). - * la valeur Unicode du caractère, en hexadécimal (plusieurs caractères - peuvent être listés, séparés par deux points (':'), ce qui permet à - certaines séquences de correspondre à des mots) - * la séquence de touches (les caractères ASCII qui doivent être saisis - pour générer le caractère Unicode) - * un drapeau (ou "-" pour rien) +Répertoriez les configurations de caractères dans ce fichier, un par ligne. +Chaque ligne doit contenir (séparés par des espaces) : - Commencez les sections de configuration de caractères supplémentaires avec - une ligne contenant le mot «section». + * la valeur Unicode du caractère, en hexadécimal (plusieurs caractères + peuvent être listés, séparés par deux points (':'), ce qui permet à + certaines séquences de correspondre à des mots) + * la séquence de touches (les caractères ASCII qui doivent être saisis pour + générer le caractère Unicode) + * un drapeau (ou "-" pour rien) - Exemple : +Commencez les sections de configuration de caractères supplémentaires avec une +ligne contenant le mot «section». - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +Exemple : - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new méthodes de saisie requires making additions to - Tux Paint's source code ("/src/im.c"), and requires updates to the - Makefile, pour s'assurer que les fichiers ".im" sont disponibles pour être - utilisés lors de l'exécution du programme. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - Clavier virtuel sur écran +💡 Note: Support for new méthodes de saisie requires making additions to Tux +Paint's source code ("/src/im.c"), and requires updates to the Makefile, pour +s'assurer que les fichiers ".im" sont disponibles pour être utilisés lors de +l'exécution du programme. - Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint - peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur - (via une souris, des systèmes de suivi oculaire, etc.) pour saisir des - caractères. Les fichiers qui décrivent la mise en page et les clés - disponibles sont stockés dans le répertoire "osk" de Tux Paint . Chaque - disposition de clavier est définie par un certain nombre de fichiers (dont - certains peuvent être partagés par différentes dispositions). +Clavier virtuel sur écran - Nous utiliserons le clavier QWERTY comme exemple : +Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint +peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via +une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères. +Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés +dans le répertoire "osk" de Tux Paint . Chaque disposition de clavier est +définie par un certain nombre de fichiers (dont certains peuvent être partagés +par différentes dispositions). + +Nous utiliserons le clavier QWERTY comme exemple : Fichier d'aperçu de la disposition ("qwerty.layout") - Il s'agit d'un fichier texte qui spécifie les autres fichiers utilisés - pour décrire l'agencement et la disposition des touches. +Il s'agit d'un fichier texte qui spécifie les autres fichiers utilisés pour +décrire l'agencement et la disposition des touches. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - La ligne "keyboardlist" décrit les dispositions vers lesquelles on bascule - lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. - (Voir ci-dessous.) +La ligne "keyboardlist" décrit les dispositions vers lesquelles on bascule +lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir +ci-dessous.) Fichier de disposition du clavier (qwerty.h_layout") - Ceci décrit la taille du clavier (sous forme de grille L × H), et - répertorie chaque touche avec son code numérique (voir le fichier - "keymap", ci-dessous), la largeur à laquelle il doit être dessiné - (généralement "1.0", pour en prendre un espace sur le clavier, mais dans - l'exemple ci-dessous, notez que les touches "TAB" et "SPACE" sont beaucoup - plus larges), le caractère ou le texte à afficher sur la touche, selon les - touches de modification qui ont été enfoncées (une pour chacune : pas de - modificateurs, [Shift] , [AltGr] et [Shift] + [AltGr] ), et enfin si la - touche est affectée ou non par la touche [CapsLock] (utilisez "1") ou - [AltGr] (alt graphiques alternatifs) (utilisez "2"), ou pas du tout - (utilisez "0"). +Ceci décrit la taille du clavier (sous forme de grille L × H), et répertorie +chaque touche avec son code numérique (voir le fichier "keymap", ci-dessous), +la largeur à laquelle il doit être dessiné (généralement "1.0", pour en prendre +un espace sur le clavier, mais dans l'exemple ci-dessous, notez que les touches +"TAB" et "SPACE" sont beaucoup plus larges), le caractère ou le texte à +afficher sur la touche, selon les touches de modification qui ont été enfoncées +(une pour chacune : pas de modificateurs, [Shift] , [AltGr] et [Shift] + +[AltGr] ), et enfin si la touche est affectée ou non par la touche [CapsLock] +(utilisez "1") ou [AltGr] (alt graphiques alternatifs) (utilisez "2"), ou pas +du tout (utilisez "0"). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # Flèche gauche pour revenir au clavier précédent - KEY 2 1.0 <- <- <- <- 0 + # Flèche gauche pour revenir au clavier précédent + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # Les touches ALT ou ALTGR sont utilisées dans im pour changer de mode - de saisie - KEY 64 2.0 Alt Alt Alt Alt 0 + # Les touches ALT ou ALTGR sont utilisées dans im pour changer de mode de + saisie + KEY 64 2.0 Alt Alt Alt Alt 0 - # Espace - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Espace + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # Flèche droite pour aller au clavier suivant - KEY 1 1.0 -> -> -> -> 0 + # Flèche droite pour aller au clavier suivant + KEY 1 1.0 -> -> -> -> 0 - Notez ici que les touches alphabétiques ( [Q], [W] , [1] , etc.) seront - affectées par CapsLock , tandis que les touches numériques ( [1] , [2] , - etc.), [Espace] , etc. ne le sont pas. +Notez ici que les touches alphabétiques ( [Q], [W] , [1] , etc.) seront +affectées par CapsLock , tandis que les touches numériques ( [1] , [2] , etc.), +[Espace] , etc. ne le sont pas. - Les codes clés jusqu'à "8" sont réservés à un usage interne. Ceux - actuellement utilisés sont décrits ci-dessous. +Les codes clés jusqu'à "8" sont réservés à un usage interne. Ceux actuellement +utilisés sont décrits ci-dessous. - * 0 — bouton vide - * 1 — disposition suivante (pour le réglage "keyboardlist" du fichier - d'agencement) - * 2 — disposition précédente (pour le réglage "keyboardlist" du fichier - d'agencement) + * 0 — bouton vide + * 1 — disposition suivante (pour le réglage "keyboardlist" du fichier + d'agencement) + * 2 — disposition précédente (pour le réglage "keyboardlist" du fichier + d'agencement) Fichier keymap ("us-intl-altgr-dead-keys.keymap") - Ce fichier définit quels codes de touches numériques (vus dans les - fichiers de disposition du clavier, tels que "qwerty.h_layout" décrits - ci-dessus) doivent correspondre aux caractères réels qu'une application - comme Tux Paint s'attend à recevoir lorsque des touches (par exemple, sur - un clavier réel) sont enfoncées. +Ce fichier définit quels codes de touches numériques (vus dans les fichiers de +disposition du clavier, tels que "qwerty.h_layout" décrits ci-dessus) doivent +correspondre aux caractères réels qu'une application comme Tux Paint s'attend à +recevoir lorsque des touches (par exemple, sur un clavier réel) sont enfoncées. - Si vous utilisez un système d'exploitation tel que Linux, qui tourne sous - X-Window et qui dispose de l'outil "xmodmap" en ligne de commande, vous - pouvez l'utiliser avec l'option "-pke" ('print keymap expressions') pour - générer un fichier keymap. +Si vous utilisez un système d'exploitation tel que Linux, qui tourne sous +X-Window et qui dispose de l'outil "xmodmap" en ligne de commande, vous pouvez +l'utiliser avec l'option "-pke" ('print keymap expressions') pour générer un +fichier keymap. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Fichier Composemap ("en_US.UTF-8_Compose") - Ce fichier décrit les caractères qui peuvent être composés avec plusieurs - entrées. Par exemple, "[Compose]" suivi de "[A] " et "[E]" peut être - utilisé pour créer le caractère "æ". +Ce fichier décrit les caractères qui peuvent être composés avec plusieurs +entrées. Par exemple, "[Compose]" suivi de "[A] " et "[E]" peut être utilisé +pour créer le caractère "æ". - Le fichier fourni avec Tux Paint est basé sur le composemap anglais - américain UTF-8 (Unicode) fourni avec le système X Window de X.Org . La - version actuelle de la bibliothèque Xlib se trouve sur la page Web à l' - adresse - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +Le fichier fourni avec Tux Paint est basé sur le composemap anglais américain +UTF-8 (Unicode) fourni avec le système X Window de X.Org . La version actuelle +de la bibliothèque Xlib se trouve sur la page Web à l' adresse https:// +www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. Fichier de définitions des Keysim ("keysymdef.h") - Ce fichier (qui est un fichier d'en-tête du langage de programmation C ) - provient également du système X Window . Il définit les valeurs Unicode de - chaque keycap (par exemple, "XK_equal" correspond à "U+003D", pour le - caractère "=" ("EQUALS SIGN"). +Ce fichier (qui est un fichier d'en-tête du langage de programmation C ) +provient également du système X Window . Il définit les valeurs Unicode de +chaque keycap (par exemple, "XK_equal" correspond à "U+003D", pour le caractère +"=" ("EQUALS SIGN"). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - Il est peu probable qu'une modification de ce fichier soit requise. +Il est peu probable qu'une modification de ce fichier soit requise. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/fr_FR.UTF-8/FAQ.txt b/docs/fr_FR.UTF-8/FAQ.txt index 8dac7e7fe..b5ff97370 100644 --- a/docs/fr_FR.UTF-8/FAQ.txt +++ b/docs/fr_FR.UTF-8/FAQ.txt @@ -4,658 +4,669 @@ Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juillet 13, 2023 + juillet 13, 2023 - ---------------------------------------------------------------------- - - +-----------------------------------+ - |Table des matières | - |-----------------------------------| - | * Liées au dessin | - | * Problèmes d'interface | - | * Impression | - | * Sauvegarde | - | * Problèmes audio | - | * Problèmes en mode plein écran | - | * Other Problems | - | * Aide / Contact | - +-----------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++-----------------------------------+ +| Table des matières | +|-----------------------------------| +| * Liées au dessin | +| * Problèmes d'interface | +| * Impression | +| * Sauvegarde | +| * Problèmes audio | +| * Problèmes en mode plein écran | +| * Other Problems | +| * Aide / Contact | ++-----------------------------------+ +------------------------------------------------------------------------------- Liées au dessin - Les polices que j'ai ajoutées à Tux Paint n'affichent que des carrés - La police TrueType que vous utilisez peut avoir le mauvais - encodage. S'il est encodé «personnalisé», par exemple, vous pouvez - essayer de l'exécuter via FontForge ( - http://fontforge.sourceforge.net/ ) pour le convertir au format - ISO-8859. (Envoyez-nous un e-mail si vous avez besoin d'aide avec - des polices spéciales.) +Les polices que j'ai ajoutées à Tux Paint n'affichent que des carrés + La police TrueType que vous utilisez peut avoir le mauvais encodage. S'il + est encodé «personnalisé», par exemple, vous pouvez essayer de l'exécuter + via FontForge ( http://fontforge.sourceforge.net/ ) pour le convertir au + format ISO-8859. (Envoyez-nous un e-mail si vous avez besoin d'aide avec + des polices spéciales.) - L'outil Tampon en caoutchouc est grisé ! +L'outil Tampon en caoutchouc est grisé ! - Cela signifie que Tux Paint n'a pas pu trouver d'images de tampons - ou a été invité à ne pas les charger. + Cela signifie que Tux Paint n'a pas pu trouver d'images de tampons ou a été + invité à ne pas les charger. - Si vous avez installé Tux Paint, mais que vous n'avez pas installé - la collection optionnelle "Stamps" séparée, quittez Tux Paint et - installez-le maintenant. Il devrait être disponible à partir du - même endroit où vous avez obtenu le programme principal de Tux - Paint. (Remarque: à partir de la version 0.9.14, Tux Paint est - livré avec une petite collection d'exemples de tampons.) + Si vous avez installé Tux Paint, mais que vous n'avez pas installé la + collection optionnelle "Stamps" séparée, quittez Tux Paint et installez-le + maintenant. Il devrait être disponible à partir du même endroit où vous + avez obtenu le programme principal de Tux Paint. (Remarque: à partir de la + version 0.9.14, Tux Paint est livré avec une petite collection d'exemples + de tampons.) - Si vous ne souhaitez pas installer la collection de tampons par - défaut, vous pouvez simplement créer la vôtre. Consultez la - documentation "Extending Tux Paint" pour en savoir plus sur la - création de fichiers image PNG et SVG, de fichiers de description - de texte TXT, de fichiers audio Ogg Vorbis, MP3 ou WAV et de - fichiers de données texte DAT qui composent les tampons. + Si vous ne souhaitez pas installer la collection de tampons par défaut, + vous pouvez simplement créer la vôtre. Consultez la documentation + "Extending Tux Paint" pour en savoir plus sur la création de fichiers image + PNG et SVG, de fichiers de description de texte TXT, de fichiers audio Ogg + Vorbis, MP3 ou WAV et de fichiers de données texte DAT qui composent les + tampons. - Enfin, si vous avez installé des tampons et pensez qu'ils - devraient être chargés, vérifiez que l'option "nostamps" n'est pas - définie. (Soit via une option "--nostamps" sur la ligne de - commande de Tux Paint, soit "nostamps=yes" dans le fichier de - configuration.) + Enfin, si vous avez installé des tampons et pensez qu'ils devraient être + chargés, vérifiez que l'option "nostamps" n'est pas définie. (Soit via une + option "--nostamps" sur la ligne de commande de Tux Paint, soit "nostamps= + yes" dans le fichier de configuration.) - Modifiez / supprimez l'option "nostamps" ou remplacez-la par - "--stamps" sur la ligne de commande ou "nostamps=no" ou - "stamps=yes" dans un des fichiers de configuration. + Modifiez / supprimez l'option "nostamps" ou remplacez-la par "--stamps" sur + la ligne de commande ou "nostamps=no" ou "stamps=yes" dans un des fichiers + de configuration. - Les contours des tampons sont toujours des rectangles - Tux Paint a été élaboré avec des contours de basse qualité (mais - plus rapides). - Pour changer cela, vous devez reconstruire Tux Paint à partir des - sources. Assurez-vous de supprimer ou de commenter toute ligne qui - dit : +Les contours des tampons sont toujours des rectangles - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint a été élaboré avec des contours de basse qualité (mais plus + rapides). - dans le fichier "tuxpaint.c" du répertoire "src". + Pour changer cela, vous devez reconstruire Tux Paint à partir des sources. + Assurez-vous de supprimer ou de commenter toute ligne qui dit : - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + dans le fichier "tuxpaint.c" du répertoire "src". + + + + +------------------------------------------------------------------------------- Problèmes d'interface - Les vignettes des tampons dans le sélecteur de tampons ne sont pas jolies +Les vignettes des tampons dans le sélecteur de tampons ne sont pas jolies - Tux Paint a probablement été compilé avec un code de vignette plus - rapide et de qualité inférieure. Exécutez la commande: "tuxpaint - --verbose-version" en ligne de commande. Si, parmi les résultats, - vous voyez le texte : "Low Quality Thumbnails enabled", c'est le - cas. + Tux Paint a probablement été compilé avec un code de vignette plus rapide + et de qualité inférieure. Exécutez la commande: "tuxpaint + --verbose-version" en ligne de commande. Si, parmi les résultats, vous + voyez le texte : "Low Quality Thumbnails enabled", c'est le cas. - Pour changer cela, vous devez reconstruire Tux Paint à partir des - sources. Assurez-vous de supprimer ou de commenter toute ligne qui - dit : + Pour changer cela, vous devez reconstruire Tux Paint à partir des sources. + Assurez-vous de supprimer ou de commenter toute ligne qui dit : - #define LOW_QUALITY_THUMBNAILS + #define LOW_QUALITY_THUMBNAILS - dans le fichier "tuxpaint.c" du répertoire "src". + dans le fichier "tuxpaint.c" du répertoire "src". - Les images de la boîte de dialogue "Ouvrir" ne sont pas jolies - "Miniatures de faible qualité" a été probablement activé. Voir: - "Les vignettes de tampon dans le sélecteur de tampon ne sont pas - jolies", ci-dessus. - Tout le texte est en majuscule ! - L'option "majuscule" est activée. +Les images de la boîte de dialogue "Ouvrir" ne sont pas jolies + "Miniatures de faible qualité" a été probablement activé. Voir: "Les + vignettes de tampon dans le sélecteur de tampon ne sont pas jolies", + ci-dessus. - Modifiez / supprimez l'option "uppercase" ou remplacez-la par - "--mixedcase" sur la ligne de commande ou "uppercase=no" ou - "mixedcase=yes" dans un des fichiers de configuration. +Tout le texte est en majuscule ! - Tux Paint est dans une autre langue - Assurez-vous que vos paramètres régionaux sont corrects. Voir "Tux - Paint ne bascule pas dans ma langue" ci-dessous. + L'option "majuscule" est activée. - Tux Paint ne bascule pas dans ma langue - * Utilisateurs Linux et Unix: assurez-vous que les paramètres - régionaux sont disponibles + Modifiez / supprimez l'option "uppercase" ou remplacez-la par "--mixedcase" + sur la ligne de commande ou "uppercase=no" ou "mixedcase=yes" dans un des + fichiers de configuration. - Assurez-vous que les paramètres régionaux souhaités sont - disponibles. Vérifiez votre fichier "/etc/locale.gen". - Consultez la documentation OPTIONS pour les paramètres - régionaux utilisés par Tux Paint (en particulier lors de - l'utilisation de l'option "--lang"). +Tux Paint est dans une autre langue + Assurez-vous que vos paramètres régionaux sont corrects. Voir "Tux Paint ne + bascule pas dans ma langue" ci-dessous. - Remarque : les utilisateurs Debian et dérivés (par exemple, - Ubuntu) peuvent simplement exécuter "dpkg-reconfigure - locales" si les paramètres régionaux sont gérés par "dpkg". +Tux Paint ne bascule pas dans ma langue + + Utilisateurs Linux et Unix: assurez-vous que les paramètres régionaux + sont disponibles - * Si vous utilisez l'option en ligne de commande "--lang" + Assurez-vous que les paramètres régionaux souhaités sont disponibles. + Vérifiez votre fichier "/etc/locale.gen". Consultez la documentation + OPTIONS pour les paramètres régionaux utilisés par Tux Paint (en + particulier lors de l'utilisation de l'option "--lang"). - Essayez d'utiliser l'option en ligne de commande "--locale", - ou les réglages des paramètres régionaux de votre système - d'exploitation (par exemple, la variable d'environnement - "$LANG"), et envoyez nous un mail pour faire part de votre - problème. + Remarque : les utilisateurs Debian et dérivés (par exemple, Ubuntu) + peuvent simplement exécuter "dpkg-reconfigure locales" si les + paramètres régionaux sont gérés par "dpkg". - * Si vous utilisez l'option en ligne de commande "--locale" + + Si vous utilisez l'option en ligne de commande "--lang" - Si ça ne marche pas, envoyez nous un courriel pour expliquer - vos soucis. + Essayez d'utiliser l'option en ligne de commande "--locale", ou les + réglages des paramètres régionaux de votre système d'exploitation (par + exemple, la variable d'environnement "$LANG"), et envoyez nous un mail + pour faire part de votre problème. - * Si vous essayez d'utiliser la langue utilisée par votre - système d'exploitation + + Si vous utilisez l'option en ligne de commande "--locale" - Si ça ne marche pas, envoyez nous un courriel pour expliquer - vos soucis. + Si ça ne marche pas, envoyez nous un courriel pour expliquer vos + soucis. - * Soyez certains d'avoir la police nécessaire + + Si vous essayez d'utiliser la langue utilisée par votre système + d'exploitation - Certaines traductions ont besoin de leurs propres polices. Le - Chinois et le Coréen, par exemple, ont besoin de fontes True - Type installées et placées au bon endroit pour chacune. + Si ça ne marche pas, envoyez nous un courriel pour expliquer vos + soucis. - Les fontes adéquates pour de telles langues peuvent être - téléchargées depuis le site de Tux Paint : + + Soyez certains d'avoir la police nécessaire - https://tuxpaint.org/download/fonts/ + Certaines traductions ont besoin de leurs propres polices. Le Chinois + et le Coréen, par exemple, ont besoin de fontes True Type installées et + placées au bon endroit pour chacune. - ---------------------------------------------------------------------- + Les fontes adéquates pour de telles langues peuvent être téléchargées + depuis le site de Tux Paint : + + https://tuxpaint.org/download/fonts/ + + + + +------------------------------------------------------------------------------- Impression - Tux Paint n'imprime pas, donne une erreur ou imprime n'importe quoi (Unix - / Linux)\ +Tux Paint n'imprime pas, donne une erreur ou imprime n'importe quoi (Unix / + Linux)\ - Tux Paint imprime en créant un rendu PostScript de l'image et en - l'envoyant à une commande externe. Par défaut, cette commande est - "lpr". + Tux Paint imprime en créant un rendu PostScript de l'image et en l'envoyant + à une commande externe. Par défaut, cette commande est "lpr". - Si ce programme n'est pas disponible (par exemple, vous utilisez - CUPS, le système d'impression commun Unix, et n'avez pas installé - "cups-lpr"), vous devrez spécifier une commande appropriée en - utilisant l'option "printcommand" dans le fichier de configuration - de Tux Paint. (Voir la documentation OPTIONS .) + Si ce programme n'est pas disponible (par exemple, vous utilisez CUPS, le + système d'impression commun Unix, et n'avez pas installé "cups-lpr"), vous + devrez spécifier une commande appropriée en utilisant l'option + "printcommand" dans le fichier de configuration de Tux Paint. (Voir la + documentation OPTIONS .) - Remarque : les versions de Tux Paint antérieures à 0.9.15 - utilisaient une commande par défaut différente pour l'impression, - "pngtopnm | pnmtops | lpr", avec le format de sortie PNG, plutôt - que PostScript. + Remarque : les versions de Tux Paint antérieures à 0.9.15 utilisaient une + commande par défaut différente pour l'impression, "pngtopnm | pnmtops | + lpr", avec le format de sortie PNG, plutôt que PostScript. - Si vous avez changé votre option "printcommand" avant Tux Paint - 0.9.15, vous devrez revenir en arrière et la modifier pour pouvoir - accepter PostScript. + Si vous avez changé votre option "printcommand" avant Tux Paint 0.9.15, + vous devrez revenir en arrière et la modifier pour pouvoir accepter + PostScript. - Je reçois le message "Vous ne pouvez pas encore imprimer !" quand je veux - imprimer - L'option "délai d'impression" est activée. Vous ne pouvez imprimer - qu'une fois toutes les X secondes. - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--printdelay=...". +Je reçois le message "Vous ne pouvez pas encore imprimer !" quand je veux + imprimer - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--printdelay=..." - est répertorié comme argument de ligne de commande. + L'option "délai d'impression" est activée. Vous ne pouvez imprimer qu'une + fois toutes les X secondes. - Si une option "--printdelay=..." n'est pas mise sur la ligne de - commande, vérifiez si le fichier de configuration de Tux Paint - possède une ligne comportant : "printdelay=....". + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--printdelay=...". - Soit vous supprimez cette ligne, soit vous mettez la valeur du - délai à 0 (aucun délai) oubien réduisez le délai à la valeur que - vous préférez. (Voir la documentation OPTIONS ). + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--printdelay=..." est répertorié comme + argument de ligne de commande. - Ou, vous pouvez simplement exécuter Tux Paint avec l'argument de - ligne de commande: "--printdelay=0", qui remplacera le paramètre - du fichier de configuration et autorisera une impression - illimitée. (Vous n'aurez pas à attendre entre les impressions.) + Si une option "--printdelay=..." n'est pas mise sur la ligne de commande, + vérifiez si le fichier de configuration de Tux Paint possède une ligne + comportant : "printdelay=....". - Je ne peux tout simplement pas imprimer ! Le bouton est grisé ! + Soit vous supprimez cette ligne, soit vous mettez la valeur du délai à 0 + (aucun délai) oubien réduisez le délai à la valeur que vous préférez. (Voir + la documentation OPTIONS ). - L'option "pas d'impression" est activée. + Ou, vous pouvez simplement exécuter Tux Paint avec l'argument de ligne de + commande: "--printdelay=0", qui remplacera le paramètre du fichier de + configuration et autorisera une impression illimitée. (Vous n'aurez pas à + attendre entre les impressions.) - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--noprint". - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--noprint" est - répertorié comme argument de ligne de commande. - Si une option "--noprint" n'est pas mise sur la ligne de commande, - vérifiez si le fichier de configuration de Tux Paint possède une - ligne comportant : "noprint=yes.". +Je ne peux tout simplement pas imprimer ! Le bouton est grisé ! - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--print", qui remplacera le - paramètre du fichier de configuration. + L'option "pas d'impression" est activée. - Ou utilisez Tux Paint Config. et assurez-vous que "Autoriser - l'impression" (sous "Impression") est coché. + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--noprint". - ---------------------------------------------------------------------- + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--noprint" est répertorié comme + argument de ligne de commande. + + Si une option "--noprint" n'est pas mise sur la ligne de commande, vérifiez + si le fichier de configuration de Tux Paint possède une ligne comportant : + "noprint=yes.". + + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument de + ligne de commande : "--print", qui remplacera le paramètre du fichier de + configuration. + + Ou utilisez Tux Paint Config. et assurez-vous que "Autoriser l'impression" + (sous "Impression") est coché. + + + + +------------------------------------------------------------------------------- Sauvegarde - Où Tux Paint enregistre-t-il mes dessins ? +Où Tux Paint enregistre-t-il mes dessins ? - Sauf si vous avez demandé à Tux Paint d'enregistrer dans un - emplacement spécifique (en utilisant l'option 'savedir'), Tux - Paint enregistre dans un emplacement standard sur votre disque - local : + Sauf si vous avez demandé à Tux Paint d'enregistrer dans un emplacement + spécifique (en utilisant l'option 'savedir'), Tux Paint enregistre dans un + emplacement standard sur votre disque local : - Windows Vista, Windows 8, Windows 10, Windows 11 - Dans le dossier "AppData" de l'utilisateur : - par ex.., - C:\Users\Username\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + Dans le dossier "AppData" de l'utilisateur : + par ex.., C:\Users\Username\AppData\Roaming\TuxPaint\saved - macOS - Dans le dossier "Application Support" de - l'utilisateur : - par ex., /Users/Username/Library/Applicaton - Support/TuxPaint/saved/ + macOS + Dans le dossier "Application Support" de l'utilisateur : + par ex., /Users/Username/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - Dans le dossier personnel de l'utilisateur ("$HOME"), - dans un sous-dossier ".tuxpaint"), par ex., - /home/username/.tuxpaint/saved/ + Linux / Unix + Dans le dossier personnel de l'utilisateur ("$HOME"), dans un + sous-dossier ".tuxpaint"), par ex., /home/username/.tuxpaint/saved/ - Les images sont stockées sous forme de bitmaps PNG, que la plupart - des programmes récents savent lire (éditeurs d'image, éditeurs de - texte, navigateurs, etc ...) - Tux Paint sauvegarde toujours en écrasant mon ancienne image + Les images sont stockées sous forme de bitmaps PNG, que la plupart des + programmes récents savent lire (éditeurs d'image, éditeurs de texte, + navigateurs, etc ...) - L'option "save over" est activée. (Cela désactive l'invite qui - apparaît lorsque vous cliquez sur «Enregistrer».) - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--saveover". - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--saveover" est - répertorié comme argument de ligne de commande. +Tux Paint sauvegarde toujours en écrasant mon ancienne image - Si une option "--saveover" n'est pas mise sur la ligne de - commande, vérifiez si le fichier de configuration de Tux Paint - possède une ligne comportant : "saveover=yes.". + L'option "save over" est activée. (Cela désactive l'invite qui apparaît + lorsque vous cliquez sur «Enregistrer».) - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--saveoverask", qui remplacera - le paramètre du fichier de configuration. + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--saveover". - Ou utilisez Tux Paint Config. et assurez-vous que "Demander avant - d'écraser" (sous "Sauvegarde") est coché. + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--saveover" est répertorié comme + argument de ligne de commande. - Également voyez "Tux Paint sauvegarde toujours avec une nouvelle - image !", ci-dessous. + Si une option "--saveover" n'est pas mise sur la ligne de commande, + vérifiez si le fichier de configuration de Tux Paint possède une ligne + comportant : "saveover=yes.". - Tux Paint sauvegarde toujours avec une nouvelle image ! + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument de + ligne de commande : "--saveoverask", qui remplacera le paramètre du fichier + de configuration. - L'option "never save over" est activée. (Cela désactive l'invite - qui apparaît lorsque vous cliquez sur «Enregistrer».) + Ou utilisez Tux Paint Config. et assurez-vous que "Demander avant + d'écraser" (sous "Sauvegarde") est coché. - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--saveovernew". + Également voyez "Tux Paint sauvegarde toujours avec une nouvelle image !", + ci-dessous. - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--saveovernew" - est répertorié comme argument de ligne de commande. - Si une option "--saveovernew" n'est pas mise sur la ligne de - commande, vérifiez si le fichier de configuration de Tux Paint - possède une ligne comportant : "saveover=new.". - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--saveoverask", qui remplacera - le paramètre du fichier de configuration. +Tux Paint sauvegarde toujours avec une nouvelle image ! - Ou utilisez Tux Paint Config. et assurez-vous que "Demander avant - d'écraser" (sous "Sauvegarde") est coché. + L'option "never save over" est activée. (Cela désactive l'invite qui + apparaît lorsque vous cliquez sur «Enregistrer».) - Également voyez "Tux Paint sauvegarde en écrasant toujours mon - ancienne image !", ci-dessus. + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--saveovernew". - ---------------------------------------------------------------------- + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--saveovernew" est répertorié comme + argument de ligne de commande. + + Si une option "--saveovernew" n'est pas mise sur la ligne de commande, + vérifiez si le fichier de configuration de Tux Paint possède une ligne + comportant : "saveover=new.". + + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument de + ligne de commande : "--saveoverask", qui remplacera le paramètre du fichier + de configuration. + + Ou utilisez Tux Paint Config. et assurez-vous que "Demander avant + d'écraser" (sous "Sauvegarde") est coché. + + Également voyez "Tux Paint sauvegarde en écrasant toujours mon ancienne + image !", ci-dessus. + + + + +------------------------------------------------------------------------------- Problèmes audio - Il n'y a pas de son ! - * D'abord, vérifiez ce qui est évident : - * Est-ce que vos haut-parleurs sont branchés et en marche - ? - * Est-ce que le volume est correct ? - * Le volume est-il correct dans la «table de mixage» de - votre système d'exploitation ? - * Êtes-vous certains d'avoir une carte son ? - * Y a-t-il d'autres programmes qui tourne et qui utilise - le son ? (Ils peuvent empêcher Tux Paint d'accéder à - votre carte son) - * (Unix / Linux) Utilisez-vous un système audio, tel que - aRts, ESD ou GStreamer ? Si tel est le cas, essayez de - définir la variable d'environnement "SDL_AUDIODRIVER" - avant d'exécuter Tux Paint (par ex., "export - SDL_AUDIODRIVER=arts"). Ou exécutez vous Tux Paint via - le routeur du système (par exemple, exécuter "artsdsp - tuxpaint" ou "esddsp tuxpaint", au lieu de simplement - "tuxpaint"). - * Est-ce que le son est désactivé dans Tux Paint ? +Il n'y a pas de son ! + + D'abord, vérifiez ce qui est évident : + o Est-ce que vos haut-parleurs sont branchés et en marche ? + o Est-ce que le volume est correct ? + o Le volume est-il correct dans la «table de mixage» de votre système + d'exploitation ? + o Êtes-vous certains d'avoir une carte son ? + o Y a-t-il d'autres programmes qui tourne et qui utilise le son ? + (Ils peuvent empêcher Tux Paint d'accéder à votre carte son) + o (Unix / Linux) Utilisez-vous un système audio, tel que aRts, ESD ou + GStreamer ? Si tel est le cas, essayez de définir la variable + d'environnement "SDL_AUDIODRIVER" avant d'exécuter Tux Paint (par + ex., "export SDL_AUDIODRIVER=arts"). Ou exécutez vous Tux Paint via + le routeur du système (par exemple, exécuter "artsdsp tuxpaint" ou + "esddsp tuxpaint", au lieu de simplement "tuxpaint"). + + Est-ce que le son est désactivé dans Tux Paint ? - Si le son semble fonctionner autrement (et que vous êtes sûr - qu'aucun autre programme ne "bloque" le périphérique audio), - alors Tux Paint tourne peut-être avec l'option "pas de son". + Si le son semble fonctionner autrement (et que vous êtes sûr qu'aucun + autre programme ne "bloque" le périphérique audio), alors Tux Paint + tourne peut-être avec l'option "pas de son". - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--nosound". + Si vous exécutez Tux Paint à partir d'une ligne de commande, + assurez-vous de ne pas lui donner l'option "--nosound". - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--nosound" - est répertorié comme argument de ligne de commande. + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez + les propriétés de l'icône pour voir si "--nosound" est répertorié comme + argument de ligne de commande. - Si une option "--nosound" n'est pas mise sur la ligne de - commande, vérifiez si le fichier de configuration de Tux - Paint possède une ligne comportant : "nosound=yes.". + Si une option "--nosound" n'est pas mise sur la ligne de commande, + vérifiez si le fichier de configuration de Tux Paint possède une ligne + comportant : "nosound=yes.". - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--sound", qui remplacera - le paramètre du fichier de configuration. + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument + de ligne de commande : "--sound", qui remplacera le paramètre du + fichier de configuration. - Ou, vous pouvez simplement exécuter Tux Paint avec l'argument - de ligne de commande: "Activez les effets sonores", qui - remplacera le paramètre du fichier de configuration et - autorisera une impression illimitée. (Vous n'aurez pas à - attendre entre les impressions.) + Ou, vous pouvez simplement exécuter Tux Paint avec l'argument de ligne + de commande: "Activez les effets sonores", qui remplacera le paramètre + du fichier de configuration et autorisera une impression illimitée. + (Vous n'aurez pas à attendre entre les impressions.) - * Le son a-t-il été temporairement désactivé ? + + Le son a-t-il été temporairement désactivé ? - Même si les sons sont activés dans Tux Paint, il est possible - de les désactiver et de les réactiver temporairement à l'aide - de la séquence de touches [Alt] + [S] . Essayez d'appuyer sur - ces touches pour voir si les sons recommencent à fonctionner. + Même si les sons sont activés dans Tux Paint, il est possible de les + désactiver et de les réactiver temporairement à l'aide de la séquence + de touches [Alt] + [S] . Essayez d'appuyer sur ces touches pour voir si + les sons recommencent à fonctionner. - * Tux Paint a-t-il été construit sans le support pour le son? + + Tux Paint a-t-il été construit sans le support pour le son? - Tux Paint a peut-être été compilé avec la prise en charge du - son désactivée. Pour tester si la prise en charge du son - était activée lors de la compilation de Tux Paint, démarrez - Tux Paint en ligne de commande, comme ceci : + Tux Paint a peut-être été compilé avec la prise en charge du son + désactivée. Pour tester si la prise en charge du son était activée lors + de la compilation de Tux Paint, démarrez Tux Paint en ligne de + commande, comme ceci : - tuxpaint --verbose-version + tuxpaint --verbose-version - Si, parmi les autres informations, vous voyez "Son - désactivé", alors la version de Tux Paint que vous utilisez a - le son désactivé. Recompilez Tux Paint et assurez-vous de NE - PAS construire avec la cible "nosound". (c'est-à-dire, ne - lancez pas "make nosound") Assurez-vous que la bibliothèque - SDL_mixer et ses en-têtes de développement sont disponibles ! + Si, parmi les autres informations, vous voyez "Son désactivé", alors la + version de Tux Paint que vous utilisez a le son désactivé. Recompilez + Tux Paint et assurez-vous de NE PAS construire avec la cible "nosound". + (c'est-à-dire, ne lancez pas "make nosound") Assurez-vous que la + bibliothèque SDL_mixer et ses en-têtes de développement sont + disponibles ! - Tux Paint fait trop de bruit ! Puis-je arrêter cela ? - Oui, il existe plusieurs façons de désactiver les sons dans Tux - Paint : - * Appuyez sur [Alt] + [S] quand Tux Paint tourne pour - désactiver temporairement les sons. (Appuyez à nouveau sur - cette séquence de touches pour réactiver les sons.) - * Exécutez Tux Paint avec l'option "pas de son" : - * Exécutez "tuxpaint --nosound" en ligne de commande ou à - partir du raccourci ou à partir de l'icône sur le - bureau. - * Editez le fichier de configuration de Tux Paint (voir - OPTIONS pour plus de détails) et ajoutez une ligne - contenant "nosound=yes". - * Ou utilisez Tux Paint Config. et assurez-vous que - "Activez les effets sonores" (sous "Vidéo et son") n'est - pas coché. - * Autrement, recompilez Tux Paint avec la prise en charge - du son désactivée. (Voir ci-dessus et la documentation - 'install' .) +Tux Paint fait trop de bruit ! Puis-je arrêter cela ? - La stéréo des effets sonores est gênante; les effets sonores peuvent-ils - être monophoniques ? + Oui, il existe plusieurs façons de désactiver les sons dans Tux Paint : - Lancez Tux Paint avec l'option "no stereo" : + + Appuyez sur [Alt] + [S] quand Tux Paint tourne pour désactiver + temporairement les sons. (Appuyez à nouveau sur cette séquence de + touches pour réactiver les sons.) + + Exécutez Tux Paint avec l'option "pas de son" : + o Exécutez "tuxpaint --nosound" en ligne de commande ou à partir du + raccourci ou à partir de l'icône sur le bureau. + o Editez le fichier de configuration de Tux Paint (voir OPTIONS pour + plus de détails) et ajoutez une ligne contenant "nosound=yes". + o Ou utilisez Tux Paint Config. et assurez-vous que "Activez les + effets sonores" (sous "Vidéo et son") n'est pas coché. + o Autrement, recompilez Tux Paint avec la prise en charge du son + désactivée. (Voir ci-dessus et la documentation 'install' .) - * Exécutez "tuxpaint --nostereo" en ligne de commande ou à - partir du raccourci ou à partir de l'icône sur le bureau. - * Editez le fichier de configuration de Tux Paint (voir OPTIONS - pour plus de détails) et ajoutez une ligne contenant - "nostereo=yes". - * Ou utilisez Tux Paint Config. et assurez-vous que "Activez - les effets stéréo" (sous "Vidéo et son") n'est pas coché. - Les effets sonores sont étranges +La stéréo des effets sonores est gênante; les effets sonores peuvent-ils être + monophoniques ? - Cela pourrait avoir un lien avec la façon dont SDL et SDL_mixer - ont été initialisés. (Choix de la taille de la mémoire tampon.) + Lancez Tux Paint avec l'option "no stereo" : - Veuillez nous envoyer un e-mail avec des détails sur votre système - utilisé. (Système d'exploitation et version, carte son, quelle - version de Tux Paint vous utilisez (exécutez "tuxpaint --version" - pour vérifier), etc...) + + Exécutez "tuxpaint --nostereo" en ligne de commande ou à partir du + raccourci ou à partir de l'icône sur le bureau. + + Editez le fichier de configuration de Tux Paint (voir OPTIONS pour plus + de détails) et ajoutez une ligne contenant "nostereo=yes". + + Ou utilisez Tux Paint Config. et assurez-vous que "Activez les effets + stéréo" (sous "Vidéo et son") n'est pas coché. - ---------------------------------------------------------------------- + +Les effets sonores sont étranges + + Cela pourrait avoir un lien avec la façon dont SDL et SDL_mixer ont été + initialisés. (Choix de la taille de la mémoire tampon.) + + Veuillez nous envoyer un e-mail avec des détails sur votre système utilisé. + (Système d'exploitation et version, carte son, quelle version de Tux Paint + vous utilisez (exécutez "tuxpaint --version" pour vérifier), etc...) + + + + +------------------------------------------------------------------------------- Problèmes en mode plein écran - Lorsque j'exécute Tux Paint en plein écran et que je fais [Alt] + [Tab], - la fenêtre devient noire ! - C'est apparemment un bug de la bibbliothèque de SDL. Désolé. +Lorsque j'exécute Tux Paint en plein écran et que je fais [Alt] + [Tab], la + fenêtre devient noire ! + C'est apparemment un bug de la bibbliothèque de SDL. Désolé. - Lorsque j'exécute Tux Paint en plein écran, il est entouré de grandes - bordures +Lorsque j'exécute Tux Paint en plein écran, il est entouré de grandes bordures - Utilisateurs Linux - Votre serveur X-Window n'est probablement pas - configuré avec la possibilité de passer à la résolution souhaitée - : 800 × 600. (ou quelle que soit la résolution à laquelle Tux - Paint doit s'exécuter.) (Cela se fait généralement manuellement - sous le serveur X-Window en appuyant sur [Control] + [Alt] + - [Keypad Plus (+)] et [Control] + [Alt] + [Keypad Minus (-)].) + Utilisateurs Linux - Votre serveur X-Window n'est probablement pas + configuré avec la possibilité de passer à la résolution souhaitée : 800 × + 600. (ou quelle que soit la résolution à laquelle Tux Paint doit + s'exécuter.) (Cela se fait généralement manuellement sous le serveur + X-Window en appuyant sur [Control] + [Alt] + [Keypad Plus (+)] et [Control] + + [Alt] + [Keypad Minus (-)].) - Pour que cela fonctionne, votre moniteur doit prendre en charge - cette résolution et elle doit être répertoriée dans la - configuration de votre serveur X. + Pour que cela fonctionne, votre moniteur doit prendre en charge cette + résolution et elle doit être répertoriée dans la configuration de votre + serveur X. - Vérifiez la sous-section «Display» de la section «Screen» de votre - fichier de configuration XFree86 ou X.org (généralement - «/etc/X11/XF86Config-4» ou «/etc/X11/XF86Config», selon la version - de XFree86 que vous utilisez; 3.x ou 4.x, respectivement, ou - "/etc/X11/xorg.conf" pour X.org). + Vérifiez la sous-section «Display» de la section «Screen» de votre fichier + de configuration XFree86 ou X.org (généralement «/etc/X11/XF86Config-4» ou + «/etc/X11/XF86Config», selon la version de XFree86 que vous utilisez; 3.x + ou 4.x, respectivement, ou "/etc/X11/xorg.conf" pour X.org). - Ajoutez "800x600" (ou la (les) résolution (s) souhaitée (s)) à la - ligne "Modes" appropriée. (par ex., dans la sous-section "Display" - qui contient une profondeur de couleur de 24 bits ("Depth 24"), ce - que Tux Paint essaye d'utiliser.) + Ajoutez "800x600" (ou la (les) résolution (s) souhaitée (s)) à la ligne + "Modes" appropriée. (par ex., dans la sous-section "Display" qui contient + une profondeur de couleur de 24 bits ("Depth 24"), ce que Tux Paint essaye + d'utiliser.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Notez que certaines distributions Linux ont des outils qui peuvent - apporter ces modifications à votre place. Les utilisateurs Debian - peuvent exécuter la commande "dpkg-reconfigure xserver-xfree86" en - tant que root, par exemple. + Notez que certaines distributions Linux ont des outils qui peuvent apporter + ces modifications à votre place. Les utilisateurs Debian peuvent exécuter + la commande "dpkg-reconfigure xserver-xfree86" en tant que root, par + exemple. - Tux Paint continue de fonctionner en mode plein écran - je veux qu'il soit - fenêtré ! - L'option "plein écran" est définie. - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--fullscreen". +Tux Paint continue de fonctionner en mode plein écran - je veux qu'il soit + fenêtré ! - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--fullscreen" est - répertorié comme argument de ligne de commande. + L'option "plein écran" est définie. - Si une option "--fullscreen" n'est pas mise sur la ligne de - commande, vérifiez si le fichier de configuration de Tux Paint - possède une ligne comportant : "fullscreen=yes.". + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--fullscreen". - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--windowed", qui remplacera le - paramètre du fichier de configuration. + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--fullscreen" est répertorié comme + argument de ligne de commande. - Ou utilisez Tux Paint Config. et assurez-vous que "Plein écran" - (sous "Vidéo et son") n'est pas coché. + Si une option "--fullscreen" n'est pas mise sur la ligne de commande, + vérifiez si le fichier de configuration de Tux Paint possède une ligne + comportant : "fullscreen=yes.". - ---------------------------------------------------------------------- + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument de + ligne de commande : "--windowed", qui remplacera le paramètre du fichier de + configuration. + + Ou utilisez Tux Paint Config. et assurez-vous que "Plein écran" (sous + "Vidéo et son") n'est pas coché. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint ne veut pas fonctionner +Tux Paint ne veut pas fonctionner - Si Tux Paint échoue avec le message: "You're already running a - copy of Tux Paint!", cela signifie qu'il a déjà été lancé dans les - 30 dernières secondes. (Sous Unix / Linux, ce message devrait - apparaîtrr dans une console de terminal si vous exécutiez Tux - Paint en ligne de commande. Sous Windows, ce message apparaîtrait - dans un fichier nommé "stdout.txt" dans le même dossier où - TuxPaint.exe réside (par exemple, dans "C:\Program - Files\TuxPaint"). + Si Tux Paint échoue avec le message: "You're already running a copy of Tux + Paint!", cela signifie qu'il a déjà été lancé dans les 30 dernières + secondes. (Sous Unix / Linux, ce message devrait apparaîtrr dans une + console de terminal si vous exécutiez Tux Paint en ligne de commande. Sous + Windows, ce message apparaîtrait dans un fichier nommé "stdout.txt" dans le + même dossier où TuxPaint.exe réside (par exemple, dans "C:\Program Files\ + TuxPaint"). - Un fichier de verrouillage ("~/.tuxpaint/lockfile.dat" sous Linux - et Unix, "userdata\lockfile.dat" sous Windows) est utilisé pour - s'assurer que Tux Paint n'est pas exécuté trop de fois en même - temps (par exemple, en à cause d'un enfant impatient qui clique - plusieurs fois sur son icône). + Un fichier de verrouillage ("~/.tuxpaint/lockfile.dat" sous Linux et Unix, + "userdata\lockfile.dat" sous Windows) est utilisé pour s'assurer que Tux + Paint n'est pas exécuté trop de fois en même temps (par exemple, en à cause + d'un enfant impatient qui clique plusieurs fois sur son icône). - Même si le fichier de verrouillage existe, il contient l'heure de - la dernière exécution de Tux Paint. Si cela fait plus de 30 - secondes, Tux Paint devrait fonctionner correctement et simplement - mettre à jour le fichier de verrouillage avec l'heure courante. + Même si le fichier de verrouillage existe, il contient l'heure de la + dernière exécution de Tux Paint. Si cela fait plus de 30 secondes, Tux + Paint devrait fonctionner correctement et simplement mettre à jour le + fichier de verrouillage avec l'heure courante. - Si plusieurs utilisateurs partagent le répertoire dans lequel ce - fichier est stocké (par exemple, sur un lecteur réseau partagé), - vous devrez désactiver cette fonctionnalité. + Si plusieurs utilisateurs partagent le répertoire dans lequel ce fichier + est stocké (par exemple, sur un lecteur réseau partagé), vous devrez + désactiver cette fonctionnalité. - Pour désactiver le fichier de verrouillage, ajoutez l'argument - "--nolockfile" à la ligne de commande de Tux Paint, ou - "nolockfile=yes" au fichier de configuration. + Pour désactiver le fichier de verrouillage, ajoutez l'argument + "--nolockfile" à la ligne de commande de Tux Paint, ou "nolockfile=yes" au + fichier de configuration. - Je ne peux pas quitter Tux Paint - L'option "noquit" est activée. Cela désactive le bouton "Quitter" - dans la barre d'outils de Tux Paint (en grisé), et empêche Tux - Paint d'être fermé en utilisant la touche [Escape]. - Si Tux Paint n'est pas en mode plein écran, cliquez simplement sur - le bouton de fermeture de la fenêtre dans la barre de titre de Tux - Paint. (c'est-à-dire le "ⓧ" en haut à droite.) +Je ne peux pas quitter Tux Paint - Si Tux Paint est en mode plein écran, vous devrez utiliser la - séquence [Shift] + [Control] + [Escape] sur le clavier pour - quitter Tux Paint. + L'option "noquit" est activée. Cela désactive le bouton "Quitter" dans la + barre d'outils de Tux Paint (en grisé), et empêche Tux Paint d'être fermé + en utilisant la touche [Escape]. - Remarque : avec ou sans "noquit" défini, vous pouvez toujours - utiliser la combinaison [Alt] + [F4] sur votre clavier pour - quitter Tux Paint.) + Si Tux Paint n'est pas en mode plein écran, cliquez simplement sur le + bouton de fermeture de la fenêtre dans la barre de titre de Tux Paint. + (c'est-à-dire le "ⓧ" en haut à droite.) - Je ne veux pas que le mode "noquit" soit activé ! + Si Tux Paint est en mode plein écran, vous devrez utiliser la séquence + [Shift] + [Control] + [Escape] sur le clavier pour quitter Tux Paint. - Si vous exécutez Tux Paint à partir d'une ligne de commande, - assurez-vous de ne pas lui donner l'option "--noquit". + Remarque : avec ou sans "noquit" défini, vous pouvez toujours utiliser la + combinaison [Alt] + [F4] sur votre clavier pour quitter Tux Paint.) - Si vous exécutez Tux Paint en double-cliquant sur une icône, - vérifiez les propriétés de l'icône pour voir si "--noquit" est - répertorié comme argument de ligne de commande. - Si une option "--noquit" n'est pas mise sur la ligne de commande, - vérifiez si le fichier de configuration de Tux Paint possède une - ligne comportant : "noquit=yes.". - Supprimez cette ligne ou exécutez simplement Tux Paint avec - l'argument de ligne de commande : "--quit", qui remplacera le - paramètre du fichier de configuration. +Je ne veux pas que le mode "noquit" soit activé ! - Ou utilisez Tux Paint Config. et assurez-vous que "Désactiver le - bouton Quit et la touche Escape" (sous "Simplification") n'est pas - coché. + Si vous exécutez Tux Paint à partir d'une ligne de commande, assurez-vous + de ne pas lui donner l'option "--noquit". - Tux Paint continue d'écrire des messages étranges à l'écran / dans un - fichier texte + Si vous exécutez Tux Paint en double-cliquant sur une icône, vérifiez les + propriétés de l'icône pour voir si "--noquit" est répertorié comme argument + de ligne de commande. - Quelques messages sont normaux, mais si Tux Paint est extrêmement - bavard (comme lister le nom de chaque image de tampon qu'il trouve - lors de son chargement), alors il a probablement été compilé avec - la sortie de débogage activée. + Si une option "--noquit" n'est pas mise sur la ligne de commande, vérifiez + si le fichier de configuration de Tux Paint possède une ligne comportant : + "noquit=yes.". - Pour changer cela, vous devez reconstruire Tux Paint à partir des - sources. Assurez-vous de supprimer ou de commenter toute ligne qui - dit : + Supprimez cette ligne ou exécutez simplement Tux Paint avec l'argument de + ligne de commande : "--quit", qui remplacera le paramètre du fichier de + configuration. - #define DEBUG + Ou utilisez Tux Paint Config. et assurez-vous que "Désactiver le bouton + Quit et la touche Escape" (sous "Simplification") n'est pas coché. - dans le fichier "tuxpaint.c" du répertoire "src". - Tux Paint utilise des options que je n'ai pas spécifiées ! - Par défaut, Tux Paint regarde d'abord les fichiers de - configuration pour les options. +Tux Paint continue d'écrire des messages étranges à l'écran / dans un fichier + texte - * Windows + Quelques messages sont normaux, mais si Tux Paint est extrêmement bavard + (comme lister le nom de chaque image de tampon qu'il trouve lors de son + chargement), alors il a probablement été compilé avec la sortie de débogage + activée. - Sous Windows, Tux Paint examine d'abord le fichier de - configuration : + Pour changer cela, vous devez reconstruire Tux Paint à partir des sources. + Assurez-vous de supprimer ou de commenter toute ligne qui dit : - tuxpaint.cfg + #define DEBUG - Et finalement, toutes les options envoyées en tant - qu'arguments de ligne de commande sont utilisées. + dans le fichier "tuxpaint.c" du répertoire "src". - * macOS - * Unix et Linux - Sous Unix et Linux, il examine d'abord le fichier de - configuration à l'échelle du système, situé ici : +Tux Paint utilise des options que je n'ai pas spécifiées ! - /etc/tuxpaint/tuxpaint.conf + Par défaut, Tux Paint regarde d'abord les fichiers de configuration pour + les options. - Il examine ensuite le fichier de configuration personnel de - l'utilisateur : + + Windows - ~/.tuxpaintrc + Sous Windows, Tux Paint examine d'abord le fichier de configuration : - Et finalement, toutes les options envoyées en tant - qu'arguments de ligne de commande sont utilisées. + tuxpaint.cfg - * Haiku + Et finalement, toutes les options envoyées en tant qu'arguments de + ligne de commande sont utilisées. - Cela signifie que si quelque chose est défini dans un fichier de - configuration que vous ne souhaitez pas activer, vous devrez soit - modifier le fichier config. fichier (si vous le pouvez), ou - changer l'option par le biais de la ligne de commande. + + macOS - Par exemple, si "/etc/tuxpaint/tuxpaint.conf" inclut une option - pour désactiver le son ... + + Unix et Linux - nosound=yes + Sous Unix et Linux, il examine d'abord le fichier de configuration à + l'échelle du système, situé ici : - ... Alors vous pouvez réactiver le son en ajoutant cette option à - votre propre fichier ".tuxpaintrc" : + /etc/tuxpaint/tuxpaint.conf - sound=yes + Il examine ensuite le fichier de configuration personnel de + l'utilisateur : - ... Ou en utilisant cet argument en ligne de commande : + ~/.tuxpaintrc - --sound + Et finalement, toutes les options envoyées en tant qu'arguments de + ligne de commande sont utilisées. - Les utilisateurs Linux et Unix peuvent également désactiver le - fichier de configuration à l'échelle du système en incluant - l'argument de ligne de commande suivant : + + Haiku - --nosysconfig + Cela signifie que si quelque chose est défini dans un fichier de + configuration que vous ne souhaitez pas activer, vous devrez soit modifier + le fichier config. fichier (si vous le pouvez), ou changer l'option par le + biais de la ligne de commande. - Tux Paint examinera alors uniquement "~/.tuxpaintrc" et les - arguments en ligne de commande pour déterminer les options à - activer. + Par exemple, si "/etc/tuxpaint/tuxpaint.conf" inclut une option pour + désactiver le son ... - ---------------------------------------------------------------------- + nosound=yes + + ... Alors vous pouvez réactiver le son en ajoutant cette option à votre + propre fichier ".tuxpaintrc" : + + sound=yes + + ... Ou en utilisant cet argument en ligne de commande : + + --sound + + Les utilisateurs Linux et Unix peuvent également désactiver le fichier de + configuration à l'échelle du système en incluant l'argument de ligne de + commande suivant : + + --nosysconfig + + Tux Paint examinera alors uniquement "~/.tuxpaintrc" et les arguments en + ligne de commande pour déterminer les options à activer. + + + + +------------------------------------------------------------------------------- Aide / Contact - Des questions auxquelles vous ne trouvez pas de réponse ? Merci de nous le - faire savoir ! Vous pouvez vous abonner et écrire sur notre liste de - diffusion "tuxpaint-users" : +Des questions auxquelles vous ne trouvez pas de réponse ? Merci de nous le +faire savoir ! Vous pouvez vous abonner et écrire sur notre liste de diffusion +"tuxpaint-users" : - https://tuxpaint.org/lists/ + https://tuxpaint.org/lists/ - Ou contactez directement le développeur principal Bill Kendrick : +Ou contactez directement le développeur principal Bill Kendrick : + + bill@newbreedsoftware.com - bill@newbreedsoftware.com diff --git a/docs/fr_FR.UTF-8/INSTALL.txt b/docs/fr_FR.UTF-8/INSTALL.txt index 38659c5d8..fc602a5a2 100644 --- a/docs/fr_FR.UTF-8/INSTALL.txt +++ b/docs/fr_FR.UTF-8/INSTALL.txt @@ -1,961 +1,955 @@ Tux Paint - version 0.9.31 - Documentation sur l'installation + version 0.9.31 + Documentation sur l'installation Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - mai 13, 2023 + mai 13, 2023 - +--------------------------------------------------------+ - |Table des matières | - |--------------------------------------------------------| - | * Exigences | - | * Biliothèque Simple DirectMedia Layer (libSDL) | - | * Autres bibliothèques | - | * Compilation et installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Débogage | - | * Désinstallation de Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +--------------------------------------------------------+ ++-------------------------------------------------------+ +| Table des matières | +|-------------------------------------------------------| +| * Exigences | +| + Biliothèque Simple DirectMedia Layer (libSDL) | +| + Autres bibliothèques | +| * Compilation et installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Débogage | +| * Désinstallation de Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++-------------------------------------------------------+ - Exigences +Exigences Biliothèque Simple DirectMedia Layer (libSDL) - Tux Paint nécessite la bibliothèque de couches DirectMedia simple - (libSDL), une bibliothèque de programmation multimédia Open Source - disponible sous la Licence publique générale limitée GNU (LGPL). +Tux Paint nécessite la bibliothèque de couches DirectMedia simple (libSDL), une +bibliothèque de programmation multimédia Open Source disponible sous la Licence +publique générale limitée GNU (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - Les bibliothèques SDL sont disponibles en tant que code source, ou en tant - que paquets RPM ou Debian pour diverses distributions de Linux. Ils - peuvent être téléchargés à partir de : +Les bibliothèques SDL sont disponibles en tant que code source, ou en tant que +paquets RPM ou Debian pour diverses distributions de Linux. Ils peuvent être +téléchargés à partir de : - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optionnel) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optionnel) - Elles sont aussi parmi les paquets inclus dans votre distribution (par ex. - sur le media d'installation, ou via la maintenance de vos logiciels comme - la commande apt de Debian). +Elles sont aussi parmi les paquets inclus dans votre distribution (par ex. sur +le media d'installation, ou via la maintenance de vos logiciels comme la +commande apt de Debian). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Autres bibliothèques +Autres bibliothèques - Tux Paint profite également d'un certain nombre d'autres bibliothèques - gratuites LGPL. Sous Linux, tout comme SDL, ils devraient être soit déjà - installées, soit facilement disponibles avec votre distribution Linux. +Tux Paint profite également d'un certain nombre d'autres bibliothèques +gratuites LGPL. Sous Linux, tout comme SDL, ils devraient être soit déjà +installées, soit facilement disponibles avec votre distribution Linux. - libPNG +libPNG - Tux Paint utilise le format PNG (Portable Network Graphics) pour - ses fichiers de données. SDL_image nécessitera l'installation de - libPNG. + Tux Paint utilise le format PNG (Portable Network Graphics) pour ses + fichiers de données. SDL_image nécessitera l'installation de libPNG. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint utilise les paramètres régionaux de votre système avec - la bibliothèque "gettext" pour prendre en charge plusieurs langues - (par exemple, l'espagnol). Vous aurez besoin d'installer la - bibliothèque de gettext. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Linux/Unix uniquement) + Tux Paint utilise les paramètres régionaux de votre système avec la + bibliothèque "gettext" pour prendre en charge plusieurs langues (par + exemple, l'espagnol). Vous aurez besoin d'installer la bibliothèque de + gettext. - Depuis Tux Paint 0.9.17, Tux Paint peut déterminer le format de - papier par défaut (par exemple, A4 ou Lettre), ou peut être invité - à utiliser un format particulier, ceci grâce à libpaper. + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - Les outils "Texte" et "Étiquette" de Tux Paint supportent les - langues bidirectionnelles, grâce à la bibliothèque "FriBidi". +libpaper (Linux/Unix uniquement) - http://fribidi.org/ + Depuis Tux Paint 0.9.17, Tux Paint peut déterminer le format de papier par + défaut (par exemple, A4 ou Lettre), ou peut être invité à utiliser un + format particulier, ceci grâce à libpaper. - Support des graphismes SVG + https://github.com/naota/libpaper - À partir de Tux Paint 0.9.17, Tux Paint peut prendre en charge les - images SVG (Scalable Vector Graphics) pour les tampons. Deux - ensembles de bibliothèques sont pris en charge et le support SVG - peut être complètement désactivé (via "make SVG_LIB:==") - librsvg-2 & libCairo2 (nouvelles bibliothèques) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * Celles-ci dépendent aussi de : - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Anciennes bibliothèques - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * Celles-ci dépendent aussi de : - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Fonction d'exportation de GIF animés + Les outils "Texte" et "Étiquette" de Tux Paint supportent les langues + bidirectionnelles, grâce à la bibliothèque "FriBidi". - Pour prendre en compte l'exportation de GIF animés (diaporama), la - bibliothèque "libimagequant" (issue du projet "pngquant" est - nécessaire. + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - Outils NetPBM (optionnel) ne sont plus utilisés par défaut - 📜 Sous Linux et Unix, les anciennes versions de Tux Paint - utilisaient les outils NetPBM comme aide à l'impression. (Un PNG - est généré par TuxPaint et converti en PostScript en utilisant en - ligne de commande les outils NetPBM pngtopnm et pnmtops.) +Support des graphismes SVG - http://netpbm.sourceforge.net/ + À partir de Tux Paint 0.9.17, Tux Paint peut prendre en charge les images + SVG (Scalable Vector Graphics) pour les tampons. Deux ensembles de + bibliothèques sont pris en charge et le support SVG peut être complètement + désactivé (via "make SVG_LIB:==") - Compilation et installation + librsvg-2 & libCairo2 (nouvelles bibliothèques) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o Celles-ci dépendent aussi de : + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint est publié sous la licence publique générale GNU (GPL) (voir - "COPYING.txt" pour plus de détails), et donc le 'code source' du programme - est disponible gratuitement. - ------------------------------------------------------------------ + Anciennes bibliothèques + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o Celles-ci dépendent aussi de : + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Fonction d'exportation de GIF animés + + Pour prendre en compte l'exportation de GIF animés (diaporama), la + bibliothèque "libimagequant" (issue du projet "pngquant" est nécessaire. + + https://github.com/ImageOptim/libimagequant + + + +Outils NetPBM (optionnel) ne sont plus utilisés par défaut + + 📜 Sous Linux et Unix, les anciennes versions de Tux Paint utilisaient les + outils NetPBM comme aide à l'impression. (Un PNG est généré par TuxPaint et + converti en PostScript en utilisant en ligne de commande les outils NetPBM + pngtopnm et pnmtops.) + + http://netpbm.sourceforge.net/ + + + + +Compilation et installation + +Tux Paint est publié sous la licence publique générale GNU (GPL) (voir +"COPYING.txt" pour plus de détails), et donc le 'code source' du programme est +disponible gratuitement. + + ----------------------------------------------------------------------- Windows - juillet 10, 2022 Shin-ichi TOYAMA +juillet 10, 2022 Shin-ichi TOYAMA - Réglages pour compilation +Réglages pour compilation - Depuis février 2005 (à partir de Tux Paint 0.9.15), le "Makefile" inclut - la prise en charge de la construction sur un système Windows à l'aide de - MinGW/MSYS (https://sourceforge.net/projects/msys2/). +Depuis février 2005 (à partir de Tux Paint 0.9.15), le "Makefile" inclut la +prise en charge de la construction sur un système Windows à l'aide de MinGW/ +MSYS (https://sourceforge.net/projects/msys2/). - Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux - Paint. Le système de gestion de paquet "pacman" apporte une aide pour - installer automatiquement, en résolvant les dépendances nombreuses. +Beaucoup d'outils et de bibliothèques sont nécessaires pour élaborer Tux Paint. +Le système de gestion de paquet "pacman" apporte une aide pour installer +automatiquement, en résolvant les dépendances nombreuses. - MYSYS2 +MYSYS2 - Téléchargez le dernier environnement MSYS2 à partir de - https://www.msys2.org/ et installez-le où vous voulez (par défaut - "C:\msys64") +Téléchargez le dernier environnement MSYS2 à partir de https://www.msys2.org/ +et installez-le où vous voulez (par défaut "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Sous le shell MSYS2, exécutez la commande suivante pour installer outils - basiques pour le développement : +Sous le shell MSYS2, exécutez la commande suivante pour installer outils +basiques pour le développement : - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Allez à la prochaine section "chaînes d'outils MinGW 64bit (x86_64) ", ou - bien à la section "chaînes d'outils MinGW 32bit (i686)" si vous ne voulez - qu'un environnement de travail 32bit. +Allez à la prochaine section "chaînes d'outils MinGW 64bit (x86_64) ", ou bien +à la section "chaînes d'outils MinGW 32bit (i686)" si vous ne voulez qu'un +environnement de travail 32bit. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit - compiler and basic development tools : +Sous le shell MSYS2, exécutez la commande suivante pour installer 64bit +compiler and basic development tools : - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" est un petit outil qui examine les fichiers exécutables de windows - en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le - process de fabrication de Tux Paint pour fournir des fichiers binaires - s'en sert pour trouver les fichiers .dll requis. +"ntldd" est un petit outil qui examine les fichiers exécutables de windows en +vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de +fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour +trouver les fichiers .dll requis. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. +💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Aller à la prochaine section "chaines d'outils MinGW 32bit (i686)", ou - bien aller directement à la section "ImageMagick" si vous n'avez besoin - que d'un environnement de travail 64bit. +Aller à la prochaine section "chaines d'outils MinGW 32bit (i686)", ou bien +aller directement à la section "ImageMagick" si vous n'avez besoin que d'un +environnement de travail 64bit. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit - compiler and basic development tools : +Sous le shell MSYS2, exécutez la commande suivante pour installer 32bit +compiler and basic development tools : - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" est un petit outil qui examine les fichiers exécutables de windows - en vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le - process de fabrication de Tux Paint pour fournir des fichiers binaires - s'en sert pour trouver les fichiers .dll requis. +"ntldd" est un petit outil qui examine les fichiers exécutables de windows en +vue de lister les fichiers DLL (.dll) qui leur sont nécessaires. Le process de +fabrication de Tux Paint pour fournir des fichiers binaires s'en sert pour +trouver les fichiers .dll requis. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. +💡 Nota : Fermez l'interpréteur de commandes avant de passer à la suite. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick est un ensemble d'outils en ligne de commande pour créer, - éditer, composer ou convertir des images bitmap, et qui supporte un grand - nombre de formats d'image. Tux Paint utilise deux fonctions ("convert" et - "composite") pour générer des vignettes pour les images de démarrage et - des modèles durant le process de compilation. +ImageMagick est un ensemble d'outils en ligne de commande pour créer, éditer, +composer ou convertir des images bitmap, et qui supporte un grand nombre de +formats d'image. Tux Paint utilise deux fonctions ("convert" et "composite") +pour générer des vignettes pour les images de démarrage et des modèles durant +le process de compilation. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - N'oubliez pas de cocher "Installer les utilitaires hérités (par ex. - convert)" pour l'installation, car le processus de compilation de Tux - Paint les utilise. +N'oubliez pas de cocher "Installer les utilitaires hérités (par ex. convert)" +pour l'installation, car le processus de compilation de Tux Paint les utilise. - Ajoutez le chemin où ImageMagick est installé au début de votre variable - d'environnement "PATH". Par exemple : +Ajoutez le chemin où ImageMagick est installé au début de votre variable +d'environnement "PATH". Par exemple : - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre - fichier de configuration du shell BASH, "~/.bash_profile". +Vous pouvez rendre ceci permanent en ajoutant ce qui précède à votre fichier de +configuration du shell BASH, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - Tous les fichiers nécessaires pour démarrer Tux Paint (et Tux Paint - Config) sont rassemblés dans le répertoire de la distribution binaire - "bdist", répertoire situé sous "win323. Vous pouvez les démarrer en - double-cliquant leurs fichiers exéctutables (.exe) dans le répertoire - "bdist". +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup est utilisé pour construire l'installeur exécutable de Tux - Paint. Vous devez donc l'installer en premier. +Tous les fichiers nécessaires pour démarrer Tux Paint (et Tux Paint Config) +sont rassemblés dans le répertoire de la distribution binaire "bdist", +répertoire situé sous "win323. Vous pouvez les démarrer en double-cliquant +leurs fichiers exéctutables (.exe) dans le répertoire "bdist". - Officiellement Inno Setup prend en compte des traductions dans environ 20 - langues. Cependant, un des points majeurs de Tux Paint est qu'il supporte - beaucoup de langues. Aussi, le script de mise au point "tuxpaint.iss" qui - sert pour construire le programme d'installation est écrit en beaucoup - plus de langues, y compris des non-officielles qui sont disponibles sur - "Inno Setup Translations". Vous devez télécharger les fichiers de - traduction (.isl) qui sont requis et les mettre dans le répertoire - "Languages" sous le répertoire dans lequel Inno Setup est installé. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup est utilisé pour construire l'installeur exécutable de Tux Paint. +Vous devez donc l'installer en premier. - Alors, vous pouvez facilement construire un installateur exécutable en - cliquant-droit sur l'icône "tuxpaint.iss" du répertoires "win32" et - sélectionner "Compile" dans la liste. Cela prendra un certain temps, et - éventuellement vous obtiendrez un fichier - "tuxpaint-X.Y.Z-windows--installer.exe" dans le même répertoire. +Officiellement Inno Setup prend en compte des traductions dans environ 20 +langues. Cependant, un des points majeurs de Tux Paint est qu'il supporte +beaucoup de langues. Aussi, le script de mise au point "tuxpaint.iss" qui sert +pour construire le programme d'installation est écrit en beaucoup plus de +langues, y compris des non-officielles qui sont disponibles sur "Inno Setup +Translations". Vous devez télécharger les fichiers de traduction (.isl) qui +sont requis et les mettre dans le répertoire "Languages" sous le répertoire +dans lequel Inno Setup est installé. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Double-cliquez sur l'exécutable du programme d'installation de Tux Paint - (fichier .EXE) et suivez les instructions. +Alors, vous pouvez facilement construire un installateur exécutable en +cliquant-droit sur l'icône "tuxpaint.iss" du répertoires "win32" et +sélectionner "Compile" dans la liste. Cela prendra un certain temps, et +éventuellement vous obtiendrez un fichier "tuxpaint-X.Y.Z-windows- +-installer.exe" dans le même répertoire. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - Il vous sera ensuite demandé si vous souhaitez installer des raccourcis à - Tux Paint dans votre menu Démarrer de Windows et sur votre bureau - Windows.(Les deux options sont définies par défaut.) +Double-cliquez sur l'exécutable du programme d'installation de Tux Paint +(fichier .EXE) et suivez les instructions. - Puis, il vous sera demandé où vous souhaitez installer Tux Paint. La - valeur par défaut devrait convenir, tant qu'il y a de l'espace disponible. - Sinon, choisissez un autre emplacement. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint ! +Il vous sera ensuite demandé si vous souhaitez installer des raccourcis à Tux +Paint dans votre menu Démarrer de Windows et sur votre bureau Windows.(Les deux +options sont définies par défaut.) - Changing the Settings Using the Shortcut +Puis, il vous sera demandé où vous souhaitez installer Tux Paint. La valeur par +défaut devrait convenir, tant qu'il y a de l'espace disponible. Sinon, +choisissez un autre emplacement. - Pour modifier les paramètres du programme, cliquez avec le bouton droit - sur le raccourci TuxPaint et sélectionnez «Propriétés» (en bas). +À ce stade, vous pouvez cliquer sur «Installer» pour installer Tux Paint ! - Assurez-vous que l'onglet "Raccourci" est sélectionné dans la fenêtre qui - apparaît et examinez le champ «Cible:». Vous devriez voir quelque chose - comme ceci : +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +Pour modifier les paramètres du programme, cliquez avec le bouton droit sur le +raccourci TuxPaint et sélectionnez «Propriétés» (en bas). - Vous pouvez maintenant ajouter des options de ligne de commande qui seront - activées lorsque vous double-cliquez sur l'icône. +Assurez-vous que l'onglet "Raccourci" est sélectionné dans la fenêtre qui +apparaît et examinez le champ «Cible:». Vous devriez voir quelque chose comme +ceci : - Par exemple, pour faire fonctionner le jeu en mode plein écran, avec des - formes simples (pas d'option de rotation) et en français, ajoutez les - options (après 'TuxPaint.exe'), comme ceci : + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +Vous pouvez maintenant ajouter des options de ligne de commande qui seront +activées lorsque vous double-cliquez sur l'icône. - (Voir «README.txt» pour une liste complète des options de ligne de - commande disponibles.) +Par exemple, pour faire fonctionner le jeu en mode plein écran, avec des formes +simples (pas d'option de rotation) et en français, ajoutez les options (après +'TuxPaint.exe'), comme ceci : - Si vous faites une erreur ou que tout disparaît, utilisez [Control] + [Z] - pour annuler ou appuyez simplement sur la touche [Esc] et la boîte se - fermera sans aucune modification (sauf si vous avez appuyé sur le bouton - "Appliquer" !). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - Quand vous avez fini, appuyez sur "OK". +(Voir «README.txt» pour une liste complète des options de ligne de commande +disponibles.) - If Something Goes Wrong +Si vous faites une erreur ou que tout disparaît, utilisez [Control] + [Z] pour +annuler ou appuyez simplement sur la touche [Esc] et la boîte se fermera sans +aucune modification (sauf si vous avez appuyé sur le bouton "Appliquer" !). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +Quand vous avez fini, appuyez sur "OK". - Il contiendra une description de ce qui n'allait pas. Habituellement, ce - sera simplement dû à une casse de caractère incorrecte (majuscule 'Z' à la - place de 'z' minuscule) ou un '-' (tiret) manquant (en trop). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +Il contiendra une description de ce qui n'allait pas. Habituellement, ce sera +simplement dû à une casse de caractère incorrecte (majuscule 'Z' à la place de +'z' minuscule) ou un '-' (tiret) manquant (en trop). + + ----------------------------------------------------------------------- Linux/Unix - Compilation : +Compilation : - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - Pour compiler le programme à partir des sources, lancez simplement la - commande suivante après une invite shell (par ex. "$") : +Pour compiler le programme à partir des sources, lancez simplement la commande +suivante après une invite shell (par ex. "$") : - $ make + $ make - Désactivation du support SVG (donc des dépendances Cairo, libSVG, et - svg-cairo) +Désactivation du support SVG (donc des dépendances Cairo, libSVG, et svg-cairo) - Pour désactiver le support de SVG (par ex. si votre système n'a pas de - bibliothèque Cairo, ou d'autres choses dont SVG est dépendant), vous - pouvez exécuter "make" avec "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" : +Pour désactiver le support de SVG (par ex. si votre système n'a pas de +bibliothèque Cairo, ou d'autres choses dont SVG est dépendant), vous pouvez +exécuter "make" avec "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" : - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - Si vous n'avez pas de carte son ou si vous préférez créer le programme - sans support sonore (et donc sans dépendance SDL_mixer), vous pouvez - exécuter "make" avec "SDL_MIXER_LIB=" comme paramètre : +Si vous n'avez pas de carte son ou si vous préférez créer le programme sans +support sonore (et donc sans dépendance SDL_mixer), vous pouvez exécuter "make" +avec "SDL_MIXER_LIB=" comme paramètre : - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Diverses autres options (par exemple, les dossiers d'installation) peuvent - être remplacées; voir dans "Makefile" pour plus de détails. +Diverses autres options (par exemple, les dossiers d'installation) peuvent être +remplacées; voir dans "Makefile" pour plus de détails. - If you get errors +If you get errors - Si vous avez des erreurs lors de la compilation, assurez-vous d'avoir les - bibliothèques adéquates installées (voir ci-dessus). Si vous utilisez les - versions issues des paquets des bibliothèques (par exemple, les RPM sous - RedHat ou les DEB sous Debian), assurez-vous d'avoir choisi également les - packages "-dev" ou "-devel" correspondants, sinon vous ne pourrez pas - compiler Tux Paint (et d'autres programmes) provenant des sources ! +Si vous avez des erreurs lors de la compilation, assurez-vous d'avoir les +bibliothèques adéquates installées (voir ci-dessus). Si vous utilisez les +versions issues des paquets des bibliothèques (par exemple, les RPM sous RedHat +ou les DEB sous Debian), assurez-vous d'avoir choisi également les packages +"-dev" ou "-devel" correspondants, sinon vous ne pourrez pas compiler Tux Paint +(et d'autres programmes) provenant des sources ! - Installng +Installng - En supposant qu'aucune erreur fatale ne se soit produite, vous pouvez - maintenant installer le programme afin qu'il puisse être exécuté par les - utilisateurs du système. Par défaut, cela doit être effectué par - l'utilisateur "root" ("superutilisateur"). Passer à "root" en tapant la - commande : +En supposant qu'aucune erreur fatale ne se soit produite, vous pouvez +maintenant installer le programme afin qu'il puisse être exécuté par les +utilisateurs du système. Par défaut, cela doit être effectué par l'utilisateur +"root" ("superutilisateur"). Passer à "root" en tapant la commande : - $ su + $ su - Entrez le mot de passe de "root" à l'invite. Vous devriez maintenant être - "root" (avec une invite comme "#"). Pour installer le programme et ses - fichiers de données, tapez : +Entrez le mot de passe de "root" à l'invite. Vous devriez maintenant être +"root" (avec une invite comme "#"). Pour installer le programme et ses fichiers +de données, tapez : - # make install + # make install - Pour finir, vous pouvez revenir sur votre compte utilisateur en sortant du - compte superutilisateur : +Pour finir, vous pouvez revenir sur votre compte utilisateur en sortant du +compte superutilisateur : - # exit + # exit - Autre manière : vous faites simplement utilisation de la commande "sudo" - (par ex. sur Ubuntu) : +Autre manière : vous faites simplement utilisation de la commande "sudo" (par +ex. sur Ubuntu) : - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Changer où vont les fichiers +Changer où vont les fichiers - Vous pouvez changer où iront les fichiers en définissant des variables - pour "Makefile" sur la ligne de commande. "DESTDIR" est utilisé pour - indiquer la sortie des résultats de la compilation. "PREFIX" est la base - où tous les autres fichiers iront et est définie par défaut comme - "/usr/local". +Vous pouvez changer où iront les fichiers en définissant des variables pour +"Makefile" sur la ligne de commande. "DESTDIR" est utilisé pour indiquer la +sortie des résultats de la compilation. "PREFIX" est la base où tous les autres +fichiers iront et est définie par défaut comme "/usr/local". - Les autres variables sont : +Les autres variables sont : - BIN_PREFIX - Où le binaire "tuxpaint" sera installé. (Par défaut - "$(PREFIX)/bin", par ex. "/usr/local/bin") +BIN_PREFIX + Où le binaire "tuxpaint" sera installé. (Par défaut "$(PREFIX)/bin", par + ex. "/usr/local/bin") - DATA_PREFIX - Où les fichiers de données (sons, graphiques, pinceaux, tampons, - fontes) iront, et où Tux Paint ira les chercher pour tourner - (Réglé à "$(PREFIX)/share/tuxpaint") +DATA_PREFIX + Où les fichiers de données (sons, graphiques, pinceaux, tampons, fontes) + iront, et où Tux Paint ira les chercher pour tourner (Réglé à "$(PREFIX)/ + share/tuxpaint") - DOC_PREFIX - Où sera mise la documentation (les répertoires "docs". 'Réglé à - "$(PREFIX)/share/doc/tuxpaint") +DOC_PREFIX + Où sera mise la documentation (les répertoires "docs". 'Réglé à "$(PREFIX)/ + share/doc/tuxpaint") - MAN_PREFIX - Où ira la page de manuel de Tuxpaint (Réglé à - "$(PREFIX)/share/man") +MAN_PREFIX + Où ira la page de manuel de Tuxpaint (Réglé à "$(PREFIX)/share/man") - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Où iront les icônes et les lanceurs (pour GNOME et KDE) - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Où iront les fichiers de traduction, et où Tux Paint ira les chercher. + (Réglé à "$(PREFIX)/share/locale/") (la destination finale de la traduction + sera dans le répertoire de la locale (par ex "es" pour l'espagnol, dans le + sous-répertoire "LC_MESSAGES"). - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Où iront les icônes et les lanceurs (pour GNOME et KDE) +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Où iront les fichiers de traduction, et où Tux Paint ira les - chercher. (Réglé à "$(PREFIX)/share/locale/") (la destination - finale de la traduction sera dans le répertoire de la locale (par - ex "es" pour l'espagnol, dans le sous-répertoire "LC_MESSAGES"). - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - juin 5, 2022 Mark Kim +juin 5, 2022 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prérequis +Prérequis - Bien Tux Paint puisse être construit sans Xcode IDE, ce dernier est - toujours nécessaire. Téléchargez le = partir de l' the App Store, et - lancez le une fois pour accepter ses accords de licence. Vous pouvez aussi - installer les outils de ligne de commande de Xcode en tapant la commande : +Bien Tux Paint puisse être construit sans Xcode IDE, ce dernier est toujours +nécessaire. Téléchargez le = partir de l' the App Store, et lancez le une fois +pour accepter ses accords de licence. Vous pouvez aussi installer les outils de +ligne de commande de Xcode en tapant la commande : - $ xcode-select --install + $ xcode-select --install - Construire Tux Paint nécessite plusieurs bibliothèques. Nous les - installons à partir de MacPorts quand c'est possible, sinon à partir du - code source. Installez MacPorts avec le chemin par défaut /opt/local - suivant les instructions données sur leur site : https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... mais vous devriez installer tout paquet requis par la dernière version - de Tux Paint. +Construire Tux Paint nécessite plusieurs bibliothèques. Nous les installons à +partir de MacPorts quand c'est possible, sinon à partir du code source. +Installez MacPorts avec le chemin par défaut /opt/local suivant les +instructions données sur leur site : https://www.macports.org/ - ^* Non disponible depuis MacPorts à ce moment, voir ci-dessous. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... mais vous devriez installer tout paquet requis par la dernière version de +Tux Paint. - libimagequant n'est pas disponible sur MacPorts à cette heure. Il peut - être installé sur /opt/local (comme pour MacPorts) pour la bibliothèque - devant être incluse dans TuxPaint.dmg. +^* Non disponible depuis MacPorts à ce moment, voir ci-dessous. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant n'est pas disponible sur MacPorts à cette heure. Il peut être +installé sur /opt/local (comme pour MacPorts) pour la bibliothèque devant être +incluse dans TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - ATTENTION :Posséder des outils Unix à côté de MacPorts et Xcode, tels que - Fink ou Brew, vous empêchera de créer un programme portable. V"rifiez que - Fink et Brew ne soient pas accessibles via votre environnement de travail. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - Comment construire + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Tapez simplement : +ATTENTION :Posséder des outils Unix à côté de MacPorts et Xcode, tels que Fink +ou Brew, vous empêchera de créer un programme portable. V"rifiez que Fink et +Brew ne soient pas accessibles via votre environnement de travail. - % make - % make install +Comment construire - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Tapez simplement : - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Problèmes connus +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * Un binaire macOS construit sur une version spécifique de macOS ne - fonctionnera qu'avec cette version, ou une plus récente. Pour - s'assurer que Tux Paint puisse tourner sur la plus vieille version de - macOS possible, construisez le sur la plus vieille version de macOS - disponible. Au moment où nous écrivons Tux Paint ne peut être - construit pour tourner sur macOS 10.7 ou plus récent. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - Voyez "Vieilles Versions de macOS" ci-dessous pour les meilleures - instructions pour obtenir, installer et construire Tux Paint sur des - vieilles versions de macOS. +Problèmes connus - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * Un binaire macOS construit sur une version spécifique de macOS ne + fonctionnera qu'avec cette version, ou une plus récente. Pour s'assurer que + Tux Paint puisse tourner sur la plus vieille version de macOS possible, + construisez le sur la plus vieille version de macOS disponible. Au moment + où nous écrivons Tux Paint ne peut être construit pour tourner sur macOS + 10.7 ou plus récent. - Vieilles versions de macOS + Voyez "Vieilles Versions de macOS" ci-dessous pour les meilleures + instructions pour obtenir, installer et construire Tux Paint sur des + vieilles versions de macOS. - Quelques vieilles versions de macOS peuvent être téléchargées sur la page - d'aide d'Apple : https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Vieilles versions de macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Quelques vieilles versions de macOS peuvent être téléchargées sur la page +d'aide d'Apple : https://support.apple.com/en-us/HT211683 - À ce moment, l'ancienne version de macOS disponible sur le site d'Apple - est la Yosemite 10.10, qui un partitionnement "GPT (GUID Partition Table)" - au lieu de MBR, et "Mac OS Extended (Journalisé)" comme type de partition - au lieu du nouveau type APFS. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Au lancement de l'installateur, si vous avez un message disant que macOD - est trop vieux ou trop récent pour être installé, un installateur bootable - peut être créé en suivant les instructions données ici : - https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Une fois l'ancienne version de macOS installée, vous pouvez trouver que le - Xcode du App Store est trop récent pour tourner sur la version du vieux - macOS. Des anciennes versions de Xcode peuvent être téléchargées sur le - site des développeurs d'Apple dans une zone accessible après - enregistrement gratuit : https://developer.apple.com/download/more/ +À ce moment, l'ancienne version de macOS disponible sur le site d'Apple est la +Yosemite 10.10, qui un partitionnement "GPT (GUID Partition Table)" au lieu de +MBR, et "Mac OS Extended (Journalisé)" comme type de partition au lieu du +nouveau type APFS. - La liste des versions de macOS et de la dernière version de Xcode - compatible avec celle-ci a été gentiment mise sur la page Wikipedia sur - Xcode : https://en.wikipedia.org/wiki/Xcode#Table de comparaison des - versions +Au lancement de l'installateur, si vous avez un message disant que macOD est +trop vieux ou trop récent pour être installé, un installateur bootable peut +être créé en suivant les instructions données ici : https://support.apple.com/ +en-mide/HT201372 - Comme Xcode a été installé manuellement, vous pouvez sauter l'étape - d'installation des outils de commande en terminal (ne pas exécuter - "xcode-select --install") mais alors vous compilez Tux Paint en utilisant - les mêmes étapes décrites auparavant dans ce document. +Une fois l'ancienne version de macOS installée, vous pouvez trouver que le +Xcode du App Store est trop récent pour tourner sur la version du vieux macOS. +Des anciennes versions de Xcode peuvent être téléchargées sur le site des +développeurs d'Apple dans une zone accessible après enregistrement gratuit : +https://developer.apple.com/download/more/ - Recompiling MacPorts +La liste des versions de macOS et de la dernière version de Xcode compatible +avec celle-ci a été gentiment mise sur la page Wikipedia sur Xcode : https:// +en.wikipedia.org/wiki/Xcode#Table de comparaison des versions - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +Comme Xcode a été installé manuellement, vous pouvez sauter l'étape +d'installation des outils de commande en terminal (ne pas exécuter +"xcode-select --install") mais alors vous compilez Tux Paint en utilisant les +mêmes étapes décrites auparavant dans ce document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - mars 29, 2023 Pere Pujal i Carabantes (Edited by - Bill Kendrick) +mars 29, 2023 Pere Pujal i Carabantes (Edited by Bill +Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prérequis +Prérequis - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - mai 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) +mai 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) - Prérequis +Prérequis - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Débogage +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Le débogage — vers "STDOUT", avec Linux et Unix, vers un fichier - "stdout.txt"avec Windows, et vers le fichier "/tmp/tuxpaint.log" avec - macOS — peut être activé en définissant "DEBUG" (et, si un mode verbeux - est souhaité, "VERBOSE") # define dans "src/debug.h, et en (re)compilant - Tux Paint. +Débogage - Désinstallation de Tux Paint +⚙ Le débogage — vers "STDOUT", avec Linux et Unix, vers un fichier +"stdout.txt"avec Windows, et vers le fichier "/tmp/tuxpaint.log" avec macOS — +peut être activé en définissant "DEBUG" (et, si un mode verbeux est souhaité, +"VERBOSE") # define dans "src/debug.h, et en (re)compilant Tux Paint. + +Désinstallation de Tux Paint Windows - Utilisation du désinstalleur +Utilisation du désinstalleur - Si vous avez installé les raccourcis du menu Démarrer (par défaut), - accédez au dossier TuxPaint et sélectionnez "Désinstaller". Une boîte - s'affichera qui confirme que vous êtes sur le point de désinstaller Tux - Paint et, si vous en êtes certain et que vous souhaitez supprimer - définitivement Tux Paint, cliquez sur le bouton 'Désinstaller'. +Si vous avez installé les raccourcis du menu Démarrer (par défaut), accédez au +dossier TuxPaint et sélectionnez "Désinstaller". Une boîte s'affichera qui +confirme que vous êtes sur le point de désinstaller Tux Paint et, si vous en +êtes certain et que vous souhaitez supprimer définitivement Tux Paint, cliquez +sur le bouton 'Désinstaller'. - Quand c'est fini, cliquez sur "Fermer". +Quand c'est fini, cliquez sur "Fermer". - En utilisant le panneau de configuration +En utilisant le panneau de configuration - Il est également possible d'utiliser l'entrée "TuxPaint (supprimer - uniquement)" dans la Section Ajout / Suppression de programmes du Panneau - de configuration. +Il est également possible d'utiliser l'entrée "TuxPaint (supprimer uniquement)" +dans la Section Ajout / Suppression de programmes du Panneau de configuration. macOS - Enlevez "TuxPaint.app" du dossier "Applications". Les fichiers de données - les fichiers de configuration, les tampons et les images sauvegardées - peuvent être trouvées dans "/Library/Application Support/TuxPaint" (pour - tous les utilisateurs) et "/Users/USERNAME/Library/Application - Support/TuxPaint" pour les utilisateurs individuels. +Enlevez "TuxPaint.app" du dossier "Applications". Les fichiers de données les +fichiers de configuration, les tampons et les images sauvegardées peuvent être +trouvées dans "/Library/Application Support/TuxPaint" (pour tous les +utilisateurs) et "/Users/USERNAME/Library/Application Support/TuxPaint" pour +les utilisateurs individuels. Linux - Dans le répertoire source de Tux Paint (où vous avez compilé Tux Paint), - vous pouvez utiliser une cible "make uninstall" pour désinstaller Tux - Paint. Par défaut, cela doit être fait par l'utilisateur "root" - ("superutilisateur"), mais si vous avez installé Tux Paint à un autre - endroit (par ex. en mettant "PREFIX=..." à "make" et "make install", vous - ne pourrez pas, et il faudra fournir les mêmes réglages ici. (Voir x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Informational + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Informational - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Getting Help +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Getting Help - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Glossary +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Glossary + + * alpha: See "RGBA" + * &: See "ampersand" + * ampersand (pointers): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * ampersand (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bit" + * API: Application Programming Interface. TBD + * argument: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * backtick: See "grave" + * bit: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "byte" + * blue: See "RGBA" + * boolean 'or': A mathematical operation that results in a true value if + either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 + | 0" results in "0".) + * |: See "boolean 'or'" + * .: See "dot" + * `: See "grave" + * *: See "star" + * byte: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * callback: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * channel: TBD + * click: The action of pressing a button on a mouse. + * coordinates: A set of numbers corresponding to a physical position; for + example, in a two-dimensional (2D) image, "X" and "Y" coordinates specify + the position across (left-to-right) and down the image, respectively. In + SDL, the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * dimensions: The size of an object, in terms of its width (left to right) + and height (top to bottom). + * .dll: See "Shared Object" + * dot: ".". A symbol in C that references an element within a struct. + * drag: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "floating point" + * floating point: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * green: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * header: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * hue: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * linear: TBD + * macro: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Plugin: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * prototype: See "C function prototype" + * red: See "RGBA" + * release: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "ampersand" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * unsigned: In C, a variable that can store a numeric value can be declared + as either "signed" (the default), or "unsigned". In the former case, one + bit of the value is used to denote the sign of the value (either positive + or negative). In the latter case, the value can only be positive, but + benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * value: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Dimensions" + * (x,y): See "Coordinates" - * alpha: See "RGBA" - * &: See "ampersand" - * ampersand (pointers): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * ampersand (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bit" - * API: Application Programming Interface. TBD - * argument: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * backtick: See "grave" - * bit: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "byte" - * blue: See "RGBA" - * boolean 'or': A mathematical operation that results in a true value if - either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in - "1". "0 | 0" results in "0".) - * |: See "boolean 'or'" - * .: See "dot" - * `: See "grave" - * *: See "star" - * byte: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * callback: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * channel: TBD - * click: The action of pressing a button on a mouse. - * coordinates: A set of numbers corresponding to a physical position; - for example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * dimensions: The size of an object, in terms of its width (left to - right) and height (top to bottom). - * .dll: See "Shared Object" - * dot: ".". A symbol in C that references an element within a struct. - * drag: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "floating point" - * floating point: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * green: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * header: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * hue: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * linear: TBD - * macro: A C construct that looks similar to a C function, but is simply - a #define that is expanded 'inline'. For example, if you declared the - macro "#define ADD(A,B) ((A)+(B))", and then used it with "c = - ADD(1,2);", that line of code would literally expand to "c = ((1) + - (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Plugin: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * prototype: See "C function prototype" - * red: See "RGBA" - * release: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "ampersand" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * unsigned: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * value: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Dimensions" - * (x,y): See "Coordinates" diff --git a/docs/fr_FR.UTF-8/OPTIONS.txt b/docs/fr_FR.UTF-8/OPTIONS.txt index 4f422e3ed..238c15356 100644 --- a/docs/fr_FR.UTF-8/OPTIONS.txt +++ b/docs/fr_FR.UTF-8/OPTIONS.txt @@ -1,2094 +1,2247 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Documentation sur les options + Documentation sur les options Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juillet 13, 2023 + juillet 13, 2023 - +---------------------------------------------------------------------+ - |Table des matières | - |---------------------------------------------------------------------| - | * Configuration de Tux Paint. | - | * Fichier de configuration | - | * Options disponibles | - | * Vidéo/Son | - | * Souris/Clavier | - | * Simplification | - | * Langues | - | * Impression | - | * Sauvegarde | - | * Données | - | * Accessibilité | - | * Joystick | - | * Écraser des options de System Config | - | * Options de ligne de commande | - | * Options d'information en ligne de commande | - | * Choisir une autre langue | - | * Langues disponibles | - | * Définition des paramètres régionaux de votre environnement | - | * Polices spéciales | - +---------------------------------------------------------------------+ ++--------------------------------------------------------------------+ +| Table des matières | +|--------------------------------------------------------------------| +| * Configuration de Tux Paint. | +| * Fichier de configuration | +| * Options disponibles | +| + Vidéo/Son | +| + Souris/Clavier | +| + Simplification | +| + Langues | +| + Impression | +| + Sauvegarde | +| + Données | +| + Accessibilité | +| + Joystick | +| * Écraser des options de System Config | +| * Options de ligne de commande | +| + Options d'information en ligne de commande | +| * Choisir une autre langue | +| + Langues disponibles | +| + Définition des paramètres régionaux de votre environnement | +| + Polices spéciales | ++--------------------------------------------------------------------+ - Configuration de Tux Paint. +Configuration de Tux Paint. - Un outil graphique est disponible qui vous permet de changer le - comportement de Tux Paint. Cependant, si vous préférez ne pas installer et - utiliser cet outil, ou si vous souhaitez mieux comprendre les options - disponibles, poursuivez la lecture. +Un outil graphique est disponible qui vous permet de changer le comportement de +Tux Paint. Cependant, si vous préférez ne pas installer et utiliser cet outil, +ou si vous souhaitez mieux comprendre les options disponibles, poursuivez la +lecture. - Fichier de configuration +Fichier de configuration - Vous pouvez créer un fichier de configuration simple pour Tux Paint, qu'il - lira à chaque démarrage. +Vous pouvez créer un fichier de configuration simple pour Tux Paint, qu'il lira +à chaque démarrage. - Le fichier est simplement un fichier texte contenant les options que vous - souhaitez activer : +Le fichier est simplement un fichier texte contenant les options que vous +souhaitez activer : Utilisateurs de Linux et Unix - Le fichier que vous devez créer s'appelle ".tuxpaintrc" et il doit être - placé dans votre répertoire personnel. (aka "~/.tuxpaintrc" ou - "$HOME/.tuxpaintrc") +Le fichier que vous devez créer s'appelle ".tuxpaintrc" et il doit être placé +dans votre répertoire personnel. (aka "~/.tuxpaintrc" ou "$HOME/.tuxpaintrc") - Fichier de configuration pour l'ensemble du système +Fichier de configuration pour l'ensemble du système - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf Utilisateurs de macOS - Le fichier que vous devez créer s'appelle "tuxpaint.cfg" et il doit être - placé dans votre dossier de départ, sous le sous-dossier : - Library/Application Support/TuxPaint +Le fichier que vous devez créer s'appelle "tuxpaint.cfg" et il doit être placé +dans votre dossier de départ, sous le sous-dossier : Library/Application +Support/TuxPaint - Fichier de configuration pour l'ensemble du système +Fichier de configuration pour l'ensemble du système - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Utilisateurs de Windows - The file you should create is called "tuxpaint.cfg" and it should be - placed in in your personal AppData folder: C:\Users\nom - d'utilisateur\AppData\Roaming\TuxPaint\ +The file you should create is called "tuxpaint.cfg" and it should be placed in +in your personal AppData folder: C:\Users\nom d'utilisateur\AppData\Roaming\ +TuxPaint\ - Vous pouvez utiliser NotePad ou WordPad pour créer ce fichier. - Assurez-vous de l'enregistrer en tant que texte brut et assurez-vous que - le nom de fichier ne contient pas ".txt" à la fin ... +Vous pouvez utiliser NotePad ou WordPad pour créer ce fichier. Assurez-vous de +l'enregistrer en tant que texte brut et assurez-vous que le nom de fichier ne +contient pas ".txt" à la fin ... - Fichier de configuration pour l'ensemble du système +Fichier de configuration pour l'ensemble du système - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ You can disable reading of this file altogether, leaving the settings as - defaults (which can then be overridden by your personal config. file - and/or command-line arguments) by using the command-line option - "--nosysconfig". +⚙ You can disable reading of this file altogether, leaving the settings as +defaults (which can then be overridden by your personal config. file and/or +command-line arguments) by using the command-line option "--nosysconfig". - Options disponibles +Options disponibles - Les paramètres suivants peuvent être définis dans le fichier de - configuration. (Les paramètres de ligne de commande les remplaceront. - Reportez-vous à la section "Options de ligne de commande " ci-dessous.) +Les paramètres suivants peuvent être définis dans le fichier de configuration. +(Les paramètres de ligne de commande les remplaceront. Reportez-vous à la +section "Options de ligne de commande " ci-dessous.) Vidéo/Son - Video +Video - fullscreen=yes +fullscreen=yes - Le programme tourne en plein écran plutôt que dans une fenêtre. + Le programme tourne en plein écran plutôt que dans une fenêtre. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "fullscreen=no". - In both cases, may be overridden by the command-line option - "--windowed". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "fullscreen=no". In both cases, may be + overridden by the command-line option "--windowed". - fullscreen=native - Le programme tourne plein écran, en adoptant la résolution - actuelle de l'écran (définie par le système d'exploitation). - windowsize=SIZE +fullscreen=native - Exécute le programme à une taille différente (en mode fenêtré) ou - à une résolution d'écran différente (en mode plein écran), plutôt - que la valeur par défaut (généralement 800x600). + Le programme tourne plein écran, en adoptant la résolution actuelle de + l'écran (définie par le système d'exploitation). - La valeur SIZE doit être exprimée en pixels, au format «largeur - par hauteur», avec un «x» (X minuscule) entre les deux valeurs. La - taille peut être au minimum 640 de large et au minimum 480 de - haut. - Quelques exemples : - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=SIZE - 💡 If only one display is available, and Tux Paint is being run in - windowed (not fullscreen) mode, and the chosen window size exceeds - the capabilities of the display, Tux Paint will fall back to the - display's dimensions. + Exécute le programme à une taille différente (en mode fenêtré) ou à une + résolution d'écran différente (en mode plein écran), plutôt que la valeur + par défaut (généralement 800x600). - orient=portrait + La valeur SIZE doit être exprimée en pixels, au format «largeur par + hauteur», avec un «x» (X minuscule) entre les deux valeurs. La taille peut + être au minimum 640 de large et au minimum 480 de haut. - Permute les options de largeur / hauteur données à Tux Paint, - utile pour faire pivoter la fenêtre pour les affichages de - portait, comme un écran PC orientée comme une tablette. + Quelques exemples : - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 If only one display is available, and Tux Paint is being run in windowed + (not fullscreen) mode, and the chosen window size exceeds the capabilities + of the display, Tux Paint will fall back to the display's dimensions. - Lorsque vous exécutez Tux Paint en mode plein écran, cela suppose - la résolution actuelle de l'écran (remplaçant toute option - "windowsize"), est celle définie par le système d'exploitation. - allowscreensaver=yes - Par défaut, Tux Paint empêche l'économiseur d'écran de votre - système de démarrer. Vous pouvez remplacer cela en utilisant - l'option "allowscreensaver". Remarque : Cela nécessite la version - 1.2.12 ou supérieure de la bibliothèque SDL. (Vous pouvez - également le faire en définissant la variable d'environnement - "SDL_VIDEO_ALLOW_SCREENSAVER" de votre système égale à "1".) +orient=portrait - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both cases, - may be overridden by the command-line option - "--disablescreensaver". + Permute les options de largeur / hauteur données à Tux Paint, utile pour + faire pivoter la fenêtre pour les affichages de portait, comme un écran PC + orientée comme une tablette. - Son + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "orient=landscape". In both cases, may + be overridden by the command-line option "--orient=landscape". - nosound=yes - Désactive les effets sonores. (Remarque: le fait d'appuyer sur - [Alt] + [S] ne peut pas être utilisé pour réactiver les sons s'ils - ont été désactivés à l'aide de cette option.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" or - "sound=yes". In both cases, may be overridden by the command-line - option "--sound". +native=yes - nostereo=yes + Lorsque vous exécutez Tux Paint en mode plein écran, cela suppose la + résolution actuelle de l'écran (remplaçant toute option "windowsize"), est + celle définie par le système d'exploitation. - Désactive la prise en charge de la stéréo. (Utile pour les - utilisateurs ayant une déficience auditive avec une oreille ou - dans les endroits où un seul haut-parleur ou casque est utilisé.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" or - "stereo=yes". In both cases, may be overridden by the command-line - option "--stereo". - Taille de l'interface +allowscreensaver=yes - buttonsize=SIZE + Par défaut, Tux Paint empêche l'économiseur d'écran de votre système de + démarrer. Vous pouvez remplacer cela en utilisant l'option + "allowscreensaver". Remarque : Cela nécessite la version 1.2.12 ou + supérieure de la bibliothèque SDL. (Vous pouvez également le faire en + définissant la variable d'environnement "SDL_VIDEO_ALLOW_SCREENSAVER" de + votre système égale à "1".) - Règle la taille en pixel des boutons de l'interface de Tux Paint - (remplaçant la valeur de "48" par défaut). Utile quand on utilise - des affichage de haute densité, ou bien des dispositifs avec - entrée peu précise comme ceux avec suivi du regard. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "allowscreensaver=no" or + "disablescreensaver=yes". In both cases, may be overridden by the + command-line option "--disablescreensaver". - La valeur de SIZE doit être exprimée en pixels, et peut être - comprise entre 24 et 192, inclusivement. La plupart des boutons - sont carrés, et cela affecte leur largeur et hauteur. - A value of "auto" may be provided, and Tux Paint will choose a - suitable button size based on the size of Tux Paint's window (or - fullscreen display). (For the default screen size of 800x600, it - will be the default button size: "48".) - 💡 Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux Paint's - chosen window size, the largest possible button size will be used. - (A note will appear in stderr.) - colorsrows=ROWS +Son + +nosound=yes + + Désactive les effets sonores. (Remarque: le fait d'appuyer sur [Alt] + [S] + ne peut pas être utilisé pour réactiver les sons s'ils ont été désactivés à + l'aide de cette option.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nosound=no" or "sound=yes". In both + cases, may be overridden by the command-line option "--sound". + + + +nostereo=yes + + Désactive la prise en charge de la stéréo. (Utile pour les utilisateurs + ayant une déficience auditive avec une oreille ou dans les endroits où un + seul haut-parleur ou casque est utilisé.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostereo=no" or "stereo=yes". In both + cases, may be overridden by the command-line option "--stereo". + + + + +Taille de l'interface + +buttonsize=SIZE + + Règle la taille en pixel des boutons de l'interface de Tux Paint + (remplaçant la valeur de "48" par défaut). Utile quand on utilise des + affichage de haute densité, ou bien des dispositifs avec entrée peu précise + comme ceux avec suivi du regard. + + La valeur de SIZE doit être exprimée en pixels, et peut être comprise entre + 24 et 192, inclusivement. La plupart des boutons sont carrés, et cela + affecte leur largeur et hauteur. + + A value of "auto" may be provided, and Tux Paint will choose a suitable + button size based on the size of Tux Paint's window (or fullscreen + display). (For the default screen size of 800x600, it will be the default + button size: "48".) + + 💡 Note: If the chosen button size would cause the buttons to be too large + for all required UI elements to appear under Tux Paint's chosen window + size, the largest possible button size will be used. (A note will appear in + stderr.) + + + +colorsrows=ROWS + + Combien de rangées de boutons pour les couleurs peuvent être montrées; + utile quand on a une grande palette (voir "colorfile ci-dessus), et/ou pour + utiliser avec des dispositifs de pointage peu précis (par ex avec + oculomètres). "ROWS" peut être entre "1" (par défaut) et "3". + + - Combien de rangées de boutons pour les couleurs peuvent être - montrées; utile quand on a une grande palette (voir "colorfile - ci-dessus), et/ou pour utiliser avec des dispositifs de pointage - peu précis (par ex avec oculomètres). "ROWS" peut être entre "1" - (par défaut) et "3". Souris/Clavier - Curseur +Curseur - nofancycursors=yes +nofancycursors=yes - Cela désactive les formes fantaisistes de pointeur de souris dans - Tux Paint et utilise le pointeur de souris normal de votre - environnement. + Cela désactive les formes fantaisistes de pointeur de souris dans Tux Paint + et utilise le pointeur de souris normal de votre environnement. - Dans certains environnements, les curseurs sophistiqués posent des - problèmes. Utilisez cette option pour les éviter. + Dans certains environnements, les curseurs sophistiqués posent des + problèmes. Utilisez cette option pour les éviter. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nofancycursors=no" or "fancycursors= + yes". In both cases, may be overridden by the command-line option + "--fancycursors". - hidecursor=yes - Cela masque complètement les formes du pointeur de la souris dans - Tux Paint. - Ceci est utile pour les appareils à écran tactile, tels que les - tablettes PC. +hidecursor=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "hidecursor=no" - or "showcursor=yes". In both cases, may be overridden by the - command-line option "--showcursor". + Cela masque complètement les formes du pointeur de la souris dans Tux + Paint. - Clavier + Ceci est utile pour les appareils à écran tactile, tels que les tablettes + PC. - noshortcuts=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "hidecursor=no" or "showcursor=yes". In + both cases, may be overridden by the command-line option "--showcursor". - Cela désactive les raccourcis clavier (par exemple [Ctrl]-[S] pour - enregistrer, [Ctrl]-[N] pour une nouvelle image, etc.) - Ceci est utile pour éviter que des commandes indésirables ne - soient activées par des enfants qui n'ont pas d'expérience avec - les claviers. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noshortcuts=no" - or "shortcuts=yes". In both cases, may be overridden by the - command-line option "--shortcuts". - Souris +Clavier - grab=yes +noshortcuts=yes - Tux Paint essaiera de «saisir» la souris et le clavier, en sorte - que la souris reste confinée dans la fenêtre de Tux Paint et que - presque toutes les entrées du clavier lui soient transmises - directement. + Cela désactive les raccourcis clavier (par exemple [Ctrl]-[S] pour + enregistrer, [Ctrl]-[N] pour une nouvelle image, etc.) - Ceci est utile pour désactiver les actions du système - d'exploitation qui pourraient faire sortir l'utilisateur de Tux - Paint [Alt]-[Tab] (changement de fenêtre), [Ctrl]-[Escape], etc. - Ceci est particulièrement utile en mode plein écran. + Ceci est utile pour éviter que des commandes indésirables ne soient + activées par des enfants qui n'ont pas d'expérience avec les claviers. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In + both cases, may be overridden by the command-line option "--shortcuts". - nowheelmouse=yes - Cela désactive la prise en charge de la molette pour les souris - qui en ont. (Normalement, la molette fait défiler le menu du - sélecteur sur la droite.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". - nobuttondistinction=yes +Souris + +grab=yes + + Tux Paint essaiera de «saisir» la souris et le clavier, en sorte que la + souris reste confinée dans la fenêtre de Tux Paint et que presque toutes + les entrées du clavier lui soient transmises directement. + + Ceci est utile pour désactiver les actions du système d'exploitation qui + pourraient faire sortir l'utilisateur de Tux Paint [Alt]-[Tab] (changement + de fenêtre), [Ctrl]-[Escape], etc. Ceci est particulièrement utile en mode + plein écran. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "grab=no" or "dontgrab=yes". In both + cases, may be overridden by the command-line option "--dontgrab". + + + +nowheelmouse=yes + + Cela désactive la prise en charge de la molette pour les souris qui en ont. + (Normalement, la molette fait défiler le menu du sélecteur sur la droite.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". + In both cases, may be overridden by the command-line option "--wheelmouse". + + + +nobuttondistinction=yes + + Avant Tux Paint 0.9.15, les boutons du milieu et de droite d'une souris + pouvaient également être utilisés pour cliquer. Dans la version 0.9.15, + cela a été modifié afin que seul le bouton gauche de la souris fonctionne, + pour de ne pas habituer les enfants à utiliser un mauvais bouton. + + Cependant, pour les enfants qui ont des problèmes avec la souris, cette + distinction entre les deux ou trois boutons d'une souris peut être + désactivée (ramenant Tux Paint à son ancien comportement) grâce à cette + option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobuttondistinction=no" or + "buttondistinction=yes". In both cases, may be overridden by the + command-line option "--buttondistinction". - Avant Tux Paint 0.9.15, les boutons du milieu et de droite d'une - souris pouvaient également être utilisés pour cliquer. Dans la - version 0.9.15, cela a été modifié afin que seul le bouton gauche - de la souris fonctionne, pour de ne pas habituer les enfants à - utiliser un mauvais bouton. - Cependant, pour les enfants qui ont des problèmes avec la souris, - cette distinction entre les deux ou trois boutons d'une souris - peut être désactivée (ramenant Tux Paint à son ancien - comportement) grâce à cette option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". Simplification - Simplification de l'interface +Simplification de l'interface - simpleshapes=yes +simpleshapes=yes - Désactive la possibilité de rotation avec l'outil «Forme». - Cliquer, faire glisser et relâcher, voilà tout ce qui sera - possible pour dessiner une forme. + Désactive la possibilité de rotation avec l'outil «Forme». Cliquer, faire + glisser et relâcher, voilà tout ce qui sera possible pour dessiner une + forme. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "simpleshapes=no" or "complexshapes= + yes". In both cases, may be overridden by the command-line option + "--complexshapes". - nooutlines=yes - Dans ce mode, des contours beaucoup plus simples et des lignes - «élastiques» sont affichés lors de l'utilisation des outils Ligne - , Forme , Tampon et Gomme . - Cela peut aider lorsque Tux Paint est exécuté sur des ordinateurs - très lents ou affiché sur un écran X-Window distant. +nooutlines=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nooutlines=no" - or "outlines=yes". In both cases, may be overridden by the - command-line option "--outlines". + Dans ce mode, des contours beaucoup plus simples et des lignes «élastiques» + sont affichés lors de l'utilisation des outils Ligne , Forme , Tampon et + Gomme . - uppercase=yes + Cela peut aider lorsque Tux Paint est exécuté sur des ordinateurs très + lents ou affiché sur un écran X-Window distant. - Tout le texte sera rendu uniquement en majuscules (par exemple, - "Boule" deviendra "BOULE"). Utile pour les enfants qui savent - lire, mais qui n'ont appris que les majuscules jusqu'à présent. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nooutlines=no" or "outlines=yes". In + both cases, may be overridden by the command-line option "--outlines". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". - Taille initiale du tampon - stampsize=SIZE +uppercase=yes - Utilisez cette option pour forcer Tux Paint à définir la taille de - départ de tous les tampons. La valeur SIZE doit être comprise - entre 0 (le plus petit) et 10 (le plus grand). La taille est - relative aux tailles disponibles du tampon, qui dépendent du - tampon lui-même, et de la taille actuelle de la toile de Tux - Paint. + Tout le texte sera rendu uniquement en majuscules (par exemple, "Boule" + deviendra "BOULE"). Utile pour les enfants qui savent lire, mais qui n'ont + appris que les majuscules jusqu'à présent. - Spécifiez "default" pour laisser Tux Paint décider (c'est un - comportement standard). + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "uppercase=no" or "mixedcase=yes". In + both cases, may be overridden by the command-line option "--mixedcase". - Simplification du contrôle - noquit=yes - Désactive le bouton "Quitter" à l'écran et empêche la touche - [Escape] de quitter Tux Paint . - Utiliser la combinaison de touches [Alt] + [F4] ou cliquer sur le - bouton de fermeture de la fenêtre (en supposant que vous n'êtes - pas en mode plein écran) fonctionne toujours pour quitter Tux - Paint . +Taille initiale du tampon - Vous pouvez également utiliser la combinaison de touches suivante - pour quitter : [Shift] + [Control] + [Escape]. +stampsize=SIZE - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Utilisez cette option pour forcer Tux Paint à définir la taille de départ + de tous les tampons. La valeur SIZE doit être comprise entre 0 (le plus + petit) et 10 (le plus grand). La taille est relative aux tailles + disponibles du tampon, qui dépendent du tampon lui-même, et de la taille + actuelle de la toile de Tux Paint. - nostamps=yes + Spécifiez "default" pour laisser Tux Paint décider (c'est un comportement + standard). - Cette option indique à Tux Paint de ne charger aucune image de - tampon en caoutchouc, ce qui entraîne la désactivation de l' outil - Tampons . - Cela peut accélérer Tux Paint au démarrage et réduire - l'utilisation de la mémoire pendant son exécution. Bien entendu, - aucun timbre ne sera disponible. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" or - "stamps=yes". In both cases, may be overridden by the command-line - option "--stamps". - nostampcontrols=yes +Simplification du contrôle - Certaines images de l' outil Tampon peuvent être mises en miroir, - inversées et / ou voir leur taille modifiée. Cette option - désactive ces contrôles et ne fournit que les tampons de base. +noquit=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be - overridden by the command-line option "--stampcontrols". + Désactive le bouton "Quitter" à l'écran et empêche la touche [Escape] de + quitter Tux Paint . - nostamprotation=yes + Utiliser la combinaison de touches [Alt] + [F4] ou cliquer sur le bouton de + fermeture de la fenêtre (en supposant que vous n'êtes pas en mode plein + écran) fonctionne toujours pour quitter Tux Paint . - This disables the rotation step of the Stamps tool, immediately - placing the stamp in its regular orientation (with any flipping or - mirroring applied) on the first click. + Vous pouvez également utiliser la combinaison de touches suivante pour + quitter : [Shift] + [Control] + [Escape]. - 📜 Note: The stamp rotation feature was added to Tux Paint in - version 0.9.29. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noquit=no" or "quit=yes". In both + cases, may be overridden by the command-line option "--quit". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostamprotation=no" or "stamprotation=yes". In both cases, may be - overridden by the command-line option "--stamprotation". - nomagiccontrols=yes - Certains outils Magie ont la possibilité d'agir comme un pinceau - ou d'affecter la toile entière. Cette option désactive les - contrôles et ne fournit que la fonctionnalité par défaut - (généralement en mode peinture). +nostamps=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be - overridden by the command-line option "--magiccontrols". + Cette option indique à Tux Paint de ne charger aucune image de tampon en + caoutchouc, ce qui entraîne la désactivation de l' outil Tampons . - nomagicsizes=yes + Cela peut accélérer Tux Paint au démarrage et réduire l'utilisation de la + mémoire pendant son exécution. Bien entendu, aucun timbre ne sera + disponible. - Some Magic tools offer various size settings. This option disables - the sizing control, and only provides the tools' default sizes. - (Some plugins may offer additional variations of a Magic tool, to - make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamps=no" or "stamps=yes". In both + cases, may be overridden by the command-line option "--stamps". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagicsizes=no" or "magicsizes=yes". In both cases, may be - overridden by the command-line option "--magicsizes". - noshapecontrols=yes - Désactive les boutons de contrôle affichés lors de l'utilisation - de l' outil Formes qui permettent de modifier la façon dont les - formes sont dessinées - centrées autour du clic initial de la - souris ou à partir d'un coin au clic de la souris. +nostampcontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be - overridden by the command-line option "--shapecontrols". + Certaines images de l' outil Tampon peuvent être mises en miroir, inversées + et / ou voir leur taille modifiée. Cette option désactive ces contrôles et + ne fournit que les tampons de base. - nolabel=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostampcontrols=no" or "stampcontrols= + yes". In both cases, may be overridden by the command-line option + "--stampcontrols". - Désactive l'outil Étiquette : l'outil qui permet la saisie de - texte pouvant être édité plus tard. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" or - "label=yes". In both cases, may be overridden by the command-line - option "--label". - nobrushspacing=yes +nostamprotation=yes - Disables the brush spacing option of the Paint and Lines tools. - The brushes' default spacings will be used. + This disables the rotation step of the Stamps tool, immediately placing the + stamp in its regular orientation (with any flipping or mirroring applied) + on the first click. - 📜 Note: The brush spacing option was added to Tux Paint's user - interface in version 0.9.28. For more information on brush - spacing, see EXTENDING.html + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobrushspacing=no" or "brushspacing=yes". In both cases, may be - overridden by the command-line option "--brushspacing". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamprotation=no" or "stamprotation= + yes". In both cases, may be overridden by the command-line option + "--stamprotation". - notemplateexport=yes - Disables the ability to create a new Template image (based on a - saved drawing) from within the Open dialog. - 📜 Note: The Template creation feature was added to Tux Paint in - version 0.9.31. +nomagiccontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "notemplateexport=no" or "templateexport=yes". In both cases, may - be overridden by the command-line option "--templateexport". + Certains outils Magie ont la possibilité d'agir comme un pinceau ou + d'affecter la toile entière. Cette option désactive les contrôles et ne + fournit que la fonctionnalité par défaut (généralement en mode peinture). - noerase=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagiccontrols=no" or "magiccontrols= + yes". In both cases, may be overridden by the command-line option + "--magiccontrols". + + + +nomagicsizes=yes + + Some Magic tools offer various size settings. This option disables the + sizing control, and only provides the tools' default sizes. (Some plugins + may offer additional variations of a Magic tool, to make a few sizes + possible, e.g. "Bricks" and "Googly Eyes".) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagicsizes=no" or "magicsizes=yes". + In both cases, may be overridden by the command-line option "--magicsizes". + + + +noshapecontrols=yes + + Désactive les boutons de contrôle affichés lors de l'utilisation de l' + outil Formes qui permettent de modifier la façon dont les formes sont + dessinées - centrées autour du clic initial de la souris ou à partir d'un + coin au clic de la souris. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshapecontrols=no" or "shapecontrols= + yes". In both cases, may be overridden by the command-line option + "--shapecontrols". + + + +nolabel=yes + + Désactive l'outil Étiquette : l'outil qui permet la saisie de texte pouvant + être édité plus tard. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nolabel=no" or "label=yes". In both + cases, may be overridden by the command-line option "--label". + + + +nobrushspacing=yes + + Disables the brush spacing option of the Paint and Lines tools. The + brushes' default spacings will be used. + + 📜 Note: The brush spacing option was added to Tux Paint's user interface in + version 0.9.28. For more information on brush spacing, see EXTENDING.html + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobrushspacing=no" or "brushspacing= + yes". In both cases, may be overridden by the command-line option + "--brushspacing". + + + +notemplateexport=yes + + Disables the ability to create a new Template image (based on a saved + drawing) from within the Open dialog. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "notemplateexport=no" or + "templateexport=yes". In both cases, may be overridden by the command-line + option "--templateexport". + + + +noerase=yes + + Disables the ability to erase saved drawings via the "Erase" button on the + Open dialog, or exported Template images (based on a saved drawing) via the + "Erase" button on the New dialog. Useful to prevent users from erasing + work, especially combined with the --saveovernew option. + + 📜 Note: This option was added to Tux Paint in version 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noerase=no" or "erase=yes". In both + cases, may be overridden by the command-line option "--erase". - Disables the ability to erase saved drawings via the "Erase" - button on the Open dialog, or exported Template images (based on a - saved drawing) via the "Erase" button on the New dialog. Useful to - prevent users from erasing work, especially combined with the - --saveovernew option. - 📜 Note: This option was added to Tux Paint in version 0.9.31. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noerase=no" or - "erase=yes". In both cases, may be overridden by the command-line - option "--erase". Langues - Langue +Langue - lang=LANGUAGE +lang=LANGUAGE - Run Tux Paint in one of the supported languages. Possible choices - for LANGUAGE currently include: + Run Tux Paint in one of the supported languages. Possible choices for + LANGUAGE currently include: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale LOCALE - Exécutez Tux Paint dans l'une des langues supportées. Consultez la - section Choisir une autre langue" ci-dessous pour les chaînes de - paramètres régionaux (par exemple, «de_DE» pour l'allemand) à - utiliser. - Si votre locale est déjà définie, par exemple avec la variable - d'environnement "$LANG", cette option n'est pas nécessaire, car - Tux Paint respecte les paramètres de votre environnement, si - possible.) +--locale LOCALE - mirrorstamps=yes + Exécutez Tux Paint dans l'une des langues supportées. Consultez la section + Choisir une autre langue" ci-dessous pour les chaînes de paramètres + régionaux (par exemple, «de_DE» pour l'allemand) à utiliser. - Pour les tampons qui peuvent être mis en miroir, cette option les - définit par défaut sur leur forme en miroir. + Si votre locale est déjà définie, par exemple avec la variable + d'environnement "$LANG", cette option n'est pas nécessaire, car Tux Paint + respecte les paramètres de votre environnement, si possible.) - Cela peut être utile pour les personnes qui préfèrent voir les - choses de droite à gauche plutôt que de gauche à droite. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be - overridden by the command-line option "--dontmirrorstamps". - Polices +mirrorstamps=yes - sysfonts=yes + Pour les tampons qui peuvent être mis en miroir, cette option les définit + par défaut sur leur forme en miroir. - Cette option oblige Tux Paint à essayer de charger des polices (à - utiliser dans l'outil Texte ) à partir de votre système - d'exploitation. Normalement, Tux Paint ne chargera que ceux - fournis avec Tux Paint. + Cela peut être utile pour les personnes qui préfèrent voir les choses de + droite à gauche plutôt que de gauche à droite. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" or - "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps= + yes". In both cases, may be overridden by the command-line option + "--dontmirrorstamps". - alllocalefonts=yes - Avant la version 0.9.21, Tux Paint chargeait toutes les polices - depuis son propre répertoire de polices, y compris celles - spécifiques à la locale (par exemple, celle pour le tibétain, qui - n'avait pas de caractères latins). Depuis la version 0.9.21, la - seule police chargée à partir du sous-répertoire spécifique aux - paramètres régionaux, si elle existe, correspond à la police - locale sur laquelle s'exécute Tux Paint. - Pour charger toutes les polices spécifiques aux paramètres - régionaux (l'ancien comportement), utilisez cette option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may - be overridden by the command-line option "--currentlocalefont". +Polices + +sysfonts=yes + + Cette option oblige Tux Paint à essayer de charger des polices (à utiliser + dans l'outil Texte ) à partir de votre système d'exploitation. Normalement, + Tux Paint ne chargera que ceux fournis avec Tux Paint. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In + both cases, may be overridden by the command-line option "--nosysfonts". + + + +alllocalefonts=yes + + Avant la version 0.9.21, Tux Paint chargeait toutes les polices depuis son + propre répertoire de polices, y compris celles spécifiques à la locale (par + exemple, celle pour le tibétain, qui n'avait pas de caractères latins). + Depuis la version 0.9.21, la seule police chargée à partir du + sous-répertoire spécifique aux paramètres régionaux, si elle existe, + correspond à la police locale sur laquelle s'exécute Tux Paint. + + Pour charger toutes les polices spécifiques aux paramètres régionaux + (l'ancien comportement), utilisez cette option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "alllocalefonts=no" or + "currentlocalefont=yes". In both cases, may be overridden by the + command-line option "--currentlocalefont". + + + +uifont=FONT NAME + + Cette option oblige Tux Paint à essayer de charger des polices (à utiliser + dans l'outil Texte ) à partir de votre système d'exploitation. Normalement, + Tux Paint ne chargera que ceux fournis avec Tux Paint. + + Specify "default" to let Tux Paint use its default font, "DejaVu Sans" (its + standard behavior). - uifont=FONT NAME - Cette option oblige Tux Paint à essayer de charger des polices (à - utiliser dans l'outil Texte ) à partir de votre système - d'exploitation. Normalement, Tux Paint ne chargera que ceux - fournis avec Tux Paint. - Specify "default" to let Tux Paint use its default font, "DejaVu - Sans" (its standard behavior). Impression - Permissions pour l'impression +Permissions pour l'impression - noprint=yes +noprint=yes - Désactive la fonction d'impression. + Désactive la fonction d'impression. - printdelay=SECONDES - Limite l'impression afin que l'impression ne puisse avoir lieu - qu'une fois toutes les SECONDES secondes. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printdelay=0". - In both cases, may be overridden by the command-line option - "--printdelay=0". +printdelay=SECONDES - Montrer le menu pour l'impression + Limite l'impression afin que l'impression ne puisse avoir lieu qu'une fois + toutes les SECONDES secondes. - altprint=always + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "printdelay=0". In both cases, may be + overridden by the command-line option "--printdelay=0". - Cela fait que Tux Paint affiche toujours la boîte de dialogue de - l'imprimante (ou, sous Linux / Unix, lance la "commande altprint") - lorsque le bouton "Imprimer" est cliqué. En d'autres termes, c'est - comme cliquer sur «Imprimer» tout en maintenant [Alt] , sauf que - vous n'avez pas besoin de maintenir [Alt] à chaque fois. - altprint=never - Cela empêche Tux Paint de ne jamais montrer la boîte de dialogue - de l' imprimante (ou, sous Linux / Unix, exécuter « - altprintcommand ») lorsque le bouton « Imprimer » est cliqué. En - d'autres termes, cela rend la touche [Alt] sans effet lorsque vous - cliquez sur le bouton «Imprimer». - altprint=mod +Montrer le menu pour l'impression - C'est le comportement par défaut. Tux Paint affiche une boîte de - dialogue d'imprimante (ou, sous Linux / Unix, exécute la commande - "altprint"), lorsque la touche [Alt] est enfoncée tandis que le - bouton "Imprimer" est cliqué. Cliquer sur «Imprimer» sans - maintenir [Alt] imprime sans afficher de boîte de dialogue. +altprint=always - Sauvegarder la configuration d'impression + Cela fait que Tux Paint affiche toujours la boîte de dialogue de + l'imprimante (ou, sous Linux / Unix, lance la "commande altprint") lorsque + le bouton "Imprimer" est cliqué. En d'autres termes, c'est comme cliquer + sur «Imprimer» tout en maintenant [Alt] , sauf que vous n'avez pas besoin + de maintenir [Alt] à chaque fois. - printcfg=yes - (Windows et macOS uniquement) - Tux Paint utilisera un fichier de configuration d'imprimante - lors de l'impression. Appuyez sur la touche [Alt] tout en - cliquant sur le bouton «Imprimer» dans Tux Paint pour faire - apparaître une fenêtre de dialogue d'impression Windows. +altprint=never - Any configuration changes made in this dialog will be saved to - the file "userdata/print.cfg" , and used again, as long as the - "printcfg" option is set. + Cela empêche Tux Paint de ne jamais montrer la boîte de dialogue de l' + imprimante (ou, sous Linux / Unix, exécuter « altprintcommand ») lorsque le + bouton « Imprimer » est cliqué. En d'autres termes, cela rend la touche + [Alt] sans effet lorsque vous cliquez sur le bouton «Imprimer». - 💡 Note: This only works when not running Tux Paint in fullscreen - mode. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". - Commandes d'impression +altprint=mod - printcommand=COMMAND + C'est le comportement par défaut. Tux Paint affiche une boîte de dialogue + d'imprimante (ou, sous Linux / Unix, exécute la commande "altprint"), + lorsque la touche [Alt] est enfoncée tandis que le bouton "Imprimer" est + cliqué. Cliquer sur «Imprimer» sans maintenir [Alt] imprime sans afficher + de boîte de dialogue. - (Linux et Unix uniquement) - Utilise la commande COMMAND pour imprimer un fichier au format - PostScript lorsque vous cliquez sur le bouton «Imprimer». Si - cette option n'est pas spécifiquement définie, la commande par - défaut est : - lpr - 📜 Remarque : les versions de Tux Paint antérieures à 0.9.15 - envoyaient des données au format PNG à la commande d'impression - (qui par défaut était "pngtopnm | pnmtops | lpr"). +Sauvegarder la configuration d'impression - Si vous définissez une autre commande printcommand dans le - fichier de configuration avant la version 0.9.15, vous devrez la - modifier. + printcfg=yes - altprintcommand=COMMAND + (Windows et macOS uniquement) - (Linux et Unix uniquement) + Tux Paint utilisera un fichier de configuration d'imprimante lors de + l'impression. Appuyez sur la touche [Alt] tout en cliquant sur le + bouton «Imprimer» dans Tux Paint pour faire apparaître une fenêtre de + dialogue d'impression Windows. - Utilisez la commande COMMAND pour imprimer un fichier au format - PostScript lorsque vous cliquez sur le bouton «Imprimer» tandis - que la touche [Alt] est maintenue enfoncée. (Ceci est - généralement utilisé pour fournir une boîte de dialogue - d'impression, comme lorsque vous appuyez sur [Alt] + 'Imprimer' - sous Windows et macOS.) + Any configuration changes made in this dialog will be saved to the file + "userdata/print.cfg" , and used again, as long as the "printcfg" option + is set. - Si cette option n'est pas spécifiquement définie, la commande - par défaut est la boîte de dialogue d'impression graphique de - KDE : + 💡 Note: This only works when not running Tux Paint in fullscreen mode. - kprinter + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "printcfg=no" or "noprintcfg= + yes". In both cases, may be overridden by the command-line option + "--noprintcfg". - Format du papier - papersize=PAPERSIZE - (Plates-formes qui utilisent le générateur PostScript interne de - Tux Paint - pas Windows, macOS, BeOS ou Haiku.) - Dit à Tux Paint quelle taille PostScript doit générer. Si aucun - n'est spécifié, Tux Paint vérifie d'abord votre variable - d'environnement $PAPER, puis le fichier /etc/papersize, puis - utilise le format de papier par défaut de la bibliothèque - 'libpaper'. + Commandes d'impression - Les tailles de papier valides sont : letter, legal, tabloid, - executive, note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, - a9, a10, b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, - halfexecutive, halfnote, folio, quarto, ledger, archA, archB, - archC, archD, archE, flsa, flse, csheet, dsheet, esheet. + printcommand=COMMAND -Sauvegarde + (Linux et Unix uniquement) - Écraser le travail précédent + Utilise la commande COMMAND pour imprimer un fichier au format + PostScript lorsque vous cliquez sur le bouton «Imprimer». Si cette + option n'est pas spécifiquement définie, la commande par défaut est : - saveover=yes + lpr - Ceci élimine le message "Écraser l'ancienne version ...? quand - on voulait sauvegarder un fichier déjà existant. Avec cette - option, l'ancienne version sera écrasée par la nouvelle, - automatiquement. + 📜 Remarque : les versions de Tux Paint antérieures à 0.9.15 envoyaient + des données au format PNG à la commande d'impression (qui par défaut + était "pngtopnm | pnmtops | lpr"). - saveover=new + Si vous définissez une autre commande printcommand dans le fichier de + configuration avant la version 0.9.15, vous devrez la modifier. - Ceci aussi élimine le message "Écraser l'ancienne version ...? - quand on sauvegarde un fichier déjà existant. Cette option, - cependant, enregistrera un nouveau fichier plutôt que d'écraser - l'ancienne version. - saveover=ask - (Cette option est redondante puisque c'est celle par défaut.) - Quand vous sauvegardez un dessin déjà existant, on vous - demandera d'abord si vous voulez écraser l'ancienne version ou - non. + altprintcommand=COMMAND - Démarrer + (Linux et Unix uniquement) - startblank=yes + Utilisez la commande COMMAND pour imprimer un fichier au format + PostScript lorsque vous cliquez sur le bouton «Imprimer» tandis que la + touche [Alt] est maintenue enfoncée. (Ceci est généralement utilisé + pour fournir une boîte de dialogue d'impression, comme lorsque vous + appuyez sur [Alt] + 'Imprimer' sous Windows et macOS.) - Ceci oblige Tux Paint à afficher une toile vide au démarrage, - plutôt que la dernière image qui a été éditée. + Si cette option n'est pas spécifiquement définie, la commande par + défaut est la boîte de dialogue d'impression graphique de KDE : - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". + kprinter - newcolorslast=yes - Place les options de couleur dans la boîte de dialogue Nouveau - en dernier, ainsi tous les démarreurs et / ou modèles seront - affichés en premier. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". - Répertoires de sauvegarde et d'export + Format du papier - savedir=DIRECTORY + papersize=PAPERSIZE - Utilisez cette option pour changer l'emplacement du répertoire / - dossier "saved" de Tux Paint , qui est l'endroit où Tux Paint - enregistre et ouvre les images. + (Plates-formes qui utilisent le générateur PostScript interne de Tux + Paint - pas Windows, macOS, BeOS ou Haiku.) - Si vous ne le changez pas, l' emplacement par défaut est : + Dit à Tux Paint quelle taille PostScript doit générer. Si aucun n'est + spécifié, Tux Paint vérifie d'abord votre variable d'environnement + $PAPER, puis le fichier /etc/papersize, puis utilise le format de + papier par défaut de la bibliothèque 'libpaper'. - * Linux & Unix - Sous un répertoire caché nommé ".tuxpaint" - dans votre répertoire personnel (aka "~" ou "$HOME") - Exemple: /home/username/.tuxpaint/saved/ - * Windows - Dans un dossier nommé "TuxPaint" dans votre - dossier "Application Data". - Exemple: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS - Dans un dossier nommé "TuxPaint" dans votre dossier - "Application Support". - Exemple: /Users/Username/Library/Application - Support/TuxPaint/saved/ + Les tailles de papier valides sont : letter, legal, tabloid, executive, + note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, + b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, + quarto, ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, + dsheet, esheet. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - 📜 Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - Exemple: savedir=Z:\tuxpaint\ - exportdir=DIRECTORY + Sauvegarde - Utilisez cette option pour modifier l'endroit où Tux Paint - exporte les fichiers - images uniques ou diaporamas GIF animés - - en vue d'un usage externe. + Écraser le travail précédent - Si vous ne le changez pas, l' emplacement par défaut est : + saveover=yes - * Linux et Unix - Si disponible, quel que soit l'endroit où - votre environnement de bureau est configuré pour le - stockage des images, en fonction de votre configuration XDG - (X Desktop Group). (Essayez d'exécuter en ligne de commande - "xdg-user-dir PICTURES" pour le savoir.) - Typiquement (dans un environnement local anglais), ce sera - "Images" dans votre répertoire personnel (c'est-à-dire - "$HOME/Images" aka "~/Images"). - Tux Paint utilisera ce répertoire typique, si aucune - configuration XDG ne peut être lue, ou rien n'est défini - pour "XDG_PICTURES_DIR". - * Windows - "Mes images" répertoire de chaque utilisateur - (normalement "c:\Users\USERNAME\Pictures"). - Vous pouvez ouvrir directement le répertoire comme ceci : - * Pressez la touche "[Windows]+[R]" pour ouvrir la boîte - de dialogue "Exécuter ...". - * Tapez "Shell:My Pictures" dans la zone de saisie et - cliquez sur OK. - * macOS — TBD! + Ceci élimine le message "Écraser l'ancienne version ...? quand on + voulait sauvegarder un fichier déjà existant. Avec cette option, + l'ancienne version sera écrasée par la nouvelle, automatiquement. - 💡 Note: When the defaults are used, a new "TuxPaint" - subdirectory will be created and used. (e.g., - "~/Images/TuxPaint") When the "--exportdir" option is used, the - exact path specified will be used (no "TuxPaint" subdirectory is - created). - - Le répertoire lui-même (par ex. "~/Images/TuxPaint") sera créé, - s'il n'existe pas. - Si le répertoire parent (par ex "~/Images/TuxPaint") n'existe - pas non plus, Tux Paint essayera aussi de le créer (mais de - répertoire plus haut que celui-là). - - Exemple: exportdir=/home/penguin/TuxPaintExports - Plus d'options de sauvegarde + saveover=new - nosave=yes + Ceci aussi élimine le message "Écraser l'ancienne version ...? quand on + sauvegarde un fichier déjà existant. Cette option, cependant, + enregistrera un nouveau fichier plutôt que d'écraser l'ancienne + version. - Ceci désactive la possibilité de sauvegarder les fichiers par - Tux Paint (et par conséquent ôte le bouton "Sauvegarder" sur - l'écran). On peut l'utiliser dans le cas où le programme est - utilisé juste pour le fun, ou dans un environnement de tests. - - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". - - autosave=yes - - Ceci empêche Tux Paint de vous demander si vous voulez - sauvegarder l'image quand vous quittez, et suppose que vous le - faites. - - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - - reversesort=yes - - This reverses the sorting of the Open and Slideshow dialogs, - placing the newest images at the top of the list. - - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "reversesort=no" or "noreversesort=yes". In both cases, may be - overridden by the command-line option "--noreversesort". - -Données - - Fichier de verouillage - - nolockfile=yes - - Par défaut, Tux Paint utilise ce qu'on appelle un «fichier de - verrouillage» pour éviter qu'il ne soit lancé plus d'une fois - toutes les 30 secondes. (Ceci permet d'éviter d'exécuter - accidentellement plusieurs copies; par exemple, en - double-cliquant sur un lanceur fonctionnant avec un seul clic, - ou en cliquant simplement avec impatience plusieurs fois sur - l'icône.) - Pour que Tux Paint ignore le fichier de verrouillage, lui - permettant de s'exécuter à nouveau, même s'il vient d'être lancé - il y a moins de 30 secondes, activez ce paramètre dans le - fichier de configuration ou exécutez Tux Paint avec l'option - '--nolockfile ' en ligne de commande. - Par défaut, le fichier de verrouillage est stocké dans - "~/.tuxpaint/" sous Linux et Unix, et "userdata\" sous Windows. + saveover=ask - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". - - Répertoire de données - - datadir=DIRECTORY - - Utilisez cette option pour changer l'endroit où Tux Paint ira - rechercher les fichiers de données personnelles (pinceaux, - tampons, images de démarrage, modèles et fontes spécifiques pour - l'utilisateur actuel). - - Tux Paint va chercher des sous-répertoires nommés "brushes", - "stamps", "starters", "templates", et "fonts" sous le répertoire - spécifié. - - Si vous ne le changez pas, l' emplacement par défaut est : - - * Linux & Unix - Sous un répertoire caché nommé ".tuxpaint" - dans votre répertoire personnel (aka "~" ou "$HOME") - Exemple: /home/username/.tuxpaint/brushes/ - * Windows - Dans un dossier nommé "TuxPaint" dans votre - dossier "Application Data". - Exemple: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS - Dans un dossier nommé "TuxPaint" dans votre dossier - "Application Support". - Exemple: /Users/Username/Library/Application - Support/TuxPaint/brushes/ - - 📜 Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. - - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. + (Cette option est redondante puisque c'est celle par défaut.) Quand + vous sauvegardez un dessin déjà existant, on vous demandera d'abord si + vous voulez écraser l'ancienne version ou non. - Exemple: datadir=/home/johnny/tuxpaint-data/ - - Fichier de palette de couleur - - colorfile=FILENAME - - Vous pouvez remplacer la palette de couleurs par défaut de Tux - Paint en créant un fichier texte ASCII simple qui décrit les - couleurs souhaitées et en pointant vers ce fichier à l'aide de - l'option "colorfile". - - Le fichier doit répertorier une couleur par ligne. Les couleurs - sont définies en fonction de leurs valeurs Rouge, Vert et Bleu, - chacune comprise entre 0 (désactivée) et 255 (la plus intense). - (Pour plus d'informations, consultez l'article de Wikipedia sur - le modèle de couleur RVB .) - - Les couleurs peuvent être listées en utilisant trois nombres - décimaux (par exemple, "255 68 136") ou un 'triplet' hexadécimal - de 6 ou 3 chiffres (par exemple, " #ff4488" ou "#F48"). - - Après la définition de la couleur (sur la même ligne), vous - pouvez saisir du texte pour décrire la couleur. Tux affichera ce - texte lorsque la couleur sera cliquée. (Par exemple, "#FFF Blanc - comme neige.") - - A titre d'exemple, vous pouvez voir les couleurs par défaut - actuellement utilisées dans Tux Paint dans : - "default_colors.txt". - - REMARQUES : Vous devez séparer les valeurs décimales par des - espaces et commencer les valeurs hexadécimales par un caractère - dièse / signe dièse (" #"). En hexadécimal à 3 chiffres, chaque - chiffre est utilisé à la fois pour les moitiés haute et basse de - l'octet, donc "#FFF" est identique à " #FFFFFF", mais pas à - "#F0F0F0". -Accessibilité - - Souris - - mouse-accessibility=yes - - Dans ce mode, au lieu de cliquer, de faire glisser et de - relâcher (par exemple, pour dessiner), vous cliquez, déplacez et - cliquez à nouveau pour terminer le mouvement. - - Clavier - keyboard=yes - Cela permet d'utiliser les touches fléchées du clavier pour - contrôler le pointeur de la souris. (Par exemple, pour les - environnements sans souris, ou en cas de problèmes de handicap - /d'accessibilité) + Démarrer - Caractéristiques : + startblank=yes - * Mouvement fin sur la toile, ou rapide si Shift est - maintenu. - * Mouvement rapide dans la zone des boutons d'outils. - * Touches de contrôle : - * [Left]/[Right]/[Up]/[Down], pavé numérique [1] jusqu'à - [9] : déplace la souris - * [Space]/[5] : Clic de la souris (sauf quand on utilise - les outils "Texte" ou "Étiquette") - * [Insert]/[F5]: Clic de la souris (toujours) - * [F4] fait naviguer la souris entre "Outils", - "Couleurs" et les zones de dessin - * Si la souris se trouve dans la section "Outils" à - gauche ou dans la section "Couleurs" en bas : - * [F7],[F8] : déplacer respectivement vers le bas / - le haut entre les boutons (section Outils, - uniquement) - * [F11],[F12] : passer respectivement au bouton - précédent / suivant - * Pour cliquer et faire glisser, maintenez l'une des touches - «clic» (par exemple [Insert]), et utilisez les touches de - déplacement (par exemple [Left]). + Ceci oblige Tux Paint à afficher une toile vide au démarrage, plutôt + que la dernière image qui a été éditée. - 💡 Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a 'click' - key to start clicking, movement keys to move around (which - will draw), and another 'click' key to end the click (stop - drawing). + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "startblank=no" or "startlast= + yes". In both cases, may be overridden by the command-line option + "--startlast". - * Une souris et/ou un joystick standard peuvent toujours être - utilisés (vous pouvez donc, par exemple, vous déplacer avec - la souris et cliquer avec le clavier, ou vice-versa) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "mouse=yes". In both cases, may be overridden by the - command-line option "--mouse". - Clavier virtuel sur écran + newcolorslast=yes - onscreen-keyboard=yes + Place les options de couleur dans la boîte de dialogue Nouveau en + dernier, ainsi tous les démarreurs et / ou modèles seront affichés en + premier. - Présente un clavier à l'écran cliquable lors de l'utilisation - des outils Texte et Étiquette . + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "newcolorslast=no" or + "newcolorsfirst=yes". In both cases, may be overridden by the + command-line option "--newcolorsfirst". - onscreen-keyboard-layout=LAYOUTNAME - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Remarque: l'utilisation de cette option implique automatiquement - onscreen-keyboard=yes , la configuration des deux est donc - redondante. - onscreen-keyboard-disable-change=yes - Désactive la possibilité de modifier la disposition du clavier à - l'écran lors de l'utilisation des outils Texte et Étiquette , - utile pour simplifier les choses pour les petits enfants. - Remarque: l'utilisation de cette option implique automatiquement - onscreen-keyboard=yes , la configuration des deux est donc - redondante. + Répertoires de sauvegarde et d'export - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". + savedir=DIRECTORY -Joystick + Utilisez cette option pour changer l'emplacement du répertoire / + dossier "saved" de Tux Paint , qui est l'endroit où Tux Paint + enregistre et ouvre les images. - Écran principal + Si vous ne le changez pas, l' emplacement par défaut est : - joystick-dev=N + o Linux & Unix - Sous un répertoire caché nommé ".tuxpaint" dans + votre répertoire personnel (aka "~" ou "$HOME") + Exemple: /home/username/.tuxpaint/saved/ + o Windows - Dans un dossier nommé "TuxPaint" dans votre dossier + "Application Data". + Exemple: C:\Documents and Settings\Username\Application Data\ + TuxPaint\saved\ + o macOS - Dans un dossier nommé "TuxPaint" dans votre dossier + "Application Support". + Exemple: /Users/Username/Library/Application Support/TuxPaint/saved + / - Spécifie quel périphérique joystick doit être utilisé par Tux - Paint. La valeur par défaut est 0 (le premier joystick). + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - joystick-slowness=SPEED + 📜 Note: Prior to version 0.9.18, Tux Paint would also use the setting + or default for "savedir" as the place to search for personal data files + (brushes, stamps, starters and fonts). As of version 0.9.18, they may + be specified separately (see the "datadir" option, below). - Définit un retard à chaque mouvement d'axe, permettant de - ralentir le joystick. Les valeurs autorisées sont comprises - entre 0 et 500. La valeur par défaut est 15. + Exemple: savedir=Z:\tuxpaint\ - joystick-threshold=THRESHOLD - Définit le niveau minimum de mouvement de l'axe pour commencer à - déplacer le pointeur. Les valeurs autorisées sont comprises - entre 0 et 32766. La valeur par défaut est 3200. - joystick-maxsteps=STEPS + exportdir=DIRECTORY - Définit le nombre de pixels maximums que le pointeur déplacera à - la fois. Les valeurs autorisées vont de 1 à 7. La valeur par - défaut est 7. + Utilisez cette option pour modifier l'endroit où Tux Paint exporte les + fichiers - images uniques ou diaporamas GIF animés - en vue d'un usage + externe. - Chapeau + Si vous ne le changez pas, l' emplacement par défaut est : - joystick-hat-slowness=SPEED + o Linux et Unix - Si disponible, quel que soit l'endroit où votre + environnement de bureau est configuré pour le stockage des images, + en fonction de votre configuration XDG (X Desktop Group). (Essayez + d'exécuter en ligne de commande "xdg-user-dir PICTURES" pour le + savoir.) + Typiquement (dans un environnement local anglais), ce sera "Images" + dans votre répertoire personnel (c'est-à-dire "$HOME/Images" aka "~ + /Images"). + Tux Paint utilisera ce répertoire typique, si aucune configuration + XDG ne peut être lue, ou rien n'est défini pour "XDG_PICTURES_DIR". + o Windows - "Mes images" répertoire de chaque utilisateur + (normalement "c:\Users\USERNAME\Pictures"). + Vous pouvez ouvrir directement le répertoire comme ceci : + # Pressez la touche "[Windows]+[R]" pour ouvrir la boîte de + dialogue "Exécuter ...". + # Tapez "Shell:My Pictures" dans la zone de saisie et cliquez sur + OK. + o macOS — TBD! - Définit un délai à chaque mouvement automatique, permettant de - ralentir la vitesse du chapeau. Les valeurs autorisées sont - comprises entre 0 et 500. La valeur par défaut est 15. + 💡 Note: When the defaults are used, a new "TuxPaint" subdirectory will + be created and used. (e.g., "~/Images/TuxPaint") When the "--exportdir" + option is used, the exact path specified will be used (no "TuxPaint" + subdirectory is created). - joystick-hat-timeout=MILLISECONDS + Le répertoire lui-même (par ex. "~/Images/TuxPaint") sera créé, s'il + n'existe pas. - Définit le délai après lequel le pointeur commencera à se - déplacer automatiquement si le chapeau est maintenu enfoncé. Les - valeurs autorisées sont comprises entre 0 et 3 000. La valeur - par défaut est 1 000. + Si le répertoire parent (par ex "~/Images/TuxPaint") n'existe pas non + plus, Tux Paint essayera aussi de le créer (mais de répertoire plus + haut que celui-là). - Boutons à désactiver + Exemple: exportdir=/home/penguin/TuxPaintExports - joystick-buttons-ignore=BUTTON1,BUTTON2,... - Un ensemble de numéros de boutons du joystick, comme vu par SDL, - qui doit être ignoré. Sinon, à moins qu'ils ne soient utilisés - par l'une des options "joystick-btn-" ci-dessus, les boutons - seront considérés comme un clic gauche de la souris. - Boutons pour raccourcis - joystick-btn-escape=BUTTON NUMBER + Plus d'options de sauvegarde - Sélectionne le numéro du bouton du joystick, tel que vu par SDL, - qui sera utilisé pour générer un événement d'échappement. Utile - pour fermer les dialogues et quitter. + nosave=yes - joystick-btn-brush=BUTTON NUMBER + Ceci désactive la possibilité de sauvegarder les fichiers par Tux Paint + (et par conséquent ôte le bouton "Sauvegarder" sur l'écran). On peut + l'utiliser dans le cas où le programme est utilisé juste pour le fun, + ou dans un environnement de tests. - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Pinceau. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nosave=no" or "save=yes". In + both cases, may be overridden by the command-line option "--save". - joystick-btn-stamp=BUTTON NUMBER - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Tampon. - joystick-btn-lines=BUTTON NUMBER + autosave=yes - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Lignes. + Ceci empêche Tux Paint de vous demander si vous voulez sauvegarder + l'image quand vous quittez, et suppose que vous le faites. - joystick-btn-shapes=BUTTON NUMBER + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "autosave=no" or "noautosave= + yes". In both cases, may be overridden by the command-line option + "--noautosave". - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Formes. - joystick-btn-text=BUTTON NUMBER - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Texte. + reversesort=yes - joystick-btn-label=BUTTON NUMBER + This reverses the sorting of the Open and Slideshow dialogs, placing + the newest images at the top of the list. - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Étiquette. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "reversesort=no" or + "noreversesort=yes". In both cases, may be overridden by the + command-line option "--noreversesort". - joystick-btn-fill=BUTTON NUMBER - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner select the fill tool. - joystick-btn-magic=BUTTON NUMBER - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sélectionne l'outil - Magie. + Données - joystick-btn-undo=BUTTON NUMBER + Fichier de verouillage - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner invoque l'outil Défaire. + nolockfile=yes - joystick-btn-redo=BUTTON NUMBER + Par défaut, Tux Paint utilise ce qu'on appelle un «fichier de + verrouillage» pour éviter qu'il ne soit lancé plus d'une fois toutes + les 30 secondes. (Ceci permet d'éviter d'exécuter accidentellement + plusieurs copies; par exemple, en double-cliquant sur un lanceur + fonctionnant avec un seul clic, ou en cliquant simplement avec + impatience plusieurs fois sur l'icône.) - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner outil Refaire. + Pour que Tux Paint ignore le fichier de verrouillage, lui permettant de + s'exécuter à nouveau, même s'il vient d'être lancé il y a moins de 30 + secondes, activez ce paramètre dans le fichier de configuration ou + exécutez Tux Paint avec l'option '--nolockfile ' en ligne de commande. - joystick-btn-eraser=BUTTON NUMBER + Par défaut, le fichier de verrouillage est stocké dans "~/.tuxpaint/" + sous Linux et Unix, et "userdata\" sous Windows. - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner outil Gomme. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nolockfile=no" or "lockfile= + yes". In both cases, may be overridden by the command-line option + "--lockfile". - joystick-btn-new=BUTTON NUMBER - Sélectionne le numéro de bouton du joysticke, comme vu par SDL, - qui sera un raccourci pour lancer la boîte dialogue pour créer - un nouveau dessin. - joystick-btn-open=BUTTON NUMBER - Sélectionne le numéro du bouton du joystick, tel que vu par SDL, - qui sera un raccourci pour lancer la boîte de dialogue pour - ouvrir un dessin existant. + Répertoire de données - joystick-btn-save=BUTTON NUMBER + datadir=DIRECTORY - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner sauvegarder le dessin. - - joystick-btn-pgsetup=BUTTON NUMBER - - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner lancer la boîte de - dialogue pour le réglage de l'imprssion. - - joystick-btn-print=BUTTON NUMBER - - Sélectionne le numéro du bouton du joystick, comme vu par SDL, - qui sera un raccourci pour sélectionner print. - - Écraser des options de System Config - - (Pour les utilisateurs Linux et Unix) - - Si l'une des options ci-dessus est définie dans " - /etc/tuxpaint/tuxpaint.config", vous pouvez la remplacer dans votre - propre fichier "~/.tuxpaintrc ". - - Pour les options vrai / faux, comme "noprint" et "grab", vous pouvez - simplement dire qu'elles sont égales à "no" dans votre fichier - "~/.tuxpaintrc" : - - noprint=no - uppercase=no - - Vous pouvez également utiliser des options similaires aux options de - remplacement de ligne de commande décrites ci-dessous. Par exemple : - - print=yes - mixedcase=yes - - Options de ligne de commande - - Options may also be issued on the command-line when you go to launch Tux - Paint. - - --fullscreen - --WIDTHxHEIGHT - --buttonsize=SIZE - --colorsrows=ROWS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDES - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --printcommand=COMMAND - --altprintcommand=COMMAND - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang LANGUAGE - --colorfile FILE - - Celles-ci activent ou correspondent aux options du fichier de - configuration décrites ci-dessus. - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - Ces options peuvent être utilisées pour remplacer les paramètres - définis dans le fichier de configuration. (Si l'option n'est pas - définie dans le (s) fichier (s) de configuration, aucune option - de remplacement n'est nécessaire.) - - --nosysconfig - - Sous Linux et Unix, cela empêche la lecture du fichier de - configuration système "/etc/tuxpaint/tuxpaint.conf". - - Seul votre propre fichier de configuration, "~/.tuxpaintrc", - s'il existe, sera utilisé. - -Options d'information en ligne de commande - - Les options suivantes affichent des informations sur l'écran. Cependant, - Tux Paint ne démarrera pas et ne s'exécutera pas. - - --version - --verbose-version - - Affiche le numéro de version et la date de la copie de Tux Paint - que vous utilisez. La "--verbose-version" répertorie également - les options de compilation définies. (Voir INSTALL et FAQ. - - --copying - - Afficher de brèves informations de licence au sujet de la copie - de Tux Paint. - - --usage - - Affiche la liste des options disponibles en ligne de commande. - - --help - - Affiche une aide sommaire sur l'utilisation de Tux Paint. - - --lang help - - Affiche une liste des langues disponibles dans Tux Paint. - - --joystick-dev list - - Afficher la liste des joysticks branchés qui sont disponibles - pour Tux Paint. - - Choisir une autre langue - - Tux Paint a été traduit en plusieurs langues. Pour accéder aux - traductions, vous pouvez utiliser l'option "--lang " sur la ligne de - commande pour définir la langue (par exemple "--lang spanish") ou - utiliser le paramètre "lang=" dans le fichier de configuration (par ex. - "lang=spanish"). - - Tux Paint respecte également les paramètres régionaux actuels de votre - environnement. (Vous pouvez les remplacer en ligne de commande en - utilisant l'option "--locale"; voir ci - dessus) - - Use the option "--lang help" to list the language options available. - -Langues disponibles - - +----------------------------------------------------------------------+ - |Code ISO 639-1 |Langue |Langue |Combinaison de | - | |nom natif |Nom anglais |touches | - |----------------+-------------------+-----------------+---------------| - |C | |English | | - |----------------+-------------------+-----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+-------------------+-----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+-------------------+-----------------+---------------| - |ak_GH | |Akan | | - |----------------+-------------------+-----------------+---------------| - |am_ET | |Amharic | | - |----------------+-------------------+-----------------+---------------| - |an_ES | |Aragones | | - |----------------+-------------------+-----------------+---------------| - |ar_SA | |Arabic | | - |----------------+-------------------+-----------------+---------------| - |as_IN | |Assamese | | - |----------------+-------------------+-----------------+---------------| - |ast_ES | |Asturian | | - |----------------+-------------------+-----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+-------------------+-----------------+---------------| - |bm_ML | |Bambara | | - |----------------+-------------------+-----------------+---------------| - |bn_IN | |Bengali | | - |----------------+-------------------+-----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+-------------------+-----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+-------------------+-----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+-------------------+-----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+-------------------+-----------------+---------------| - |brx_IN | |Bodo | | - |----------------+-------------------+-----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+-------------------+-----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+-------------------+-----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+-------------------+-----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+-------------------+-----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+-------------------+-----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+-------------------+-----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+-------------------+-----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+-------------------+-----------------+---------------| - |doi_IN | |Dogri | | - |----------------+-------------------+-----------------+---------------| - |et_EE | |Estonian | | - |----------------+-------------------+-----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+-------------------+-----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |en_CA | |Canadian English | | - |----------------+-------------------+-----------------+---------------| - |en_GB | |British English | | - |----------------+-------------------+-----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |eo | |Esperanto | | - |----------------+-------------------+-----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+-------------------+-----------------+---------------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+-------------------+-----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+-------------------+-----------------+---------------| - |fa_IR | |Persian | | - |----------------+-------------------+-----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+-------------------+-----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+-------------------+-----------------+---------------| - |fo_FO | |Faroese | | - |----------------+-------------------+-----------------+---------------| - |fr_FR |Français |French | | - |----------------+-------------------+-----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+-------------------+-----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+-------------------+-----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+-------------------+-----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+-------------------+-----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+-------------------+-----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+-------------------+-----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+-------------------+-----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+-------------------+-----------------+---------------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+-------------------+-----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+-------------------+-----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+-------------------+-----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+-------------------+-----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |ka_GE | |Georgian | | - |----------------+-------------------+-----------------+---------------| - |kab | |Kabyle | | - |----------------+-------------------+-----------------+---------------| - |km_KH | |Khmer | | - |----------------+-------------------+-----------------+---------------| - |kn_IN | |Kannada | | - |----------------+-------------------+-----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+-------------------+-----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+-------------------+-----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+-------------------+-----------------+---------------| - |lg_UG | |Luganda | | - |----------------+-------------------+-----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+-------------------+-----------------+---------------| - |lv_LV | |Latvian | | - |----------------+-------------------+-----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+-------------------+-----------------+---------------| - |mai_IN | |Maithili | | - |----------------+-------------------+-----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+-------------------+-----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+-------------------+-----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+-------------------+-----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+-------------------+-----------------+---------------| - |mr_IN | |Marathi | | - |----------------+-------------------+-----------------+---------------| - |ms_MY | |Malay | | - |----------------+-------------------+-----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+-------------------+-----------------+---------------| - |ne_NP |Nepali | | | - |----------------+-------------------+-----------------+---------------| - |nl_NL | |Dutch | | - |----------------+-------------------+-----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk| | - |----------------+-------------------+-----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+-------------------+-----------------+---------------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+-------------------+-----------------+---------------| - |oc_FR | |Occitan | | - |----------------+-------------------+-----------------+---------------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+-------------------+-----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+-------------------+-----------------+---------------| - |or_IN |Odia |Oriya | | - |----------------+-------------------+-----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+-------------------+-----------------+---------------| - |pt_BR |Portugês Brazileiro|Brazilian | | - | | |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |ro_RO | |Romanian | | - |----------------+-------------------+-----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+-------------------+-----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+-------------------+-----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+-------------------+-----------------+---------------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+-------------------+-----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+-------------------+-----------------+---------------| - |si_LK | |Sinhala | | - |----------------+-------------------+-----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+-------------------+-----------------+---------------| - |sk_SK | |Slovak | | - |----------------+-------------------+-----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+-------------------+-----------------+---------------| - |son | |Songhay | | - |----------------+-------------------+-----------------+---------------| - |sq_AL | |Albanian | | - |----------------+-------------------+-----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+-------------------+-----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+-------------------+-----------------+---------------| - |su_ID | |Sundanese | | - |----------------+-------------------+-----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+-------------------+-----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+-------------------+-----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+-------------------+-----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+-------------------+-----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+-------------------+-----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+-------------------+-----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+-------------------+-----------------+---------------| - |tr_TR | |Turkish | | - |----------------+-------------------+-----------------+---------------| - |tw_GH | |Twi | | - |----------------+-------------------+-----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+-------------------+-----------------+---------------| - |ur_IN | |Urdu | | - |----------------+-------------------+-----------------+---------------| - |ve_ZA | |Venda | | - |----------------+-------------------+-----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+-------------------+-----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+-------------------+-----------------+---------------| - |wa_BE | |Walloon | | - |----------------+-------------------+-----------------+---------------| - |wo_SN | |Wolof | | - |----------------+-------------------+-----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+-------------------+-----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+-------------------+-----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+-------------------+-----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+-------------------+-----------------+---------------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - Ces langues nécessitent leurs propres polices, car elles ne sont - pas représentées à l'aide d'un jeu de caractères latins, comme les - autres. Consultez la section "Polices spéciales " ci-dessous. - - 💡 Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods while - the Text tool is active. - -Définition des paramètres régionaux de votre environnement - - La modification de vos paramètres régionaux affectera une grande partie - de votre environnement. - - Comme indiqué ci-dessus, en plus de vous permettre de choisir la langue - au moment de l'exécution en utilisant les options de ligne de commande - ("--lang" et "--locale"), Tux Paint respecte les paramètres régionaux - globaux de votre environnement. - - Si vous n'avez pas encore défini les paramètres régionaux de votre - environnement, ce qui suit explique brièvement comment : - - Utilisateurs de Linux/Unix - - Tout d'abord, assurez-vous que les paramètres régionaux que vous - souhaitez utiliser sont activés en éditant le fichier "/etc/locale.gen" - sur votre système, puis en exécutant le programme "locale-gen" en tant - que root. - - 💡 Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration dialog. - Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the - "localeconf" package may need to be installed first), or you may need to - edit the file "/var/lib/locales/supported.d/local" first, and add - locales they want, from the list found in "/usr/share/i18n/SUPPORTED". - - Ensuite, avant d'exécuter Tux Paint, définissez votre variable - d'environnement "$LANG" sur l'un des paramètres régionaux répertoriés - ci-dessus. (Si vous voulez que tous les programmes qui peuvent être - traduits le soient, vous voudrez peut - être placer les éléments - suivants dans script de connexion, par ex. "~/.profile", "~/.bashrc", - "~/.cshrc", etc...) - - Par exemple, pour un Bourne Shell (tel que BASH) : - - export LANG=es_ES ; \ - tuxpaint - - Et un C Shell (tel que TCSH) : - - setenv LANG es_ES ; \ - tuxpaint - - Utilisateurs de Windows - - Tux Paint reconnaîtra les paramètres régionaux en cours et utilisera les - fichiers appropriés par défaut. Cette section est donc réservée aux - personnes essayant différentes langues. - - La chose la plus simple à faire est d'utiliser le commutateur '--lang' - dans le raccourci (voir "INSTALL"). Cependant, en utilisant une fenêtre - d'invite MSDOS, il est également possible de taper une commande comme - celle-ci : - - set LANG=es_ES - - ... qui définira la langue pour la durée de vie de cette fenêtre DOS. - - Pour quelque chose de plus permanent, vous pouvez mettre un 'variable - d'environnement' en utilisant la boîte de dialogue "Propriétés du - système" comme suit : - - * Entrez "la combinaison de touches [Windows]+[R]" pour ouvrir la - boîte de dialogue "Exécuter ...". - * Entrez "sysdm.cpl" dans la boîte de dialogue et cliquez sur le - bouton '[OK]" pour ouvrir la boîte de dialogue "Propriétés du - système'. - * Sélectionner l'onglet "Avancé". - * Cliquez sur le bouton "Variables d'environnement ...". - * Édite la valeur du paramètre "LANG" (le crée s'il n'existe pas). - -Polices spéciales - - Certaines langues nécessitent l'installation de polices spéciales. Ces - fichiers de polices (qui sont au format TrueType (TTF)), sont beaucoup - trop volumineux pour être inclus avec le téléchargement de Tux Paint et - sont disponibles séparément. (Voir le tableau ci-dessus, dans la section - « Choisir une autre langue ».) - - 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user interface, - rather than using "SDL_ttf" directly. Unless your copy of Tux Paint was - built without Pango support, special fonts should no longer be - necessary. + Utilisez cette option pour changer l'endroit où Tux Paint ira + rechercher les fichiers de données personnelles (pinceaux, tampons, + images de démarrage, modèles et fontes spécifiques pour l'utilisateur + actuel). - Lors de l'exécution de Tux Paint dans une langue nécessitant sa propre - police, Tux Paint essaiera de charger le fichier de police à partir de - son répertoire système "fonts" (sous un sous- répertoire "locale"). Le - nom du fichier correspond aux deux premières lettres du code 'locale' de - la langue (par exemple, "ko" pour le coréen, "ja" pour le japonais, - "zh_tw" pour le chinois traditionnel). + Tux Paint va chercher des sous-répertoires nommés "brushes", "stamps", + "starters", "templates", et "fonts" sous le répertoire spécifié. - Par exemple, sous Linux ou Unix, lorsque Tux Paint est exécuté en coréen - (par exemple, avec l'option "--lang korean"), Tux Paint tentera de - charger le fichier de police suivant : + Si vous ne le changez pas, l' emplacement par défaut est : - /usr/share/tuxpaint/fonts/locale/ko.ttf + o Linux & Unix - Sous un répertoire caché nommé ".tuxpaint" dans + votre répertoire personnel (aka "~" ou "$HOME") + Exemple: /home/username/.tuxpaint/brushes/ + o Windows - Dans un dossier nommé "TuxPaint" dans votre dossier + "Application Data". + Exemple: C:\Documents and Settings\Username\Application Data\ + TuxPaint\brushes\ + o macOS - Dans un dossier nommé "TuxPaint" dans votre dossier + "Application Support". + Exemple: /Users/Username/Library/Application Support/TuxPaint/ + brushes/ - You can download fonts for supported languages from Tux Paint's website, - https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + 📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting + or default as for "savedir" to search for data files. As of version + 0.9.18, they may be specified separately. - Sous Unix et Linux, vous pouvez utiliser le Makefile qui est fourni avec - la police pour installer la police à l'emplacement approprié. + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. + + Exemple: datadir=/home/johnny/tuxpaint-data/ + + + + + Fichier de palette de couleur + + colorfile=FILENAME + + Vous pouvez remplacer la palette de couleurs par défaut de Tux Paint en + créant un fichier texte ASCII simple qui décrit les couleurs souhaitées + et en pointant vers ce fichier à l'aide de l'option "colorfile". + + Le fichier doit répertorier une couleur par ligne. Les couleurs sont + définies en fonction de leurs valeurs Rouge, Vert et Bleu, chacune + comprise entre 0 (désactivée) et 255 (la plus intense). (Pour plus + d'informations, consultez l'article de Wikipedia sur le modèle de + couleur RVB .) + + Les couleurs peuvent être listées en utilisant trois nombres décimaux + (par exemple, "255 68 136") ou un 'triplet' hexadécimal de 6 ou 3 + chiffres (par exemple, " #ff4488" ou "#F48"). + + Après la définition de la couleur (sur la même ligne), vous pouvez + saisir du texte pour décrire la couleur. Tux affichera ce texte lorsque + la couleur sera cliquée. (Par exemple, "#FFF Blanc comme neige.") + + A titre d'exemple, vous pouvez voir les couleurs par défaut + actuellement utilisées dans Tux Paint dans : "default_colors.txt". + + REMARQUES : Vous devez séparer les valeurs décimales par des espaces et + commencer les valeurs hexadécimales par un caractère dièse / signe + dièse (" #"). En hexadécimal à 3 chiffres, chaque chiffre est utilisé à + la fois pour les moitiés haute et basse de l'octet, donc "#FFF" est + identique à " #FFFFFF", mais pas à "#F0F0F0". + + + + + Accessibilité + + Souris + + mouse-accessibility=yes + + Dans ce mode, au lieu de cliquer, de faire glisser et de relâcher (par + exemple, pour dessiner), vous cliquez, déplacez et cliquez à nouveau + pour terminer le mouvement. + + + + + Clavier + + keyboard=yes + + Cela permet d'utiliser les touches fléchées du clavier pour contrôler + le pointeur de la souris. (Par exemple, pour les environnements sans + souris, ou en cas de problèmes de handicap /d'accessibilité) + + Caractéristiques : + + o Mouvement fin sur la toile, ou rapide si Shift est maintenu. + o Mouvement rapide dans la zone des boutons d'outils. + o Touches de contrôle : + # [Left]/[Right]/[Up]/[Down], pavé numérique [1] jusqu'à [9] : + déplace la souris + # [Space]/[5] : Clic de la souris (sauf quand on utilise les + outils "Texte" ou "Étiquette") + # [Insert]/[F5]: Clic de la souris (toujours) + # [F4] fait naviguer la souris entre "Outils", "Couleurs" et les + zones de dessin + # Si la souris se trouve dans la section "Outils" à gauche ou + dans la section "Couleurs" en bas : + @ [F7],[F8] : déplacer respectivement vers le bas / le haut + entre les boutons (section Outils, uniquement) + @ [F11],[F12] : passer respectivement au bouton précédent / + suivant + o Pour cliquer et faire glisser, maintenez l'une des touches «clic» + (par exemple [Insert]), et utilisez les touches de déplacement (par + exemple [Left]). + + 💡 Note: The "mouse accessibility" feature works with the keyboard + mouse controls. With both options enabled, painting tools can be + used to draw by pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another 'click' key to + end the click (stop drawing). + + o Une souris et/ou un joystick standard peuvent toujours être + utilisés (vous pouvez donc, par exemple, vous déplacer avec la + souris et cliquer avec le clavier, ou vice-versa) + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "keyboard=no" or "mouse=yes". In + both cases, may be overridden by the command-line option "--mouse". + + + + + Clavier virtuel sur écran + + onscreen-keyboard=yes + + Présente un clavier à l'écran cliquable lors de l'utilisation des + outils Texte et Étiquette . + + + + onscreen-keyboard-layout=LAYOUTNAME + + Selects the initial layout for the on-screen keyboard when using the + Text and Label tools. + Remarque: l'utilisation de cette option implique automatiquement + onscreen-keyboard=yes , la configuration des deux est donc redondante. + + + + onscreen-keyboard-disable-change=yes + + Désactive la possibilité de modifier la disposition du clavier à + l'écran lors de l'utilisation des outils Texte et Étiquette , utile + pour simplifier les choses pour les petits enfants. + Remarque: l'utilisation de cette option implique automatiquement + onscreen-keyboard=yes , la configuration des deux est donc redondante. + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be overridden + by the command-line option "--onscreen-keyboard-disable-change=no". + + + + + Joystick + + Écran principal + + joystick-dev=N + + Spécifie quel périphérique joystick doit être utilisé par Tux Paint. La + valeur par défaut est 0 (le premier joystick). + + + + joystick-slowness=SPEED + + Définit un retard à chaque mouvement d'axe, permettant de ralentir le + joystick. Les valeurs autorisées sont comprises entre 0 et 500. La + valeur par défaut est 15. + + + + joystick-threshold=THRESHOLD + + Définit le niveau minimum de mouvement de l'axe pour commencer à + déplacer le pointeur. Les valeurs autorisées sont comprises entre 0 et + 32766. La valeur par défaut est 3200. + + + + joystick-maxsteps=STEPS + + Définit le nombre de pixels maximums que le pointeur déplacera à la + fois. Les valeurs autorisées vont de 1 à 7. La valeur par défaut est 7. + + + + + Chapeau + + joystick-hat-slowness=SPEED + + Définit un délai à chaque mouvement automatique, permettant de ralentir + la vitesse du chapeau. Les valeurs autorisées sont comprises entre 0 et + 500. La valeur par défaut est 15. + + + + joystick-hat-timeout=MILLISECONDS + + Définit le délai après lequel le pointeur commencera à se déplacer + automatiquement si le chapeau est maintenu enfoncé. Les valeurs + autorisées sont comprises entre 0 et 3 000. La valeur par défaut est 1 + 000. + + + + + Boutons à désactiver + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + Un ensemble de numéros de boutons du joystick, comme vu par SDL, qui + doit être ignoré. Sinon, à moins qu'ils ne soient utilisés par l'une + des options "joystick-btn-" ci-dessus, les boutons seront considérés + comme un clic gauche de la souris. + + + + +Boutons pour raccourcis + + joystick-btn-escape=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, tel que vu par SDL, qui + sera utilisé pour générer un événement d'échappement. Utile pour fermer + les dialogues et quitter. + + + + joystick-btn-brush=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Pinceau. + + + + joystick-btn-stamp=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Tampon. + + + + joystick-btn-lines=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Lignes. + + + + joystick-btn-shapes=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Formes. + + + + joystick-btn-text=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Texte. + + + + joystick-btn-label=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Étiquette. + + + + joystick-btn-fill=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner select the fill tool. + + + + joystick-btn-magic=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sélectionne l'outil Magie. + + + + joystick-btn-undo=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner invoque l'outil Défaire. + + + + joystick-btn-redo=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner outil Refaire. + + + + joystick-btn-eraser=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner outil Gomme. + + + + joystick-btn-new=BUTTON NUMBER + + Sélectionne le numéro de bouton du joysticke, comme vu par SDL, qui + sera un raccourci pour lancer la boîte dialogue pour créer un nouveau + dessin. + + + + joystick-btn-open=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, tel que vu par SDL, qui + sera un raccourci pour lancer la boîte de dialogue pour ouvrir un + dessin existant. + + + + joystick-btn-save=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner sauvegarder le dessin. + + + + joystick-btn-pgsetup=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner lancer la boîte de dialogue pour le + réglage de l'imprssion. + + + + joystick-btn-print=BUTTON NUMBER + + Sélectionne le numéro du bouton du joystick, comme vu par SDL, qui sera + un raccourci pour sélectionner print. + + + + + Écraser des options de System Config + + (Pour les utilisateurs Linux et Unix) + + Si l'une des options ci-dessus est définie dans " /etc/tuxpaint/ + tuxpaint.config", vous pouvez la remplacer dans votre propre fichier "~ + /.tuxpaintrc ". + + Pour les options vrai / faux, comme "noprint" et "grab", vous pouvez + simplement dire qu'elles sont égales à "no" dans votre fichier "~ + /.tuxpaintrc" : + + noprint=no + uppercase=no + + Vous pouvez également utiliser des options similaires aux options de + remplacement de ligne de commande décrites ci-dessous. Par exemple : + + print=yes + mixedcase=yes + + Options de ligne de commande + + Options may also be issued on the command-line when you go to launch Tux + Paint. + + --fullscreen + --WIDTHxHEIGHT + --buttonsize=SIZE + --colorsrows=ROWS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDES + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --printcommand=COMMAND + --altprintcommand=COMMAND + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang LANGUAGE + --colorfile FILE + + Celles-ci activent ou correspondent aux options du fichier de + configuration décrites ci-dessus. + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + Ces options peuvent être utilisées pour remplacer les paramètres + définis dans le fichier de configuration. (Si l'option n'est pas + définie dans le (s) fichier (s) de configuration, aucune option de + remplacement n'est nécessaire.) + + + + --nosysconfig + + Sous Linux et Unix, cela empêche la lecture du fichier de configuration + système "/etc/tuxpaint/tuxpaint.conf". + + Seul votre propre fichier de configuration, "~/.tuxpaintrc", s'il + existe, sera utilisé. + + + + + Options d'information en ligne de commande + + Les options suivantes affichent des informations sur l'écran. Cependant, + Tux Paint ne démarrera pas et ne s'exécutera pas. + + --version + --verbose-version + + Affiche le numéro de version et la date de la copie de Tux Paint que + vous utilisez. La "--verbose-version" répertorie également les options + de compilation définies. (Voir INSTALL et FAQ. + + + + --copying + + Afficher de brèves informations de licence au sujet de la copie de Tux + Paint. + + + + --usage + + Affiche la liste des options disponibles en ligne de commande. + + + + --help + + Affiche une aide sommaire sur l'utilisation de Tux Paint. + + + + --lang help + + Affiche une liste des langues disponibles dans Tux Paint. + + + + --joystick-dev list + + Afficher la liste des joysticks branchés qui sont disponibles pour Tux + Paint. + + + + + Choisir une autre langue + + Tux Paint a été traduit en plusieurs langues. Pour accéder aux traductions, + vous pouvez utiliser l'option "--lang " sur la ligne de commande pour + définir la langue (par exemple "--lang spanish") ou utiliser le paramètre + "lang=" dans le fichier de configuration (par ex. "lang=spanish"). + + Tux Paint respecte également les paramètres régionaux actuels de votre + environnement. (Vous pouvez les remplacer en ligne de commande en utilisant + l'option "--locale"; voir ci - dessus) + + Use the option "--lang help" to list the language options available. + + Langues disponibles + + +-------------------------------------------------------------------------+ + | Code ISO 639-1 | Langue | Langue | Combinaison de | + | | nom natif | Nom anglais | touches | + |------------------+------------------+----------------+------------------| + | C | | English | | + |------------------+------------------+----------------+------------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+----------------+------------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+----------------+------------------| + | ak_GH | | Akan | | + |------------------+------------------+----------------+------------------| + | am_ET | | Amharic | | + |------------------+------------------+----------------+------------------| + | an_ES | | Aragones | | + |------------------+------------------+----------------+------------------| + | ar_SA | | Arabic | | + |------------------+------------------+----------------+------------------| + | as_IN | | Assamese | | + |------------------+------------------+----------------+------------------| + | ast_ES | | Asturian | | + |------------------+------------------+----------------+------------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+----------------+------------------| + | bm_ML | | Bambara | | + |------------------+------------------+----------------+------------------| + | bn_IN | | Bengali | | + |------------------+------------------+----------------+------------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+----------------+------------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+----------------+------------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+----------------+------------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+----------------+------------------| + | brx_IN | | Bodo | | + |------------------+------------------+----------------+------------------| + | bs_BA | | Bosnian | | + |------------------+------------------+----------------+------------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+----------------+------------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+----------------+------------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+----------------+------------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+----------------+------------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+----------------+------------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+----------------+------------------| + | de_DE | Deutsch | German | | + |------------------+------------------+----------------+------------------| + | doi_IN | | Dogri | | + |------------------+------------------+----------------+------------------| + | et_EE | | Estonian | | + |------------------+------------------+----------------+------------------| + | el_GR (*) | | Greek | | + |------------------+------------------+----------------+------------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_GB | | British | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+----------------+------------------| + | eo | | Esperanto | | + |------------------+------------------+----------------+------------------| + | es_ES | Español | Spanish | | + |------------------+------------------+----------------+------------------| + | es_MX | Español-Mejicano | Mexican | | + | | | Spanish | | + |------------------+------------------+----------------+------------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+----------------+------------------| + | fa_IR | | Persian | | + |------------------+------------------+----------------+------------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+----------------+------------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+----------------+------------------| + | fo_FO | | Faroese | | + |------------------+------------------+----------------+------------------| + | fr_FR | Français | French | | + |------------------+------------------+----------------+------------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+----------------+------------------| + | gd_GB | Ghaidhlig | Scottish | | + | | | Gaelic | | + |------------------+------------------+----------------+------------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+----------------+------------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+----------------+------------------| + | gu_IN | | Gujarati | | + |------------------+------------------+----------------+------------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+----------------+------------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+----------------+------------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+----------------+------------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+----------------+------------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+----------------+------------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+----------------+------------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+----------------+------------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+----------------+------------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+----------------+------------------| + | ja_JP (*) | | Japanese | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | ka_GE | | Georgian | | + |------------------+------------------+----------------+------------------| + | kab | | Kabyle | | + |------------------+------------------+----------------+------------------| + | km_KH | | Khmer | | + |------------------+------------------+----------------+------------------| + | kn_IN | | Kannada | | + |------------------+------------------+----------------+------------------| + | ko_KR (*) | | Korean | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | kok@roman | | Konkani | | + | | | (Roman) | | + |------------------+------------------+----------------+------------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+----------------+------------------| + | ku_TR | | Kurdish | | + |------------------+------------------+----------------+------------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+----------------+------------------| + | lg_UG | | Luganda | | + |------------------+------------------+----------------+------------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+----------------+------------------| + | lv_LV | | Latvian | | + |------------------+------------------+----------------+------------------| + | mk_MK | | Macedonian | | + |------------------+------------------+----------------+------------------| + | mai_IN | | Maithili | | + |------------------+------------------+----------------+------------------| + | ml_IN | | Malayalam | | + |------------------+------------------+----------------+------------------| + | mn_MN | | Mongolian | | + |------------------+------------------+----------------+------------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+----------------+------------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+----------------+------------------| + | mr_IN | | Marathi | | + |------------------+------------------+----------------+------------------| + | ms_MY | | Malay | | + |------------------+------------------+----------------+------------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+----------------+------------------| + | ne_NP | Nepali | | | + |------------------+------------------+----------------+------------------| + | nl_NL | | Dutch | | + |------------------+------------------+----------------+------------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+----------------+------------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+----------------+------------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+----------------+------------------| + | oc_FR | | Occitan | | + |------------------+------------------+----------------+------------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+----------------+------------------| + | pa_IN | | Punjabi | | + |------------------+------------------+----------------+------------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+----------------+------------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+----------------+------------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+----------------+------------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+----------------+------------------| + | ro_RO | | Romanian | | + |------------------+------------------+----------------+------------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+----------------+------------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+----------------+------------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+----------------+------------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+----------------+------------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+----------------+------------------| + | si_LK | | Sinhala | | + |------------------+------------------+----------------+------------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sd_IN | | Sindhi | | + |------------------+------------------+----------------+------------------| + | sk_SK | | Slovak | | + |------------------+------------------+----------------+------------------| + | sl_SI | | Slovenian | | + |------------------+------------------+----------------+------------------| + | son | | Songhay | | + |------------------+------------------+----------------+------------------| + | sq_AL | | Albanian | | + |------------------+------------------+----------------+------------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+----------------+------------------| + | sr_RS@latin | | Serbian | | + | | | (latin) | | + |------------------+------------------+----------------+------------------| + | su_ID | | Sundanese | | + |------------------+------------------+----------------+------------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+----------------+------------------| + | sw_TZ | | Swahili | | + |------------------+------------------+----------------+------------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+----------------+------------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+----------------+------------------| + | th_TH (*) | | Thai | | + |------------------+------------------+----------------+------------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+----------------+------------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+----------------+------------------| + | tr_TR | | Turkish | | + |------------------+------------------+----------------+------------------| + | tw_GH | | Twi | | + |------------------+------------------+----------------+------------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+----------------+------------------| + | ur_IN | | Urdu | | + |------------------+------------------+----------------+------------------| + | ve_ZA | | Venda | | + |------------------+------------------+----------------+------------------| + | vec | Venèto | Venetian | | + |------------------+------------------+----------------+------------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+----------------+------------------| + | wa_BE | | Walloon | | + |------------------+------------------+----------------+------------------| + | wo_SN | | Wolof | | + |------------------+------------------+----------------+------------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+----------------+------------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+----------------+------------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+----------------+------------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+----------------+------------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - Ces langues nécessitent leurs propres polices, car elles ne sont pas + représentées à l'aide d'un jeu de caractères latins, comme les autres. + Consultez la section "Polices spéciales " ci-dessous. + + 💡 Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) listed + can be used to cycle through the supported input methods while the Text + tool is active. + + Définition des paramètres régionaux de votre environnement + + La modification de vos paramètres régionaux affectera une grande partie de + votre environnement. + + Comme indiqué ci-dessus, en plus de vous permettre de choisir la langue au + moment de l'exécution en utilisant les options de ligne de commande + ("--lang" et "--locale"), Tux Paint respecte les paramètres régionaux + globaux de votre environnement. + + Si vous n'avez pas encore défini les paramètres régionaux de votre + environnement, ce qui suit explique brièvement comment : + + Utilisateurs de Linux/Unix + + Tout d'abord, assurez-vous que les paramètres régionaux que vous souhaitez + utiliser sont activés en éditant le fichier "/etc/locale.gen" sur votre + système, puis en exécutant le programme "locale-gen" en tant que root. + + 💡 Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration dialog. + Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the + "localeconf" package may need to be installed first), or you may need to + edit the file "/var/lib/locales/supported.d/local" first, and add locales + they want, from the list found in "/usr/share/i18n/SUPPORTED". + + Ensuite, avant d'exécuter Tux Paint, définissez votre variable + d'environnement "$LANG" sur l'un des paramètres régionaux répertoriés + ci-dessus. (Si vous voulez que tous les programmes qui peuvent être + traduits le soient, vous voudrez peut - être placer les éléments suivants + dans script de connexion, par ex. "~/.profile", "~/.bashrc", "~/.cshrc", + etc...) + + Par exemple, pour un Bourne Shell (tel que BASH) : + + export LANG=es_ES ; \ + tuxpaint + + Et un C Shell (tel que TCSH) : + + setenv LANG es_ES ; \ + tuxpaint + + Utilisateurs de Windows + + Tux Paint reconnaîtra les paramètres régionaux en cours et utilisera les + fichiers appropriés par défaut. Cette section est donc réservée aux + personnes essayant différentes langues. + + La chose la plus simple à faire est d'utiliser le commutateur '--lang' dans + le raccourci (voir "INSTALL"). Cependant, en utilisant une fenêtre d'invite + MSDOS, il est également possible de taper une commande comme celle-ci : + + set LANG=es_ES + + ... qui définira la langue pour la durée de vie de cette fenêtre DOS. + + Pour quelque chose de plus permanent, vous pouvez mettre un 'variable + d'environnement' en utilisant la boîte de dialogue "Propriétés du système" + comme suit : + + + Entrez "la combinaison de touches [Windows]+[R]" pour ouvrir la boîte + de dialogue "Exécuter ...". + + Entrez "sysdm.cpl" dans la boîte de dialogue et cliquez sur le bouton ' + [OK]" pour ouvrir la boîte de dialogue "Propriétés du système'. + + Sélectionner l'onglet "Avancé". + + Cliquez sur le bouton "Variables d'environnement ...". + + Édite la valeur du paramètre "LANG" (le crée s'il n'existe pas). + + Polices spéciales + + Certaines langues nécessitent l'installation de polices spéciales. Ces + fichiers de polices (qui sont au format TrueType (TTF)), sont beaucoup trop + volumineux pour être inclus avec le téléchargement de Tux Paint et sont + disponibles séparément. (Voir le tableau ci-dessus, dans la section « + Choisir une autre langue ».) + + 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, which + utilizes the "Pango" library to render text in the user interface, rather + than using "SDL_ttf" directly. Unless your copy of Tux Paint was built + without Pango support, special fonts should no longer be necessary. + + Lors de l'exécution de Tux Paint dans une langue nécessitant sa propre + police, Tux Paint essaiera de charger le fichier de police à partir de son + répertoire système "fonts" (sous un sous- répertoire "locale"). Le nom du + fichier correspond aux deux premières lettres du code 'locale' de la langue + (par exemple, "ko" pour le coréen, "ja" pour le japonais, "zh_tw" pour le + chinois traditionnel). + + Par exemple, sous Linux ou Unix, lorsque Tux Paint est exécuté en coréen + (par exemple, avec l'option "--lang korean"), Tux Paint tentera de charger + le fichier de police suivant : + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + You can download fonts for supported languages from Tux Paint's website, + https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + + Sous Unix et Linux, vous pouvez utiliser le Makefile qui est fourni avec la + police pour installer la police à l'emplacement approprié. + diff --git a/docs/fr_FR.UTF-8/PNG.txt b/docs/fr_FR.UTF-8/PNG.txt index 112d247a0..41a55c55c 100644 --- a/docs/fr_FR.UTF-8/PNG.txt +++ b/docs/fr_FR.UTF-8/PNG.txt @@ -1,93 +1,96 @@ Tux Paint - version 0.9.31 - Documentation sur PNG pour Tux Paint + version 0.9.31 + Documentation sur PNG pour Tux Paint Copyright © 2007-2022 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juin 4, 2022 + juin 4, 2022 - À propos des PNG +À propos des PNG - 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 - (comme les GIF). C'est un format hautement compressé (mais pas "avec - perte" comme les JPEG - la perte permet aux fichiers d'être plus petit, - mais introduit des "erreurs" dans l'image lors de l'enregistrement), et - prend en charge la couleur 24 bits (16,7 millions de couleurs) ainsi qu'un - "canal alpha", c'est-à-dire que chaque pixel peut avoir un degré variable - de transparence. +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 +(comme les GIF). C'est un format hautement compressé (mais pas "avec perte" +comme les JPEG - la perte permet aux fichiers d'être plus petit, mais introduit +des "erreurs" dans l'image lors de l'enregistrement), et prend en charge la +couleur 24 bits (16,7 millions de couleurs) ainsi qu'un "canal alpha", +c'est-à-dire que chaque pixel peut avoir un degré variable 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, - transparence/alpha) en font le meileur choix pour Tux Paint (La prise en - charge du format PNG par Tux Paint vient de la bibliothèque Open Source - SDL_Image, qui à son tour l'a obtenue de la bibliothèque libPNG.) +Ces fonctionnalités (format ouvert, pas de perte, compression, transparence/ +alpha) en font le meileur choix pour Tux Paint (La prise en charge du format +PNG par Tux Paint vient de la bibliothèque Open Source SDL_Image, qui à son +tour l'a obtenue de la bibliothèque libPNG.) - La prise en charge de nombreuses couleurs permet aux images "tampons de - caoutchouc" de qualité photo d'être utilisable dans Tux Paint, et la - transparence alpha permet une haute qualité pour les pinceaux. +La prise en charge de nombreuses couleurs permet aux images "tampons de +caoutchouc" de qualité photo d'être utilisable dans Tux Paint, et la +transparence alpha permet une haute qualité pour les pinceaux. Comment créer des PNG - Ce qui suit est une très brève liste de méthodes pour créer des PNG ou - convertir des images existantes en PNG. +Ce qui suit est une très brève liste de méthodes pour créer des PNG ou +convertir des images existantes en PNG. - GIMP & Krita +GIMP & Krita - D'excellents outils pour créer des images PNG utilisables dans Tux - Paint sont Gimp et Krita, tous deux programmes interactifs de - dessin et d'édition de photos Open Source et de grande qualité. + D'excellents outils pour créer des images PNG utilisables dans Tux Paint + sont Gimp et Krita, tous deux programmes interactifs de dessin et d'édition + 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 - NetPBM - Les outils Bitmap portables (appelés généralement - «NetPBM») sont une collection d'outils de ligne de - commande Open Source qui convertissent vers et depuis - différents formats tels que GIF, TIFF, BMP, PNG et - beaucoup d'autres. +Outils en ligne de commande - Ils sont probablement déjà installés sur votre - système. Sinon, ils sont certainement disponibles - depuis le site de téléchargement de votre - distribution Linux. Sinon, ou pour en apprendre plus, - visitez http://netpbm.sourceforge.net/. + NetPBM - cjpeg/djpeg + Les outils Bitmap portables (appelés généralement «NetPBM») sont une + collection d'outils de ligne de commande Open Source qui convertissent + vers et depuis différents formats tels que GIF, TIFF, BMP, PNG et + beaucoup d'autres. + + Ils sont probablement déjà installés sur votre système. Sinon, ils sont + certainement disponibles depuis le site de téléchargement de votre + distribution Linux. Sinon, ou pour en apprendre plus, visitez http:// + netpbm.sourceforge.net/. + + + + cjpeg/djpeg + + Les programmes en ligne de commande "cjpeg" et "djpeg" font la + conversion entre le format PNM (Portable Any Map) de NetPBM et les + JPEG. Ils sont probablement déjà installés sur votre système. Sinon, + ils sont certainement disponibles depuis le site de téléchargement de + votre distribution Linux. Sinon, ou pour en apprendre plus, visitez + https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Utilisateurs de Macintosh + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - Les programmes en ligne de commande "cjpeg" et - "djpeg" font la conversion entre le format PNM - (Portable Any Map) de NetPBM et les JPEG. Ils sont - probablement déjà installés sur votre système. Sinon, - ils sont certainement disponibles depuis le site de - téléchargement de votre distribution Linux. Sinon, ou - pour en apprendre plus, visitez - https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Utilisateurs de Macintosh - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/fr_FR.UTF-8/README.txt b/docs/fr_FR.UTF-8/README.txt index 949821e53..f495373b1 100644 --- a/docs/fr_FR.UTF-8/README.txt +++ b/docs/fr_FR.UTF-8/README.txt @@ -1,1412 +1,1402 @@ Tux Paint - version 0.9.31 + version 0.9.31 - Un programme simple pour les enfants + Un programme simple pour les enfants Copyright © 2002-2023 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juillet 13, 2023 + juillet 13, 2023 - +------------------------------------------------------------+ - |Table des matières | - |------------------------------------------------------------| - |I. À propos de Tux Paint | - |II. Utiliser Tux Paint | - | A. Lancement de Tux Paint | - | B. Écran titre | - | C. Écran principal | - | D. Outils disponibles | - | 1. Outils de dessin | - | a. Outil "Peinture" (pinceau) | - | b. Outil "Tampon" (tampon de caoutchouc) | - | c. Outil "Lignes" | - | d. Outil "Formes" | - | e. Outils "Texte" et "Étiquette" | - | f. Outil "Remplir" | - | g. Outil "Magie" (Effets spéciaux) | - | h. Outil "Gomme" | - | 2. Autres contrôles | - | a. "Undo" and "Redo" Commands | - | b. Commande "Nouveau" | - | c. Commande "Ouvrir" | - | d. Commande "Sauvegarder" | - | e. Commande "Imprimer" | - | f. Commande "Diapos" (sous "Ouvrir") | - | g. Commande "Quitter" | - | h. Coupure du son | - | E. Controlling Tux Paint | - |III. Chargement d'autres images dans Tux Paint | - |IV. Lectures complémentaires | - |V. Comment obtenir de l'aide | - |VI. Comment participer | - +------------------------------------------------------------+ ++-------------------------------------------------------+ +| Table des matières | +|-------------------------------------------------------| +| I. À propos de Tux Paint | +| II. Utiliser Tux Paint | +| A. Lancement de Tux Paint | +| B. Écran titre | +| C. Écran principal | +| D. Outils disponibles | +| 1. Outils de dessin | +| a. Outil "Peinture" (pinceau) | +| b. Outil "Tampon" (tampon de caoutchouc) | +| c. Outil "Lignes" | +| d. Outil "Formes" | +| e. Outils "Texte" et "Étiquette" | +| f. Outil "Remplir" | +| g. Outil "Magie" (Effets spéciaux) | +| h. Outil "Gomme" | +| 2. Autres contrôles | +| a. "Undo" and "Redo" Commands | +| b. Commande "Nouveau" | +| c. Commande "Ouvrir" | +| d. Commande "Sauvegarder" | +| e. Commande "Imprimer" | +| f. Commande "Diapos" (sous "Ouvrir") | +| g. Commande "Quitter" | +| h. Coupure du son | +| E. Controlling Tux Paint | +| III. Chargement d'autres images dans Tux Paint | +| IV. Lectures complémentaires | +| V. Comment obtenir de l'aide | +| VI. Comment participer | ++-------------------------------------------------------+ - I. À propos de Tux Paint +I. À propos de Tux Paint A. Qu'est-ce que "Tux Paint" ? - Tux Paint est un programme de dessin gratuit conçu pour les jeunes enfants - (enfants de 3 ans et plus). Il possède une interface simple et facile à - utiliser, des effets sonores amusants et une mascotte de dessin animé pour - encourager et guider les enfants lorsqu'ils utilisent le programme. Sont - fournis une toile vierge et un ensemble d'outils de dessin pour aider - votre enfant à être créatif. +Tux Paint est un programme de dessin gratuit conçu pour les jeunes enfants +(enfants de 3 ans et plus). Il possède une interface simple et facile à +utiliser, des effets sonores amusants et une mascotte de dessin animé pour +encourager et guider les enfants lorsqu'ils utilisent le programme. Sont +fournis une toile vierge et un ensemble d'outils de dessin pour aider votre +enfant à être créatif. B. Objectives - Facile et amusant - Tux Paint se veut un simple programme de dessin pour les jeunes - enfants. Il ne s'agit pas d'un programme de dessin à usage - général. Il se veut amusant et facile à utiliser. Les effets - sonores et un personnage de dessin animé permettent à - l'utilisateur de savoir ce qui se passe tout en le divertissant. - Il existe également des pointeurs de souris, de style dessin - animé, extra-larges. +Facile et amusant + Tux Paint se veut un simple programme de dessin pour les jeunes enfants. Il + ne s'agit pas d'un programme de dessin à usage général. Il se veut amusant + et facile à utiliser. Les effets sonores et un personnage de dessin animé + permettent à l'utilisateur de savoir ce qui se passe tout en le + divertissant. Il existe également des pointeurs de souris, de style dessin + animé, extra-larges. - Flexibilité - Tux Paint est extensible. Les brosses et les formes de "tampon en - caoutchouc" peuvent être déposées et retirées. Par exemple, un - enseignant peut apporter une collection de formes animales et - demander à ses élèves de dessiner un écosystème. Chaque forme peut - avoir un son qui l'accompagne et un texte est affiché lorsque - l'enfant sélectionne la forme. +Flexibilité + Tux Paint est extensible. Les brosses et les formes de "tampon en + caoutchouc" peuvent être déposées et retirées. Par exemple, un enseignant + peut apporter une collection de formes animales et demander à ses élèves de + dessiner un écosystème. Chaque forme peut avoir un son qui l'accompagne et + un texte est affiché lorsque l'enfant sélectionne la forme. - Portabilité - Tux Paint est portable sur diverses plates-formes informatiques: - Windows, Macintosh, Linux, etc. L'interface est la même sur - toutes. Tux Paint fonctionne correctement sur les systèmes plus - anciens (comme un Pentium 133), et peut être modifié pour mieux - fonctionner sur des systèmes lents. +Portabilité + Tux Paint est portable sur diverses plates-formes informatiques: Windows, + Macintosh, Linux, etc. L'interface est la même sur toutes. Tux Paint + fonctionne correctement sur les systèmes plus anciens (comme un Pentium + 133), et peut être modifié pour mieux fonctionner sur des systèmes lents. - Simplicité - Il n'y a pas d'accès direct à la complexité sous-jacente de - l'ordinateur. L'image en cours est conservée lorsque le programme - se ferme et réapparaît au redémarrage. L'enregistrement d'images - ne nécessite pas la création de noms de fichiers ou l'utilisation - du clavier. L'ouverture d'une image se fait en la sélectionnant - dans une collection de vignettes. L'accès à d'autres fichiers sur - l'ordinateur est restreint. +Simplicité + Il n'y a pas d'accès direct à la complexité sous-jacente de l'ordinateur. + L'image en cours est conservée lorsque le programme se ferme et réapparaît + au redémarrage. L'enregistrement d'images ne nécessite pas la création de + noms de fichiers ou l'utilisation du clavier. L'ouverture d'une image se + fait en la sélectionnant dans une collection de vignettes. L'accès à + d'autres fichiers sur l'ordinateur est restreint. + +Accessibilité + Tux Paint offers a number of accessibility options, including increasing + the size of control buttons, changing the UI font, options to control the + cursor (mouse pointer) using the keyboard or other input devices (joystick, + gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks. - Accessibilité - Tux Paint offers a number of accessibility options, including - increasing the size of control buttons, changing the UI font, - options to control the cursor (mouse pointer) using the keyboard - or other input devices (joystick, gamepad, etc.), an on-screen - keyboard, and "stick" mouse clicks. C. Licence - Tux Paint est un projet Open Source, un logiciel libre publié sous la - licence publique générale GNU (GPL). Il est gratuit et le «code source» du - programme est disponible. (Cela permet à d'autres d'ajouter des - fonctionnalités, de corriger des bogues et d'utiliser des parties du - programme dans leur propre logiciel sous GPL.) +Tux Paint est un projet Open Source, un logiciel libre publié sous la licence +publique générale GNU (GPL). Il est gratuit et le «code source» du programme +est disponible. (Cela permet à d'autres d'ajouter des fonctionnalités, de +corriger des bogues et d'utiliser des parties du programme dans leur propre +logiciel sous GPL.) - Voir COPYING.txt pour le texte complet de la licence GPL. +Voir COPYING.txt pour le texte complet de la licence GPL. D. What's New in Tux Paint version 0.9.31? - Fuzzy Erasers - Fuzzy-edged round erasers have been added to the Eraser tool +Fuzzy Erasers + Fuzzy-edged round erasers have been added to the Eraser tool - New Magic tools - Loops, Ribbon, Smooth, and Squiggles +New Magic tools + Loops, Ribbon, Smooth, and Squiggles - Create templates from Open dialog - Saved drawings can be turned into templates (used to make new - drawings) via a new option in the Open dialog. (This feature may - be deactivated using the "notemplateexport" simplification - option.) +Create templates from Open dialog + Saved drawings can be turned into templates (used to make new drawings) via + a new option in the Open dialog. (This feature may be deactivated using the + "notemplateexport" simplification option.) - User interface font may be overridden - The font used for the user interface (button labels, dialog - pop-ups, and instructions) can be overridden from its default - ("DejaVu Sans"). (See the "uifont" configuration option. Use - "--listfonts" to see a list of available fonts.) +User interface font may be overridden + The font used for the user interface (button labels, dialog pop-ups, and + instructions) can be overridden from its default ("DejaVu Sans"). (See the + "uifont" configuration option. Use "--listfonts" to see a list of available + fonts.) - File Erase may be disabled - Controls to erase saved work — saved drawings (via the Open - dialog) and exported templates (via the New dialog) — can be - disabled. (See the "noerase" configuration option.) +File Erase may be disabled - "Controlling Tux Paint" documentation - A brief overview of how Tux Paint can be controlled — mouse, - tablet, touchscreen, joystick, and keyboard — has been added to - the README documentation. + Controls to erase saved work — saved drawings (via the Open dialog) and + exported templates (via the New dialog) — can be disabled. (See the + "noerase" configuration option.) - See CHANGES.txt for the complete list of changes. +"Controlling Tux Paint" documentation - II. Utiliser Tux Paint + A brief overview of how Tux Paint can be controlled — mouse, tablet, + touchscreen, joystick, and keyboard — has been added to the README + documentation. + + +See CHANGES.txt for the complete list of changes. + +II. Utiliser Tux Paint A. Lancement de Tux Paint - 1. Utilisateurs de Linux/Unix +1. Utilisateurs de Linux/Unix - Tux Paint should have placed a launcher icon in your KDE and/or GNOME - menus, under 'Graphics.' +Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus, +under 'Graphics.' - Autrement, vous pouvez exécuter la commande suivante à une invite du shell - (par exemple, "$") : +Autrement, vous pouvez exécuter la commande suivante à une invite du shell (par +exemple, "$") : - $ tuxpaint + $ tuxpaint - Si des erreurs se produisent, elles seront affichées sur le terminal - ("stderr"). +Si des erreurs se produisent, elles seront affichées sur le terminal +("stderr"). - 2. Utilisateurs de Windows +2. Utilisateurs de Windows - [Icône pour Tux Paint] - Tux Paint +[Icône pour Tux Paint] + Tux Paint - Si vous avez installé Tux Paint sur votre ordinateur en utilisant le 'Tux - Paint Installer', il vous aura demandé si vous vouliez un raccourci de - menu 'Démarrer' et / ou un raccourci sur le bureau. Si vous avez accepté, - vous pouvez simplement exécuter Tux Paint à partir de la section 'Tux - Paint' de votre menu 'Démarrer' (par exemple, sous «Tous les programmes» - sous Windows XP), ou en double-cliquant sur l'icône «Tux Paint» sur votre - bureau . +Si vous avez installé Tux Paint sur votre ordinateur en utilisant le 'Tux Paint +Installer', il vous aura demandé si vous vouliez un raccourci de menu +'Démarrer' et / ou un raccourci sur le bureau. Si vous avez accepté, vous +pouvez simplement exécuter Tux Paint à partir de la section 'Tux Paint' de +votre menu 'Démarrer' (par exemple, sous «Tous les programmes» sous Windows +XP), ou en double-cliquant sur l'icône «Tux Paint» sur votre bureau . - Si vous avez installé Tux Paint en utilisant le téléchargement 'ZIP-file', - ou si vous avez utilisé 'Tux Paint Installer', mais que vous avez choisi - de ne pas installer de raccourcis, vous devrez double-cliquer sur l'icône - "tuxpaint.exe" dans le dossier "Tux Paint" de votre ordinateur. +Si vous avez installé Tux Paint en utilisant le téléchargement 'ZIP-file', ou +si vous avez utilisé 'Tux Paint Installer', mais que vous avez choisi de ne pas +installer de raccourcis, vous devrez double-cliquer sur l'icône "tuxpaint.exe" +dans le dossier "Tux Paint" de votre ordinateur. - Par défaut, le 'Tux Paint Installer' mettra le dossier de Tux Paint dans - "C:\Program Files\",ou bien vous avez pu changer cela lors de l'exécution - du programme d'installation. +Par défaut, le 'Tux Paint Installer' mettra le dossier de Tux Paint dans "C:\ +Program Files\",ou bien vous avez pu changer cela lors de l'exécution du +programme d'installation. - Si vous avez utilisé le téléchargement de 'ZIP-file', le dossier de Tux - Paint sera là où vous l'avez placé lorsque vous avez décompressé le - fichier ZIP. +Si vous avez utilisé le téléchargement de 'ZIP-file', le dossier de Tux Paint +sera là où vous l'avez placé lorsque vous avez décompressé le fichier ZIP. - 3. Utilisateurs de macOS +3. Utilisateurs de macOS - Double-cliquez simplement sur l'icône "Tux Paint". +Double-cliquez simplement sur l'icône "Tux Paint". - [Écran-titre] +[Écran-titre] B. Écran titre - Lors du premier chargement de Tux Paint, un écran avec titre et crédits - apparaîtra. +Lors du premier chargement de Tux Paint, un écran avec titre et crédits +apparaîtra. - Une fois le chargement terminé, appuyez sur une touche ou cliquez sur la - souris pour continuer. (Ou, après environ 30 secondes, l'écran-titre - disparaîtra automatiquement.) +Une fois le chargement terminé, appuyez sur une touche ou cliquez sur la souris +pour continuer. (Ou, après environ 30 secondes, l'écran-titre disparaîtra +automatiquement.) C. Écran principal - L'écran principal est divisé en plusieurs sections : +L'écran principal est divisé en plusieurs sections : - [Outils : Peindre, Tampon, Lignes, Formes, Texte, Magie, Étiquette, - Défaire, Refaire, Gomme, Nouveau, Ouvrir, Sauvegarder, Imprimer, Quitter] +[Outils : Peindre, Tampon, Lignes, Formes, Texte, Magie, Étiquette, Défaire, + Refaire, Gomme, Nouveau, Ouvrir, Sauvegarder, Imprimer, Quitter] +Côté gauche : la barre d'outils - Côté gauche : la barre d'outils + La barre d'outils contient les commandes pour dessiner et éditer. - La barre d'outils contient les commandes pour dessiner et éditer. - [Toile] - Milieu : Toile pour Dessiner + [Toile] +Milieu : Toile pour Dessiner - La plus grande partie de l'écran, au centre, est la toile de - dessin. C'est évidemment là que vous dessinerez ! + La plus grande partie de l'écran, au centre, est la toile de dessin. C'est + évidemment là que vous dessinerez ! - 💡 Remarque: la taille de la toile de dessin dépend de la taille de - Tux Paint. Vous pouvez modifier la taille de Tux Paint à l'aide de - l'outil de configuration tuxpaint-config, ou par d’autres moyens. - Consultez la documentation OPTIONS pour plus de détails. + 💡 Remarque: la taille de la toile de dessin dépend de la taille de Tux + Paint. Vous pouvez modifier la taille de Tux Paint à l'aide de l'outil de + configuration tuxpaint-config, ou par d’autres moyens. Consultez la + documentation OPTIONS pour plus de détails. - [Sélecteurs - Pinceaux, Lettres, Formes, Tampons] - Côté droit : sélecteur - En fonction de l'outil en cours d'utilisation, le sélecteur - affiche différentes choses. Par exemple, lorsque l'outil Pinceau - est sélectionné, il affiche les différents pinceaux disponibles. - Lorsque l'outil Tampon en caoutchouc est sélectionné, il affiche - les différentes formes que vous pouvez utiliser. + [Sélecteurs - Pinceaux, Lettres, Formes, Tampons] +Côté droit : sélecteur - [Couleurs - Noir, Blanc, Rouge, Rose, Orange, Jaune, Vert, Cyan, - Bleu, Pourpre, Brun, Gris] + En fonction de l'outil en cours d'utilisation, le sélecteur affiche + différentes choses. Par exemple, lorsque l'outil Pinceau est sélectionné, + il affiche les différents pinceaux disponibles. Lorsque l'outil Tampon en + caoutchouc est sélectionné, il affiche les différentes formes que vous + pouvez utiliser. - En bas : couleurs - When the active tool supports colors, a palette of colors choices - will be shown near the bottom of the screen. Click one to choose a - color, and it will be used by the active tool. (For example, the - "Paint" tool will use it as the color to draw with the chosen - brush, and the "Fill" tool will use it as the color to use when - flood-filling an area of the picture.) - On the far right are three special color options: - * Color Picker - The "color picker" (which has an outline of an eye-dropper) - allows you to pick a color found within your drawing. - (A shortcut key is available to access this feature quickly; - see below.) - * Rainbow Palette - The rainbow palette allows you to pick any color by choosing - the hue, saturation, and value of the color you want. A box - on the left displays hundreds of hues — from red at the top - through to violet at the bottom — at hundreds of - saturation/intensity levels — from pale & washed-out on the - left through to pure on the right. A grey vertical bar - provides access to hundreds of value levels — from lighest at - the top through to darkest at the bottom. - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. - You may also set this tool's color to that of other color - choices: - * Whichever built-in color is selected, if any - * The Color Picker's current color - * The Color Mixer's current color - * Color Mixer - The "color mixer" (which has silhouette of a paint palette) - allows you to create colors by blending primary additive - colors — red, yellow, and blue — along with white (to - "tint"), grey (to "tone"), and black (to "shade"). - You may click any button multiple times (for example, red + - red + yellow results in a red-orange color). The ratios of - colors added are shown at the bottom. - You can start over (reset to no colors in your picture) by - clicking the "Clear" button. You can also undo or redo - multiple steps of mixing, in case you made a mistake (without - having to start over). - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. + [Couleurs - Noir, Blanc, Rouge, Rose, Orange, Jaune, Vert, Cyan, Bleu, + Pourpre, Brun, Gris] +En bas : couleurs - ⌨ When the active tool supports colors, a shortcut may be used for - quick access to the "color picker" option. Hold the [Control] key - while clicking, and the color under the mouse cursor will be shown - at the bottom. You may drag around to canvas to find the color you - want. When you release the mouse button, the color under the - cursor will be selected. If you release the mouse outside of the - canvas (e.g., over the "Tools" area), the color selection will be - left unchanged. (This is similar to clicking the "Back" button - that's available when bringing up the "color picker" option via - its button the color palette.) + When the active tool supports colors, a palette of colors choices will be + shown near the bottom of the screen. Click one to choose a color, and it + will be used by the active tool. (For example, the "Paint" tool will use it + as the color to draw with the chosen brush, and the "Fill" tool will use it + as the color to use when flood-filling an area of the picture.) - ⚙ Note: You can define your own colors for Tux Paint. See the - "Options" documentation. + On the far right are three special color options: + + Color Picker + The "color picker" (which has an outline of an eye-dropper) allows you + to pick a color found within your drawing. + (A shortcut key is available to access this feature quickly; see + below.) + + Rainbow Palette + The rainbow palette allows you to pick any color by choosing the hue, + saturation, and value of the color you want. A box on the left displays + hundreds of hues — from red at the top through to violet at the bottom + — at hundreds of saturation/intensity levels — from pale & washed-out + on the left through to pure on the right. A grey vertical bar provides + access to hundreds of value levels — from lighest at the top through to + darkest at the bottom. + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + You may also set this tool's color to that of other color choices: + o Whichever built-in color is selected, if any + o The Color Picker's current color + o The Color Mixer's current color + + Color Mixer + The "color mixer" (which has silhouette of a paint palette) allows you + to create colors by blending primary additive colors — red, yellow, and + blue — along with white (to "tint"), grey (to "tone"), and black (to + "shade"). + You may click any button multiple times (for example, red + red + + yellow results in a red-orange color). The ratios of colors added are + shown at the bottom. + You can start over (reset to no colors in your picture) by clicking the + "Clear" button. You can also undo or redo multiple steps of mixing, in + case you made a mistake (without having to start over). + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + + ⌨ When the active tool supports colors, a shortcut may be used for quick + access to the "color picker" option. Hold the [Control] key while clicking, + and the color under the mouse cursor will be shown at the bottom. You may + drag around to canvas to find the color you want. When you release the + mouse button, the color under the cursor will be selected. If you release + the mouse outside of the canvas (e.g., over the "Tools" area), the color + selection will be left unchanged. (This is similar to clicking the "Back" + button that's available when bringing up the "color picker" option via its + button the color palette.) + + ⚙ Note: You can define your own colors for Tux Paint. See the "Options" + documentation. + + + + (Par exemple : Choisis une forme. Clique pour démarrer le dessin , fais + glisser et continue jusqu'à la taille désirée. Déplace-toi pour la faire + tourner, et clique pour dessiner.) +En bas : zone d'aide + + Tout en bas de l'écran, Tux, le pingouin Linux, fournit des conseils et + d'autres informations pendant que vous dessinez. - (Par exemple : Choisis une forme. Clique pour démarrer le dessin , - fais glisser et continue jusqu'à la taille désirée. Déplace-toi - pour la faire tourner, et clique pour dessiner.) - En bas : zone d'aide - Tout en bas de l'écran, Tux, le pingouin Linux, fournit des - conseils et d'autres informations pendant que vous dessinez. D. Outils disponibles - 1. Outils de dessin - - a. Outil "Peinture" (pinceau) - - L'outil Pinceau vous permet de dessiner à main levée, en utilisant - différents pinceaux (choisis dans le sélecteur à droite) et - couleurs (choisis dans la palette de couleurs qui est en bas). - - Si vous maintenez le bouton de la souris enfoncé et déplacez la - souris, elle dessine au fur et à mesure que vous vous déplacez. - - Cerains pinceaux sont animés — ils changent de forme lorsque vous - dessinez. Un bon exemple est le pinceau 'grappe' livré avec Tux - Paint. Ces pinceaux ont une icône avec une petite pellicule - dessinée sur le bouton de sélection. - - D'autres pinceaux sont directionnels — leur forme dépend de la - direction dans laquelle vous dessinez. Un exemple est le pinceau - flèche livré avec Tux Paint. Ces pinceaux ont une petite étoile à - 8 branches sur leur icône du bouton de sékection. - - Et enfin, certains pinceaux peuvent être = la fois directionnels - et animés. Des exemples sont les pinceaux 'chat' et 'écureuil' - livrés avec Tux Paint. Ces pinceaux ont à la fois une pellicule et - une étoile à 8 branches sur leur icône. - - Pendant que vous dessinez, un son est joué. Plus la brosse est - grosse, plus le son est grave. - - Espacement des pinceaux - - The space between each position where a brush is applied to the - canvas can vary. Some brushes (such as the footprints and - flower) are spaced, by default, far enough apart that they don't - overlap. Other brushes (such as the basic circular ones) are - spaced closely, so they make a continuous stroke. - - The default spacing of brushes may be overridden using by - clicking within the triangular-shaped series of bars at the - bottom right; the larger the bar, the wider the spacing. Brush - spacing affects both tools that use the brushes: the "Paint" - tool and the "Lines" tool. - - ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't - display the brush spacing controls. See the "Options" - documentation. - - b.Outil "Tampon" (tampon de caoutchouc) - - L'outil Tampon montre un ensemble de tampons en caoutchouc ou - d'autocollants. Il vous permet de coller des images pré-dessinées - ou photographiques (comme l'image d'un cheval, d'un arbre ou de la - lune) dans votre dessin. - - As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be. Click on the canvas where you wish to place the stamp. - - Stamp Categories - Il peut y avoir de nombreuses catégories de timbres - (par ex. animaux, plantes, espace - extra-atmosphérique, véhicules, personnes, etc.). - Utilisez les flèches gauche et droite pour parcourir - les différentes collections. - - Stamp Rotation - - Using the rotation toggle button near the bottom - right, you can enable a rotation step when placing - stamps. Once you've placed the stamp, choose the - angle to rotate it by moving the mouse around the - canvas. Click the mouse button again and the stamp - will be added to the drawing. - - ⚙ Note: If "stamp rotation" option is disabled, the - stamp will be drawn on the canvas when you let go of - the mouse button. (There's no rotation step.) See the - "Options" documentation to learn about the "stamp - rotation" ("stamprotation") option. - - 📜 Note: The stamp rotation feature was added to Tux - Paint in version 0.9.29. - - Stamp Controls - - Avant de `` tamponner '' une image sur votre dessin, - différents effets peuvent parfois être appliqués (en - fonction du tampon) : - - * Certains tampons peuvent être colorés ou - teintés. Si la palette de couleurs sous le - canevas est activée, vous pouvez cliquer sur les - couleurs pour changer la teinte ou la couleur du - tampon avant de le placer dans le dessin. - * Les tampons peuvent être rétrécis et agrandis, - en cliquant dans l'ensemble de barres (de forme - triangulaire) en bas à droite; plus la barre est - grande, plus le tampon apparaîtra grand sur - votre dessin. - * De nombreux tampons peuvent être retournés - verticalement ou affichés sous forme d'image - miroir à l'aide des boutons de commande en bas à - droite. - - ⚙ Note: If the "nostampcontrols" option is set, Tux - Paint won't display the Rotation, Mirror, Flip, or - sizing controls for stamps. See the "Options" - documentation. - - Stamp Sounds - - Les tampons peuvent avoir un effet sonore et / ou une - description orale (parlés). Les boutons en bas à - gauche (près de Tux, le pingouin Linux) vous - permettent de rejouer les effets sonores et la - description du tampon actuellement sélectionné. - - c.Outil "Lignes" - - Cet outil vous permet de dessiner des lignes droites à l'aide des - différents pinceaux et couleurs que vous utilisez habituellement. - - Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line will - show where the line will be drawn. At the bottom, you'll see the - angle of your line, in degrees. A line going straight to the right - is 0°, a line going straight up is 90°, a line going straight left - is 180°, a line going straight down is 270°, and so on. - - Relâchez la souris pour terminer la ligne. On entend alors le son - "sproing !". - - Certains pinceaux sont animés, et montre un ensemble formes le - long d'une ligne. D'autres sont directionnels et montre des formes - différentes suivant l'angle du pinceau. Et enfin certains sont à - la fois animés et directionnels. Voir "Paint", au-dessus, pour en - savoir plus. - - Different brushes have different spacing, leaving either a series - of individual shapes, or a continuous stroke of the brush shape. - Brush spacing may be adjusted. See the brush spacing section of - the "Paint" tool, above, to learn more. - - d.Outil "Formes" - - Cet outil vous permet de dessiner des formes simples remplies ou - non remplies. - - Choisissez une forme dans le sélecteur de droite (cercle, - carré,ovale, etc.). - - Utilisez les options en bas à droite pour choisir le comportement - de l'outil : - - Formes à partir du centre - The shape will expand from where you initially - clicked, and will be centered around that position. - - 📜 This was Tux Paint's only behavior through version - 0.9.24.) - - Formes à partir d'un coin - The shape will extend with one corner starting from - where you initially clicked. This is the default - method of most other traditional drawing software. - - 📜 This option was added starting with Tux Paint - version 0.9.25. - - ⚙ Remarque : si les contrôles de forme sont désactivés (par - exemple, avec l'option "noshapecontrols"), il n'y aura pas de - contrôle et la méthode "formes à partir du centre" sera utilisée. - - Dans le dessin, cliquez sur la souris et maintenez-la pour étirer - la forme à partir de l'endroit où vous avez cliqué. Certaines - formes peuvent changer de proportion (par exemple, le rectangle et - l'ovale peuvent être plus larges que hauts ou plus hauts que - larges), d'autres pas (par exemple, carré et cercle). - - For shapes that can change proportion, the aspect ratio of the - shape will be shown at the bottom. For example: "1:1" will be - shown if it is "square" (as tall as it is wide); "2:1" if it is - either twice as wide as it is tall, or twice as tall as it is - wide; and so on. - - Relâchez la souris lorsque vous avez terminé l'étirement. - - Mode normal - - Now you can move the mouse around the canvas to - rotate the shape. The angle your shape is rotated - will be shown at the bottom, in degrees (similar to - the "Lines" tool, described above). - - Cliquez à nouveau sur le bouton de la souris et la - forme sera dessinée avec la couleur en cours. - - Mode de Formes Simples - If the "simple shapes" option is enabled, the shape - will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) - - ⚙ See the "Options" documentation to learn about the - "simple shapes" ("simpleshapes") option. - - e.Outils "Texte" et "Étiquette" - - Choose a font (from the 'Letters' available on the right) and a - color (from the color palette near the bottom). You may also apply - a bold, and/or an italic styling effect to the text. Click on the - screen and a cursor will appear. Type text and it will show up on - the screen. (You can change the font, color, and styling while - entering the text, before it is applied to the canvas.) - - Appuyez sur [Entrée] ou [Retour] et le texte sera inclus dans - l'image et le curseur se déplacera d'une ligne vers le bas. - - Sinon, appuyez sur [Tab] et le texte sera inclus dans l'image, - mais le curseur se déplacera vers la droite du texte, plutôt que - vers le bas d'une ligne et vers la gauche. (Cela peut être utile - pour créer une ligne de texte avec des couleurs, des polices, des - styles et des tailles variés.) - - Cliquer ailleurs dans l'image alors que l'entrée de texte est - toujours active entraîne le déplacement de la ligne de texte - actuelle vers cet emplacement (et vous pouvez continuer à la - modifier). - - "Texte" par rapport à "Étiquette" - - L' outil Texte est l'outil de saisie de texte - original de Tux Paint. Le texte saisi à l'aide de cet - outil ne peut pas être modifié ou déplacé - ultérieurement, car il fait partie du dessin. - Cependant, comme le texte fait partie de l'image, il - peut être dessiné ou modifié à l'aide des effets de - l'outil Magie (par exemple, taché, teinté, gaufré, - etc.) - - Lors de l'utilisation de l' outil Étiquette (qui a - été ajouté à Tux Paint dans la version 0.9.22), le - texte `` flotte '' sur l'image, et les détails de - l'étiquette (le texte, la position de l'étiquette, le - choix de la police et la couleur ) sont stockés - séparément. Cela permet à l'étiquette d'être - repositionnée ou modifiée ultérieurement. - - To edit a label, click the label selection button. - All labels in the drawing will appear highlighted. - Click one — or use the [Tab] key to cycle through all - the labels, and the [Entrée] or [Retour] key to - select one — and you may then edit the label. (Use - they [Backspace] key to erase characters, and other - keys to add text to the label; click in the canvas to - reposition the label; click in the palette to change - the color of the text in the label; etc.) - - You may "apply" a label to the canvas, painting the - text into the picture as if it had been added using - the Text tool, by clicking the label application - button. (This feature was added in Tux Paint version - 0.9.28.) All labels in the drawing will appear - highlighted, and you select one just as you do when - selecting a label to edit. The chosen label will be - removed, and the text will be added directly to the - canvas. - - ⚙ L' outil Étiquette peut être désactivé (par - exemple, en sélectionnant "Désactiver l'outil - 'Label'" dans Tux Paint Config ou bien en exécutant - Tux Paint en ligne de commande avec l'option - "nolabel"). - - Saisie de caractères internationaux - - Tux Paint permet de saisir des caractères dans - différentes langues. La plupart des caractères latins - ( A - Z , ñ , è , etc...) peuvent être saisis - directement. Certaines langues exigent que Tux Paint - soit commuté dans un mode d'entrée alternatif avant - la saisie, et certains caractères doivent être - composés en utilisant plusieurs touches. - - Lorsque les paramètres régionaux de Tux Paint sont - définis sur l'une des langues fournissant des modes - de saisie alternatifs, une touche est utilisée pour - parcourir le ou les modes soit normaux (caractère - latin) soit spécifiques aux paramètres régionaux. - - Currently supported locales, the input methods - available, and the key to toggle or cycle modes, are - listed below. - - * Japanese — Romanized Hiragana and Romanized - Katakana — touche [Alt] droite or touche [Alt] - gauche - * Korean — Hangul 2-Bul — touche [Alt] droite or - touche [Alt] gauche - * Chinois traditionnel — touche [Alt] droite or - touche [Alt] gauche - * Thai — touche [Alt] droite - - 💡 Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change - fonts to see the characters you're trying to type. - - Clavier virtuel sur écran - - An optional on-screen keyboard is available for the - Text and Label tools, which can provide a variety of - layouts and character composition (e.g., composing - "a" and "e" into "æ"). - - ⚙ See the "Options" and "Extending Tux Paint" - documentation for more information. - - f.Outil "Remplir" - - L'outil «Remplir» «remplit» une zone contiguë de votre dessin avec - une couleur unie de votre choix. Trois options de remplissage sont - offertes : - * Solide — cliquez une fois pour remplir une zone avec une - couleur unie. - * Brush — click and drag to fill an area with a solid color - using freehand painting. - * Linéaire—cliquez et faites glisser pour remplir une zone avec - une couleur qui s'atténue au fur et à mesure dans la - direction où vous déplacez la souris. - * Radial—cliquez une fois pour remplir une zone avec une - couleur qui s'atténue graduellement, à partir de l'endroit où - vous avez cliqué. - * Shaped — click once to fill an area with a color that fades - away (a gradient), following the contours of the shape you're - filling. - - 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see - below). Prior to Tux Paint 0.9.26, the "Fill" tool only offered - the 'Solid' method of filling. 'Shaped' fill was introduced in Tux - Paint 0.9.29. - - g.Outil "Magie" (Effets spéciaux) - - L'outil «Magie» est en fait un ensemble d'outils spéciaux. - Sélectionnez l'un des effets «magiques» dans le sélecteur de - droite. Ensuite, selon l'outil, vous pouvez soit cliquer et faire - glisser dans l'image, et / ou simplement cliquer une fois sur - l'image pour appliquer l'effet. - - Magic Controls - - Si l'outil peut être utilisé en cliquant et en faisant glisser, - un bouton «peinture» sera disponible sur la gauche, sous la - liste des outils «magiques» sur le côté droit de l'écran. Si - l'outil peut affecter toute l'image en entier, un bouton «Image - entière» sera disponible sur la droite. - - ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't - display the painting or entire picture controls. See the - "Options" documentation. - - 💡 If the magic controls are disabled, the Magic plugin may make - separate tools available, one for painting and one that affects - the entire pictre. - - Magic Sizing - - Some tools offer different sizing options. If so, a slider will - appear at the bottom right side of the screen. This may affect - the radius of a special effect (e.g., Darken) or painted object - (e.g., Patterns), or other attributes (e.g., large versus small - Brick shapes). - - ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't - display the sizing controls. See the "Options" documentation. - - 💡 If the sizing option is disabled, the Magic plugin may simply - offer a default size (e.g., Patterns), or it may make separate - tools available with different pre-set sizes (e.g., Bricks and - Googly Eyes). - - 📜 This option was added starting with Tux Paint version 0.9.30. - - Voir les instructions pour chaque outil 'Magie' (dans le dossier - 'magic-docs'). - - h.Outil "Gomme" - - Cet outil est similaire au pinceau. Partout où vous cliquez (ou - cliquez et faites glisser), l'image sera effacée. (Cela peut être - du blanc, une autre couleur ou une image d'arrière-plan, selon - l'image.) - - A number of eraser sizes are available, with both square and round - shapes. Fuzzy-edged round shapes are also available. - - Lorsque vous déplacez la souris, un contour carré suit le - pointeur, indiquant quelle partie de l'image sera effacée en - blanc. - - Au fur et à mesure que vous effacez, un grincement est émis. - - ⌨ Hold the [X] key while clicking for quick access to a small - sharp round eraser (not available when the Text or Label tools are - selected, when you're in the process of rotating a stamp or shape, - or when using an interactive magic tool). Release the mouse to - return to your currently-selected tool. - - 2. Autres contrôles - - a."Undo" and "Redo" Commands - - Clicking the "Undo" button will undo (revert) the last drawing - action. You can even undo more than once! - - ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [Z] sur - le clavier pour Défaire. - - Clicking the "Redo" button will redo the drawing action you just - un-did via the "Undo" command. - - Tant que vous ne dessinez plus, vous pouvez refaire autant de fois - que vous avez défait ! - - ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [R] sur - le clavier pour Refaire. - - b.Commande "Nouveau" - - Cliquez sur le bouton "Nouveau" pour démarrer un nouveau dessin. - Une boîte de dialogue apparaîtra, avec laquelle vous pouvez - choisir de commencer une nouvelle image en utilisant une couleur - d'arrière-plan unie, ou en utilisant une image 'Starter' ou - 'Template' (voir ci-dessous). On vous demandera d'abord si vous - voulez vraiment faire cela. - - ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [N] sur - le clavier pour commencer un nouveau dessin. - - Special Solid Background Color Choices - Along with the preset solid colors, you can also - choose colors using a rainbow palette or a "color - mixer". These operate identically to the options - found in the color palette shown below the canvas - when drawing a picture. See Main Screen > Lower: - Colors > Special color options for details. - - Images de "Démarrage" et images "Modèle" - * Les "Images de démarrage" se comportent comme - une page d'un livre de coloriage - un contour - noir et blanc d'une image, que vous pouvez - ensuite colorier, et le contour noir reste - intact - ou comme une photographie 3D, où vous - dessinez entre une couche de premier plan et une - d'arrière-plan. - * Les "Images modèle" sont semblables, mais - fournissent simplement un dessin d'arrière-plan - sur lequel travailler. Contrairement aux «Images - de démarrage», rien de ce que vous dessinerez ne - restera au premier plan. - - Lorsque vous utiliserez l'outil «Gomme», l'image - d'origine du «Démarrage» ou du «Modèle» réapparaîtra. - Les outils magiques "Retourner" et "Miroir" - affecteront aussi bien l'orientation de "l'image de - démarrage" que celle de "l'image Modèle". - - Lorsque vous chargez une 'Image modèle' ou 'image - modèle', dessinez dessus, puis cliquez sur - 'Sauvegarder', cela crée un nouveau fichier image - - il n'écrase pas l'original, vous pouvez donc - l'utiliser à nouveau plus tard (en y accédant depuis - la boîte de dialogue 'Nouveau'). - - ⚙ You can create your own 'Starter' and Template - images. See the Extending Tux Paint documentation's - sections on 'Starters' and Templates. - - 💡 You can also convert your saved drawings into - Templates directly within Tux Paint, from the 'Open' - dialog. See "Open", below. - - Erasing Exported Template Images - - If you've selected a Template in your personal - templates folder, and it was created from within Tux - Paint (using the "Template" button in the "Open" - dialog), you may remove it from within Tux Paint, - too. An 'Erase' (trash can) button will appear at the - lower right of the list. Click it to erase the - selected template. (You will be asked to confirm.) +1. Outils de dessin - 💡 Note: On Linux, Windows, and macOS, the picture - will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you - change your mind). - - ⚙ Note: The 'Erase' button may be disabled, via the - "noerase" option. +a. Outil "Peinture" (pinceau) - ⚙ Note: The solid colors can be placed at the end of the 'New' - dialog (below the Starters and Templates), via the "newcolorslast" - option. - - c.Commande "Ouvrir" + L'outil Pinceau vous permet de dessiner à main levée, en utilisant + différents pinceaux (choisis dans le sélecteur à droite) et couleurs + (choisis dans la palette de couleurs qui est en bas). - Cela vous montre une liste de toutes les images que vous avez - enregistrées. S'il y en a plus que ce que peut contenir l'écran, - utilisez les flèches «Haut» et «Bas» en haut et en bas de la liste - pour faire défiler la liste des images. + Si vous maintenez le bouton de la souris enfoncé et déplacez la souris, + elle dessine au fur et à mesure que vous vous déplacez. - Cliquez sur une image pour la sélectionner, puis ... - * Click the green 'Open' button at the lower left of the list - to load the selected picture. You will then be able to edit - it. - - (Vous pouvez également double-cliquer sur l'icône d'une image - pour la charger.) + Cerains pinceaux sont animés — ils changent de forme lorsque vous dessinez. + Un bon exemple est le pinceau 'grappe' livré avec Tux Paint. Ces pinceaux + ont une icône avec une petite pellicule dessinée sur le bouton de + sélection. - 💡 If choose to open a picture, and your current drawing - hasn't been saved, you will be prompted as to whether you - want to save it or not. (See "Save," below.) + D'autres pinceaux sont directionnels — leur forme dépend de la direction + dans laquelle vous dessinez. Un exemple est le pinceau flèche livré avec + Tux Paint. Ces pinceaux ont une petite étoile à 8 branches sur leur icône + du bouton de sékection. - * Cliquez sur le bouton marron "Effacer" (poubelle) en bas à - droite de la liste pour effacer l'image sélectionnée. (Il - vous sera demandé de confirmer.) + Et enfin, certains pinceaux peuvent être = la fois directionnels et animés. + Des exemples sont les pinceaux 'chat' et 'écureuil' livrés avec Tux Paint. + Ces pinceaux ont à la fois une pellicule et une étoile à 8 branches sur + leur icône. - 📜 Note: On Linux (as of version 0.9.22), Windows (as of - version 0.9.27), and macOS (as of version 0.9.29), the - picture will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you change your - mind). + Pendant que vous dessinez, un son est joué. Plus la brosse est grosse, plus + le son est grave. - ⚙ Note: The 'Erase' button may be disabled, via the "noerase" - option. + Espacement des pinceaux - * Click the 'Export' button near the lower right to export the - selected picture to your export folder. (e.g., - "~/Pictures/TuxPaint/") - From the "Open" screen you can also: - * Click the blue 'Slides' (slide projector) button at the lower - left to go to slideshow mode. See "Slides", below, for - details. + The space between each position where a brush is applied to the canvas + can vary. Some brushes (such as the footprints and flower) are spaced, + by default, far enough apart that they don't overlap. Other brushes + (such as the basic circular ones) are spaced closely, so they make a + continuous stroke. - * Click the blue 'Template' button at the lower left to go to - convert the selected picture into a new template, which can - be used as the basis for new drawings. + The default spacing of brushes may be overridden using by clicking + within the triangular-shaped series of bars at the bottom right; the + larger the bar, the wider the spacing. Brush spacing affects both tools + that use the brushes: the "Paint" tool and the "Lines" tool. - 📜 Note: The Template creation feature was added to Tux Paint - in version 0.9.31. To learn how to create Templates outside - of Tux Paint, see Extending Tux Paint + ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't display + the brush spacing controls. See the "Options" documentation. - ⚙ The Template creation feature can be disabled (e.g., by - selecting "Disable 'Make Template'" in Tux Paint Config. or - running Tux Paint with the "notemplateexport" option). - * Ou cliquez sur le bouton fléché rouge «Retour» en bas à - droite de la liste pour annuler et revenir à l'image que vous - étiez en train de dessiner. - ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [O] sur - le clavier pour afficher la boîte de dialogue "Ouvrir". +b.Outil "Tampon" (tampon de caoutchouc) - d.Commande "Sauvegarder" + L'outil Tampon montre un ensemble de tampons en caoutchouc ou + d'autocollants. Il vous permet de coller des images pré-dessinées ou + photographiques (comme l'image d'un cheval, d'un arbre ou de la lune) dans + votre dessin. - Pour sauvegarder votre image en cours. + As you move the mouse around the canvas, an outline follows the mouse, + showing where the stamp will be placed, and how big it will be. Click on + the canvas where you wish to place the stamp. - Si vous ne l'avez pas enregistré auparavant, il créera une - nouvelle entrée dans la liste des images enregistrées. - (c'est-à-dire qu'il créera un nouveau fichier) + Stamp Categories + Il peut y avoir de nombreuses catégories de timbres (par ex. animaux, + plantes, espace extra-atmosphérique, véhicules, personnes, etc.). + Utilisez les flèches gauche et droite pour parcourir les différentes + collections. - 💡 Remarque : il ne vous demandera rien (par exemple, un nom de - fichier). Il enregistrera simplement l'image et fera le bruit d'un - obturateur d'appareil photographique. + Stamp Rotation - Si vous avez déjà enregistré l'image, ou s'il s'agit d'une image - que vous venez de charger à l'aide de la commande "Ouvrir", il - vous sera d'abord demandé si vous voulez écraser l'ancienne - version ou bien créer une nouvelle entrée (un nouveau fichier). + Using the rotation toggle button near the bottom right, you can enable + a rotation step when placing stamps. Once you've placed the stamp, + choose the angle to rotate it by moving the mouse around the canvas. + Click the mouse button again and the stamp will be added to the + drawing. - ⚙ Remarque : si les options " saveover" ou " saveovernew" sont - déjà définies, il ne sera rien demandé avant de sauvegarder. Voir - la documentation Options. + ⚙ Note: If "stamp rotation" option is disabled, the stamp will be drawn + on the canvas when you let go of the mouse button. (There's no rotation + step.) See the "Options" documentation to learn about the "stamp + rotation" ("stamprotation") option. - ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [S] sur - le clavier pour sauvegarde. + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - e.Commande "Imprimer" - Cliquez sur ce bouton et votre image sera imprimée ! - Sur la plupart des plates-formes, vous pouvez également maintenir - la touche [Alt] (appelée [Option] sur Mac) tout en cliquant sur le - bouton «Imprimer» pour obtenir une boîte de dialogue d'impression. - Notez que cela pourrait ne pas fonctionner si vous exécutez Tux - Paint en mode plein écran. Voir ci-dessous. + Stamp Controls - Désactivation de l'impression + Avant de `` tamponner '' une image sur votre dessin, différents effets + peuvent parfois être appliqués (en fonction du tampon) : - On peut définir une option "noprint", ce qui - entraînera la désactivation du bouton "Imprimer". + o Certains tampons peuvent être colorés ou teintés. Si la palette de + couleurs sous le canevas est activée, vous pouvez cliquer sur les + couleurs pour changer la teinte ou la couleur du tampon avant de le + placer dans le dessin. + o Les tampons peuvent être rétrécis et agrandis, en cliquant dans + l'ensemble de barres (de forme triangulaire) en bas à droite; plus + la barre est grande, plus le tampon apparaîtra grand sur votre + dessin. + o De nombreux tampons peuvent être retournés verticalement ou + affichés sous forme d'image miroir à l'aide des boutons de commande + en bas à droite. - ⚙ Voir la documentation sur "Options". + ⚙ Note: If the "nostampcontrols" option is set, Tux Paint won't display + the Rotation, Mirror, Flip, or sizing controls for stamps. See the " + Options" documentation. - Restreindre l'impression - Si l'option "printdelay" a été utilisée, vous ne - pouvez imprimer — qu'une fois toutes les x secondes, - tel que vous l'avez défini. - Par exemple, avec "printdelay=60" dans le fichier de - configuration de Tux Paint, vous ne pouvez imprimer - qu'une fois par minute. + Stamp Sounds - ⚙ Voir la documentation sur "Options". + Les tampons peuvent avoir un effet sonore et / ou une description orale + (parlés). Les boutons en bas à gauche (près de Tux, le pingouin Linux) + vous permettent de rejouer les effets sonores et la description du + tampon actuellement sélectionné. - Commandes d'impression - (Linux et Unix uniquement) - Tux Paint imprime en générant une représentation - PostScript du dessin et en l'envoyant à un programme - externe. Par défaut, le programme est : - lpr - Cette commande peut être modifiée en définissant la - valeur "printcommand" dans le fichier de - configuration de Tux Paint. - Si la touche "[Alt]" du clavier est enfoncée tout en - cliquant sur le bouton «Imprimer», et tant que vous - n'êtes pas en mode plein écran, un programme - alternatif est exécuté. Par défaut, le programme est - la boîte de dialogue d'impression graphique de KDE : +c.Outil "Lignes" - kprinter + Cet outil vous permet de dessiner des lignes droites à l'aide des + différents pinceaux et couleurs que vous utilisez habituellement. - Cette commande peut être modifiée en définissant la - valeur "altprintcommand" dans le fichier de - configuration de Tux Paint. + Click the mouse and hold it to choose the starting point of the line. As + you move the mouse around, a thin 'rubber-band' line will show where the + line will be drawn. At the bottom, you'll see the angle of your line, in + degrees. A line going straight to the right is 0°, a line going straight up + is 90°, a line going straight left is 180°, a line going straight down is + 270°, and so on. - ⚙ Voir la documentation sur "Options". + Relâchez la souris pour terminer la ligne. On entend alors le son "sproing + !". - Réglages pour l'impression + Certains pinceaux sont animés, et montre un ensemble formes le long d'une + ligne. D'autres sont directionnels et montre des formes différentes suivant + l'angle du pinceau. Et enfin certains sont à la fois animés et + directionnels. Voir "Paint", au-dessus, pour en savoir plus. - (Windows et macOS) + Different brushes have different spacing, leaving either a series of + individual shapes, or a continuous stroke of the brush shape. Brush spacing + may be adjusted. See the brush spacing section of the "Paint" tool, above, + to learn more. - Par défaut, Tux Paint imprime simplement sur - l'imprimante par défaut avec les paramètres par - défaut lorsque le bouton «Imprimer» est enfoncé. - Cependant, si vous maintenez la touche [Alt] (ou - [Option]) du clavier tout en appuyant sur le bouton - "Imprimer, et ceci tant que vous n'êtes pas en mode - plein écran, la boîte de dialogue de l'imprimante de - votre système d'exploitation apparaît, et vous pouvez - modifier les réglages. - Vous pouvez stocker les changements de configuration, - entre les sessions de Tux Paint, en paramétrant - l'option "printcfg". +d.Outil "Formes" - Si l'option "printcfg" est utilisée, les réglages - d'impression seront chargés à partir du fichier - "printcfg.cfg" de votre répertoire personnel (voir - ci-dessous). Tout changement y sera ernregistré. + Cet outil vous permet de dessiner des formes simples remplies ou non + remplies. - ⚙ Voir la documentation sur "Options". + Choisissez une forme dans le sélecteur de droite (cercle, carré,ovale, + etc.). - Options de la boîte de dialogue de l'imprimante + Utilisez les options en bas à droite pour choisir le comportement de + l'outil : - Par défaut, Tux Paint affiche uniquement la boîte de - dialogue de l'imprimante (ou, sous Linux / Unix, - exécute "altprintcommand", par exemple, "kprinter" au - lieu de "lpr") si la touche [Alt] (ou [Option] ) est - maintenue pendant en cliquant sur le bouton - «Imprimer». + Formes à partir du centre + The shape will expand from where you initially clicked, and will be + centered around that position. - Cependant, ce comportement peut être modifié. Vous - pouvez toujours faire apparaître la boîte de dialogue - de l'imprimante en utilisant "--altprintalways" sur - la ligne de commande ou "altprint=always" dans le - fichier de configuration de Tux Paint. Inversement - vous pouvez empêcher la touche [Alt] / [Option] - d'avoir un effet en utilisant "--altprintnever" ou - "altprint=never". + 📜 This was Tux Paint's only behavior through version 0.9.24.) - ⚙ Voir la documentation sur "Options". - f.Commande "Diapos" (sous "Ouvrir") - Le bouton "Diapositives" est disponible dans la boîte de dialogue - "Ouvrir". Il peut être utilisé pour lire une simple animation dans - Tux Paint, ou un diaporama. Il peut également exporter un GIF - animé basé sur les images choisies. + Formes à partir d'un coin + The shape will extend with one corner starting from where you initially + clicked. This is the default method of most other traditional drawing + software. - Choisir des images + 📜 This option was added starting with Tux Paint version 0.9.25. - Lorsque vous entrez dans la section "Diapos" de Tux - Paint, il affiche une liste de vos fichiers - enregistrés, tout comme la boîte de dialogue - "Ouvrir". - Cliquez sur chacune des images que vous souhaitez - afficher dans une présentation de style diaporama, - une par une. Un chiffre apparaîtra sur chaque image, - vous indiquant dans quel ordre elles seront - affichées. - Vous pouvez cliquer sur une image sélectionnée pour - la désélectionner (la retirer de votre diaporama). - Cliquez à nouveau dessus si vous souhaitez l'ajouter - à la fin de la liste. - Régler la vitesse de lecture + ⚙ Remarque : si les contrôles de forme sont désactivés (par exemple, avec + l'option "noshapecontrols"), il n'y aura pas de contrôle et la méthode + "formes à partir du centre" sera utilisée. - Une échelle mobile en bas à gauche de l'écran (à côté - du bouton "Lecture") peut être utilisée pour régler - la vitesse du diaporama ou du GIF animé, du plus lent - au plus rapide. Choisissez le paramètre le plus à - gauche pour désactiver l'avancement automatique - pendant la lecture dans Tux Paint - vous devrez - appuyer sur une touche ou cliquer pour passer à la - diapositive suivante (voir ci-dessous). + Dans le dessin, cliquez sur la souris et maintenez-la pour étirer la forme + à partir de l'endroit où vous avez cliqué. Certaines formes peuvent changer + de proportion (par exemple, le rectangle et l'ovale peuvent être plus + larges que hauts ou plus hauts que larges), d'autres pas (par exemple, + carré et cercle). - 💡 Remarque : le paramètre le plus lent ne fait pas - automatiquement avancer les diapositives. Utilisez-le - lorsque vous souhaitez les parcourir manuellement. - (Cela ne s'applique pas à un GIF animé exporté.) + For shapes that can change proportion, the aspect ratio of the shape will + be shown at the bottom. For example: "1:1" will be shown if it is "square" + (as tall as it is wide); "2:1" if it is either twice as wide as it is tall, + or twice as tall as it is wide; and so on. - Lecture dans Tux Paint + Relâchez la souris lorsque vous avez terminé l'étirement. - To play a slideshow within Tux Paint, click the - 'Play' button. + Mode normal - 💡 Note: If you hadn't selected any images, then all - of your saved images will be played in the slideshow! + Now you can move the mouse around the canvas to rotate the shape. The + angle your shape is rotated will be shown at the bottom, in degrees + (similar to the "Lines" tool, described above). - Pendant le diaporama, appuyez sur [Espace], [Entrée] - ou [Retour] , ou sur [Flèche droite] - ou cliquez sur - le bouton "Suivant" en bas à gauche - pour passer - manuellement à la diapositive suivante. Appuyez sur - [Flèche gauche] pour revenir à la diapositive - précédente. + Cliquez à nouveau sur le bouton de la souris et la forme sera dessinée + avec la couleur en cours. - Appuyez sur [Escape] , ou cliquez sur le bouton - "Retour" en bas à droite, pour quitter le diaporama - et revenir à l'écran de sélection d'image du - diaporama. - Exporter un GIF animé - - Cliquez sur le bouton "Exporter GIF" en bas à droite - pour que Tux Paint génère un fichier GIF animé basé - sur les images sélectionnées. - 💡 Note: At least two images must be selected. (To - export a single image, use the 'Export' option from - the main 'Open' dialog.) If no images are selected, - Tux Paint will not attempt to generate a GIF based on - all saved images. + Mode de Formes Simples + If the "simple shapes" option is enabled, the shape will be drawn on + the canvas when you let go of the mouse button. (There's no rotation + step.) - Appuyer sur [Escape] pendant l'exportation annulera - le processus et vous ramènera à la boîte de dialogue - "Diaporama". + ⚙ See the "Options" documentation to learn about the "simple shapes" + ("simpleshapes") option. - Cliquez sur "Retour" dans l'écran de sélection d'image du - diaporama pour revenir à la boîte de dialogue "Ouvrir". - g.Commande "Quitter" - Cliquez sur le bouton "Quitter", fermez la fenêtre de Tux Paint ou - appuyez sur la touche [Escape] pour quitter Tux Paint. - On vous demandera d'abord si vous voulez vraiment arrêter. - If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new - image, you will then be asked if you want to save over the old - version, or create a new entry. (See "Save" above.) - ⚙ Remarque :: Si l'image est enregistrée, elle sera rechargée - automatiquement la prochaine fois que vous exécuterez Tux Paint -- - à moins que l'option"startblank" ait été activée. +e.Outils "Texte" et "Étiquette" - ⚙ Remarque :: Le bouton "Quitter" et la touche [Escape] peuvent - être désactivés par le biais de option "noquit". + Choose a font (from the 'Letters' available on the right) and a color (from + the color palette near the bottom). You may also apply a bold, and/or an + italic styling effect to the text. Click on the screen and a cursor will + appear. Type text and it will show up on the screen. (You can change the + font, color, and styling while entering the text, before it is applied to + the canvas.) - Dans ce cas, le bouton "Fermer la fenêtre" sur la barre de titre - de Tux Paint (si vous n'êtes pas en mode plein écran) ou la touche - [Alt] + [F4] peut être utilisée pour quitter. + Appuyez sur [Entrée] ou [Retour] et le texte sera inclus dans l'image et le + curseur se déplacera d'une ligne vers le bas. - Si aucune de ces options n'est possible, la séquence de touches - [Shift] + [Control / ⌘] + [Escape] peut être utilisée pour - quitter. + Sinon, appuyez sur [Tab] et le texte sera inclus dans l'image, mais le + curseur se déplacera vers la droite du texte, plutôt que vers le bas d'une + ligne et vers la gauche. (Cela peut être utile pour créer une ligne de + texte avec des couleurs, des polices, des styles et des tailles variés.) - ⚙ Voir la documentation sur "Options". + Cliquer ailleurs dans l'image alors que l'entrée de texte est toujours + active entraîne le déplacement de la ligne de texte actuelle vers cet + emplacement (et vous pouvez continuer à la modifier). - h.Coupure du son + "Texte" par rapport à "Étiquette" + + L' outil Texte est l'outil de saisie de texte original de Tux Paint. Le + texte saisi à l'aide de cet outil ne peut pas être modifié ou déplacé + ultérieurement, car il fait partie du dessin. Cependant, comme le texte + fait partie de l'image, il peut être dessiné ou modifié à l'aide des + effets de l'outil Magie (par exemple, taché, teinté, gaufré, etc.) + + Lors de l'utilisation de l' outil Étiquette (qui a été ajouté à Tux + Paint dans la version 0.9.22), le texte `` flotte '' sur l'image, et + les détails de l'étiquette (le texte, la position de l'étiquette, le + choix de la police et la couleur ) sont stockés séparément. Cela permet + à l'étiquette d'être repositionnée ou modifiée ultérieurement. + + To edit a label, click the label selection button. All labels in the + drawing will appear highlighted. Click one — or use the [Tab] key to + cycle through all the labels, and the [Entrée] or [Retour] key to + select one — and you may then edit the label. (Use they [Backspace] key + to erase characters, and other keys to add text to the label; click in + the canvas to reposition the label; click in the palette to change the + color of the text in the label; etc.) + + You may "apply" a label to the canvas, painting the text into the + picture as if it had been added using the Text tool, by clicking the + label application button. (This feature was added in Tux Paint version + 0.9.28.) All labels in the drawing will appear highlighted, and you + select one just as you do when selecting a label to edit. The chosen + label will be removed, and the text will be added directly to the + canvas. + + ⚙ L' outil Étiquette peut être désactivé (par exemple, en sélectionnant + "Désactiver l'outil 'Label'" dans Tux Paint Config ou bien en exécutant + Tux Paint en ligne de commande avec l'option "nolabel"). + + + + Saisie de caractères internationaux + + Tux Paint permet de saisir des caractères dans différentes langues. La + plupart des caractères latins ( A - Z , ñ , è , etc...) peuvent être + saisis directement. Certaines langues exigent que Tux Paint soit + commuté dans un mode d'entrée alternatif avant la saisie, et certains + caractères doivent être composés en utilisant plusieurs touches. + + Lorsque les paramètres régionaux de Tux Paint sont définis sur l'une + des langues fournissant des modes de saisie alternatifs, une touche est + utilisée pour parcourir le ou les modes soit normaux (caractère latin) + soit spécifiques aux paramètres régionaux. + + Currently supported locales, the input methods available, and the key + to toggle or cycle modes, are listed below. + + o Japanese — Romanized Hiragana and Romanized Katakana — touche [Alt] + droite or touche [Alt] gauche + o Korean — Hangul 2-Bul — touche [Alt] droite or touche [Alt] gauche + o Chinois traditionnel — touche [Alt] droite or touche [Alt] gauche + o Thai — touche [Alt] droite + + 💡 Note: Many fonts do not include all characters for all languages, so + sometimes you'll need to change fonts to see the characters you're + trying to type. + + + + Clavier virtuel sur écran + + An optional on-screen keyboard is available for the Text and Label + tools, which can provide a variety of layouts and character composition + (e.g., composing "a" and "e" into "æ"). + + ⚙ See the "Options" and "Extending Tux Paint" documentation for more + information. + + + + + + +f.Outil "Remplir" + + L'outil «Remplir» «remplit» une zone contiguë de votre dessin avec une + couleur unie de votre choix. Trois options de remplissage sont offertes : + + Solide — cliquez une fois pour remplir une zone avec une couleur unie. + + Brush — click and drag to fill an area with a solid color using + freehand painting. + + Linéaire—cliquez et faites glisser pour remplir une zone avec une + couleur qui s'atténue au fur et à mesure dans la direction où vous + déplacez la souris. + + Radial—cliquez une fois pour remplir une zone avec une couleur qui + s'atténue graduellement, à partir de l'endroit où vous avez cliqué. + + Shaped — click once to fill an area with a color that fades away (a + gradient), following the contours of the shape you're filling. + + 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see below). + Prior to Tux Paint 0.9.26, the "Fill" tool only offered the 'Solid' method + of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29. + + + +g.Outil "Magie" (Effets spéciaux) + + L'outil «Magie» est en fait un ensemble d'outils spéciaux. Sélectionnez + l'un des effets «magiques» dans le sélecteur de droite. Ensuite, selon + l'outil, vous pouvez soit cliquer et faire glisser dans l'image, et / ou + simplement cliquer une fois sur l'image pour appliquer l'effet. + + Magic Controls + + + Si l'outil peut être utilisé en cliquant et en faisant glisser, un + bouton «peinture» sera disponible sur la gauche, sous la liste des + outils «magiques» sur le côté droit de l'écran. Si l'outil peut + affecter toute l'image en entier, un bouton «Image entière» sera + disponible sur la droite. + + ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't display + the painting or entire picture controls. See the "Options" + documentation. + + 💡 If the magic controls are disabled, the Magic plugin may make + separate tools available, one for painting and one that affects the + entire pictre. + + Magic Sizing + + + Some tools offer different sizing options. If so, a slider will appear + at the bottom right side of the screen. This may affect the radius of a + special effect (e.g., Darken) or painted object (e.g., Patterns), or + other attributes (e.g., large versus small Brick shapes). + + ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't display + the sizing controls. See the "Options" documentation. + + 💡 If the sizing option is disabled, the Magic plugin may simply offer a + default size (e.g., Patterns), or it may make separate tools available + with different pre-set sizes (e.g., Bricks and Googly Eyes). + + 📜 This option was added starting with Tux Paint version 0.9.30. + + Voir les instructions pour chaque outil 'Magie' (dans le dossier + 'magic-docs'). + + + +h.Outil "Gomme" + + Cet outil est similaire au pinceau. Partout où vous cliquez (ou cliquez et + faites glisser), l'image sera effacée. (Cela peut être du blanc, une autre + couleur ou une image d'arrière-plan, selon l'image.) + + A number of eraser sizes are available, with both square and round shapes. + Fuzzy-edged round shapes are also available. + + Lorsque vous déplacez la souris, un contour carré suit le pointeur, + indiquant quelle partie de l'image sera effacée en blanc. + + Au fur et à mesure que vous effacez, un grincement est émis. + + ⌨ Hold the [X] key while clicking for quick access to a small sharp round + eraser (not available when the Text or Label tools are selected, when + you're in the process of rotating a stamp or shape, or when using an + interactive magic tool). Release the mouse to return to your + currently-selected tool. + + + + +2. Autres contrôles + +a."Undo" and "Redo" Commands + + Clicking the "Undo" button will undo (revert) the last drawing action. You + can even undo more than once! + + ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [Z] sur le + clavier pour Défaire. + + Clicking the "Redo" button will redo the drawing action you just un-did via + the "Undo" command. + + Tant que vous ne dessinez plus, vous pouvez refaire autant de fois que vous + avez défait ! + + ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [R] sur le + clavier pour Refaire. + + + +b.Commande "Nouveau" + + Cliquez sur le bouton "Nouveau" pour démarrer un nouveau dessin. Une boîte + de dialogue apparaîtra, avec laquelle vous pouvez choisir de commencer une + nouvelle image en utilisant une couleur d'arrière-plan unie, ou en + utilisant une image 'Starter' ou 'Template' (voir ci-dessous). On vous + demandera d'abord si vous voulez vraiment faire cela. + + ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [N] sur le + clavier pour commencer un nouveau dessin. + + Special Solid Background Color Choices + Along with the preset solid colors, you can also choose colors using a + rainbow palette or a "color mixer". These operate identically to the + options found in the color palette shown below the canvas when drawing + a picture. See Main Screen > Lower: Colors > Special color options for + details. + + Images de "Démarrage" et images "Modèle" + o Les "Images de démarrage" se comportent comme une page d'un livre + de coloriage - un contour noir et blanc d'une image, que vous + pouvez ensuite colorier, et le contour noir reste intact - ou comme + une photographie 3D, où vous dessinez entre une couche de premier + plan et une d'arrière-plan. + o Les "Images modèle" sont semblables, mais fournissent simplement un + dessin d'arrière-plan sur lequel travailler. Contrairement aux + «Images de démarrage», rien de ce que vous dessinerez ne restera au + premier plan. + + Lorsque vous utiliserez l'outil «Gomme», l'image d'origine du + «Démarrage» ou du «Modèle» réapparaîtra. Les outils magiques + "Retourner" et "Miroir" affecteront aussi bien l'orientation de + "l'image de démarrage" que celle de "l'image Modèle". + + Lorsque vous chargez une 'Image modèle' ou 'image modèle', dessinez + dessus, puis cliquez sur 'Sauvegarder', cela crée un nouveau fichier + image - il n'écrase pas l'original, vous pouvez donc l'utiliser à + nouveau plus tard (en y accédant depuis la boîte de dialogue + 'Nouveau'). + + ⚙ You can create your own 'Starter' and Template images. See the + Extending Tux Paint documentation's sections on 'Starters' and + Templates. + + 💡 You can also convert your saved drawings into Templates directly + within Tux Paint, from the 'Open' dialog. See "Open", below. + + + + Erasing Exported Template Images + + If you've selected a Template in your personal templates folder, and it + was created from within Tux Paint (using the "Template" button in the + "Open" dialog), you may remove it from within Tux Paint, too. An + 'Erase' (trash can) button will appear at the lower right of the list. + Click it to erase the selected template. (You will be asked to + confirm.) + + 💡 Note: On Linux, Windows, and macOS, the picture will be placed in + your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + + + ⚙ Note: The solid colors can be placed at the end of the 'New' dialog + (below the Starters and Templates), via the "newcolorslast" option. + + + +c.Commande "Ouvrir" + + Cela vous montre une liste de toutes les images que vous avez enregistrées. + S'il y en a plus que ce que peut contenir l'écran, utilisez les flèches + «Haut» et «Bas» en haut et en bas de la liste pour faire défiler la liste + des images. + + Cliquez sur une image pour la sélectionner, puis ... + + Click the green 'Open' button at the lower left of the list to load the + selected picture. You will then be able to edit it. + + (Vous pouvez également double-cliquer sur l'icône d'une image pour la + charger.) + + 💡 If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.) + + + Cliquez sur le bouton marron "Effacer" (poubelle) en bas à droite de la + liste pour effacer l'image sélectionnée. (Il vous sera demandé de + confirmer.) + + 📜 Note: On Linux (as of version 0.9.22), Windows (as of version + 0.9.27), and macOS (as of version 0.9.29), the picture will be placed + in your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + Click the 'Export' button near the lower right to export the selected + picture to your export folder. (e.g., "~/Pictures/TuxPaint/") + + From the "Open" screen you can also: + + Click the blue 'Slides' (slide projector) button at the lower left to + go to slideshow mode. See "Slides", below, for details. + + + Click the blue 'Template' button at the lower left to go to convert the + selected picture into a new template, which can be used as the basis + for new drawings. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. To learn how to create Templates outside of Tux Paint, see + Extending Tux Paint + + ⚙ The Template creation feature can be disabled (e.g., by selecting + "Disable 'Make Template'" in Tux Paint Config. or running Tux Paint + with the "notemplateexport" option). + + + Ou cliquez sur le bouton fléché rouge «Retour» en bas à droite de la + liste pour annuler et revenir à l'image que vous étiez en train de + dessiner. + + ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [O] sur le + clavier pour afficher la boîte de dialogue "Ouvrir". + + + +d.Commande "Sauvegarder" + + Pour sauvegarder votre image en cours. + + Si vous ne l'avez pas enregistré auparavant, il créera une nouvelle entrée + dans la liste des images enregistrées. (c'est-à-dire qu'il créera un + nouveau fichier) + + 💡 Remarque : il ne vous demandera rien (par exemple, un nom de fichier). Il + enregistrera simplement l'image et fera le bruit d'un obturateur d'appareil + photographique. + + Si vous avez déjà enregistré l'image, ou s'il s'agit d'une image que vous + venez de charger à l'aide de la commande "Ouvrir", il vous sera d'abord + demandé si vous voulez écraser l'ancienne version ou bien créer une + nouvelle entrée (un nouveau fichier). + + ⚙ Remarque : si les options " saveover" ou " saveovernew" sont déjà + définies, il ne sera rien demandé avant de sauvegarder. Voir la + documentation Options. + + ⌨ Remarque : vous pouvez également appuyer [Control / ⌘] + [S] sur le + clavier pour sauvegarde. + + + +e.Commande "Imprimer" + + Cliquez sur ce bouton et votre image sera imprimée ! + + Sur la plupart des plates-formes, vous pouvez également maintenir la touche + [Alt] (appelée [Option] sur Mac) tout en cliquant sur le bouton «Imprimer» + pour obtenir une boîte de dialogue d'impression. Notez que cela pourrait ne + pas fonctionner si vous exécutez Tux Paint en mode plein écran. Voir + ci-dessous. + + Désactivation de l'impression + + On peut définir une option "noprint", ce qui entraînera la + désactivation du bouton "Imprimer". + + ⚙ Voir la documentation sur "Options". + + + + Restreindre l'impression + + Si l'option "printdelay" a été utilisée, vous ne pouvez imprimer — + qu'une fois toutes les x secondes, tel que vous l'avez défini. + + Par exemple, avec "printdelay=60" dans le fichier de configuration de + Tux Paint, vous ne pouvez imprimer qu'une fois par minute. + + ⚙ Voir la documentation sur "Options". + + + + Commandes d'impression + + (Linux et Unix uniquement) + + Tux Paint imprime en générant une représentation PostScript du dessin + et en l'envoyant à un programme externe. Par défaut, le programme est : + + lpr + + Cette commande peut être modifiée en définissant la valeur + "printcommand" dans le fichier de configuration de Tux Paint. + + Si la touche "[Alt]" du clavier est enfoncée tout en cliquant sur le + bouton «Imprimer», et tant que vous n'êtes pas en mode plein écran, un + programme alternatif est exécuté. Par défaut, le programme est la boîte + de dialogue d'impression graphique de KDE : + + kprinter + + Cette commande peut être modifiée en définissant la valeur + "altprintcommand" dans le fichier de configuration de Tux Paint. + + ⚙ Voir la documentation sur "Options". + + + + Réglages pour l'impression + + (Windows et macOS) + + Par défaut, Tux Paint imprime simplement sur l'imprimante par défaut + avec les paramètres par défaut lorsque le bouton «Imprimer» est + enfoncé. + + Cependant, si vous maintenez la touche [Alt] (ou [Option]) du clavier + tout en appuyant sur le bouton "Imprimer, et ceci tant que vous n'êtes + pas en mode plein écran, la boîte de dialogue de l'imprimante de votre + système d'exploitation apparaît, et vous pouvez modifier les réglages. + + Vous pouvez stocker les changements de configuration, entre les + sessions de Tux Paint, en paramétrant l'option "printcfg". + + Si l'option "printcfg" est utilisée, les réglages d'impression seront + chargés à partir du fichier "printcfg.cfg" de votre répertoire + personnel (voir ci-dessous). Tout changement y sera ernregistré. + + ⚙ Voir la documentation sur "Options". + + + + Options de la boîte de dialogue de l'imprimante + + Par défaut, Tux Paint affiche uniquement la boîte de dialogue de + l'imprimante (ou, sous Linux / Unix, exécute "altprintcommand", par + exemple, "kprinter" au lieu de "lpr") si la touche [Alt] (ou [Option] ) + est maintenue pendant en cliquant sur le bouton «Imprimer». + + Cependant, ce comportement peut être modifié. Vous pouvez toujours + faire apparaître la boîte de dialogue de l'imprimante en utilisant + "--altprintalways" sur la ligne de commande ou "altprint=always" dans + le fichier de configuration de Tux Paint. Inversement vous pouvez + empêcher la touche [Alt] / [Option] d'avoir un effet en utilisant + "--altprintnever" ou "altprint=never". + + ⚙ Voir la documentation sur "Options". + + + + + + +f.Commande "Diapos" (sous "Ouvrir") + + Le bouton "Diapositives" est disponible dans la boîte de dialogue "Ouvrir". + Il peut être utilisé pour lire une simple animation dans Tux Paint, ou un + diaporama. Il peut également exporter un GIF animé basé sur les images + choisies. + + Choisir des images + + Lorsque vous entrez dans la section "Diapos" de Tux Paint, il affiche + une liste de vos fichiers enregistrés, tout comme la boîte de dialogue + "Ouvrir". + + Cliquez sur chacune des images que vous souhaitez afficher dans une + présentation de style diaporama, une par une. Un chiffre apparaîtra sur + chaque image, vous indiquant dans quel ordre elles seront affichées. + + Vous pouvez cliquer sur une image sélectionnée pour la désélectionner + (la retirer de votre diaporama). Cliquez à nouveau dessus si vous + souhaitez l'ajouter à la fin de la liste. + + + + Régler la vitesse de lecture + + Une échelle mobile en bas à gauche de l'écran (à côté du bouton + "Lecture") peut être utilisée pour régler la vitesse du diaporama ou du + GIF animé, du plus lent au plus rapide. Choisissez le paramètre le plus + à gauche pour désactiver l'avancement automatique pendant la lecture + dans Tux Paint - vous devrez appuyer sur une touche ou cliquer pour + passer à la diapositive suivante (voir ci-dessous). + + 💡 Remarque : le paramètre le plus lent ne fait pas automatiquement + avancer les diapositives. Utilisez-le lorsque vous souhaitez les + parcourir manuellement. (Cela ne s'applique pas à un GIF animé + exporté.) + + + + Lecture dans Tux Paint + + To play a slideshow within Tux Paint, click the 'Play' button. + + 💡 Note: If you hadn't selected any images, then all of your saved + images will be played in the slideshow! + + Pendant le diaporama, appuyez sur [Espace], [Entrée] ou [Retour] , ou + sur [Flèche droite] - ou cliquez sur le bouton "Suivant" en bas à + gauche - pour passer manuellement à la diapositive suivante. Appuyez + sur [Flèche gauche] pour revenir à la diapositive précédente. + + Appuyez sur [Escape] , ou cliquez sur le bouton "Retour" en bas à + droite, pour quitter le diaporama et revenir à l'écran de sélection + d'image du diaporama. + + + + Exporter un GIF animé + + Cliquez sur le bouton "Exporter GIF" en bas à droite pour que Tux Paint + génère un fichier GIF animé basé sur les images sélectionnées. + + 💡 Note: At least two images must be selected. (To export a single + image, use the 'Export' option from the main 'Open' dialog.) If no + images are selected, Tux Paint will not attempt to generate a GIF based + on all saved images. + + Appuyer sur [Escape] pendant l'exportation annulera le processus et + vous ramènera à la boîte de dialogue "Diaporama". + + + + + Cliquez sur "Retour" dans l'écran de sélection d'image du diaporama pour + revenir à la boîte de dialogue "Ouvrir". + + + +g.Commande "Quitter" + + Cliquez sur le bouton "Quitter", fermez la fenêtre de Tux Paint ou appuyez + sur la touche [Escape] pour quitter Tux Paint. + + On vous demandera d'abord si vous voulez vraiment arrêter. + + If you choose to quit, and you haven't saved the current picture, you will + first be asked if wish to save it. If it's not a new image, you will then + be asked if you want to save over the old version, or create a new entry. + (See "Save" above.) + + ⚙ Remarque :: Si l'image est enregistrée, elle sera rechargée + automatiquement la prochaine fois que vous exécuterez Tux Paint -- à moins + que l'option"startblank" ait été activée. + + ⚙ Remarque :: Le bouton "Quitter" et la touche [Escape] peuvent être + désactivés par le biais de option "noquit". + + Dans ce cas, le bouton "Fermer la fenêtre" sur la barre de titre de Tux + Paint (si vous n'êtes pas en mode plein écran) ou la touche [Alt] + [F4] + peut être utilisée pour quitter. + + Si aucune de ces options n'est possible, la séquence de touches [Shift] + + [Control / ⌘] + [Escape] peut être utilisée pour quitter. + + ⚙ Voir la documentation sur "Options". + + + +h.Coupure du son + + Il n'y a pas de bouton de commande à l'écran pour le moment, mais en + appuyant sur les touches [Alt] + [S] , les effets sonores peuvent être + désactivés et réactivés pendant que le programme est en cours d'exécution. + + Notez que si les sons sont complètement désactivés via l'option "nosound, + la combinaison des touches [Alt] + [S] n'a pas d'effet (c'est-à-dire qu'il + ne peut pas être utilisé pour activer les sons lorsque le parent / + enseignant veut qu'ils soient désactivés.) + + ⚙ Voir la documentation sur "Options". - Il n'y a pas de bouton de commande à l'écran pour le moment, mais - en appuyant sur les touches [Alt] + [S] , les effets sonores - peuvent être désactivés et réactivés pendant que le programme est - en cours d'exécution. - Notez que si les sons sont complètement désactivés via l'option - "nosound, la combinaison des touches [Alt] + [S] n'a pas d'effet - (c'est-à-dire qu'il ne peut pas être utilisé pour activer les sons - lorsque le parent / enseignant veut qu'ils soient désactivés.) - ⚙ Voir la documentation sur "Options". E. Controlling Tux Paint - 1. Using a Mouse or Trackball +1. Using a Mouse or Trackball - Tux Paint's main mode of operation is via any device that appears to your - operating system as a mouse, including standard mice, trackballs, and - trackpads, as well as drawing tablets (usually operated with a stylus) and - touch screens (operated with a finger and/or a stylus) (see "Using a - Tablet or Touchscreen" below for more information). +Tux Paint's main mode of operation is via any device that appears to your +operating system as a mouse, including standard mice, trackballs, and +trackpads, as well as drawing tablets (usually operated with a stylus) and +touch screens (operated with a finger and/or a stylus) (see "Using a Tablet or +Touchscreen" below for more information). - For drawing and controlling Tux Paint, only a single mouse button is used - — typically, on multi-button mice, this will the left mouse button, but - this can usually be configured at the operating system level. By default, - Tux Paint will ignore input from the other button(s). If a user attempts - to use the other button(s), a pop-up dialog will eventually appear - reminding them that only one button is recognized Tux Paint. However, you - may configure Tux Paint to accept any button as input (see the Options - documentation). +For drawing and controlling Tux Paint, only a single mouse button is used — +typically, on multi-button mice, this will the left mouse button, but this can +usually be configured at the operating system level. By default, Tux Paint will +ignore input from the other button(s). If a user attempts to use the other +button(s), a pop-up dialog will eventually appear reminding them that only one +button is recognized Tux Paint. However, you may configure Tux Paint to accept +any button as input (see the Options documentation). - a. Scrolling +a. Scrolling - Many input devices offer a way to quickly scroll within applications — - many mice have a scroll wheel, trackballs have scroll rings, and trackpads - recognize certain "scroll" gestures (e.g., two-finger vertical motion, or - vertical motion on the edge of the trackpad). Tux Paint supports scrolling - input to allow quick scrolling through certain lists (e.g., Stamps, Magic - tools, and the New and Open dialogs). +Many input devices offer a way to quickly scroll within applications — many +mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize +certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion +on the edge of the trackpad). Tux Paint supports scrolling input to allow quick +scrolling through certain lists (e.g., Stamps, Magic tools, and the New and +Open dialogs). - Tux Paint will also automatically scroll if you click and hold the mouse - down on an scroll button — the "up" and "down" arrow buttons that appear - above and below scrolling lists. +Tux Paint will also automatically scroll if you click and hold the mouse down +on an scroll button — the "up" and "down" arrow buttons that appear above and +below scrolling lists. - b. Mouse Accessibility +b. Mouse Accessibility - Other devices that appear as a mouse can be used to control Tux Paint. For - example: - * Head pointing/tracking devices - * Eye gaze trackers - * Foot mice +Other devices that appear as a mouse can be used to control Tux Paint. For +example: - Tux Paint offers a "sticky mouse click" accessibility setting, where a - single click begins a click-and-drag operation, and a subsequent click - ends it. (See the Options documentation.) + * Head pointing/tracking devices + * Eye gaze trackers + * Foot mice - 2. Using a Tablet or Touchscreen +Tux Paint offers a "sticky mouse click" accessibility setting, where a single +click begins a click-and-drag operation, and a subsequent click ends it. (See +the Options documentation.) - As noted above, Tux Paint recognizes any device that appears as a mouse. - This means drawing tablets and touchscreens may be used. However, these - devices often support other features beyond X/Y motion, button clicks, and - scroll-wheel motion. Currently, those additional features are not - supported by Tux Paint. Some examples: - * Pressure and angle - * Eraser tip - * Multi-touch gestures +2. Using a Tablet or Touchscreen - 3. Using a Joystick-like Device +As noted above, Tux Paint recognizes any device that appears as a mouse. This +means drawing tablets and touchscreens may be used. However, these devices +often support other features beyond X/Y motion, button clicks, and scroll-wheel +motion. Currently, those additional features are not supported by Tux Paint. +Some examples: - Tux Paint may be configured to recognize input from any game controller - that appears to your operating system as a joystick. That even includes - modern game console controllers connected via USB or Bluetooth (e.g., - Nintendo Switch or Microsoft Xbox game pads)! + * Pressure and angle + * Eraser tip + * Multi-touch gestures - Numerous configuration options are available to best suit the device being - used, and the user's needs. Analog input will be used for coarse movement, - and digital "hat" input for fine movement. Buttons on the controller can - be mapped to different Tux Paint controls (e.g., acting as the [Escape] - key, switching to the Paint tool, invoking Undo and Redo operations, - etc.). See the Options documentation for more details. +3. Using a Joystick-like Device - 4. Using the Keyboard +Tux Paint may be configured to recognize input from any game controller that +appears to your operating system as a joystick. That even includes modern game +console controllers connected via USB or Bluetooth (e.g., Nintendo Switch or +Microsoft Xbox game pads)! - Tux Paint offers an option to allow the keyboard to be used to control the - mouse pointer. This includes motion and clicking, as well as shortcuts to - navigate between and within certain parts of the interface. See the - Options documentation for more details. +Numerous configuration options are available to best suit the device being +used, and the user's needs. Analog input will be used for coarse movement, and +digital "hat" input for fine movement. Buttons on the controller can be mapped +to different Tux Paint controls (e.g., acting as the [Escape] key, switching to +the Paint tool, invoking Undo and Redo operations, etc.). See the Options +documentation for more details. - III. Chargement d'autres images dans Tux Paint +4. Using the Keyboard + +Tux Paint offers an option to allow the keyboard to be used to control the +mouse pointer. This includes motion and clicking, as well as shortcuts to +navigate between and within certain parts of the interface. See the Options +documentation for more details. + +III. Chargement d'autres images dans Tux Paint A. Overview - Étant donné que la boîte de dialogue «Ouvrir» de Tux Paint n'affiche que - les images que vous avez créées avec Tux Paint, que se passe-t-il si vous - souhaitez charger une autre image ou photo dans Tux Paint pour les éditer - et dessiner par-dessus ? +Étant donné que la boîte de dialogue «Ouvrir» de Tux Paint n'affiche que les +images que vous avez créées avec Tux Paint, que se passe-t-il si vous souhaitez +charger une autre image ou photo dans Tux Paint pour les éditer et dessiner +par-dessus ? - Pour ce faire, il vous suffit de convertir l'image dans le format utilisé - par Tux Paint, qui est —PNG (Portable Network Graphic), et de la placer - dans le répertoire "saved" de Tux Paint. C'est là où on les trouve (par - défaut) : +Pour ce faire, il vous suffit de convertir l'image dans le format utilisé par +Tux Paint, qui est —PNG (Portable Network Graphic), et de la placer dans le +répertoire "saved" de Tux Paint. C'est là où on les trouve (par défaut) : - Windows 10, 8, 7, Vista - Dans le dossier utilisateurs "AppData", par ex. "C:\Users\nom - d'utilisateur\AppData\Roaming\TuxPaint\saved\". +Windows 10, 8, 7, Vista + Dans le dossier utilisateurs "AppData", par ex. "C:\Users\nom d'utilisateur + \AppData\Roaming\TuxPaint\saved\". - Windows 2000, XP - Dans le dossier utilisateurs "Application Data", par ex. - "C:\Documents and Settings\nom d'utilisateur\Application - Data\TuxPaint\saved\". +Windows 2000, XP + Dans le dossier utilisateurs "Application Data", par ex. "C:\Documents and + Settings\nom d'utilisateur\Application Data\TuxPaint\saved\". - macOS - Dans le dossier utilisateurs "Library", par ex. "/Users/nom - d'utilisateur/Library/Application Support/Tux Paint/saved/". +macOS + Dans le dossier utilisateurs "Library", par ex. "/Users/nom d'utilisateur/ + Library/Application Support/Tux Paint/saved/". - Linux/Unix - Dans un répertoire caché ".tuxpaint" qui est dans le répertoire - personnel de l'utilisateur ("$HOME"), par ex. "/home/nom - d'utilisateur/.tuxpaint/saved/". +Linux/Unix + Dans un répertoire caché ".tuxpaint" qui est dans le répertoire personnel + de l'utilisateur ("$HOME"), par ex. "/home/nom d'utilisateur/.tuxpaint/ + saved/". - 💡 Remarque : C'est également à partir de ce dossier que vous pouvez copier - ou ouvrir des images dessinées dans Tux Paint à l'aide d'autres - applications, ainsi l'option 'Export' de la boîte de dialogue 'Ouvrir' de - Tux Paint peut être utilisée pour les copier dans un endroit plus facile - d'accès plus sûr. + +💡 Remarque : C'est également à partir de ce dossier que vous pouvez copier ou +ouvrir des images dessinées dans Tux Paint à l'aide d'autres applications, +ainsi l'option 'Export' de la boîte de dialogue 'Ouvrir' de Tux Paint peut être +utilisée pour les copier dans un endroit plus facile d'accès plus sûr. B. Utilisation du script d'importation "tuxpaint-import" - Les utilisateurs Linux et Unix peuvent utiliser script shell - "tuxpaint-import" qui s'installe lorsque vous installez Tux Paint. Il - utilise certains outils NetPBM pour convertir l'image ("anytopnm"), la - redimensionner pour qu'elle tienne dans le canevas de Tux Paint - ("pnmscale") et la convertir en PNG ("pnmtopng"). +Les utilisateurs Linux et Unix peuvent utiliser script shell "tuxpaint-import" +qui s'installe lorsque vous installez Tux Paint. Il utilise certains outils +NetPBM pour convertir l'image ("anytopnm"), la redimensionner pour qu'elle +tienne dans le canevas de Tux Paint ("pnmscale") et la convertir en PNG +("pnmtopng"). - Il utilise également la commande "date" pour obtenir l'heure et la date - actuelles, qui sont la convention de dénomination des fichiers utilisée - par Tux Paint pour les fichiers enregistrés. (N'oubliez pas que vous - n'êtes jamais invité à entrer un "nom de fichier " lorsque vous allez - enregistrer ou ouvrir des images !) +Il utilise également la commande "date" pour obtenir l'heure et la date +actuelles, qui sont la convention de dénomination des fichiers utilisée par Tux +Paint pour les fichiers enregistrés. (N'oubliez pas que vous n'êtes jamais +invité à entrer un "nom de fichier " lorsque vous allez enregistrer ou ouvrir +des images !) - Pour utiliser ce script, exécutez simplement la commande à partir d'une - invite de ligne de commande et indiquez-lui le (s) nom (s) du ou des - fichiers que vous voulez convertir. +Pour utiliser ce script, exécutez simplement la commande à partir d'une invite +de ligne de commande et indiquez-lui le (s) nom (s) du ou des fichiers que vous +voulez convertir. - They will be converted and placed in your Tux Paint "saved" directory. +They will be converted and placed in your Tux Paint "saved" directory. - 💡 Note: If you're doing this for a different user (e.g., your child) - you'll need to make sure to run the command under their account.) +💡 Note: If you're doing this for a different user (e.g., your child) you'll +need to make sure to run the command under their account.) - Exemple : +Exemple : - $ tuxpaint-import grandma.jpg - grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import grandma.jpg + grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - La première ligne ("tuxpaint-import grandma.jpg") est la commande à - exécuter. Les deux lignes suivantes sont les sorties du programme pendant - qu'il fonctionne. +La première ligne ("tuxpaint-import grandma.jpg") est la commande à exécuter. +Les deux lignes suivantes sont les sorties du programme pendant qu'il +fonctionne. - Vous pouvez maintenant charger Tux Paint, et une version de cette image - originale sera disponible dans la boîte de dialogue «Ouvrir». - Double-cliquez simplement sur son icône ! +Vous pouvez maintenant charger Tux Paint, et une version de cette image +originale sera disponible dans la boîte de dialogue «Ouvrir». Double-cliquez +simplement sur son icône ! C. Importer des images manuellement - Les utilisateurs de Windows, macOS et Haiku désirant importer des images - dans Tux Paint doivent le faire manuellement. +Les utilisateurs de Windows, macOS et Haiku désirant importer des images dans +Tux Paint doivent le faire manuellement. - Chargez un programme graphique capable à la fois de charger votre image et - d'enregistrer un fichier au format PNG. (Voir le fichier de documentation - "PNG.html" pour une liste des logiciels suggérés et d'autres références.) +Chargez un programme graphique capable à la fois de charger votre image et +d'enregistrer un fichier au format PNG. (Voir le fichier de documentation " +PNG.html" pour une liste des logiciels suggérés et d'autres références.) - Lorsque Tux Paint charge une image qui n'a pas la même taille que son - canevas de dessin, il met à l'échelle (et parfois en coloriant les bords) - l'image pour qu'elle tienne dans le canevas. +Lorsque Tux Paint charge une image qui n'a pas la même taille que son canevas +de dessin, il met à l'échelle (et parfois en coloriant les bords) l'image pour +qu'elle tienne dans le canevas. - Pour éviter que l'image ne soit étirée ou maculée, vous pouvez la - redimensionner à la taille de la toile de Tux Paint. Cette taille dépend - de la taille de la fenêtre Tux Paint, ou de la résolution à laquelle Tux - Paint est exécuté, si il est en plein écran. (Remarque : la résolution par - défaut est de 800x600.) Voir "Calculer les dimensions des images" - ci-dessous. +Pour éviter que l'image ne soit étirée ou maculée, vous pouvez la +redimensionner à la taille de la toile de Tux Paint. Cette taille dépend de la +taille de la fenêtre Tux Paint, ou de la résolution à laquelle Tux Paint est +exécuté, si il est en plein écran. (Remarque : la résolution par défaut est de +800x600.) Voir "Calculer les dimensions des images" ci-dessous. - 1. Naming the File +1. Naming the File - Sauvegarder l'image au format PNG. Il est fortement recommandé que vous - nommiez le fichier en utilisant la date et l'heure courante, puisque c'est - ce que Tux Paint utilise : +Sauvegarder l'image au format PNG. Il est fortement recommandé que vous nommiez +le fichier en utilisant la date et l'heure courante, puisque c'est ce que Tux +Paint utilise : - YYYYMMDDhhmmss.png + YYYYMMDDhhmmss.png - * YYYY = Year - * MM = Mois (deux chiffres, "01"-"12") - * DD = Jour du mois (deux chiffres, "01"-"31") - * HH = Heure (deux chiffres,au format 24h, "00"-"23") - * mm = Minute (deux chiffres, "00"-"59") - * ss = Secondes (deux chiffres, "00"-"59") + * YYYY = Year + * MM = Mois (deux chiffres, "01"-"12") + * DD = Jour du mois (deux chiffres, "01"-"31") + * HH = Heure (deux chiffres,au format 24h, "00"-"23") + * mm = Minute (deux chiffres, "00"-"59") + * ss = Secondes (deux chiffres, "00"-"59") - Exemple: "20210731110500.png",pour le 31 juillet 2021 à 11:05 du matin. +Exemple: "20210731110500.png",pour le 31 juillet 2021 à 11:05 du matin. - Mettez cd fichier PNG dans votre répertoire Tux Paint "saved". (Voir - ci-dessus) +Mettez cd fichier PNG dans votre répertoire Tux Paint "saved". (Voir ci-dessus) - 2. Calculer les dimensions des images +2. Calculer les dimensions des images - Cette partie de documentation doit être réécrite puisque la nouvelle - option "buttonsize" a été ajoutée. Pour l'heure, essayer de dessiner et de - sauvegarder l'image dans Tux Paint, et ensuite déterminer quelle taille - (largeur et hauteur en pixels) elle possède, et essayez de l'adapter lors - de la mise à l'échelle en l'important dans Tux Paint. +Cette partie de documentation doit être réécrite puisque la nouvelle option +"buttonsize" a été ajoutée. Pour l'heure, essayer de dessiner et de sauvegarder +l'image dans Tux Paint, et ensuite déterminer quelle taille (largeur et hauteur +en pixels) elle possède, et essayez de l'adapter lors de la mise à l'échelle en +l'important dans Tux Paint. - IV.Lectures complémentaires +IV.Lectures complémentaires - Les autres documents inclus avec Tux Paint (dans le répertoire "docs") - incluent : +Les autres documents inclus avec Tux Paint (dans le répertoire "docs") incluent +: - Using Tux Paint: - * OPTIONS.html - Instructions détaillées sur les options en ligne de commande - et les fichiers de configuration, pour ceux qui ne veulent - pas utiliser l'outil Tux Paint Config. - * Documentation sur l'outil 'Magie' ("magic-docs") - Documentation pour chacun des outils "Magic" actuellement - installés. +Using Tux Paint: + + OPTIONS.html + Instructions détaillées sur les options en ligne de commande et les + fichiers de configuration, pour ceux qui ne veulent pas utiliser + l'outil Tux Paint Config. + + Documentation sur l'outil 'Magie' ("magic-docs") + Documentation pour chacun des outils "Magic" actuellement installés. - How to extend Tux Paint: - * EXTENDING.html - Des instructions détaillées sur la création de pinceaux, de - tampons, d'images de démarrage et de modèles; et l'ajout de - polices; et créer un nouveau clavier virtuel et des méthodes - de saisie. - * PNG.html - Remarques sur la création d'images bitmap au format PNG à - utiliser dans Tux Paint. - * SVG.html - Remarques sur la création d'images vectorielles au format SVG - à utiliser dans Tux Paint. - Technical information: - * INSTALL.html - Instructions pour compiler et installer Tux Paint, le cas - échéant. - * SIGNALS.html - Informations sur les signaux POSIX auxquels répond Tux Paint. - * MAGIC-API.html - Creating new Magic tools using Tux Paint's plugin API. +How to extend Tux Paint: + + EXTENDING.html + Des instructions détaillées sur la création de pinceaux, de tampons, + d'images de démarrage et de modèles; et l'ajout de polices; et créer un + nouveau clavier virtuel et des méthodes de saisie. + + PNG.html + Remarques sur la création d'images bitmap au format PNG à utiliser dans + Tux Paint. + + SVG.html + Remarques sur la création d'images vectorielles au format SVG à + utiliser dans Tux Paint. - Development history and license: - * AUTHORS.txt - Liste des auteurs et contributeurs. - * CHANGES.txt - Résumé des changements entre chaque version de Tux Paint. - * COPYING.txt - Tux Paint's software license, the GNU General Public License - (GPL) - V.Comment obtenir de l'aide +Technical information: + + INSTALL.html + Instructions pour compiler et installer Tux Paint, le cas échéant. + + SIGNALS.html + Informations sur les signaux POSIX auxquels répond Tux Paint. + + MAGIC-API.html + Creating new Magic tools using Tux Paint's plugin API. - If you need help, there are numerous ways to interact with Tux Paint - developers and other users: - * Mentionner des bogues, ou demander de nouvelles fonctionnalités via le - système de suivi des bogues - * Participer aux nombreuses listes de diffusion de Tux Paint - * Contacter les développeurs directement - Pour en savoir plus, visitez la page "Contact" du site officiel de Tux - Paint : https://tuxpaint.org/contact/ +Development history and license: + + AUTHORS.txt + Liste des auteurs et contributeurs. + + CHANGES.txt + Résumé des changements entre chaque version de Tux Paint. + + COPYING.txt + Tux Paint's software license, the GNU General Public License (GPL) - VI.Comment participer - Tux Paint is a volunteer-driven project, and we're happy to accept your - help in a variety of ways: - * Traduire Tux Paint dans une autre langue - * Améliorer les traductions existantes - * Créer des oeuvres (tampons, images de démarrage, modèles, pinceaux) - * Ajouter ou améliorer des caractéristiques ou bien des outils "Magie" - * Créer un programme d'étude en classe - * Promouvoir ou aider ceux qui utilisent Tux Paint - Pour en savoir plus, visitez la page "Nous aider" du site officiel de Tux - Paint : https://tuxpaint.org/help/ +V.Comment obtenir de l'aide - VII.Follow the Tux Paint project on social media +If you need help, there are numerous ways to interact with Tux Paint developers +and other users: - Tux Paint maintains a presence on a variety of social media networks, - where we post updates and artwork. - * Join the Tux Paint page on Facebook - * Follow @TuxPaintDevs on Instagram - * Follow @tuxpaint@floss.social on Mastodon - * Follow u/TuxPaintDevs on Reddit - * Follow @TuxPaintDevs on Threads - * Follow Tux Paint on Tumblr - * Follow @TuxPaintTweets on Twitter + * Mentionner des bogues, ou demander de nouvelles fonctionnalités via le + système de suivi des bogues + * Participer aux nombreuses listes de diffusion de Tux Paint + * Contacter les développeurs directement - VIII. Trademark notices +Pour en savoir plus, visitez la page "Contact" du site officiel de Tux Paint : +https://tuxpaint.org/contact/ + +VI.Comment participer + +Tux Paint is a volunteer-driven project, and we're happy to accept your help in +a variety of ways: + + * Traduire Tux Paint dans une autre langue + * Améliorer les traductions existantes + * Créer des oeuvres (tampons, images de démarrage, modèles, pinceaux) + * Ajouter ou améliorer des caractéristiques ou bien des outils "Magie" + * Créer un programme d'étude en classe + * Promouvoir ou aider ceux qui utilisent Tux Paint + +Pour en savoir plus, visitez la page "Nous aider" du site officiel de Tux Paint +: https://tuxpaint.org/help/ + +VII.Follow the Tux Paint project on social media + +Tux Paint maintains a presence on a variety of social media networks, where we +post updates and artwork. + + * Join the Tux Paint page on Facebook + * Follow @TuxPaintDevs on Instagram + * Follow @tuxpaint@floss.social on Mastodon + * Follow u/TuxPaintDevs on Reddit + * Follow @TuxPaintDevs on Threads + * Follow Tux Paint on Tumblr + * Follow @TuxPaintTweets on Twitter + +VIII. Trademark notices + + * "Linux" is a registered trademark of Linus Torvalds. + * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. + * "Apple" and "macOS" are registered trademarks of Apple Inc. + * "Facebook", "Instagram", and "Threads" are registered trademarks of Meta + Platforms, Inc. + * "Mastodon" is a registered trademark of Mastodon gGmbH. + * "Reddit" is a registered trademark of Reddit, Inc. + * "Tumblr" is a registered trademark of Tumblr, Inc. + * "Twitter" is a registered trademark of X Corp. - * "Linux" is a registered trademark of Linus Torvalds. - * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. - * "Apple" and "macOS" are registered trademarks of Apple Inc. - * "Facebook", "Instagram", and "Threads" are registered trademarks of - Meta Platforms, Inc. - * "Mastodon" is a registered trademark of Mastodon gGmbH. - * "Reddit" is a registered trademark of Reddit, Inc. - * "Tumblr" is a registered trademark of Tumblr, Inc. - * "Twitter" is a registered trademark of X Corp. diff --git a/docs/fr_FR.UTF-8/SIGNALS.txt b/docs/fr_FR.UTF-8/SIGNALS.txt index 7c51a03ad..b1bc877f2 100644 --- a/docs/fr_FR.UTF-8/SIGNALS.txt +++ b/docs/fr_FR.UTF-8/SIGNALS.txt @@ -1,56 +1,59 @@ Tux Paint - version 0.9.31 + version 0.9.31 Documentation sur les signaux Copyright © 2019-2022 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juin 4, 2022 + juin 4, 2022 - Tux Paint répond aux signaux suivants (qui peuvent être envoyé au - processus du programme via `kill` ou`killall`, par exemple). +Tux Paint répond aux signaux suivants (qui peuvent être envoyé au processus du +programme via `kill` ou`killall`, par exemple). - SIGTERM (également, [Control] + [C] depuis un terminal exécutant - 'tuxpaint') +SIGTERM (également, [Control] + [C] depuis un terminal exécutant 'tuxpaint') - Tux Paint répond comme si le bouton "Quitter" était enfoncé, ou - l'environnement de bureau a été invité à fermer Tux Paint (par - exemple, en cliquant sur un bouton de fermeture de fenêtre, ou en - appuyant sur [Alt] + [F4] sur la plupart des systèmes). + Tux Paint répond comme si le bouton "Quitter" était enfoncé, ou + l'environnement de bureau a été invité à fermer Tux Paint (par exemple, en + cliquant sur un bouton de fermeture de fenêtre, ou en appuyant sur [Alt] + + [F4] sur la plupart des systèmes). - Depuis l'interface principale, Tux Paint vous demandera si vous - souhaitez quitter ou non, et (sauf si remplacé par l'option - autosave, par ex. "--autosave") si vous souhaitez enregistrer le - dessin courant (s'il n'est pas enregistré), et si c'est le cas, et - c'est une version modifiée d'un dessin existant (sauf si remplacé - par les options pour écraser les images anciennes, ou bien - sauvegarder avec un nouveau nom (par ex. "--saveover" ou - "--saveovernew") vers un nouveau fichier. + Depuis l'interface principale, Tux Paint vous demandera si vous souhaitez + quitter ou non, et (sauf si remplacé par l'option autosave, par ex. + "--autosave") si vous souhaitez enregistrer le dessin courant (s'il n'est + pas enregistré), et si c'est le cas, et c'est une version modifiée d'un + dessin existant (sauf si remplacé par les options pour écraser les images + anciennes, ou bien sauvegarder avec un nouveau nom (par ex. "--saveover" ou + "--saveovernew") vers un nouveau fichier. - Exemple: killall tuxpaint + Exemple: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint répond en définissant son option "autosave" (comme si - cela avait été lancé avec "--autosave"), aussi bien que l'option - pour toujours sauvegarder de nouvelles images (comme si c'était - lancé avec "--saveovernew"), dans le cas de la réception d'un - signal SIGUSR1, ou bien d'écraser les images existantes (comme si - cela avait lancé avec "--saveover") dans le cas où on recevait - SIGUSR2. Alors Tux Paint envoie à lui-même le signal SIGTERM, pour - une tentative de quitter (Voir ci-dessus.) - Ainsi, à partir de l'interface principale, Tux Paint devrait se - fermer presque immédiatement, sans poser de questions. +SIGUSR1 & SIGUSR2 + + Tux Paint répond en définissant son option "autosave" (comme si cela avait + été lancé avec "--autosave"), aussi bien que l'option pour toujours + sauvegarder de nouvelles images (comme si c'était lancé avec + "--saveovernew"), dans le cas de la réception d'un signal SIGUSR1, ou bien + d'écraser les images existantes (comme si cela avait lancé avec + "--saveover") dans le cas où on recevait SIGUSR2. Alors Tux Paint envoie à + lui-même le signal SIGTERM, pour une tentative de quitter (Voir ci-dessus.) + + Ainsi, à partir de l'interface principale, Tux Paint devrait se fermer + presque immédiatement, sans poser de questions. + + Exemple: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - Exemple: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/fr_FR.UTF-8/SVG.txt b/docs/fr_FR.UTF-8/SVG.txt index 33b8d47b7..47898421c 100644 --- a/docs/fr_FR.UTF-8/SVG.txt +++ b/docs/fr_FR.UTF-8/SVG.txt @@ -1,37 +1,38 @@ Tux Paint - version 0.9.31 + version 0.9.31 Documentation sur SVG Copyright © 2007-2022 by divers contributeurs; see AUTHORS.txt. https://tuxpaint.org/ - juin 4, 2022 + juin 4, 2022 - À propos de SVG +À propos de SVG - SVG (Scalable Vector Graphics) est un standard ouvert utilisé pour décrire - des graphiques vectoriels en deux dimensions. C'est parfait pour les - diagrammes et les formes, tandis que les PNG sont meilleurs pour les - photographies. Les fichiers SVG sont un peu comme des instructions sur la - façon de créer une image. Cela signifie qu'ils peuvent être redimensionnés - sans paraître pixélisés ou avec des blocs. +SVG (Scalable Vector Graphics) est un standard ouvert utilisé pour décrire des +graphiques vectoriels en deux dimensions. C'est parfait pour les diagrammes et +les formes, tandis que les PNG sont meilleurs pour les photographies. Les +fichiers SVG sont un peu comme des instructions sur la façon de créer une +image. Cela signifie qu'ils peuvent être redimensionnés sans paraître pixélisés +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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt b/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt index 578537e34..321fba76b 100644 --- a/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt +++ b/docs/fr_FR.UTF-8/tuxpaint-quickstart-guide.txt @@ -1,215 +1,210 @@ - Tux Paint 0.9.29 Quickstart Guide +Tux Paint 0.9.29 Quickstart Guide Tools (Drawing) - 🖌Peindre +🖌Peindre - * Choose a brush on the right. - * Some brushes are animated 🎞, some are directional ✲, some are both. - * Change brush spacing with the bars 📶 at the bottom right. - * Choose a color (see "Colors"). - * Click/tap and drag in the canvas to paint. + * Choose a brush on the right. + * Some brushes are animated 🎞, some are directional ✲, some are both. + * Change brush spacing with the bars 📶 at the bottom right. + * Choose a color (see "Colors"). + * Click/tap and drag in the canvas to paint. - ⌧Tampons +⌧Tampons - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Choose a stamp on the right. - * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near - the bottom right. - * Some stamps allow you to choose their color (see "Colors"). - * Change stamp size with the bars 📶 at the bottom right. - * Rotation ⟳ may be enabled, if desired. - * Click/tap in the canvas to place a stamp. - * If rotation is enabled, drag to rotate it, and click/tap again to - add it to the drawing. - * Some stamps play sound effects; press the speaker 🕪 button to hear it - again. - * Some stamps play descriptive sounds; press the headphones 🎧 button to - hear it again. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Choose a stamp on the right. + * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the + bottom right. + * Some stamps allow you to choose their color (see "Colors"). + * Change stamp size with the bars 📶 at the bottom right. + * Rotation ⟳ may be enabled, if desired. + * Click/tap in the canvas to place a stamp. + + If rotation is enabled, drag to rotate it, and click/tap again to add + it to the drawing. + * Some stamps play sound effects; press the speaker 🕪 button to hear it + again. + * Some stamps play descriptive sounds; press the headphones 🎧 button to hear + it again. - ⚟Lignes +⚟Lignes - * (See Paint) - * Click/tap and drag to draw a line. + * (See Paint) + * Click/tap and drag to draw a line. - ⭓Formes +⭓Formes - * Choose a shape on the right. - * Select whether you want to extend the shape from the center ⧈, or a - corner ◰, using controls at the bottom right. - * 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. + * Choose a shape on the right. + * Select whether you want to extend the shape from the center ⧈, or a corner + ◰, using controls at the bottom right. + * 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. - 🄰Texte +🄰Texte - * Choose a font on the right. - * Select whether you want the text bold 𝗔 and/or italic 𝘈, using - controls near the bottom right. - * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom - right. - * Choose a color (see "Colors"). - * Click/tap the canvas to position an insertion cursor. - * Enter text via your keyboard or the on-screen keyboard. - * 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 - and begin entering more text one line down. - * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and - continue entering more text immediately to the right. - * Using the on-screen keyboard: - * "Cmp" can be used to compose characters, e.g. Cmp ' a results in - á. - * "AltGr" can be used to quickly access more characters. - * Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. - "ABC") + * Choose a font on the right. + * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls + near the bottom right. + * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom + right. + * Choose a color (see "Colors"). + * Click/tap the canvas to position an insertion cursor. + * Enter text via your keyboard or the on-screen keyboard. + * 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 and + begin entering more text one line down. + * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and + continue entering more text immediately to the right. + * Using the on-screen keyboard: + + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á. + + "AltGr" can be used to quickly access more characters. + + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC") - 🅰Étiquette +🅰Étiquette - * (See Text) - * Labels float 'above' the drawing; you cannot paint or stamp over them, - apply Magic effects, etc. - * Labels may be edited, repositioned, and styled after they've been - added to the drawing. - * Click/tap the ☝ button near the lower right to choose a label. - Click/tap the label you wish to modify, then click/tap somewhere else - in the canvas to reposition, or change the font/style, change color, - and/or type to edit the text. - * Or, use the 🖑 button near the lower right to "flatten" a label, - applying it to the canvas; it may no longer be edited with the Label - tool. + * (See Text) + * Labels float 'above' the drawing; you cannot paint or stamp over them, + apply Magic effects, etc. + * Labels may be edited, repositioned, and styled after they've been added to + the drawing. + * Click/tap the ☝ button near the lower right to choose a label. Click/tap + the label you wish to modify, then click/tap somewhere else in the canvas + to reposition, or change the font/style, change color, and/or type to edit + the text. + * Or, use the 🖑 button near the lower right to "flatten" a label, applying it + to the canvas; it may no longer be edited with the Label tool. - 🪣Fill +🪣Fill - * Choose a fill mode on the right. - * Choose a color (see "Colors"). - * Click/tap (and drag, with Brush and Linear modes) to fill an area of - the picture with a color. - * Solid - Flood-fills an area with a solid color - * Brush - Paints with a solid color, without drawing outside the - chosen area - * Linear - Fills the area with a linear gradient (drag to choose - angle and gradient) - * Radial - Fills the area with a radial gradient, centered where - you clicked/tapped - * Shaped - Fills the area with a gradient that follows the contours - of the area being filled + * Choose a fill mode on the right. + * Choose a color (see "Colors"). + * Click/tap (and drag, with Brush and Linear modes) to fill an area of the + picture with a color. + + Solid - Flood-fills an area with a solid color + + Brush - Paints with a solid color, without drawing outside the chosen + area + + Linear - Fills the area with a linear gradient (drag to choose angle + and gradient) + + Radial - Fills the area with a radial gradient, centered where you + clicked/tapped + + Shaped - Fills the area with a gradient that follows the contours of + the area being filled - 🪄Magie +🪄Magie - * Choose a magic tool on the right. - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some - affect the entire drawing 🖻🪄, and some offer both options; use the - controls at the bottom right. - * Some magic tools offer various sizes; change it with the bars 📶 at the - bottom right. - * Some magic tools allow you to choose their color. + * Choose a magic tool on the right. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some + affect the entire drawing 🖻🪄, and some offer both options; use the controls + at the bottom right. + * Some magic tools offer various sizes; change it with the bars 📶 at the + bottom right. + * Some magic tools allow you to choose their color. - 🖓Défaire +🖓Défaire - * Use to undo the most recent changes (multiple undo available). - * Shortcut: [Ctrl]+[Z] + * Use to undo the most recent changes (multiple undo available). + * Shortcut: [Ctrl]+[Z] - 🖒Refaire +🖒Refaire - * Use to redo the most recent undone change (multiple redo available). - * Shortcut: [Ctrl]+[R] + * Use to redo the most recent undone change (multiple redo available). + * Shortcut: [Ctrl]+[R] - ◪Gomme +◪Gomme - * Choose the size and shape of the eraser on the right. - * Click/tap and drag to erase parts of the picture (solid color, or - starter or template image). - * Shortcut: [X] and click/tap in the drawing (not always available) + * Choose the size and shape of the eraser on the right. + * Click/tap and drag to erase parts of the picture (solid color, or starter + or template image). + * Shortcut: [X] and click/tap in the drawing (not always available) Tools (Controls) - 🗏Nouveau +🗏Nouveau - * Choose a solid color, starter, or template image to start with. - * Starters allow drawing "under" a picture (e.g., a coloring book - outline), sometimes with a background layer, too. - * Templates are pictures to start with (background only). - * Eraser tool ◪ reveals the solid color, or starter/template - background. - * Click/tap "🕮⮫Open" to begin a new drawing. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Shortcut: [Ctrl]+[N] + * Choose a solid color, starter, or template image to start with. + + Starters allow drawing "under" a picture (e.g., a coloring book + outline), sometimes with a background layer, too. + + Templates are pictures to start with (background only). + + Eraser tool ◪ reveals the solid color, or starter/template background. + * Click/tap "🕮⮫Open" to begin a new drawing. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Shortcut: [Ctrl]+[N] - 🕮⮫Ouvrir +🕮⮫Ouvrir - * Choose a previously-saved drawing to open (or export or erase). - * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. - * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" - folder. - * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle - Bin. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Click/tap "📽Slides" to switch to slideshow mode: - * Click/tap two or more of your previously-saved drawings, in the - order you want them shown. Numbers will appear on them. - * Choose the playback speed using the bars 📶 near the lower left. - * Click/tap "⯈Play" to watch the slideshow/animation. - * Or, click/tap "🎞GIF Export" to save an animated GIF of the - animation to your system's "Pictures" folder. - * Click/tap "⤺Back" to return to the Open dialog. - * Shortcut: [Ctrl]+[O] + * Choose a previously-saved drawing to open (or export or erase). + * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. + * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" + folder. + * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Click/tap "📽Slides" to switch to slideshow mode: + + Click/tap two or more of your previously-saved drawings, in the order + you want them shown. Numbers will appear on them. + + Choose the playback speed using the bars 📶 near the lower left. + + Click/tap "⯈Play" to watch the slideshow/animation. + + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to + your system's "Pictures" folder. + + Click/tap "⤺Back" to return to the Open dialog. + * Shortcut: [Ctrl]+[O] - 🕮⮪Sauvegarder +🕮⮪Sauvegarder - * Click/tap to save your drawing. - * If you've saved previously, you'll be prompted whether to overwrite - the previously-saved drawing (a la "File→Save") or create a new saved - drawing (a la "File→Save As...") - * Shortcut: [Ctrl]+[S] + * Click/tap to save your drawing. + * If you've saved previously, you'll be prompted whether to overwrite the + previously-saved drawing (a la "File→Save") or create a new saved drawing + (a la "File→Save As...") + * Shortcut: [Ctrl]+[S] - 🖶Print +🖶Print - * Click/tap to print your drawing. - * Hold [Alt] or [Option] while clicking/tapping to bring up printer - dialog, if available. - * Shortcut: [Ctrl]+[P] + * Click/tap to print your drawing. + * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog, + if available. + * Shortcut: [Ctrl]+[P] - 🗙Quit +🗙Quit - * Click/tap to quit Tux Paint. - * Shortcut: [Esc] + * Click/tap to quit Tux Paint. + * Shortcut: [Esc] Colors - * Click/tap to choose a color to use with the Paint, Lines, and Shapes - tools, and Stamps and Magic tools that support colors. - * Use the pipette / color picker 💉 button to choose a color from a pixel - in your current drawing. - * Shortcut: When colors are available, press [Ctrl] and click/tap - in your drawing, to quickly pick a color from your drawing. - * Click/tap the rainbow 🌈 button to choose a arbitrary color. - * Click/tap in the rainbow square to pick a color (hue and - saturation). - * Click/tap in the grey gradient bar to adjust brightness (value). - * Click/tap the green checkbox ✓ to accept. - * Click/tap "⤺Back" to abort and dismiss the palette. - * You may grab the currently-chosen built-in color (if any), the - color in the pipette / color picker, or the color in the color - mixer, by clicking one of the colored arrow ⇫ buttons. - * Click/tap the paint palette 🎨 button to create a color by mixing - primary colors: red, yellow, and blue, and white (tint), grey (tone), - and black (shade). - * Click/tap the green checkbox ✓ to accept. - * Color mixing offers its own 🖓Undo and 🖒Redo options. - * Click/tap "🗑Clear" to start over with no mixed colors. - * Click/tap "⤺Back" to abort and dismiss the color mixer. + * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools, + and Stamps and Magic tools that support colors. + * Use the pipette / color picker 💉 button to choose a color from a pixel in + your current drawing. + + Shortcut: When colors are available, press [Ctrl] and click/tap in your + drawing, to quickly pick a color from your drawing. + * Click/tap the rainbow 🌈 button to choose a arbitrary color. + + Click/tap in the rainbow square to pick a color (hue and saturation). + + Click/tap in the grey gradient bar to adjust brightness (value). + + Click/tap the green checkbox ✓ to accept. + + Click/tap "⤺Back" to abort and dismiss the palette. + + You may grab the currently-chosen built-in color (if any), the color in + the pipette / color picker, or the color in the color mixer, by + clicking one of the colored arrow ⇫ buttons. + * Click/tap the paint palette 🎨 button to create a color by mixing primary + colors: red, yellow, and blue, and white (tint), grey (tone), and black + (shade). + + Click/tap the green checkbox ✓ to accept. + + Color mixing offers its own 🖓Undo and 🖒Redo options. + + Click/tap "🗑Clear" to start over with no mixed colors. + + Click/tap "⤺Back" to abort and dismiss the color mixer. Shortcuts while drawing: - * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access - * [X]+Click/tap - Quick eraser ◪ access - * [Ctrl]+[Z] - 🖓Undo - * [Ctrl]+[R] - 🖒Redo - * [Ctrl]+[N] - 🗏New - * [Ctrl]+[O] - 🕮⮫Open - * [Ctrl]+[S] - 🕮⮪Save - * [Ctrl]+[P] - 🖶Print - * [Alt]+[S] - Toggle sound effects on/off - * [Esc] - ⤺Back or 🗙Quit + * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access + * [X]+Click/tap - Quick eraser ◪ access + * [Ctrl]+[Z] - 🖓Undo + * [Ctrl]+[R] - 🖒Redo + * [Ctrl]+[N] - 🗏New + * [Ctrl]+[O] - 🕮⮫Open + * [Ctrl]+[S] - 🕮⮪Save + * [Ctrl]+[P] - 🖶Print + * [Alt]+[S] - Toggle sound effects on/off + * [Esc] - ⤺Back or 🗙Quit + +Last updated: mai 9, 2023 - Last updated: mai 9, 2023 diff --git a/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt index 18bbe20b4..a295d7853 100644 --- a/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/gl_ES.UTF-8/ADVANCED-STAMPS-HOWTO.txt @@ -1,307 +1,299 @@ Tux Paint - versión 0.9.31 «Como facer» os selos avanzados + versión 0.9.31 «Como facer» os selos avanzados - Copyright © 2006-2022 by Albert Cahalan e outros; see AUTHORS.txt. + Copyright © 2006-2022 by Albert Cahalan e outros; see AUTHORS.txt. https://tuxpaint.org/ 4 de Xuño de 2022 - ---------------------------------------------------------------------- - - +-------------------------------------------+ - |Índice | - |-------------------------------------------| - | * Sobre este «Como facelo» | - | * A elección da imaxe é crucial | - | * Preparar a máscara | - | * Substituír a franxa e os píxeles lixo | - | * Gardar a imaxe para Tux Paint | - +-------------------------------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++-------------------------------------------+ +| Índice | +|-------------------------------------------| +| * Sobre este «Como facelo» | +| * A elección da imaxe é crucial | +| * Preparar a máscara | +| * Substituír a franxa e os píxeles lixo | +| * Gardar a imaxe para Tux Paint | ++-------------------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- Sobre este «Como facelo» - Este «Como facelo» supón que quere facer un excelente selo de Tux Paint, - en 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 - unha calidade inferior. + Este «Como facelo» supón que quere facer un excelente selo de Tux Paint, en + 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 unha + calidade inferior. - Este «Como facelo» supón que está a tratar con obxectos opacos normais. - O tratamento de obxectos semitransparentes (lume, ventilador en - movemento, globo infantil) ou obxectos que dan luz (lume, bombilla, sol) - faise mellor cun software personalizado. As imaxes con fondos de cor - sólida perfectos tamén se fan mellor con software personalizado, pero - non son difíciles de facer do seguinte xeito. + Este «Como facelo» supón que está a tratar con obxectos opacos normais. O + tratamento de obxectos semitransparentes (lume, ventilador en movemento, + globo infantil) ou obxectos que dan luz (lume, bombilla, sol) faise mellor + cun software personalizado. As imaxes con fondos de cor sólida perfectos + tamén se fan mellor con software personalizado, pero non son difíciles de + facer do seguinte xeito. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- A elección da imaxe é crucial - Licenza + Licenza - 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 - copia de Tux Paint, xunto cos seus propios gráficos, precisa unha - imaxe que sexa compatíbel coa Licenza Pública Xeral GNU empregada por - Tux Paint. + 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 + copia de Tux Paint, xunto cos seus propios gráficos, precisa unha imaxe + que sexa compatíbel coa Licenza Pública Xeral GNU empregada por Tux + Paint. - 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 - usa outras imaxes na web. As consultas de Google image incluíndo - site:gov or site:mil proporcionarán moitas imaxes axeitadas. (Nota: os - sitios *.mil tamén inclúen contido non militar.) + 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 + usa outras imaxes na web. As consultas de Google image incluíndo + site:gov or site:mil proporcionarán moitas imaxes axeitadas. (Nota: os + sitios *.mil tamén inclúen contido non militar.) - As súas propias imaxes pódense poñer no dominio público ou nunha - licenza axeitada, como o Creative Commons CC0 declarándoas así . - (Consulte cun avogado se considera a necesidade dun asesoramento - xurídico.) + As súas propias imaxes pódense poñer no dominio público ou nunha + licenza axeitada, como o Creative Commons CC0 declarándoas así . + (Consulte cun avogado se considera a necesidade dun asesoramento + xurídico.) - Para uso persoal, calquera imaxe que lexitimamente poida modificar e - usar para o seu uso persoal debería estar ben. + Para uso persoal, calquera imaxe que lexitimamente poida modificar e + usar para o seu uso persoal debería estar ben. - Tamaño e orientación da imaxe + Tamaño e orientación da imaxe - Precisa unha imaxe que teña unha orientación útil. A perspectiva é un - inimigo. As imaxes que obxecto un obxecto dende un canto son difíciles - de encaixar nun bo debuxo. Como regra xeral, as vistas laterais con - teleobxectivo son as mellores. O ideal imposíbel é que, por exemplo, - dúas rodas dun coche estean perfectamente agochadas tras as outras - dúas. + Precisa unha imaxe que teña unha orientación útil. A perspectiva é un + inimigo. As imaxes que obxecto un obxecto dende un canto son difíciles + de encaixar nun bo debuxo. Como regra xeral, as vistas laterais con + teleobxectivo son as mellores. O ideal imposíbel é que, por exemplo, + dúas rodas dun coche estean perfectamente agochadas tras as outras + dúas. - Rotar unha imaxe pode facela borrosa, especialmente se só rota uns - 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 - e as que precisan uns poucos graos as peores. A rotación tamén fará - que a imaxe sexa máis escura porque a maioría do software de edición - de imaxes é moi malo na manipulación da gamma. (A rotación só é - lexítima para imaxes gamma = 1,0.) + Rotar unha imaxe pode facela borrosa, especialmente se só rota uns + 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 e + as que precisan uns poucos graos as peores. A rotación tamén fará que a + imaxe sexa máis escura porque a maioría do software de edición de + imaxes é moi malo na manipulación da gamma. (A rotación só é lexítima + para imaxes gamma = 1,0.) - As imaxes moi grandes son máis indulxentes cos erros e, polo tanto, - son máis doadas de traballar. Escolla unha imaxe cun obxecto de máis - de 1000 píxeles se pode. Pode reducilo máis tarde para agochar os seus - erros. + As imaxes moi grandes son máis indulxentes cos erros e, polo tanto, son + máis doadas de traballar. Escolla unha imaxe cun obxecto de máis de + 1000 píxeles se pode. Pode reducilo máis tarde para agochar os seus + erros. - Asegúrese de que a imaxe non está demasiado granulada, tenue ou - lavada. + Asegúrese de que a imaxe non está demasiado granulada, tenue ou lavada. - 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 - copiar o outro como substituto. + 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 + copiar o outro como substituto. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Preparar a imaxe - Primeiro de todo, asegúrese de evitar gardar de novo a imaxe como JPEG. - Isto provoca unha perda de calidade. Hai unha ferramenta especial - chamada jpegtran que permite recortar unha imaxe sen perder a calidade - normal. + Primeiro de todo, asegúrese de evitar gardar de novo a imaxe como JPEG. + Isto provoca unha perda de calidade. Hai unha ferramenta especial chamada + jpegtran que permite recortar unha imaxe sen perder a calidade normal. - jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - Cargue esa imaxe para o seu editor de imaxes. Se aínda non a cortou, - pode que o seu editor de imaxes sexa moi lento. Rote e recorte a imaxe - segundo sexa necesario. Garde a imaxe, escolla o formato nativo que - admita capas, máscaras, alfa, etc. Os usuarios de GIMP deberían escoller - «XCF» e os usuarios de Adobe Photoshop debería escoller «PSD», por - exemplo. + Cargue esa imaxe para o seu editor de imaxes. Se aínda non a cortou, pode + que o seu editor de imaxes sexa moi lento. Rote e recorte a imaxe segundo + sexa necesario. Garde a imaxe, escolla o formato nativo que admita capas, + máscaras, alfa, etc. Os usuarios de GIMP deberían escoller «XCF» e os + usuarios de Adobe Photoshop debería escoller «PSD», por exemplo. - Se rotou ou recortou a imaxe no seu editor de imaxes, aplánea agora. - Debe ter só unha capa RGB sen máscara nin alfa. + Se rotou ou recortou a imaxe no seu editor de imaxes, aplánea agora. Debe + ter só unha capa RGB sen máscara nin alfa. - Abra o cadro de diálogo de capas. Replique a capa varias veces. De - arriba abaixo necesitará algo así: + Abra o cadro de diálogo de capas. Replique a capa varias veces. De arriba + abaixo necesitará algo así: - 1. imaxe sen modificar (protexa isto contra escritura se pode) - 2. unha imaxe que modificar: a capa de «traballo en ptoceso» - 3. verde 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) + 1. imaxe sen modificar (protexa isto contra escritura se pode) + 2. unha imaxe que modificar: a capa de «traballo en ptoceso» + 3. verde 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) - Delle á capa Traballo en proceso (WIP — «work in progress» ) unha - máscara inicial aproximada. Pode comezar cunha selección ou empregando o - valor de escala de grises da capa WIP. Pode inverter a máscara. + Delle á capa Traballo en proceso (WIP — «work in progress» ) unha máscara + inicial aproximada. Pode comezar cunha selección ou empregando o valor de + 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 - imaxe normalmente. Isto provocaría a perda de datos. Máis adiante se lle - darán instrucións especiais de escalado. + 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 + darán instrucións especiais de escalado. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Preparar a máscara - Acostúmese a facer [Control]-premer e [Alt]-premer nas imaxes en - miniatura no diálogo de capas. Necesitará isto para controlar o que está - a ver e o que está a editar. Ás veces estará editando cousas que non - pode ver. Por exemplo, pode editar a máscara da capa WIP mentres mira a - imaxe sen modificar. Preste atención para non meter a pata. Verifica - sempre que está a editar o correcto. + Acostúmese a facer [Control]-premer e [Alt]-premer nas imaxes en miniatura + no diálogo de capas. Necesitará isto para controlar o que está a ver e o + que está a editar. Ás veces estará editando cousas que non pode ver. Por + exemplo, pode editar a máscara da capa WIP mentres mira a imaxe sen + modificar. Preste atención para non meter a pata. Verifica sempre que está + a editar o correcto. - Estabeleza unha imaxe sen modificar como a que vai ver (a superior é a - máis doada). Estabeleza a máscara WIP como o que vai editar. Nalgún - momento, quizais non de inmediato, debería aumentar a imaxe ata - aproximadamente o 400% (cada píxel da imaxe vese e edítase como un - bloque de píxeles 4x4 na súa pantalla). + Estabeleza unha imaxe sen modificar como a que vai ver (a superior é a máis + doada). Estabeleza a máscara WIP como o que vai editar. Nalgún momento, + quizais non de inmediato, debería aumentar a imaxe ata aproximadamente o + 400% (cada píxel da imaxe vese e edítase como un bloque de píxeles 4x4 na + súa pantalla). - Seleccione partes da imaxe que deben ser 100% opacas ou 0% opacas. Se - pode seleccionar o obxecto ou o fondo con certa precisión por cor, - fágao. Se é necesario para evitar seleccionar píxeles que deben ser - parcialmente opacos (xeralmente no bordo do obxecto), debe aumentar, - diminuír e inverter a selección. + Seleccione partes da imaxe que deben ser 100% opacas ou 0% opacas. Se pode + seleccionar o obxecto ou o fondo con certa precisión por cor, fágao. Se é + necesario para evitar seleccionar píxeles que deben ser parcialmente opacos + (xeralmente no bordo do obxecto), debe aumentar, diminuír e inverter a + selección. - Encha as áreas 100% opacas con branco e as áreas 0% opacas con negro. - Isto faise máis facilmente arrastrando e soltando dende o indicador de - cor de primeiro plano/fondo. Non debería ver ocorrer nada porque está a - ver a capa de imaxe sen modificar mentres edita a máscara da capa WIP. É - posíbel que se poidan notar grandes cambios na miniatura. + Encha as áreas 100% opacas con branco e as áreas 0% opacas con negro. Isto + faise máis facilmente arrastrando e soltando dende o indicador de cor de + primeiro plano/fondo. Non debería ver ocorrer nada porque está a ver a capa + de imaxe sen modificar mentres edita a máscara da capa WIP. É posíbel que + 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. - Amose só a máscara, que debería ser un obxecto branco sobre un fondo - negro (probabelmente cun gris sen editar no bordo). Agora amose - normalmente a capa WIP para que a máscara estea activa. Isto debería - amosar o seu obxecto sobre a seguinte capa máis alta activada, que - debería ser verde ou maxenta segundo sexa necesario para obter o máximo - contraste. Quizais queira alternar entre eses fondos premendo varias - veces para activar/desactivar a capa verde. Corrixa os problemas obvios - e sinxelos editando a máscara mentres a ve. + 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 negro + (probabelmente cun gris sen editar no bordo). Agora amose normalmente a + capa WIP para que a máscara estea activa. Isto debería amosar o seu obxecto + sobre a seguinte capa máis alta activada, que debería ser verde ou maxenta + segundo sexa necesario para obter o máximo contraste. Quizais queira + alternar entre eses fondos premendo varias veces para activar/desactivar a + capa verde. Corrixa os problemas obvios e sinxelos editando a máscara + mentres a ve. - 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 - un pequeno círculo difuso. O tamaño 5x5 é bo para a maioría dos usos. + 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 un + 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 - branco polo interior. Evite facer máis dun pase sen cambiar de cor (e, - polo tanto, de lado). + 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, polo + tanto, de lado). - 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 - 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 - píxeles que non son nin 100% obxecto nin 0% obxecto. Para eles, a - máscara non debería ser nin do 100% nin do 0%. A franxa retirase pronto. + 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 + 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 + píxeles que non son nin 100% obxecto nin 0% obxecto. Para eles, a máscara + 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. - O 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. - Faga esta operación tanto para branco como para negro. + Ver e editar a máscara. Seleccione por cor, escollendo negro ou branco. O + 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. Faga + esta operación tanto para branco como para negro. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Substituír a franxa e os píxeles lixo - Se sigue a ver a máscara, seleccione por cor. Escolla o negro. Reduza a - selección en varios píxeles, asegurándose de NON reducir os bordos da - máscara (a contracción axúdalle a evitar e recuperar os erros). + Se sigue a ver a máscara, seleccione por cor. Escolla o negro. Reduza a + selección en varios píxeles, asegurándose de NON reducir os bordos da + máscara (a contracción axúdalle a evitar e recuperar os erros). - 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 - obxecto. Arrastre e solte esta cor na selección, eliminando así a - maioría dos píxeles que non son do obxecto. + 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 + obxecto. Arrastre e solte esta cor na selección, eliminando así a maioría + dos píxeles que non son do obxecto. - 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 - moi diferentes, debe dividir a selección para que poida colorar o fondo - próximo para que sexa semellante. + 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 moi + diferentes, debe dividir a selección para que poida colorar o fondo próximo + para que sexa semellante. - Agora pintará a franxa de bordo existente. Asegúrese de que está - editando e vendo a imaxe WIP. Os cambios frecuentes na visibilidade das - capas axudaranlle a ver o que fai. É probábel que empregue todos os: + Agora pintará a franxa de bordo existente. Asegúrese de que está editando e + vendo a imaxe WIP. Os cambios frecuentes na visibilidade das capas + axudaranlle a ver o que fai. É probábel que empregue todos os: - * composto sobre verde (máscara activada) - * composto sobre maxenta (máscara activada) - * orixinal (a capa superior ou inferior) - * composto sobre o orixinal (máscara activada) - * capa WIP en bruto (máscara desactivada) + + composto sobre verde (máscara activada) + + composto sobre maxenta (máscara activada) + + orixinal (a capa superior ou inferior) + + composto sobre o orixinal (máscara activada) + + capa WIP en bruto (máscara desactivada) - Para reducir os accidentes, pode que queira seleccionar só os píxeles - que non estean grises na máscara. (Seleccione por cor na máscara, - escolla negro, engada o modo, escolla o branco, inverter. - Alternativamente: seleccione todo, seleccione por cor da máscara, modo - de subtracción, escolla o negro, escolla o branco.) Se fai isto, - probabelmente queira expandir un pouco a selección e/ou agochar a - ringleira de «formigas» que marca a selección. + Para reducir os accidentes, pode que queira seleccionar só os píxeles que + non estean grises na máscara. (Seleccione por cor na máscara, escolla + negro, engada o modo, escolla o branco, inverter. Alternativamente: + seleccione todo, seleccione por cor da máscara, modo de subtracción, + escolla o negro, escolla o branco.) Se fai isto, probabelmente queira + expandir un pouco a selección e/ou agochar a ringleira de «formigas» que + marca a selección. - Use a ferramenta de clonación e a de pincel. Varíe a opacidade segundo - sexa necesario. Empregue principalmente pinceis redondos pequenos, - quizais 3x3 ou 5x5, difusos ou non. (Xeralmente é bo emparellar pinceis - difusos cun 100% de opacidade e pinceis non difusos cun 70% de - opacidade.) Os modos de debuxo pouco comúns poden ser útiles con - obxectos semitransparentes. + Use a ferramenta de clonación e a de pincel. Varíe a opacidade segundo sexa + necesario. Empregue principalmente pinceis redondos pequenos, quizais 3x3 + ou 5x5, difusos ou non. (Xeralmente é bo emparellar pinceis difusos cun + 100% de opacidade e pinceis non difusos cun 70% de opacidade.) Os modos de + debuxo pouco comúns poden ser útiles con obxectos semitransparentes. - 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 - maxenta ou verde, debe eliminarse por razóns obvias. Tamén hai que - eliminar a franxa exterior porque se fará visíbel cando a imaxe se - reduza. Como exemplo, considere unha rexión de 2x2 de píxeles no bordo - dun obxecto de bordos afiados. A metade esquerda é negra e 0% opaca. A - metade dereita é branca e 100% opaca. É dicir, temos un obxecto branco - sobre fondo negro. Cando Tux Paint escala este ao 50% (unha área de 1x1 - píxeles), o resultado será un píxel gris opaco do 50%. O resultado - correcto sería un píxel branco ao 50% opaco. Para obter este resultado, - pintaríamos os píxeles negros. Estes iImportan, a pesar de ser 0% - opacos. + 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 + maxenta ou verde, debe eliminarse por razóns obvias. Tamén hai que eliminar + a franxa exterior porque se fará visíbel cando a imaxe se reduza. Como + exemplo, considere unha rexión de 2x2 de píxeles no bordo dun obxecto de + bordos afiados. A metade esquerda é negra e 0% opaca. A metade dereita é + branca e 100% opaca. É dicir, temos un obxecto branco sobre fondo negro. + Cando Tux Paint escala este ao 50% (unha área de 1x1 píxeles), o resultado + será un píxel gris opaco do 50%. O resultado correcto sería un píxel branco + ao 50% opaco. Para obter este resultado, pintaríamos os píxeles negros. + Estes iImportan, a pesar de ser 0% opacos. - Tux Paint pode reducir a escala das imaxes nun factor moi grande, polo - que é importante estender moito o bordo do obxecto cara a fóra. Xusto no - bordo do obxecto, debe ser moi preciso respecto diso. A medida que se - afasta do o, pode ser un pouco desleixado. É razoábel pintar cara a fóra - unha ducia de píxeles ou máis. Canto máis lonxe vaia, máis pode Tux - Paint reducir sen crear franxas de cor feas. Para as áreas que están a - máis duns poucos píxeles de distancia do bordo do obxecto, debería - empregar a ferramenta de lapis (ou seleccionar arrastrar e soltar cor) - para garantir que o resultado se comprime ben. + Tux Paint pode reducir a escala das imaxes nun factor moi grande, polo que + é importante estender moito o bordo do obxecto cara a fóra. Xusto no bordo + do obxecto, debe ser moi preciso respecto diso. A medida que se afasta do + o, pode ser un pouco desleixado. É razoábel pintar cara a fóra unha ducia + de píxeles ou máis. Canto máis lonxe vaia, máis pode Tux Paint reducir sen + crear franxas de cor feas. Para as áreas que están a máis duns poucos + píxeles de distancia do bordo do obxecto, debería empregar a ferramenta de + lapis (ou seleccionar arrastrar e soltar cor) para garantir que o resultado + se comprime ben. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Gardar a imaxe para Tux Paint - É moi doado esnaquizar un traballo arreo. Os editores de imaxes poden - 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, - pode tentar gardar a súa imaxe directamente como PNG. Asegúrese de vela - de novo para verificar que as áreas 0% opacas non se volveron negras ou - brancas, o que crearía franxas cando Tux Paint reduza a imaxe. Se - precisa escalar a súa imaxe para aforrar espazo (e agochar os seus - erros), é case seguro que destruirá todas as áreas 0% opacas. Velaquí - unha mellor forma... + É moi doado esnaquizar un traballo arreo. Os editores de imaxes poden + 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, pode + tentar gardar a súa imaxe directamente como PNG. Asegúrese de vela de novo + para verificar que as áreas 0% opacas non se volveron negras ou brancas, o + que crearía franxas cando Tux Paint reduza a imaxe. Se precisa escalar a + súa imaxe para aforrar espazo (e agochar os seus erros), é case seguro que + destruirá todas as áreas 0% opacas. Velaquí unha mellor forma... - Un xeito máis seguro de gardar + Un xeito máis seguro de gardar - Arrastre a máscara desde o diálogo de capas ata a parte non utilizada - da barra de ferramentas (xusto após a última ferramenta de debuxo). - Isto creará unha nova imaxe composta por unha capa que contén os datos - da máscara. Escale isto como queira, lembrando os axustes que utiliza. - Moitas veces debe comezar cunha imaxe de entre 700 e 1500 píxeles de - largo e acabar cunha de 300 a 400. + Arrastre a máscara desde o diálogo de capas ata a parte non utilizada + da barra de ferramentas (xusto após a última ferramenta de debuxo). + Isto creará unha nova imaxe composta por unha capa que contén os datos + da máscara. Escale isto como queira, lembrando os axustes que utiliza. + Moitas veces debe comezar cunha imaxe de entre 700 e 1500 píxeles de + largo e acabar cunha de 300 a 400. - Garde a imaxe da máscara como un ficheiro de mapa de grises portátil - NetPBM («.pgm»). (Se está a usar unha versión antiga de The GIMP, é - posíbel que deba converter a imaxe en escala de grises antes de - gardala.) Escolla o formato máis compacto «RAW PGM». (O segundo - carácter do ficheiro debe ser o díxito ASCII «5», byte hexadecimal - 0x35.) + Garde a imaxe da máscara como un ficheiro de mapa de grises portátil + NetPBM («.pgm»). (Se está a usar unha versión antiga de The GIMP, é + posíbel que deba converter a imaxe en escala de grises antes de + gardala.) Escolla o formato máis compacto «RAW PGM». (O segundo + carácter do ficheiro debe ser o díxito ASCII «5», byte hexadecimal + 0x35.) - Pode pechar a imaxe da máscara. + Pode pechar a imaxe da máscara. - 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 - 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 - obxecto e o contorno pintado sen ningunha miniatura de máscara no - diálogo de capas. Se escalou a máscara, entón escale esta imaxe - exactamente do mesmo xeito. Garde esta imaxe como un ficheiro de - pixmap portátil NetPBM («.ppm»). (Nota: .ppm, non .pgm.) (Se escolle o - formato RAW PPM, o segundo byte do ficheiro debería ser o díxito ASCII - «6», o byte hexadecimal 0x36.) + 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 + 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 obxecto + e o contorno pintado sen ningunha miniatura de máscara no diálogo de + capas. Se escalou a máscara, entón escale esta imaxe exactamente do + mesmo xeito. Garde esta imaxe como un ficheiro de pixmap portátil + NetPBM («.ppm»). (Nota: .ppm, non .pgm.) (Se escolle o formato RAW PPM, + o segundo byte do ficheiro debería ser o díxito ASCII «6», o byte + hexadecimal 0x36.) - Agora cómpre fusionar os dous ficheiros nun só. Fagao coa orde - pnmtopng, así: + Agora cómpre fusionar os dous ficheiros nun só. Fagao coa orde pnmtopng + , así: + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/gl_ES.UTF-8/ENVVARS.txt b/docs/gl_ES.UTF-8/ENVVARS.txt index e37c64e2c..b473d7cf8 100644 --- a/docs/gl_ES.UTF-8/ENVVARS.txt +++ b/docs/gl_ES.UTF-8/ENVVARS.txt @@ -1,100 +1,106 @@ Tux Paint - versión 0.9.31 - Documentación de variábeis de contorno + versión 0.9.31 + Documentación de variábeis de contorno Copyright © 2021-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ 5 de Maio de 2023 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint comprende unha serie de variábeis de contorno, ben directamente - ou indirectamente polas bibliotecas que emprega. +Tux Paint comprende unha serie de variábeis de contorno, ben directamente ou +indirectamente polas bibliotecas que emprega. Variábeis de contorno relacionadas co almacenamento - HOME +HOME - Especifica o «directorio persoal» do usuario, que se usa para - localizar outros ficheiros ou directorios. Nalgúns casos, úsase - como parte dunha situación alternativa, cando non se configuran - outras variábeis de contorno (noutros lugares desta - documentación). Ás veces, a localización a empregar pode ser - 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 «OPCIÓNS» (OPTIONS) para máis detalles. + Especifica o «directorio persoal» do usuario, que se usa para localizar + outros ficheiros ou directorios. Nalgúns casos, úsase como parte dunha + situación alternativa, cando non se configuran outras variábeis de contorno + (noutros lugares desta documentación). Ás veces, a localización a empregar + pode ser 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 + «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 base de onde Tux Paint garda e carga os debuxos dos - usuarios - * A localización da colección privada de ficheiros de datos dun - usuario — selos, pinceis, etc. — (fronte aos dispoñíbeis no - sistema) + + A localización do ficheiro de configuración de Tux Paint + + A base de onde Tux Paint garda e carga os debuxos dos usuarios + + A localización da colección privada de ficheiros de datos dun usuario — + selos, pinceis, etc. — (fronte aos dispoñíbeis no sistema) - XDG_CONFIG_HOME - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's configuration files. - Specifically, where to find "user-dirs.dirs", where the - "XDG_PICTURES_DIR" might be defined. It is used for exporting - drawings and animated GIFs. Generally it's set to something like - "$HOME/Pictures/". If not specified, Tux Paint checks in the - directory "$HOME/.config/". If the configuration cannot be found, - Tux Paint simply exports drawings and GIFs to "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's configuration files. Specifically, where to find + "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used + for exporting drawings and animated GIFs. Generally it's set to something + like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory + "$HOME/.config/". If the configuration cannot be found, Tux Paint simply + exports drawings and GIFs to "$HOME". - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's data directories. - Specifically, where to find the "Trash" directory. It is used when - deleting images from Tux Paint's "Open" dialog. If not set, the - location "$HOME/.local/share/Trash/" is used, if available. If - not, images are simply deleted, rather than moved anywhere. - TEMP - Especifica a localización onde se poden crear ficheiros temporais. - Só o usa Tux Paint nos sistemas operativos Microsoft Windows. - Emprega «userdata» se non se define. +XDG_DATA_HOME + + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's data directories. Specifically, where to find + the "Trash" directory. It is used when deleting images from Tux Paint's + "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is + used, if available. If not, images are simply deleted, rather than moved + anywhere. + + + +TEMP + + Especifica a localización onde se poden crear ficheiros temporais. Só o usa + Tux Paint nos sistemas operativos Microsoft Windows. Emprega «userdata» se + non se define. Variábeis de contorno relacionadas co idioma - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Specify the language Tux Paint should utilize in its user interface. + Overridde by the "--lang" and "--locale" command-line options or their + configuration file counterparts. The "LANGUAGE" environment variable is + used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES", + and finally "LANG". - LC_ALL - LC_MESSAGES - Specify the language Tux Paint should utilize in its user - interface. Overridde by the "--lang" and "--locale" command-line - options or their configuration file counterparts. The "LANGUAGE" - environment variable is used, if set. If not, "LC_ALL" is used as - a fallback. Then "LC_MESSAGES", and finally "LANG". Variábeisbles de contorno relacionadas co que se amosa - A seguir amósanse algunhas das variábeis de contorno compatíbeis con - Simple DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar - gráficos, reproducir sons e recibir entrada do rato, teclado e joystick — - e que poden ser útiles para os usuarios de Tux Paint. +A seguir amósanse algunhas das variábeis de contorno compatíbeis con Simple +DirectMedia Layer (libSDL) — que Tux Paint utiliza para amosar gráficos, +reproducir sons e recibir entrada do rato, teclado e joystick — e que poden ser +útiles para os usuarios de Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Especifica se Tux Paint debería permitir a execución dun protector de + pantalla. Pode ser definido como «1» (verdadeiro) polo propio Tux Paint + emitindo a opción de liña de ordes «--allowscreensaver» ou o seu equivaente + no ficheiro de configuración. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Especifica se Tux Paint debería permitir a execución dun protector - de pantalla. Pode ser definido como «1» (verdadeiro) polo propio - Tux Paint emitindo a opción de liña de ordes «--allowscreensaver» - ou o seu equivaente no ficheiro de configuración. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/gl_ES.UTF-8/EXTENDING.txt b/docs/gl_ES.UTF-8/EXTENDING.txt index 6042624bf..36f79ae74 100644 --- a/docs/gl_ES.UTF-8/EXTENDING.txt +++ b/docs/gl_ES.UTF-8/EXTENDING.txt @@ -1,1084 +1,1098 @@ Ampliar Tux Paint - versión 0.9.31 + versión 0.9.31 Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ - 29 de Maio de 2023 + 29 de Maio de 2023 - +--------------------------------------------------------------+ - |Índice | - |--------------------------------------------------------------| - | * Onde van os ficheiros | - | * Ficheiros estándar | - | * Ficheiros persoais | - | * Pinceis | - | * Opcións de pinceis | - | * Selos | - | * Imaxes de selos | - | * Texto descritivo do selo | - | * Efectos de son dos selos | - | * Son descritivo do selo | - | * Opcións de selos | - | * Selos prereflectidos e invertidos | - | * Tipos de letra | - | * «Imaxes de comezo» | - | * Imaxes «de comezo» ao estilo dun libro para colorar | - | * Imaxes «de comezo» ao estilo dunha escena | - | * Starter Options | - | * «Modelos» | - | * Template Options | - | * Traducións | - | * Métodos de entrada alternativos | - | * Teclado en pantalla | - | * Magic Tools | - +--------------------------------------------------------------+ ++-------------------------------------------------------------+ +| Índice | +|-------------------------------------------------------------| +| * Onde van os ficheiros | +| + Ficheiros estándar | +| + Ficheiros persoais | +| * Pinceis | +| + Opcións de pinceis | +| * Selos | +| + Imaxes de selos | +| + Texto descritivo do selo | +| + Efectos de son dos selos | +| + Son descritivo do selo | +| + Opcións de selos | +| + Selos prereflectidos e invertidos | +| * Tipos de letra | +| * «Imaxes de comezo» | +| + Imaxes «de comezo» ao estilo dun libro para colorar | +| + Imaxes «de comezo» ao estilo dunha escena | +| + Starter Options | +| * «Modelos» | +| + Template Options | +| * Traducións | +| * Métodos de entrada alternativos | +| * Teclado en pantalla | +| * Magic Tools | ++-------------------------------------------------------------+ - Se quere engadir ou cambiar cousas como pinceis, imaxes de comezo, selos - de goma e outros contidos empregados por Tux Paint, pode facelo con - bastante facilidade simplemente engadindo, cambiando ou eliminando - ficheiros onde os busque Tux Paint. +Se quere engadir ou cambiar cousas como pinceis, imaxes de comezo, selos de +goma e outros contidos empregados por Tux Paint, pode facelo con bastante +facilidade simplemente engadindo, cambiando ou eliminando ficheiros onde os +busque Tux Paint. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Onde van os ficheiros +Onde van os ficheiros Ficheiros estándar - Tux Paint busca os seus diferentes ficheiros de datos no directorio - «data». +Tux Paint busca os seus diferentes ficheiros de datos no directorio «data». - Linux e Unix +Linux e Unix - Onde vai este directorio depende do valor estabelecido para - «DATA_PREFIX» cando se construíu Tux Paint. Vexa a «Documentación - de instalación» para máis detalles. + Onde vai este directorio depende do valor estabelecido para «DATA_PREFIX» + cando se construíu Tux Paint. Vexa a «Documentación de instalación» para + máis detalles. - De xeito predeterminado, o directorio é: + De xeito predeterminado, o directorio é: - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - Se instalou dende un paquete, o máis probábel é que sexa: + Se instalou dende un paquete, o máis probábel é que sexa: - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint busca un directorio chamado «data» no mesmo directorio - que o executábel. Este é o directorio que utilizou o instalador ao - instalar Tux Paint p. ex.: - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint busca un directorio chamado «data» no mesmo directorio que o + executábel. Este é o directorio que utilizou o instalador ao instalar Tux + Paint p. ex.: - Tux Paint almacena os seus ficheiros de datos dentro da icona da - aplicación «Tux Paint» (que en realidade é un tipo de cartafol - especial en macOS e Mac OS X antes). Os seguintes pasos explican - como chegar aos cartafoles dentro del: + C:\Program Files\TuxPaint\data - 1. Abra un menú «contextual» mantendo premida a tecla [Control] - e premendo na icona de Tux Paint no Finder (buscador). (Se - ten un rato con máis dun botón, pode simplemente premer co - botón dereito na icona.) - 2. Seleccione «Amosar contido» no menú que aparece. Aparecerá - unha nova xanela Finder cun cartafol dentro chamado - «Contido». - 3. Abra o cartafol «Contido» e abra o cartafol «Recursos» que se - atopa dentro. - 4. Alí atoparás varios subcartafoles, como «imaxes de comezo», - «selos», «pinceis», etc. Engadindo novo contido a estes - cartafoles fará que o contido estea dispoñíbel para calquera - usuario que inicia copia (icona) de Tux Paint . - 💡 Nota: Se instala unha versión máis recente de Tux Paint e - substitúe ou desbota a versión antiga, perderá os cambios feitos - seguindo as instrucións anteriores, así que garde as copias de - seguridade do seu novo contido (selos, pinceis, etc.) . - Tux Paint tamén busca ficheiros nun cartafol «TuxPaint» que pode - colocar no seu sistema no cartafol «Application Support» (atópase - en «Library» na raíz do seu sistema de ficheiros): +macOS + + Tux Paint almacena os seus ficheiros de datos dentro da icona da aplicación + «Tux Paint» (que en realidade é un tipo de cartafol especial en macOS e Mac + OS X antes). Os seguintes pasos explican como chegar aos cartafoles dentro + del: + + 1. Abra un menú «contextual» mantendo premida a tecla [Control] e premendo + na icona de Tux Paint no Finder (buscador). (Se ten un rato con máis + dun botón, pode simplemente premer co botón dereito na icona.) + 2. Seleccione «Amosar contido» no menú que aparece. Aparecerá unha nova + xanela Finder cun cartafol dentro chamado «Contido». + 3. Abra o cartafol «Contido» e abra o cartafol «Recursos» que se atopa + dentro. + 4. Alí atoparás varios subcartafoles, como «imaxes de comezo», «selos», + «pinceis», etc. Engadindo novo contido a estes cartafoles fará que o + contido estea dispoñíbel para calquera usuario que inicia copia (icona) + de Tux Paint . + + 💡 Nota: Se instala unha versión máis recente de Tux Paint e substitúe ou + desbota a versión antiga, perderá os cambios feitos seguindo as instrucións + anteriores, así que garde as copias de seguridade do seu novo contido + (selos, pinceis, etc.) . + + Tux Paint tamén busca ficheiros nun cartafol «TuxPaint» que pode colocar no + seu sistema no cartafol «Application Support» (atópase en «Library» na raíz + do seu sistema de ficheiros): + + /Library/Application Support/TuxPaint/ + + Cando actualice a unha versión máis recente de Tux Paint, o contido deste + cartafol «TuxPaint» seguirá sendo o mesmo e permanecerá accesíbel por todos + os usuarios de Tux Paint. + - /Library/Application Support/TuxPaint/ - Cando actualice a unha versión máis recente de Tux Paint, o - contido deste cartafol «TuxPaint» seguirá sendo o mesmo e - permanecerá accesíbel por todos os usuarios de Tux Paint. Ficheiros persoais - Tamén pode crear pinceis, selos, «imaxes de comezo», modelos e tipos de - letra no directorio da súa propia conta de usuario (cartafol) para que Tux - Paint poida atopalos. +Tamén pode crear pinceis, selos, «imaxes de comezo», modelos e tipos de letra +no directorio da súa propia conta de usuario (cartafol) para que Tux Paint +poida atopalos. - Windows +Windows - O seu cartafol persoal de Tux Paint almacénase nos seus «Datos da - aplicación» persoais. Por exemplo, nos Windows máis recentes: + O seu cartafol persoal de Tux Paint almacénase nos seus «Datos da + aplicación» persoais. Por exemplo, nos Windows máis recentes: - C:\Documentos e axustes\(nome de usuario)\Datos da - aplicación\TuxPaint\ + C:\Documentos e axustes\(nome de usuario)\Datos da aplicación\TuxPaint\ - macOS - O seu cartafol persoal de Tux Paint almacénase no cartafol persoal - «Application Support»: - /Users/(nome de usuario)/Library/Application Support/TuxPaint/ +macOS - Linux e Unix + O seu cartafol persoal de Tux Paint almacénase no cartafol persoal + «Application Support»: - Os seus ficheiros persoais de Tux Paint van a un «directorio - agochado» que se atopa no directorio persoal da súa conta: - «$(HOME)/.tuxpaint/» (tamén coñecido como «~/.tuxpaint/»). + /Users/(nome de usuario)/Library/Application Support/TuxPaint/ - É dicir, se o seu directorio persoal é «/home/tux», entón os - ficheiros persoais de Tux Paint entrarán en - «/home/tux/.tuxpaint/». - Non esqueza o punto («.») antes de «tuxpaint»! - Para engadir os seus propios pinceis, selos, «imaxes de comezo», modelos e - tipos de letra, cree subdirectorios no seu directorio persoal de Tux Paint - chamados «brushes», «stamps», «starters», «templates», «fonts», , - respectivamente. +Linux e Unix - (Por exemplo, se creou un pincel chamado «flor.png», poñeríao en - «~/.tuxpaint/brushes/» en Linux ou Unix.) + Os seus ficheiros persoais de Tux Paint van a un «directorio agochado» que + se atopa no directorio persoal da súa conta: «$(HOME)/.tuxpaint/» (tamén + coñecido como «~/.tuxpaint/»). - Pinceis + É dicir, se o seu directorio persoal é «/home/tux», entón os ficheiros + persoais de Tux Paint entrarán en «/home/tux/.tuxpaint/». - Os pinceis empregados para debuxar coas ferramentas «Pincel» e «Liñas» en - Tux Paint son simplemente ficheiros de imaxe PNG. + Non esqueza o punto («.») antes de «tuxpaint»! - A alfa (transparencia) da imaxe PNG úsase para determinar a forma do - pincel, o que significa que a forma pode ser «alisado» e incluso - parcialmente transparente. - Os píxeles de escala de grises no pincel PNG debuxaranse empregando a cor - seleccionada actualmente en Tux Paint. Os píxeles de cor tinguiranse. + + +Para engadir os seus propios pinceis, selos, «imaxes de comezo», modelos e +tipos de letra, cree subdirectorios no seu directorio persoal de Tux Paint +chamados «brushes», «stamps», «starters», «templates», «fonts», , +respectivamente. + +(Por exemplo, se creou un pincel chamado «flor.png», poñeríao en «~/.tuxpaint/ +brushes/» en Linux ou Unix.) + +Pinceis + +Os pinceis empregados para debuxar coas ferramentas «Pincel» e «Liñas» en Tux +Paint son simplemente ficheiros de imaxe PNG. + +A alfa (transparencia) da imaxe PNG úsase para determinar a forma do pincel, o +que significa que a forma pode ser «alisado» e incluso parcialmente +transparente. + +Os píxeles de escala de grises no pincel PNG debuxaranse empregando a cor +seleccionada actualmente en Tux Paint. Os píxeles de cor tinguiranse. Opcións de pinceis - Ademais de a graphical shape, a brushes tamén se lle poden dar outros - atributos. Para facelo, cómpre crear un «ficheiro de datos» para brush. +Ademais de a graphical shape, a brushes tamén se lle poden dar outros +atributos. Para facelo, cómpre crear un «ficheiro de datos» para brush. - Un ficheiro de datos de brush's é simplemente un ficheiro de texto ASCII - simple que contén as opcións de brush. +Un ficheiro de datos de brush's é simplemente un ficheiro de texto ASCII simple +que contén as opcións de brush. - O ficheiro ten o mesmo nome que a imaxe PNG, pero unha extensión «.dat». - (p. ex.: o ficheiro de datos de «pincel.png» é o ficheiro de texto - «pincel.dat», que se atopa no mesmo directorio.) +O ficheiro ten o mesmo nome que a imaxe PNG, pero unha extensión «.dat». (p. +ex.: o ficheiro de datos de «pincel.png» é o ficheiro de texto «pincel.dat», +que se atopa no mesmo directorio.) - Espazado do pincel +Espazado do pincel - A partir da versión 0.9.16 de Tux Paint, agora pode especificar o - espazado para os pinceis (é dicir, a frecuencia coa que se - debuxan). De xeito predeterminado, o espazado será a altura do - pincel, dividido por 4. + A partir da versión 0.9.16 de Tux Paint, agora pode especificar o espazado + para os pinceis (é dicir, a frecuencia coa que se debuxan). De xeito + predeterminado, o espazado será a altura do pincel, dividido por 4. - Engada unha liña que conteña a liña «spacing=N» ao ficheiro de - datos do pincel, onde «N» é o espazado que quere para o pincel. - (Canto menor sexa o número, máis veces se debuxa o pincel.) + Engada unha liña que conteña a liña «spacing=N» ao ficheiro de datos do + pincel, onde «N» é o espazado que quere para o pincel. (Canto menor sexa o + número, máis veces se debuxa o pincel.) - Pinceis animados - A partir da versión 0.9.16 de Tux Paint, pode crear pinceis - animados. A medida que se usa o pincel, debúxase cada cadro da - animación. - Coloca cada cadro nunha ampla imaxe PNG. Por exemplo, se o pincel - ten 30x30 e ten 5 fotogramas, a imaxe debería ser 150x30. +Pinceis animados - Engada unha liña que conteña a liña «frames=N» ao ficheiro de - datos do pincel, onde «N» é o número de fotogramas do pincel. + A partir da versión 0.9.16 de Tux Paint, pode crear pinceis animados. A + medida que se usa o pincel, debúxase cada cadro da animación. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Coloca cada cadro nunha ampla imaxe PNG. Por exemplo, se o pincel ten 30x30 + e ten 5 fotogramas, a imaxe debería ser 150x30. - Pinceis direccionais + Engada unha liña que conteña a liña «frames=N» ao ficheiro de datos do + pincel, onde «N» é o número de fotogramas do pincel. - A partir da versión 0.9.16 de Tux Paint, pode crear pinceis - direccionais. A medida que se usa o pincel, debúxanse diferentes - formas, dependendo da dirección na que vaia. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - As formas direccionais divídense nun cadrado de 3x3 nunha imaxe - PNG. Por exemplo, se o pincel ten 30x30, a imaxe debería ser 90x90 - e cada unha das formas da dirección colocadas nunha grade 3x3. A - rexión central úsase sen movemento. A parte superior dereita úsase - para o movemento cara arriba e á dereita. E así sucesivamente. - Engada unha liña que conteña a palabra «directional» ao ficheiro - de datos debrush's. - Rotating Brushes +Pinceis direccionais - As of Tux Paint version 0.9.27, you may now create rotating - brushes. As the brush is used, it is rotated 360 degrees, - depending on the direction the brush is going. + A partir da versión 0.9.16 de Tux Paint, pode crear pinceis direccionais. A + medida que se usa o pincel, debúxanse diferentes formas, dependendo da + dirección na que vaia. - Engada unha liña que conteña a palabra «rotate» ao ficheiro de - datos debrush's. + As formas direccionais divídense nun cadrado de 3x3 nunha imaxe PNG. Por + exemplo, se o pincel ten 30x30, a imaxe debería ser 90x90 e cada unha das + formas da dirección colocadas nunha grade 3x3. A rexión central úsase sen + movemento. A parte superior dereita úsase para o movemento cara arriba e á + dereita. E así sucesivamente. - Animated Directional or Rotating Brushes + Engada unha liña que conteña a palabra «directional» ao ficheiro de datos + debrush's. - You may mix both animated and either directional or rotating - features into one brush. Use both options desired ("frames=N" and - "directional" or "rotate"), in separate lines in the brush's - ".dat" file. - For directional brushes, lay the brush out so that each 3x3 set of - directional shapes are laid out across a wide PNG image. For - example, if the brush is 30x30 and there are 5 frames, it would be - 450x90. (The leftmost 150x90 pixels of the image represent the 9 - direction shapes for the first frame, for example.) - Coloque os ficheiros PNG de pincel (e calquera ficheiro de texto de datos) - no directorio «brushes». +Rotating Brushes - 💡 Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + As of Tux Paint version 0.9.27, you may now create rotating brushes. As the + brush is used, it is rotated 360 degrees, depending on the direction the + brush is going. - Selos + Engada unha liña que conteña a palabra «rotate» ao ficheiro de datos + debrush's. - Todos os ficheiros relacionados co selo van no directorio «stamps». É útil - crear alí subdirectorios e subsubdirectorios para organizar os selos. (Por - exemplo, pode ter un cartafol «vacacións» con subcartafoles «samaín» e - «nadal»). + + +Animated Directional or Rotating Brushes + + You may mix both animated and either directional or rotating features into + one brush. Use both options desired ("frames=N" and "directional" or " + rotate"), in separate lines in the brush's ".dat" file. + + For directional brushes, lay the brush out so that each 3x3 set of + directional shapes are laid out across a wide PNG image. For example, if + the brush is 30x30 and there are 5 frames, it would be 450x90. (The + leftmost 150x90 pixels of the image represent the 9 direction shapes for + the first frame, for example.) + + + + +Coloque os ficheiros PNG de pincel (e calquera ficheiro de texto de datos) no +directorio «brushes». + +💡 Note: If your new brushes all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +Selos + +Todos os ficheiros relacionados co selo van no directorio «stamps». É útil +crear alí subdirectorios e subsubdirectorios para organizar os selos. (Por +exemplo, pode ter un cartafol «vacacións» con subcartafoles «samaín» e +«nadal»). Imaxes de selos - Os selos de caucho en Tux Paint poden estar formados por varios ficheiros - separados. O único ficheiro necesario é, por suposto, a imaxe en si. +Os selos de caucho en Tux Paint poden estar formados por varios ficheiros +separados. O único ficheiro necesario é, por suposto, a imaxe en si. - A partir da versión 0.9.17 de Tux Paint, os selos poden ser imaxes de mapa - de bits PNG ou imaxes vectoriais SVG. Poden ser a toda cor ou en escala de - grises. A canle alfa (transparencia) dos PNG utilízase para determinar a - forma real da imaxe (se non, marcará un rectángulo grande nos seus - debuxos). +A partir da versión 0.9.17 de Tux Paint, os selos poden ser imaxes de mapa de +bits PNG ou imaxes vectoriais SVG. Poden ser a toda cor ou en escala de grises. +A canle alfa (transparencia) dos PNG utilízase para determinar a forma real da +imaxe (se non, marcará un rectángulo grande nos seus debuxos). - Os PNG poden ter calquera tamaño e Tux Paint (de xeito predeterminado) - ofrece un conxunto de botóns de tamaño para que o usuario poida escalar o - selo cara arriba (máis grande) e cara abaixo (máis pequeno). +Os PNG poden ter calquera tamaño e Tux Paint (de xeito predeterminado) ofrece +un conxunto de botóns de tamaño para que o usuario poida escalar o selo cara +arriba (máis grande) e cara abaixo (máis pequeno). - Os SVG están baseados en vectores e escalaranse axeitadamente para o - tamaño do lenzo que se use en Tux Paint. +Os SVG están baseados en vectores e escalaranse axeitadamente para o tamaño do +lenzo que se use en Tux Paint. - 💡 Note: If your new PNG-based stamps all come out as solid squares or - rectangles, it's because you forgot to use alpha transparency! See the - 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new PNG-based stamps all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Usuarios avanzados: O documento «Como facer os selos avanzados» describe - detalladamente como facer imaxes PNG que se adaptarán perfectamente cando - se usen como selos en Tux Paint. +⚙ Usuarios avanzados: O documento «Como facer os selos avanzados» describe +detalladamente como facer imaxes PNG que se adaptarán perfectamente cando se +usen como selos en Tux Paint. Texto descritivo do selo - Tux Paint amosará texto descritivo cando se seleccione un selo. Estes - colócanse en ficheiros de texto sinxelo co mesmo nome que PNG ou SVG, pero - cunha extensión de nome de ficheiro «.txt». (p. ex.: a descrición de - «selo.png» almacénase en «selo.txt» no mesmo directorio.) +Tux Paint amosará texto descritivo cando se seleccione un selo. Estes colócanse +en ficheiros de texto sinxelo co mesmo nome que PNG ou SVG, pero cunha +extensión de nome de ficheiro «.txt». (p. ex.: a descrición de «selo.png» +almacénase en «selo.txt» no mesmo directorio.) - A primeira liña do ficheiro de texto usarase como a descrición da imaxe do - selo en inglés dos EUA. Debe estar codificado en UTF-8. +A primeira liña do ficheiro de texto usarase como a descrición da imaxe do selo +en inglés dos EUA. Debe estar codificado en UTF-8. - Compatibilidade da localización +Compatibilidade da localización - Pódense engadir liñas adicionais ao ficheiro de texto para - fornecer traducións da descrición, que se amosarán cando Tux Paint - estea a executarse nun idioma diferente (como o francés ou o - español). + Pódense engadir liñas adicionais ao ficheiro de texto para fornecer + traducións da descrición, que se amosarán cando Tux Paint estea a + executarse nun idioma diferente (como o francés ou o español). - O comezo da liña debería corresponder ao código de idioma do - idioma en cuestión (por exemplo, «fr» para o francés e «zh_TW» - para o chinés tradicional), seguido de «.utf8=» e a descrición - traducida (Unicode, codificado en UTF-8). + O comezo da liña debería corresponder ao código de idioma do idioma en + cuestión (por exemplo, «fr» para o francés e «zh_TW» para o chinés + tradicional), seguido de «.utf8=» e a descrición traducida (Unicode, + codificado en UTF-8). - Para os desenvolvedores de Tux Paint: Hai scripts no directorio - «po» para converter os ficheiros de texto ao formato PO (e - posterior) para facilitar a tradución a diferentes idiomas. Polo - tanto, nunca debería engadir nin cambiar traducións directamente - nos ficheiros «.txt». + Para os desenvolvedores de Tux Paint: Hai scripts no directorio «po» para + converter os ficheiros de texto ao formato PO (e posterior) para facilitar + a tradución a diferentes idiomas. Polo tanto, nunca debería engadir nin + cambiar traducións directamente nos ficheiros «.txt». + + Se non hai tradución dispoñíbel para o idioma en que se está a executar Tux + Paint, utilízase o texto en inglés dos EUA. + + + +Usuarios de Windows + + Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de + gardalos como texto simple e asegúrese de que teñen unha extensión «.txt» + ao final do nome do ficheiro. - Se non hai tradución dispoñíbel para o idioma en que se está a - executar Tux Paint, utilízase o texto en inglés dos EUA. - Usuarios de Windows - Use NotePad ou WordPad para editar/crear estes ficheiros. - Asegúrese de gardalos como texto simple e asegúrese de que teñen - unha extensión «.txt» ao final do nome do ficheiro. Efectos de son dos selos - Tux Paint pode reproducir un efecto de son cando se selecciona un selo. - Por exemplo, o son dun pato tremendo cando se selecciona un pato ou unha - breve peza musical cando se escolle un instrumento musical. Os ficheiros - poden estar en formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» e reciben - o mesmo nome que a imaxe PNG ou SVG. (p. ex.: o efecto de son de - «selo.svg» é o ficheiro de son «selo.ogg» no mesmo directorio.) +Tux Paint pode reproducir un efecto de son cando se selecciona un selo. Por +exemplo, o son dun pato tremendo cando se selecciona un pato ou unha breve peza +musical cando se escolle un instrumento musical. Os ficheiros poden estar en +formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» e reciben o mesmo nome que a +imaxe PNG ou SVG. (p. ex.: o efecto de son de «selo.svg» é o ficheiro de son +«selo.ogg» no mesmo directorio.) - Compatibilidade da localización +Compatibilidade da localización - Para sons para distintos idiomas (p. ex.: se o son é alguén que di - unha palabra e quere versións traducidas da palabra dita), cree - tamén ficheiros WAV ou OGG coa etiqueta de idioma no nome do - ficheiro, na forma: «selo_IDIOMA.EXT» + Para sons para distintos idiomas (p. ex.: se o son é alguén que di unha + palabra e quere versións traducidas da palabra dita), cree tamén ficheiros + WAV ou OGG coa etiqueta de idioma no nome do ficheiro, na forma: + «selo_IDIOMA.EXT» - The efecto de son that will be played when the stamp corresponding - to the image file "selo.png" is selected, and when Tux Paint is - using the Spanish locale, would be "selo_es.wav". Under the French - locale, it would be "selo_fr.wav". Under the Brazilian Portuguese - locale, "selo_pt_BR.wav". And so on... + The efecto de son that will be played when the stamp corresponding to the + image file "selo.png" is selected, and when Tux Paint is using the Spanish + locale, would be "selo_es.wav". Under the French locale, it would be + "selo_fr.wav". Under the Brazilian Portuguese locale, "selo_pt_BR.wav". And + so on... - Se non se pode cargar efecto de son localizado, Tux Paint tentará - cargar o ficheiro de son «predeterminado». (por exemplo, - «selo.wav») + Se non se pode cargar efecto de son localizado, Tux Paint tentará cargar o + ficheiro de son «predeterminado». (por exemplo, «selo.wav») - 💡 Note: Also consider using descriptive sounds; see 'Son descritivo do - selo', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Son descritivo do selo', +below. Son descritivo do selo - Tux Paint tamén pode reproducir un son descritivo cando se selecciona un - selo. Por exemplo, o son de alguén que di a palabra «pato» cando - selecciona un pato ou o nome dun instrumento musical cando se elixe un. Os - ficheiros poden estar en formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» - e reciben o mesmo nome que a imaxe PNG ou SVG, con «_desc» ao final. (p. - ex.: o son descritivo de «selo.svg» é o ficheiro de son «selo_desc.ogg» no - mesmo directorio.) +Tux Paint tamén pode reproducir un son descritivo cando se selecciona un selo. +Por exemplo, o son de alguén que di a palabra «pato» cando selecciona un pato +ou o nome dun instrumento musical cando se elixe un. Os ficheiros poden estar +en formatos «WAVE (".wav")» ou «OGG Vorbis (".ogg")» e reciben o mesmo nome que +a imaxe PNG ou SVG, con «_desc» ao final. (p. ex.: o son descritivo de +«selo.svg» é o ficheiro de son «selo_desc.ogg» no mesmo directorio.) - Compatibilidade da localización +Compatibilidade da localización + + Para sons descritivos de diferentes idiomas, cree tamén ficheiros WAV ou + OGG con ambos «_desc» e a etiqueta local no nome do ficheiro, na forma: + «selo_desc_IDIOMA.EXT» + + The son descritivo that will be played when the stamp corresponding to the + image file "selo.png" is selected, and when Tux Paint is using the Spanish + locale, would be "selo_desc_es.wav". Under the French locale, it would be + "selo_desc_fr.wav". Under the Brazilian Portuguese locale, + "selo_desc_pt_BR.wav". And so on... + + Se non se pode cargar son descritivo localizado, Tux Paint tentará cargar o + ficheiro de son «predeterminado». (por exemplo, «selo_desc.wav») - Para sons descritivos de diferentes idiomas, cree tamén ficheiros - WAV ou OGG con ambos «_desc» e a etiqueta local no nome do - ficheiro, na forma: «selo_desc_IDIOMA.EXT» - The son descritivo that will be played when the stamp - corresponding to the image file "selo.png" is selected, and when - Tux Paint is using the Spanish locale, would be - "selo_desc_es.wav". Under the French locale, it would be - "selo_desc_fr.wav". Under the Brazilian Portuguese locale, - "selo_desc_pt_BR.wav". And so on... - Se non se pode cargar son descritivo localizado, Tux Paint tentará - cargar o ficheiro de son «predeterminado». (por exemplo, - «selo_desc.wav») Opcións de selos - Ademais de a graphical shape, a textual description, a sound effect, and a - descriptive sound, a stamps tamén se lle poden dar outros atributos. Para - facelo, cómpre crear un «ficheiro de datos» para stamp. +Ademais de a graphical shape, a textual description, a sound effect, and a +descriptive sound, a stamps tamén se lle poden dar outros atributos. Para +facelo, cómpre crear un «ficheiro de datos» para stamp. - Un ficheiro de datos de stamp's é simplemente un ficheiro de texto ASCII - simple que contén as opcións de stamp. +Un ficheiro de datos de stamp's é simplemente un ficheiro de texto ASCII simple +que contén as opcións de stamp. - O ficheiro ten o mesmo nome que a imaxe PNG or SVG, pero unha extensión - «.dat». (p. ex.: o ficheiro de datos de «selo.png» é o ficheiro de texto - «selo.dat», que se atopa no mesmo directorio.) +O ficheiro ten o mesmo nome que a imaxe PNG or SVG, pero unha extensión «.dat». +(p. ex.: o ficheiro de datos de «selo.png» é o ficheiro de texto «selo.dat», +que se atopa no mesmo directorio.) - Selos de cores +Selos de cores - Os selos pódense facer «colorábeis» ou «tinguíbeis». + Os selos pódense facer «colorábeis» ou «tinguíbeis». - Colorábel + Colorábel - Os selos «colorábeis» funcionan como os pinceis: - escolla o selo para obter a forma e logo escolla a - cor que quere que sexa. (Os selos de símbolos, como - os matemáticos e os musicais, son un exemplo). + Os selos «colorábeis» funcionan como os pinceis: escolla o selo para + obter a forma e logo escolla a cor que quere que sexa. (Os selos de + símbolos, como os matemáticos e os musicais, son un exemplo). - Non se usa nada sobre a imaxe orixinal agás a - transparencia (da canle «alfa»). A cor do selo sae - sólida. + Non se usa nada sobre a imaxe orixinal agás a transparencia (da canle + «alfa»). A cor do selo sae sólida. - Engada unha liña que conteña a palabra «colorable» ao - ficheiro de datos destamp's. + Engada unha liña que conteña a palabra «colorable» ao ficheiro de datos + destamp's. - Tinguido - Os selos «tinguidos» son semellantes aos - «colorábeis», agás que se conservan os detalles da - imaxe orixinal. (Para dicilo tecnicamente, úsase a - imaxe orixinal, pero a súa tonalidade cambia, en - función da cor seleccionada actualmente). - Engada unha liña que conteña a palabra «tintable» ao - ficheiro de datos destamp's. + Tinguido - Opcións de tintura: + Os selos «tinguidos» son semellantes aos «colorábeis», agás que se + conservan os detalles da imaxe orixinal. (Para dicilo tecnicamente, + úsase a imaxe orixinal, pero a súa tonalidade cambia, en función da cor + seleccionada actualmente). - Dependendo do contido do seu selo, é posíbel que - queira que Tux Paint use un dos varios métodos para - tinguilo. Engada unha das seguintes liñas ao ficheiro - de datos do selo: + Engada unha liña que conteña a palabra «tintable» ao ficheiro de datos + destamp's. - Tinguido normal — "tinter=normal" (o - predeterminado) - This is the normal tinting mode. First, - the primary hue of the stamp is - determined. (For example, a picture of a - flower with a stem will have the petal - color seen as the primary hue of the - overall image.) Next, the most highly - saturated part of the picture is found. - With "normal tinter", the range of hue - used to do this starts out within ±18° - of the pimary hue found in step 1. (If - none can be found, it widens the range - by 50% and tries again.) Finally, the - image is tinted. Anything falling within - 50% of the range (e.g., ±27°) is altered - to have the hue of the color chosen by - the user. - Tinguido estreito — "tinter=narrow" - This like the "normal" option described - above, but starts a narrower hue range - of ±6°. Anything found within 50% of the - range (e.g. ±9°) is tinted. If too much - of your stamp is being tinted, try this - option. - Tinguir de «calquera tonalidade» — - "tinter=anyhue" - This remaps all hues in the stamp. It - works similarly to the "anyhue" and - "narrow" options described above, but - the hue range is ±180°. + Opcións de tintura: - Tinguido vectorial — "tinter=vector" - Isto asigna de «negro a través branco» a - «negro a través do destino». + Dependendo do contido do seu selo, é posíbel que queira que Tux Paint + use un dos varios métodos para tinguilo. Engada unha das seguintes + liñas ao ficheiro de datos do selo: - Selos inalterábeis + Tinguido normal — "tinter=normal" (o predeterminado) + This is the normal tinting mode. First, the primary hue of the + stamp is determined. (For example, a picture of a flower with a + stem will have the petal color seen as the primary hue of the + overall image.) Next, the most highly saturated part of the picture + is found. With "normal tinter", the range of hue used to do this + starts out within ±18° of the pimary hue found in step 1. (If none + can be found, it widens the range by 50% and tries again.) Finally, + the image is tinted. Anything falling within 50% of the range + (e.g., ±27°) is altered to have the hue of the color chosen by the + user. - De xeito predeterminado, un selo pode inverter (poñer do revés), - amosarse como unha imaxe reflectida ou ámbalas dúas cousas. Isto - faise usando os botóns de control situados baixo o selector de - selos, na parte inferior dereita da pantalla en Tux Paint. + Tinguido estreito — "tinter=narrow" + This like the "normal" option described above, but starts a + narrower hue range of ±6°. Anything found within 50% of the range + (e.g. ±9°) is tinted. If too much of your stamp is being tinted, + try this option. - Ás veces, non ten sentido que un selo poida ser invertido ou - reflectido; por exemplo, selos de letras ou números. Ás veces, os - selos son simétricos, polo que non é útil deixar que os usuarios - os invertan ou reflictan. + Tinguir de «calquera tonalidade» — "tinter=anyhue" + This remaps all hues in the stamp. It works similarly to the + "anyhue" and "narrow" options described above, but the hue range is + ±180°. - Para evitar que un selo sexa from being flipped vertically, engada - a opción «noflip» no ficheiro de datos do selo. + Tinguido vectorial — "tinter=vector" + Isto asigna de «negro a través branco» a «negro a través do + destino». - Para evitar que un selo sexa from being mirrored horizontally, - engada a opción «nomirror» no ficheiro de datos do selo. - Tamaño inicial do selo - De xeito predeterminado, Tux Paint asume que o seu selo ten o - tamaño axeitado para ser visto sen escala nun lenzo de 608x472. - Este era o tamaño orixinal do lenzo de Tux Paint, fornecido por - unha pantalla de 640x480. Tux Paint axustará o selo segundo o - tamaño actual do lenzo e, se está activado, os controis do tamaño - do selo do usuario. - Se o seu selo fose demasiado grande ou moi pequeno, pode - especificar un factor de escala. Se o seu selo fose 2,5 veces máis - largo (ou alto) do que debería ser, engada unha das seguintes - opcións, que representan o mesmo axuste, ao ficheiro de datos do - selo. (Pódese incluír un signo igual, «=» após a palabra «scale».) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Usuarios de Windows - Use NotePad ou WordPad para editar/crear estes ficheiros. - Asegúrese de gardalos como texto simple e asegúrese de que teñen - unha extensión «.txt» ao final do nome do ficheiro. +Selos inalterábeis + + De xeito predeterminado, un selo pode inverter (poñer do revés), amosarse + como unha imaxe reflectida ou ámbalas dúas cousas. Isto faise usando os + botóns de control situados baixo o selector de selos, na parte inferior + dereita da pantalla en Tux Paint. + + Ás veces, non ten sentido que un selo poida ser invertido ou reflectido; + por exemplo, selos de letras ou números. Ás veces, os selos son simétricos, + polo que non é útil deixar que os usuarios os invertan ou reflictan. + + Para evitar que un selo sexa from being flipped vertically, engada a opción + «noflip» no ficheiro de datos do selo. + + Para evitar que un selo sexa from being mirrored horizontally, engada a + opción «nomirror» no ficheiro de datos do selo. + + + +Tamaño inicial do selo + + De xeito predeterminado, Tux Paint asume que o seu selo ten o tamaño + axeitado para ser visto sen escala nun lenzo de 608x472. Este era o tamaño + orixinal do lenzo de Tux Paint, fornecido por unha pantalla de 640x480. Tux + Paint axustará o selo segundo o tamaño actual do lenzo e, se está activado, + os controis do tamaño do selo do usuario. + + Se o seu selo fose demasiado grande ou moi pequeno, pode especificar un + factor de escala. Se o seu selo fose 2,5 veces máis largo (ou alto) do que + debería ser, engada unha das seguintes opcións, que representan o mesmo + axuste, ao ficheiro de datos do selo. (Pódese incluír un signo igual, «=» + após a palabra «scale».) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Usuarios de Windows + + Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de + gardalos como texto simple e asegúrese de que teñen unha extensión «.txt» + ao final do nome do ficheiro. + + + Selos prereflectidos e invertidos - Nalgúns casos, pode que queira fornecer unha versión deseñada previamente - da imaxe reflectida, da imaxe invertida ou incluso de ámbalas dúas. Por - exemplo, imaxine unha foto dun camión de bombeiros coa palabra «Bombeiros» - escritas á beira. Probabelmente non quererá que o texto apareza cara atrás - cando se reflicte a imaxe. +Nalgúns casos, pode que queira fornecer unha versión deseñada previamente da +imaxe reflectida, da imaxe invertida ou incluso de ámbalas dúas. Por exemplo, +imaxine unha foto dun camión de bombeiros coa palabra «Bombeiros» escritas á +beira. Probabelmente non quererá que o texto apareza cara atrás cando se +reflicte a imaxe. - Para crear unha versión reflectida dun selo que quere que use Tux Paint, - no canto de reflectila vostede mesmo, simplemente cree un segundo ficheiro - gráfico «.png» ou «.svg» co mesmo nome, agás con con «_mirror» antes da - extensión do nome do ficheiro. +Para crear unha versión reflectida dun selo que quere que use Tux Paint, no +canto de reflectila vostede mesmo, simplemente cree un segundo ficheiro gráfico +«.png» ou «.svg» co mesmo nome, agás con con «_mirror» antes da extensión do +nome do ficheiro. - Por exemplo, para o selo «selo.png» crearíase outro ficheiro chamado - «selo_mirror.png», que se usará cando o selo se reflicta (no canto de usar - unha versión ao revés de «selo.png». +Por exemplo, para o selo «selo.png» crearíase outro ficheiro chamado +«selo_mirror.png», que se usará cando o selo se reflicta (no canto de usar unha +versión ao revés de «selo.png». - A partir de Tux Paint 0.9.18, de xeito similar pode fornecer unha imaxe - previamente invertida con «_flip» no nome e/ou unha imaxe que se reflicta - e inverta, denominándoa «_mirror_flip». +A partir de Tux Paint 0.9.18, de xeito similar pode fornecer unha imaxe +previamente invertida con «_flip» no nome e/ou unha imaxe que se reflicta e +inverta, denominándoa «_mirror_flip». - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - Tipos de letra +Tipos de letra - Os tipos de letra empregados por Tux Paint son TrueType Fonts (TTF). +Os tipos de letra empregados por Tux Paint son TrueType Fonts (TTF). - Simplemente colóqueas no directorio «fonts». Tux Paint cargará o tipo de - letra e fornecerá catro tamaños diferentes no selector de «Letras» cando - empregue as ferramentas «Texto» e «Etiqueta». +Simplemente colóqueas no directorio «fonts». Tux Paint cargará o tipo de letra +e fornecerá catro tamaños diferentes no selector de «Letras» cando empregue as +ferramentas «Texto» e «Etiqueta». - «Imaxes de comezo» +«Imaxes de comezo» - As imaxes « de inicio» aparecen no diálogo «Novo», xunto con opcións de - fondo de cor sólida. +As imaxes « de inicio» aparecen no diálogo «Novo», xunto con opcións de fondo +de cor sólida. - Cando usa unha imaxe «de inicio», fai modificacións e a garda, a imaxe «de - inicio» orixinal non se sobreescribe. Ademais, ao editar a súa nova imaxe, - o contido da imaxe «de inicio» orixinal pode afectala. +Cando usa unha imaxe «de inicio», fai modificacións e a garda, a imaxe «de +inicio» orixinal non se sobreescribe. Ademais, ao editar a súa nova imaxe, o +contido da imaxe «de inicio» orixinal pode afectala. Imaxes «de comezo» ao estilo dun libro para colorar - O tipo máis básico de imaxe «de inicio» é semellante a unha imaxe dun - libro para colorar. É un esquema dunha forma que logo pode colorar e - engadir detalles. En Tux Paint, mentre debuxa, escribe texto ou estampa - selos, o contorno segue «por riba» do que debuxa. Pode borrar as partes do - debuxo que fixo, mais non pode borrar o contorno. +O tipo máis básico de imaxe «de inicio» é semellante a unha imaxe dun libro +para colorar. É un esquema dunha forma que logo pode colorar e engadir +detalles. En Tux Paint, mentre debuxa, escribe texto ou estampa selos, o +contorno segue «por riba» do que debuxa. Pode borrar as partes do debuxo que +fixo, mais non pode borrar o contorno. - Para crear este tipo de imaxe «de inicio», simplemente cree unha imaxe en - branco e negro nun programa de pintura e gárdea como ficheiro PNG - rasterizado ou SVG vectorial. Se o garda como PNG, opcionalmente pode - renderizar a imaxe en negro e transparente no canto de en branco e negro, - mais (a partir do Tux Paint 0.9.21) isto non é necesario. +Para crear este tipo de imaxe «de inicio», simplemente cree unha imaxe en +branco e negro nun programa de pintura e gárdea como ficheiro PNG rasterizado +ou SVG vectorial. Se o garda como PNG, opcionalmente pode renderizar a imaxe en +negro e transparente no canto de en branco e negro, mais (a partir do Tux Paint +0.9.21) isto non é necesario. Imaxes «de comezo» ao estilo dunha escena - Xunto coa superposición de estilo «libro para colorar», tamén pode - fornecer unha imaxe de fondo separada como parte dunha imaxe «de inicio». - A superposición actúa igual: non pode ser debuxada, borrada nin afectada - polas ferramentas de «Maxia». Porén, o fondo pode si o pode ser ser. +Xunto coa superposición de estilo «libro para colorar», tamén pode fornecer +unha imaxe de fondo separada como parte dunha imaxe «de inicio». A +superposición actúa igual: non pode ser debuxada, borrada nin afectada polas +ferramentas de «Maxia». Porén, o fondo pode si o pode ser ser. - Cando a ferramenta «Goma» se usa nunha imaxe baseada neste tipo de imaxe - «de comezo», no canto de converter o lenzo a unha cor sólida, como o - branco, devolve esa parte do lenzo á imaxe de fondo orixinal dende o imaxe - «de comezo». +Cando a ferramenta «Goma» se usa nunha imaxe baseada neste tipo de imaxe «de +comezo», no canto de converter o lenzo a unha cor sólida, como o branco, +devolve esa parte do lenzo á imaxe de fondo orixinal dende o imaxe «de comezo». - Ao crear unha superposición e un fondo, pode crear unha imaxe «de inicio» - que simule a profundidade. Imaxine un fondo que amosa o océano e unha capa - que representa a imaxe dun arrecife. Após pode debuxar (ou estampar) - peixes na imaxe. Aparecerán no océano, pero nunca «diante» do arrecife. +Ao crear unha superposición e un fondo, pode crear unha imaxe «de inicio» que +simule a profundidade. Imaxine un fondo que amosa o océano e unha capa que +representa a imaxe dun arrecife. Após pode debuxar (ou estampar) peixes na +imaxe. Aparecerán no océano, pero nunca «diante» do arrecife. - Para crear este tipo de imaxe «de inicio», simplemente cree unha - superposición (con transparencia) e gárdea como PNG. A continuación, cree - outra imaxe (sen transparencia) e gárdea co mesmo nome de ficheiro, pero - con «-back» (abreviatura de «fondo») engadido ao nome. (p. ex.: - «imaxe-de-comezo-back.png» sería a imaxe de fondo do océano que - corresponde á superposición ou primeiro plano.) +Para crear este tipo de imaxe «de inicio», simplemente cree unha superposición +(con transparencia) e gárdea como PNG. A continuación, cree outra imaxe (sen +transparencia) e gárdea co mesmo nome de ficheiro, pero con «-back» +(abreviatura de «fondo») engadido ao nome. (p. ex.: «imaxe-de-comezo-back.png» +sería a imaxe de fondo do océano que corresponde á superposición ou primeiro +plano.) - Para obter os mellores resultados, imaxes «de comezo» debería ter polo - menos o mesmo tamaño que o lenzo de debuxo de Tux Paint. (Vexa a sección - «Cargar outras imaxes en Tux Paint» da documentación principal de Tux - Paint (README – LÉAME) para os detalles sobre o tamaño.) Se non o son, - estiraranse ou escalaranse. Isto faise sen afectar a forma («relación de - aspecto»); con todo pódense aplicar algunhas manchas nos bordos. +Para obter os mellores resultados, imaxes «de comezo» debería ter polo menos o +mesmo tamaño que o lenzo de debuxo de Tux Paint. (Vexa a sección «Cargar outras +imaxes en Tux Paint» da documentación principal de Tux Paint (README – LÉAME) +para os detalles sobre o tamaño.) Se non o son, estiraranse ou escalaranse. +Isto faise sen afectar a forma («relación de aspecto»); con todo pódense +aplicar algunhas manchas nos bordos. - Colóqueas no directorio de «starters». Cando se accede ao diálogo «Novo» - en Tux Paint, as imaxes «de comezo» veranse na pantalla que aparece, após - as distintas opcións de cor sólida. +Colóqueas no directorio de «starters». Cando se accede ao diálogo «Novo» en Tux +Paint, as imaxes «de comezo» veranse na pantalla que aparece, após as distintas +opcións de cor sólida. - 💡 Note: «Imaxes de comezo» are 'attached' to saved pictures, via a small - text file that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a imaxe «de comezo», it - will always be affected by it.) +💡 Note: «Imaxes de comezo» are 'attached' to saved pictures, via a small text +file that has the same name as the saved file, but with ".dat" as the +extension. This allows it to continue to affect the drawing even after Tux +Paint has been quit, or another picture is loaded or a new image is created. +(In other words, if you base a drawing on a imaxe «de comezo», it will always +be affected by it.) Starter Options - Ademais de an image, a starters tamén se lle poden dar outros atributos. - Para facelo, cómpre crear un «ficheiro de datos» para starter. (Note: Tux - Paint prior to version 0.9.29 did not support starter options.) +Ademais de an image, a starters tamén se lle poden dar outros atributos. Para +facelo, cómpre crear un «ficheiro de datos» para starter. (Note: Tux Paint +prior to version 0.9.29 did not support starter options.) - Un ficheiro de datos de starter's é simplemente un ficheiro de texto ASCII - simple que contén as opcións de starter. +Un ficheiro de datos de starter's é simplemente un ficheiro de texto ASCII +simple que contén as opcións de starter. - O ficheiro ten o mesmo nome que a imaxe , pero unha extensión «.dat». (p. - ex.: o ficheiro de datos de «starter.png» é o ficheiro de texto - «starter.dat», que se atopa no mesmo directorio.) +O ficheiro ten o mesmo nome que a imaxe , pero unha extensión «.dat». (p. ex.: +o ficheiro de datos de «starter.png» é o ficheiro de texto «starter.dat», que +se atopa no mesmo directorio.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - As cores pódense enumerar usando tres números decimais (por - exemplo, «255 68 136») ou un «triplete» hexadecimal de 6 ou 3 - díxitos de longo (por exemplo, «#ff4488» ou «#F48»). +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + As cores pódense enumerar usando tres números decimais (por exemplo, «255 + 68 136») ou un «triplete» hexadecimal de 6 ou 3 díxitos de longo (por + exemplo, «#ff4488» ou «#F48»). - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - «Modelos» + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - As imaxes «modelo» tamén aparecen no diálogo «Novo», xunto coas opcións de - fondo de cor sólida e «imaxes de comezo». (Nota: Tux Paint antes da - versión 0.9.22 non tiña a función «Modelo»). + Focusing on the top of a starter image stretched to fit the width of the + canvas. - A diferenza das imaxes debuxadas en Tux Paint polos usuarios e abertas - despois, a apertura dun «modelo» crea un novo debuxo. Cando garda, a imaxe - «modelo» non se sobreescribe. A diferenza das «imaxes de comezo», non hai - unha «capa» inmutábel por riba do lenzo. Pode debuxar sobre calquera parte - del. - Cando a ferramenta «Goma» se usa nunha imaxe baseada neste tipo de imaxe - «modelo», no canto de converter o lenzo a unha cor sólida, como o branco, - devolve esa parte do lenzo á imaxe de fondo orixinal dende o imaxe - «modelo». + [ Landscape-shaped image of the ground with the sun at the top. ] - Os «modelos» son simplemente ficheiros de imaxe (en formato PNG, JPEG, SVG - ou KPX (KidPix)). Non debe ser necesaria ningunha preparación nin - conversión. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - Para obter os mellores resultados, imaxes «modelo» debería ter polo menos - o mesmo tamaño que o lenzo de debuxo de Tux Paint. (Vexa a sección «Cargar - outras imaxes en Tux Paint» da documentación principal de Tux Paint - (README – LÉAME) para os detalles sobre o tamaño.) Se non o son, - estiraranse ou escalaranse. Isto faise sen afectar a forma («relación de - aspecto»); con todo pódense aplicar algunhas manchas nos bordos. - Colóqueas no directorio de «templates». Cando se accede ao diálogo «Novo» - en Tux Paint, as imaxes «modelo» veranse na pantalla que aparece, após as - distintas opcións de cor sólida. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +«Modelos» + +As imaxes «modelo» tamén aparecen no diálogo «Novo», xunto coas opcións de +fondo de cor sólida e «imaxes de comezo». (Nota: Tux Paint antes da versión +0.9.22 non tiña a función «Modelo»). + +A diferenza das imaxes debuxadas en Tux Paint polos usuarios e abertas despois, +a apertura dun «modelo» crea un novo debuxo. Cando garda, a imaxe «modelo» non +se sobreescribe. A diferenza das «imaxes de comezo», non hai unha «capa» +inmutábel por riba do lenzo. Pode debuxar sobre calquera parte del. + +Cando a ferramenta «Goma» se usa nunha imaxe baseada neste tipo de imaxe +«modelo», no canto de converter o lenzo a unha cor sólida, como o branco, +devolve esa parte do lenzo á imaxe de fondo orixinal dende o imaxe «modelo». + +Os «modelos» son simplemente ficheiros de imaxe (en formato PNG, JPEG, SVG ou +KPX (KidPix)). Non debe ser necesaria ningunha preparación nin conversión. + +Para obter os mellores resultados, imaxes «modelo» debería ter polo menos o +mesmo tamaño que o lenzo de debuxo de Tux Paint. (Vexa a sección «Cargar outras +imaxes en Tux Paint» da documentación principal de Tux Paint (README – LÉAME) +para os detalles sobre o tamaño.) Se non o son, estiraranse ou escalaranse. +Isto faise sen afectar a forma («relación de aspecto»); con todo pódense +aplicar algunhas manchas nos bordos. + +Colóqueas no directorio de «templates». Cando se accede ao diálogo «Novo» en +Tux Paint, as imaxes «modelo» veranse na pantalla que aparece, após as +distintas opcións de cor sólida. + +💡 Note: «Modelos» are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a imaxe «modelo», it will always be affected by it.) - 💡 Note: «Modelos» are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a imaxe «modelo», it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Traducións +Traducións - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - Para traducir Tux Paint a un novo idioma, copie o ficheiro de modelo de - tradución, «tuxpaint.pot» (atopado no código fonte de Tux Paint, no - cartafol «src/po/»). Cambie o nome da copia como un ficheiro «.po», cun - nome apropiado para o idioma ao que está a traducir (p. ex.: «es.po» para - o español; ou «pt_BR.po» para o portugués brasileiro fronte a «pt.po» ou - «pt_PT.po» para o portugués falado en Portugal.) +Para traducir Tux Paint a un novo idioma, copie o ficheiro de modelo de +tradución, «tuxpaint.pot» (atopado no código fonte de Tux Paint, no cartafol +«src/po/»). Cambie o nome da copia como un ficheiro «.po», cun nome apropiado +para o idioma ao que está a traducir (p. ex.: «es.po» para o español; ou +«pt_BR.po» para o portugués brasileiro fronte a «pt.po» ou «pt_PT.po» para o +portugués falado en Portugal.) - Abra o ficheiro «.po» creado recentemente: pode editar nun editor de texto - simple, como Emacs, Pico ou VI en Linux ou NotePad en Windows. O texto - orixinal en inglés usado en Tux Paint está coutado en liñas que comezan - por «msgid». Introduza as traducións de cada un destes anacos de texto nas - liñas baleiras «msgstr» directamente baixo as liñas correspondentes - «msgid». (Nota: Non elimine as comiñas.) +Abra o ficheiro «.po» creado recentemente: pode editar nun editor de texto +simple, como Emacs, Pico ou VI en Linux ou NotePad en Windows. O texto orixinal +en inglés usado en Tux Paint está coutado en liñas que comezan por «msgid». +Introduza as traducións de cada un destes anacos de texto nas liñas baleiras +«msgstr» directamente baixo as liñas correspondentes «msgid». (Nota: Non +elimine as comiñas.) - Exemplo: +Exemplo: - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - Existen varias ferramentas para xestionar os catálogos de tradución de - gettext, polo que non ten que editalos a man nun editor de texto. Aquí ten - algúns: - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +Existen varias ferramentas para xestionar os catálogos de tradución de gettext, +polo que non ten que editalos a man nun editor de texto. Aquí ten algúns: - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - Para editar unha tradución existente, descargue o último ficheiro «.po» - para ese idioma e edíteo como se describe anteriormente. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - Pode enviar ficheiros de tradución novos ou editados a Bill Kendrick, - responsábel do desenvolvemento de Tux Paint, a: bill@newbreedsoftware.com, - ou publicalos na lista de correo «tuxpaint-i18n» (vexa: - https://tuxpaint.org/lists/). +Para editar unha tradución existente, descargue o último ficheiro «.po» para +ese idioma e edíteo como se describe anteriormente. - Como alternativa, se te unha conta con SourceForge.net, pode solicitar que - o engadan ao proxecto «tuxpaint» e recibir acceso de escritura ao - repositorio de código fonte de Git para que poida enviar os seus cambios - directamente. +Pode enviar ficheiros de tradución novos ou editados a Bill Kendrick, +responsábel do desenvolvemento de Tux Paint, a: bill@newbreedsoftware.com, ou +publicalos na lista de correo «tuxpaint-i18n» (vexa: https://tuxpaint.org/lists +/). - 💡 Note: Support for new configuracións locais requires making additions to - Tux Paint's source code («/src/i18n.h» e «/src/i18n.c»), and requires - updates to the Makefile, para asegurarse de que os ficheiros «.po» están - compilados en ficheiros «.mo» e están dispoñíbeis para o seu uso en tempo - de execución. +Como alternativa, se te unha conta con SourceForge.net, pode solicitar que o +engadan ao proxecto «tuxpaint» e recibir acceso de escritura ao repositorio de +código fonte de Git para que poida enviar os seus cambios directamente. - Métodos de entrada alternativos +💡 Note: Support for new configuracións locais requires making additions to Tux +Paint's source code («/src/i18n.h» e «/src/i18n.c»), and requires updates to +the Makefile, para asegurarse de que os ficheiros «.po» están compilados en +ficheiros «.mo» e están dispoñíbeis para o seu uso en tempo de execución. - As ferramentas «Texto» e «Etiqueta» de Tux Paint poden fornecer métodos - alternativos de entrada para algúns idiomas. Por exemplo, cando Tux Paint - está a executarse co idioma xaponés, pódese premer a tecla [Alt] da - dereita para alternar entre os modos latino, hiragana romanizado e - Katakana romanizado. Isto permite introducir palabras e caracteres nativos - nas ferramentas «Texto» e «Etiqueta» escribindo unha ou máis teclas dun - teclado con caracteres latinos (por exemplo, un teclado US QWERTY). +Métodos de entrada alternativos - Para crear un método de entrada para un idioma novo, cree un ficheiro de - texto cun nome baseado no idioma (por exemplo, «ja» para xaponés), con - «.im» como extensión (por exemplo, «ja.im»). +As ferramentas «Texto» e «Etiqueta» de Tux Paint poden fornecer métodos +alternativos de entrada para algúns idiomas. Por exemplo, cando Tux Paint está +a executarse co idioma xaponés, pódese premer a tecla [Alt] da dereita para +alternar entre os modos latino, hiragana romanizado e Katakana romanizado. Isto +permite introducir palabras e caracteres nativos nas ferramentas «Texto» e +«Etiqueta» escribindo unha ou máis teclas dun teclado con caracteres latinos +(por exemplo, un teclado US QWERTY). - O ficheiro «.im» pode ter varias seccións de asignación de caracteres para - diferentes modos de asignación de caracteres. Por exemplo, nun sistema de - escritura de xaponés, escribir [K] [A] no modo Hiragana xera un carácter - Unicode diferente ("か") que escribir [K] [A] no modo Katakana ("カ"). +Para crear un método de entrada para un idioma novo, cree un ficheiro de texto +cun nome baseado no idioma (por exemplo, «ja» para xaponés), con «.im» como +extensión (por exemplo, «ja.im»). - Enumere as asignacións de caracteres neste ficheiro, unha por liña. Cada - liña debe conter (separada por espazos en branco): +O ficheiro «.im» pode ter varias seccións de asignación de caracteres para +diferentes modos de asignación de caracteres. Por exemplo, nun sistema de +escritura de xaponés, escribir [K] [A] no modo Hiragana xera un carácter +Unicode diferente ("か") que escribir [K] [A] no modo Katakana ("カ"). - * o valor Unicode do carácter, en hexadecimal (pode enumerar máis dun - carácter, separados por dous puntos («:»), permitindo que algunhas - secuencias se asignen a palabras) - * a secuencia de código de teclas (os caracteres ASCII que se deben - introducir para xerar o carácter Unicode) - * un sinalador (ou «-» se non hai ningún) +Enumere as asignacións de caracteres neste ficheiro, unha por liña. Cada liña +debe conter (separada por espazos en branco): - Inicie seccións adicionais de asignación de caracteres cunha liña que - conteña a palabra «section». + * o valor Unicode do carácter, en hexadecimal (pode enumerar máis dun + carácter, separados por dous puntos («:»), permitindo que algunhas + secuencias se asignen a palabras) + * a secuencia de código de teclas (os caracteres ASCII que se deben + introducir para xerar o carácter Unicode) + * un sinalador (ou «-» se non hai ningún) - Exemplo: +Inicie seccións adicionais de asignación de caracteres cunha liña que conteña a +palabra «section». - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +Exemplo: - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new input methods requires making additions to Tux - Paint's source code ("/src/im.c"), and requires updates to the Makefile, - para asegurarse de que os ficheiros «.im» están dispoñíbeis para o seu uso - en tempo de execución. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - Teclado en pantalla +💡 Note: Support for new input methods requires making additions to Tux Paint's +source code ("/src/im.c"), and requires updates to the Makefile, para +asegurarse de que os ficheiros «.im» están dispoñíbeis para o seu uso en tempo +de execución. - A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux - Paint poden presentar un teclado en pantalla que permite utilizar o - punteiro (mediante un rato, sistemas de seguimento de ollos, etc.) para - introducir caracteres. Os ficheiros que describen o deseño e as claves - dispoñíbeis almacénanse no directorio «osk» de Tux Paint. Cada deseño de - teclado está definido por varios ficheiros (algúns dos cales poden ser - compartidos por diferentes deseños). +Teclado en pantalla - Usaremos o teclado QWERTY como exemplo: +A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux Paint +poden presentar un teclado en pantalla que permite utilizar o punteiro +(mediante un rato, sistemas de seguimento de ollos, etc.) para introducir +caracteres. Os ficheiros que describen o deseño e as claves dispoñíbeis +almacénanse no directorio «osk» de Tux Paint. Cada deseño de teclado está +definido por varios ficheiros (algúns dos cales poden ser compartidos por +diferentes deseños). + +Usaremos o teclado QWERTY como exemplo: Ficheiro de visión xeral da disposición («qwerty.layout») - Este é un ficheiro de texto que especifica os outros ficheiros empregados - para describir a disposición e as asignacións de teclas. +Este é un ficheiro de texto que especifica os outros ficheiros empregados para +describir a disposición e as asignacións de teclas. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - A liña «keyboardlist» describe a que esquemas cambiar, cando o usuario - preme nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.) +A liña «keyboardlist» describe a que esquemas cambiar, cando o usuario preme +nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.) Ficheiro de disposición do teclado («qwerty.h_layout») - Isto describe o tamaño do teclado (como unha reixa de «largo × alto») e - lista cada tecla co seu código numérico (ver o ficheiro «keymap», máis - abaixo), o largo no que debería debuxarse ​​(normalmente «1.0», para - ocupar un espazo no teclado, pero no seguinte exemplo, teña en conta que - as teclas «TAB» e «SPACE» son moito máis largas), o carácter ou o texto - que se amosará na tecla, dependendo das teclas modificadoras premido (unha - para cada unha: sen modificadores,[Maiúsculas],[AltGr] e [Maiúsculas] + - [AltGr]) e, finalmente, se a tecla está afectada ou non pola tecla - [BloqMaiús] (use «1») ou a tecla [AltGr] (gráficos alternativos) ( use - «2»), ou non (use «0»). +Isto describe o tamaño do teclado (como unha reixa de «largo × alto») e lista +cada tecla co seu código numérico (ver o ficheiro «keymap», máis abaixo), o +largo no que debería debuxarse ​​(normalmente «1.0», para ocupar un espazo no +teclado, pero no seguinte exemplo, teña en conta que as teclas «TAB» e «SPACE» +son moito máis largas), o carácter ou o texto que se amosará na tecla, +dependendo das teclas modificadoras premido (unha para cada unha: sen +modificadores,[Maiúsculas],[AltGr] e [Maiúsculas] + [AltGr]) e, finalmente, se +a tecla está afectada ou non pola tecla [BloqMaiús] (use «1») ou a tecla +[AltGr] (gráficos alternativos) ( use «2»), ou non (use «0»). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # A frecha cara á esquerda cambiará ao teclado anterior - KEY 2 1.0 <- <- <- <- 0 + # A frecha cara á esquerda cambiará ao teclado anterior + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # As teclas ALT ou ALTGR úsanse no método de entrada (im) para cambiar o - modo de entrada - KEY 64 2.0 Alt Alt Alt Alt 0 + # As teclas ALT ou ALTGR úsanse no método de entrada (im) para cambiar o + modo de entrada + KEY 64 2.0 Alt Alt Alt Alt 0 - # Espazo - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Espazo + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # A frecha cara á dereita cambiará ao seguinte teclado - KEY 1 1.0 -> -> -> -> 0 + # A frecha cara á dereita cambiará ao seguinte teclado + KEY 1 1.0 -> -> -> -> 0 - Teña en conta aquí que as teclas alfabéticas ([Q],[W], etc.) serán - afectadas por [BloqMaiús], mentres as teclas numéricas ([1], [2], etc.), - [Espazo], etc., non o farán. +Teña en conta aquí que as teclas alfabéticas ([Q],[W], etc.) serán afectadas +por [BloqMaiús], mentres as teclas numéricas ([1], [2], etc.), [Espazo], etc., +non o farán. - Os códigos de tecla ata «8» están reservados para uso interno. Os que se - usan actualmente descríbense a continuación. +Os códigos de tecla ata «8» están reservados para uso interno. Os que se usan +actualmente descríbense a continuación. - * 0 — botón baleiro - * 1 — seguinte disposición (segundo o axuste «keyboardlist» do ficheiro - de disposición) - * 2 — disposición anterior (segundo o axuste «keyboardlist» do ficheiro - de disposición) + * 0 — botón baleiro + * 1 — seguinte disposición (segundo o axuste «keyboardlist» do ficheiro de + disposición) + * 2 — disposición anterior (segundo o axuste «keyboardlist» do ficheiro de + disposición) Ficheiro do mapa do teclado («us-intl-altgr-dead-keys.keymap») - Este ficheiro define que códigos das teclas numéricas (vistos nos - ficheiros de disposición de teclado, como «qwerty.h_layout» descrito - anteriormente) deben asignarse a que caracteres reais que unha aplicación - como Tux Paint agarda recibir cando se premen as teclas (por exemplo, nun - teclado real). +Este ficheiro define que códigos das teclas numéricas (vistos nos ficheiros de +disposición de teclado, como «qwerty.h_layout» descrito anteriormente) deben +asignarse a que caracteres reais que unha aplicación como Tux Paint agarda +recibir cando se premen as teclas (por exemplo, nun teclado real). - Se está a usar un sistema operativo como Linux, que executa X-Window e ten - dispoñíbel a ferramenta de liña de ordes «xmodmap», pode executala coa - opción «print keymap expressions», «-pke», para xerar un ficheiro de mapa - de teclas. +Se está a usar un sistema operativo como Linux, que executa X-Window e ten +dispoñíbel a ferramenta de liña de ordes «xmodmap», pode executala coa opción +«print keymap expressions», «-pke», para xerar un ficheiro de mapa de teclas. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Ficheiro do mapa de composición («en_US.UTF-8_Compose») - Este ficheiro describe caracteres individuais que poden ser compostos por - varias entradas. Por exemplo, pódese usar «[Composición]» seguido de «[A]» - e «[E]» para crear o carácter «æ». +Este ficheiro describe caracteres individuais que poden ser compostos por +varias entradas. Por exemplo, pódese usar «[Composición]» seguido de «[A]» e « +[E]» para crear o carácter «æ». - O ficheiro que vén con Tux Paint está baseado no mapa de composición UTF-8 - (Unicode) en inglés dos EUA que vén co Sistema X Window de X.Org. A - versión actual da biblioteca Xlib dispón dunha páxina en - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +O ficheiro que vén con Tux Paint está baseado no mapa de composición UTF-8 +(Unicode) en inglés dos EUA que vén co Sistema X Window de X.Org. A versión +actual da biblioteca Xlib dispón dunha páxina en https://www.x.org/releases/ +current/doc/libX11/i18n/compose/en_US.UTF-8.html. Ficheiro de definición Keysym («keysymdef.h») - Este ficheiro (que é un ficheiro de cabeceira da linguaxe de programación - C) tamén é do Sistema X Window. Define os valores Unicode de cada tecla - (p. ex.: «XK_equal» corresponde a «U+003D», para o carácter «=» («EQUALS - SIGN»). +Este ficheiro (que é un ficheiro de cabeceira da linguaxe de programación C) +tamén é do Sistema X Window. Define os valores Unicode de cada tecla (p. ex.: +«XK_equal» corresponde a «U+003D», para o carácter «=» («EQUALS SIGN»). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - É pouco probábel que se precise algunha modificación neste ficheiro. +É pouco probábel que se precise algunha modificación neste ficheiro. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/gl_ES.UTF-8/FAQ.txt b/docs/gl_ES.UTF-8/FAQ.txt index 9bb9059f2..938aeeefd 100644 --- a/docs/gl_ES.UTF-8/FAQ.txt +++ b/docs/gl_ES.UTF-8/FAQ.txt @@ -1,643 +1,648 @@ Tux Paint - versión 0.9.31 Preguntas máis frecuentes + versión 0.9.31 Preguntas máis frecuentes Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ 13 de Xullo de 2023 - ---------------------------------------------------------------------- - - +--------------------------------------------+ - |Índice | - |--------------------------------------------| - | * Relacionado co debuxo | - | * Problemas de interface | - | * Impresión | - | * Gardar | - | * Problemas de son | - | * Problemas no modo de pantalla completa | - | * Other Problems | - | * Axuda / Contacto | - +--------------------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++--------------------------------------------+ +| Índice | +|--------------------------------------------| +| * Relacionado co debuxo | +| * Problemas de interface | +| * Impresión | +| * Gardar | +| * Problemas de son | +| * Problemas no modo de pantalla completa | +| * Other Problems | +| * Axuda / Contacto | ++--------------------------------------------+ +------------------------------------------------------------------------------- Relacionado co debuxo - Os tipos de letra que engadín a Tux Paint só amosan cadrados - O tipo de letra TrueType que está a usar pode ter unha - codificación incorrecta. Se está codificado «personalizado», por - exemplo, pode tentar executalo a través de FontForge - (http://fontforge.sourceforge.net/) para convertelo a un formato - ISO-8859. (Envíanos un correo electrónico se precisas axuda con - tipos de letra especiais.) +Os tipos de letra que engadín a Tux Paint só amosan cadrados + O tipo de letra TrueType que está a usar pode ter unha codificación + incorrecta. Se está codificado «personalizado», por exemplo, pode tentar + executalo a través de FontForge (http://fontforge.sourceforge.net/) para + convertelo a un formato ISO-8859. (Envíanos un correo electrónico se + precisas axuda con tipos de letra especiais.) - A ferramenta «Selo de caucho» está gris. +A ferramenta «Selo de caucho» está gris. - Isto significa que Tux Paint non atopou ningunha imaxe de selo ou - se lle pediu que non as cargase. + Isto significa que Tux Paint non atopou ningunha imaxe de selo ou se lle + pediu que non as cargase. - Se instalou Tux Paint, pero non instalou a colección opcional - separada de «Selos», saia de Tux Paint e instálea agora. Debe - estar dispoñíbel no mesmo lugar no que obtivo o programa principal - de Tux Paint. (Nota: A partir da versión 0.9.14, Tux Paint inclúe - unha pequena colección de selos de exemplo.) + Se instalou Tux Paint, pero non instalou a colección opcional separada de + «Selos», saia de Tux Paint e instálea agora. Debe estar dispoñíbel no mesmo + lugar no que obtivo o programa principal de Tux Paint. (Nota: A partir da + versión 0.9.14, Tux Paint inclúe unha pequena colección de selos de + exemplo.) - Se non quere instalar a colección predeterminada de selos, pode - crear os seu.s Vexa a documentación «Ampliar Tux Paint» para obter - máis información sobre como crear ficheiros de imaxe PNG e SVG, - ficheiros de descrición de texto TXT, ficheiros de son Ogg Vorbis, - MP3 ou WAV e ficheiros de datos de texto DAT que compoñen os - selos. + Se non quere instalar a colección predeterminada de selos, pode crear os + seu.s Vexa a documentación «Ampliar Tux Paint» para obter máis información + sobre como crear ficheiros de imaxe PNG e SVG, ficheiros de descrición de + texto TXT, ficheiros de son Ogg Vorbis, MP3 ou WAV e ficheiros de datos de + texto DAT que compoñen os selos. - Finalmente, se instalou selos e pensa que deberían cargarse, - comprobe que a opción «nostamps» non está configurada. (Ben sexa - mediante a opción «--nostamps» na liña de ordes de Tux Paint ou - «nostamps=yes» no ficheiro de configuración.) + Finalmente, se instalou selos e pensa que deberían cargarse, comprobe que a + opción «nostamps» non está configurada. (Ben sexa mediante a opción + «--nostamps» na liña de ordes de Tux Paint ou «nostamps=yes» no ficheiro de + configuración.) - Cambie ou elimine a opción «nostamps» ou pode anulala con - «--stamps» na liña de ordes ou con «nostamps=no» ou »stamps=yes» - nun ficheiro de configuración. + Cambie ou elimine a opción «nostamps» ou pode anulala con «--stamps» na + liña de ordes ou con «nostamps=no» ou »stamps=yes» nun ficheiro de + configuración. - Os contornos do selo son sempre rectángulos - Tux Paint foi compilado con contornos de selo de baixa calidade - (pero máis rápidos). - Para cambialo, debe volver compilar Tux Paint dende o código - fonte. Asegúrese de eliminar ou comentar calquera liña que diga: +Os contornos do selo son sempre rectángulos - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint foi compilado con contornos de selo de baixa calidade (pero máis + rápidos). - no ficheiro «tuxpaint.c» no directorio «src». + Para cambialo, debe volver compilar Tux Paint dende o código fonte. + Asegúrese de eliminar ou comentar calquera liña que diga: - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + no ficheiro «tuxpaint.c» no directorio «src». + + + + +------------------------------------------------------------------------------- Problemas de interface - As miniaturas dos selos no selector de selos vense mal +As miniaturas dos selos no selector de selos vense mal - Probabelmente Tux Paint foi compilado co código de miniaturas máis - rápidoase de menor calidade activado. Executa a orde «tuxpaint - --verbose-version» dende unha liña de ordes. Se, entre outras - saídas, ves o texto: «Low Quality Thumbnails enabled», entón é - isto o que está a suceder. + Probabelmente Tux Paint foi compilado co código de miniaturas máis + rápidoase de menor calidade activado. Executa a orde «tuxpaint + --verbose-version» dende unha liña de ordes. Se, entre outras saídas, ves o + texto: «Low Quality Thumbnails enabled», entón é isto o que está a suceder. - Para cambialo, debe volver compilar Tux Paint dende o código - fonte. Asegúrese de eliminar ou comentar calquera liña que diga: + Para cambialo, debe volver compilar Tux Paint dende o código fonte. + Asegúrese de eliminar ou comentar calquera liña que diga: - #define LOW_QUALITY_THUMBNAILS + #define LOW_QUALITY_THUMBNAILS - no ficheiro «tuxpaint.c» no directorio «src». + no ficheiro «tuxpaint.c» no directorio «src». - As imaxes do diálogo «Abrir» vense mal - Probabelmente estea activada a opción «Miniaturas de baixa - calidade». Vexa: «As miniaturas dos selos no selector de selos - vense mal», arriba. - Todo o texto está en maiúscula. - Está activada a opción «maiúsculas». +As imaxes do diálogo «Abrir» vense mal + Probabelmente estea activada a opción «Miniaturas de baixa calidade». Vexa: + «As miniaturas dos selos no selector de selos vense mal», arriba. - Cambie ou elimine a opción «uppercase» ou pode anulala con - «--mixedcase» na liña de ordes ou con «uppercase=no» ou - »mixedcase=yes» nun ficheiro de configuración. +Todo o texto está en maiúscula. - Tux Paint está noutro idioma - Asegúrese de que os seu axuste da configuración local sexa - correcto. Vexa «Tux Paint non cambia ao meu idioma», a - continuación. + Está activada a opción «maiúsculas». - Tux Paint non cambia ao meu idioma - * Usuarios de Linux e Unix: asegúrese de que a configuración - local está dispoñíbel + Cambie ou elimine a opción «uppercase» ou pode anulala con «--mixedcase» na + liña de ordes ou con «uppercase=no» ou »mixedcase=yes» nun ficheiro de + configuración. - Asegúrese de que a configuración local que quere está - dispoñíbel. Comprobe o seu ficheiro «/etc/locale.gen». Vexa a - «Documentación de opcións» para coñecer as configuracións - locais que usa Tux Paint (especialmente cando se usa a opción - «--lang»). +Tux Paint está noutro idioma + Asegúrese de que os seu axuste da configuración local sexa correcto. Vexa + «Tux Paint non cambia ao meu idioma», a continuación. - Nota: os usuarios de Debian e derivados (p. ex.: Ubuntu) - poden simplemente executar «dpkg-reconfigure locales» se se - as configuracións locais son xestionadas por «dpkg». +Tux Paint non cambia ao meu idioma + + Usuarios de Linux e Unix: asegúrese de que a configuración local está + dispoñíbel - * Se está a empregar a opción de liña de ordes «--lang» + Asegúrese de que a configuración local que quere está dispoñíbel. + Comprobe o seu ficheiro «/etc/locale.gen». Vexa a «Documentación de + opcións» para coñecer as configuracións locais que usa Tux Paint + (especialmente cando se usa a opción «--lang»). - Probe a usar a opción de liña de ordes «--locale» ou o axuste - da configuración local do seu sistema operativo (p. ex.: a - variábel de contorno «$LANG») e envíenos un correo-e con - respecto ao seu problema. + Nota: os usuarios de Debian e derivados (p. ex.: Ubuntu) poden + simplemente executar «dpkg-reconfigure locales» se se as configuracións + locais son xestionadas por «dpkg». - * Se está a empregar a opción de liña de ordes «--locale» + + Se está a empregar a opción de liña de ordes «--lang» - Se isto non funciona, envíenos un correo-e con respecto ao - seu problema. + Probe a usar a opción de liña de ordes «--locale» ou o axuste da + configuración local do seu sistema operativo (p. ex.: a variábel de + contorno «$LANG») e envíenos un correo-e con respecto ao seu problema. - * Se está a empregar a configuración local do seu sistema - operativo + + Se está a empregar a opción de liña de ordes «--locale» - Se isto non funciona, envíenos un correo-e con respecto ao - seu problema. + Se isto non funciona, envíenos un correo-e con respecto ao seu + problema. - * Asegúrese de ter o tipo de letra necesario + + Se está a empregar a configuración local do seu sistema operativo - Algunhas traducións requiren o seu propio tipo de letra. O - chinés e o coreano, por exemplo, precisan que os tipos de - letra TrueType chinés e coreano estean instalados e colocados - no lugar adecuado, respectivamente. + Se isto non funciona, envíenos un correo-e con respecto ao seu + problema. - Os tipos de letra axeitados para estas configuracións locais - pódense descargar dende o sitio web de Tux Paint: + + Asegúrese de ter o tipo de letra necesario - https://tuxpaint.org/download/fonts/ + Algunhas traducións requiren o seu propio tipo de letra. O chinés e o + coreano, por exemplo, precisan que os tipos de letra TrueType chinés e + coreano estean instalados e colocados no lugar adecuado, + respectivamente. - ---------------------------------------------------------------------- + Os tipos de letra axeitados para estas configuracións locais pódense + descargar dende o sitio web de Tux Paint: + + https://tuxpaint.org/download/fonts/ + + + + +------------------------------------------------------------------------------- Impresión - Tux Paint non imprime, produce un erro ou imprime lixo (Unix/Linux) +Tux Paint non imprime, produce un erro ou imprime lixo (Unix/Linux) - Tux Paint imprime creando unha representación PostScript da imaxe - e enviándoa a unha orde externa. De xeito predeterminado, esta - orde é a ferramenta de impresión «lpr». + Tux Paint imprime creando unha representación PostScript da imaxe e + enviándoa a unha orde externa. De xeito predeterminado, esta orde é a + ferramenta de impresión «lpr». - Se ese programa non está dispoñíbel (por exemplo, está a usar - CUPS, o Sistema Común de Impresión Unix e non ten instalado - «cups-lpr»), terá que especificar unha orde apropiada usando a - opción «printcommand» no ficheiro de configuración de Tux Paint. - (Vexa a «Documentación de opcións».) + Se ese programa non está dispoñíbel (por exemplo, está a usar CUPS, o + Sistema Común de Impresión Unix e non ten instalado «cups-lpr»), terá que + especificar unha orde apropiada usando a opción «printcommand» no ficheiro + de configuración de Tux Paint. (Vexa a «Documentación de opcións».) - Nota: As versións de Tux Paint anteriores ao 0.9.15 usaban unha - orde predeterminada diferente para imprimir, «pngtopnm | pnmtops | - lpr», como formato PNG de saída de Tux PaintNG, no canto de - PostScript. + Nota: As versións de Tux Paint anteriores ao 0.9.15 usaban unha orde + predeterminada diferente para imprimir, «pngtopnm | pnmtops | lpr», como + formato PNG de saída de Tux PaintNG, no canto de PostScript. - Se xa cambiara a súa opción «printcommand» antes de Tux Paint - 0.9.15, terá que volver atras e modificala para que acepte - PostScript. + Se xa cambiara a súa opción «printcommand» antes de Tux Paint 0.9.15, terá + que volver atras e modificala para que acepte PostScript. - Recibo a mensaxe «Aínda non pode imprimir» cando vou imprimir - A opción «atraso de impresión» está activada. Só pode imprimir - unha vez cada X segundos. - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--printdelay=...». +Recibo a mensaxe «Aínda non pode imprimir» cando vou imprimir - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--printdelay=...» - aparece como un argumento da liña de ordes. + A opción «atraso de impresión» está activada. Só pode imprimir unha vez + cada X segundos. - Se non se está a enviar a opción «--printdelay=...» na liña de - ordes, comprobe o ficheiro de configuración de Tux Paint para ver - se hai unha liña que diga: «printdelay=...». + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--printdelay=...». - Retire esa liña, configure o valor de atraso en 0 (sen atraso) ou - diminúa o atraso a o valor que prefira. (Vexa a «Documentación de - opcións».) + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--printdelay=...» aparece como un + argumento da liña de ordes. - Ou, simplemente pode executar Tux Paint co argumento da liña de - ordes: «--printdelay=0», que anulará o axuste do ficheiro de - configuración e permitirá a impresión ilimitada. (Non terás aue - agardar entre impresións). + Se non se está a enviar a opción «--printdelay=...» na liña de ordes, + comprobe o ficheiro de configuración de Tux Paint para ver se hai unha liña + que diga: «printdelay=...». - Simplemente non podo imprimir. O botón está gris. + Retire esa liña, configure o valor de atraso en 0 (sen atraso) ou diminúa o + atraso a o valor que prefira. (Vexa a «Documentación de opcións».) - A opción «non imprimir» está activada. + Ou, simplemente pode executar Tux Paint co argumento da liña de ordes: + «--printdelay=0», que anulará o axuste do ficheiro de configuración e + permitirá a impresión ilimitada. (Non terás aue agardar entre impresións). - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--noprint». - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--noprint» aparece - como un argumento da liña de ordes. - Se non se está a enviar a opción «--noprint» na liña de ordes, - comprobe o ficheiro de configuración de Tux Paint para ver se hai - unha liña que diga: «noprint=yes». +Simplemente non podo imprimir. O botón está gris. - Retire esa liña ou simplemente execute Tux Paint co argumento da - liña de ordes «--print», que anulará o axuste do ficheiro de - configuración. + A opción «non imprimir» está activada. - Ou use Tux Paint Config. e asegúrese de «Permitir a impresión» - (baixo «Impresión») está marcado. + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--noprint». - ---------------------------------------------------------------------- + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--noprint» aparece como un argumento da + liña de ordes. + + Se non se está a enviar a opción «--noprint» na liña de ordes, comprobe o + ficheiro de configuración de Tux Paint para ver se hai unha liña que diga: + «noprint=yes». + + Retire esa liña ou simplemente execute Tux Paint co argumento da liña de + ordes «--print», que anulará o axuste do ficheiro de configuración. + + Ou use Tux Paint Config. e asegúrese de «Permitir a impresión» (baixo + «Impresión») está marcado. + + + + +------------------------------------------------------------------------------- Gardar - Onde garda Tux Paint os meus debuxos? +Onde garda Tux Paint os meus debuxos? - A non ser que lle solicite a Tux Paint que garde nun lugar - específico (usando a opción «savedir»), Tux Paint garda nun lugar - estándar na súa unidade local: + A non ser que lle solicite a Tux Paint que garde nun lugar específico + (usando a opción «savedir»), Tux Paint garda nun lugar estándar na súa + unidade local: - Windows Vista, Windows 8, Windows 10, Windows 11 - No cartafol «AppData» do usuario: - p. ex.: C:\Users\nome de - usuario\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + No cartafol «AppData» do usuario: + p. ex.: C:\Users\nome de usuario\AppData\Roaming\TuxPaint\saved - macOS - No cartafol «Asistencia de aplicacións» do usuario:: - e.g., /Users/nome de usuario/Library/Applicaton - Support/TuxPaint/saved/ + macOS + No cartafol «Asistencia de aplicacións» do usuario:: + e.g., /Users/nome de usuario/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - No directorio persoal do usuario («$HOME»), baixo un - subcartafol «.tuxpaint»: - e.g., /home/nome de usuario/.tuxpaint/saved/ + Linux / Unix + No directorio persoal do usuario («$HOME»), baixo un subcartafol + «.tuxpaint»: + e.g., /home/nome de usuario/.tuxpaint/saved/ - As imaxes almacénanse como mapas de bits PNG, que a maioría dos - programas modernos deberían poder cargar (editores de imaxes, - procesadores de texto, navegadores web, etc.) - Tux Paint sempre garda sobre a miña imaxe antiga + As imaxes almacénanse como mapas de bits PNG, que a maioría dos programas + modernos deberían poder cargar (editores de imaxes, procesadores de texto, + navegadores web, etc.) - A opción «save over» está activada. (Isto desactiva a pregunta que - aparecería ao premer en «Gardar»). - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--saveover». - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--saveover» aparece - como un argumento da liña de ordes. +Tux Paint sempre garda sobre a miña imaxe antiga - Se non se está a enviar a opción «--saveover» na liña de ordes, - comprobe o ficheiro de configuración de Tux Paint para ver se hai - unha liña que diga: «saveover=yes». + A opción «save over» está activada. (Isto desactiva a pregunta que + aparecería ao premer en «Gardar»). - Retire esa liña ou simplemente execute Tux Paint co argumento da - liña de ordes «--saveoverask», que anulará o axuste do ficheiro de - configuración. + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--saveover». - Ou use Tux Paint Config. e asegúrese de «Preguntar antes de - sobrescribir» (baixo «Gardar») está marcado. + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--saveover» aparece como un argumento da + liña de ordes. - Ademais, vexa «Tux Paint sempre garda unha nova imaxe», a - continuación. + Se non se está a enviar a opción «--saveover» na liña de ordes, comprobe o + ficheiro de configuración de Tux Paint para ver se hai unha liña que diga: + «saveover=yes». - Tux Paint sempre garda unha nova imaxe. + Retire esa liña ou simplemente execute Tux Paint co argumento da liña de + ordes «--saveoverask», que anulará o axuste do ficheiro de configuración. - A opción «never save over» está activada. (Isto desactiva a - pregunta que aparecería ao premer en «Gardar»). + Ou use Tux Paint Config. e asegúrese de «Preguntar antes de sobrescribir» + (baixo «Gardar») está marcado. - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--saveovernew». + Ademais, vexa «Tux Paint sempre garda unha nova imaxe», a continuación. - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--saveovernew» - aparece como un argumento da liña de ordes. - Se non se está a enviar a opción «--saveovernew» na liña de ordes, - comprobe o ficheiro de configuración de Tux Paint para ver se hai - unha liña que diga: «saveover=new». - Retire esa liña ou simplemente execute Tux Paint co argumento da - liña de ordes «--saveoverask», que anulará o axuste do ficheiro de - configuración. +Tux Paint sempre garda unha nova imaxe. - Ou use Tux Paint Config. e asegúrese de «Preguntar antes de - sobrescribir» (baixo «Gardar») está marcado. + A opción «never save over» está activada. (Isto desactiva a pregunta que + aparecería ao premer en «Gardar»). - Also, see "Tux Paint always saves over my old picture!", above. + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--saveovernew». - ---------------------------------------------------------------------- + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--saveovernew» aparece como un argumento + da liña de ordes. + + Se non se está a enviar a opción «--saveovernew» na liña de ordes, comprobe + o ficheiro de configuración de Tux Paint para ver se hai unha liña que + diga: «saveover=new». + + Retire esa liña ou simplemente execute Tux Paint co argumento da liña de + ordes «--saveoverask», que anulará o axuste do ficheiro de configuración. + + Ou use Tux Paint Config. e asegúrese de «Preguntar antes de sobrescribir» + (baixo «Gardar») está marcado. + + Also, see "Tux Paint always saves over my old picture!", above. + + + + +------------------------------------------------------------------------------- Problemas de son - Non hai son. - * Primeiro, comprobe o obvio: - * Están conectados e acendidos os altofalantes? - * Subiu o volume dos altofalantes? - * Subiu o volume no «mesturador» do seu sistema operativo? - * Estás seguro de que está a usar un computador con - tarxeta de son? - * Existe algún outro programa que use son? (É posíbel que - estea «bloqueando» o acceso de Tux Paint ao seu - dispositivo de son) - * (Unix/Linux) Está a usar un sistema de son, como aRts, - ESD ou GStreamer? Se é así, tente axustar a variábel de - contorno «SDL_AUDIODRIVER« antes de executar Tux Paint - (p. ex.: «export SDL_AUDIODRIVER=arts»). Ou execute Tux - Paint a través do redireccionador do sistema (p. ex.: - execute «artsdsp tuxpaint» ou «esddsp tuxpaint», no - canto de simplemente «tuxpaint»). - * Está desactivado o son en Tux Paint? +Non hai son. + + Primeiro, comprobe o obvio: + o Están conectados e acendidos os altofalantes? + o Subiu o volume dos altofalantes? + o Subiu o volume no «mesturador» do seu sistema operativo? + o Estás seguro de que está a usar un computador con tarxeta de son? + o Existe algún outro programa que use son? (É posíbel que estea + «bloqueando» o acceso de Tux Paint ao seu dispositivo de son) + o (Unix/Linux) Está a usar un sistema de son, como aRts, ESD ou + GStreamer? Se é así, tente axustar a variábel de contorno + «SDL_AUDIODRIVER« antes de executar Tux Paint (p. ex.: «export + SDL_AUDIODRIVER=arts»). Ou execute Tux Paint a través do + redireccionador do sistema (p. ex.: execute «artsdsp tuxpaint» ou + «esddsp tuxpaint», no canto de simplemente «tuxpaint»). + + Está desactivado o son en Tux Paint? - Se o son parece funcionar doutro xeito (e está seguro de que - ningún outro programa «bloquea» o dispositivo de son), é - posíbel que Tux Paint estea a executarse coa opción «sen - son». + Se o son parece funcionar doutro xeito (e está seguro de que ningún + outro programa «bloquea» o dispositivo de son), é posíbel que Tux Paint + estea a executarse coa opción «sen son». - Se está a executar Tux Paint dende unha liña de ordes, - asegúrese de que non está a pasarlle a opción «--nosound». + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que + non está a pasarlle a opción «--nosound». - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--nosound» - aparece como un argumento da liña de ordes. + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe + as propiedades da icona para ver se «--nosound» aparece como un + argumento da liña de ordes. - Se non se está a enviar a opción «--nosound» na liña de - ordes, comprobe o ficheiro de configuración de Tux Paint para - ver se hai unha liña que diga: «nosound=yes». + Se non se está a enviar a opción «--nosound» na liña de ordes, comprobe + o ficheiro de configuración de Tux Paint para ver se hai unha liña que + diga: «nosound=yes». - Retire esa liña ou simplemente execute Tux Paint co argumento - da liña de ordes «--sound», que anulará o axuste do ficheiro - de configuración. + Retire esa liña ou simplemente execute Tux Paint co argumento da liña + de ordes «--sound», que anulará o axuste do ficheiro de configuración. - Ou, simplemente pode executar Tux Paint co argumento da liña - de ordes: «Activar os efectos de son», que anulará o axuste - do ficheiro de configuración e permitirá a impresión - ilimitada. (Non terás aue agardar entre impresións). + Ou, simplemente pode executar Tux Paint co argumento da liña de ordes: + «Activar os efectos de son», que anulará o axuste do ficheiro de + configuración e permitirá a impresión ilimitada. (Non terás aue agardar + entre impresións). - * Desactiváronse os sons temporalmente? + + Desactiváronse os sons temporalmente? - Mesmo se os sons están activados en Tux Paint, é posíbel - desactivalos e reactivalos temporalmente usando a secuencia - de teclas [Alt] + [S]. Probe a premer esas teclas para ver se - os sons comezan a funcionar de novo. + Mesmo se os sons están activados en Tux Paint, é posíbel desactivalos e + reactivalos temporalmente usando a secuencia de teclas [Alt] + [S]. + Probe a premer esas teclas para ver se os sons comezan a funcionar de + novo. - * Foi compilado Tux Paint sen compatibilidade con son? + + Foi compilado Tux Paint sen compatibilidade con son? - É posíbel que Tux Paint se compilase coa compatibilidade de - son desactivada. Para comprobar se a compatibilidade de son - estaba activada cando se compilou Tux Paint, execute Tux - Paint dende unha liña de ordes, así: + É posíbel que Tux Paint se compilase coa compatibilidade de son + desactivada. Para comprobar se a compatibilidade de son estaba activada + cando se compilou Tux Paint, execute Tux Paint dende unha liña de + ordes, así: - tuxpaint --verbose-version + tuxpaint --verbose-version - Se, entre outra información, ve «Son desactivado», entón a - versión de Tux Paint que está a executar ten o son - desactivado. Recompile Tux Paint e asegúrese de NON construír - o obxectivo «nosound». (é dicir, non execute «make nosound») - Asegúrese de que a biblioteca SDL_mixer e as súas cabeceiras - de desenvolvemento están dispoñíbeis. + Se, entre outra información, ve «Son desactivado», entón a versión de + Tux Paint que está a executar ten o son desactivado. Recompile Tux + Paint e asegúrese de NON construír o obxectivo «nosound». (é dicir, non + execute «make nosound») Asegúrese de que a biblioteca SDL_mixer e as + súas cabeceiras de desenvolvemento están dispoñíbeis. - Tux Paint fai moito ruído. Podo apagalo? - Si, hai varias formas de desactivar os sons en Tux Paint: - * Prema [Alt] + [S] mentres está en Tux Paint para desactivar - temporalmente os sons. (Prema de novo esa secuencia de teclas - para volver activar os sons.) - * Execute Tux Paint coa opción «sen son»: - * Execute «tuxpaint --nosound» dende a liña de ordes, - dende o atallo ou dende a icona do escritorio. - * Edite o ficheiro de configuración de Tux Paint (consulte - a «Documentación de opcións» para obter máis detalles) e - engada unha liña que conteña «nosound=yes». - * Ou use Tux Paint Config. e asegúrese de «Activar os - efectos de son» (baixo «Vídeo e son») non está marcado. - * Como alternativa, recompile Tux Paint coa - compatibilidade de son desactivada. (Vexa máis arriba e - a documentación «Instalar». +Tux Paint fai moito ruído. Podo apagalo? - A panorámica estéreo dos efectos de son é molesta; os efectos de son poden - ser monofónicos? + Si, hai varias formas de desactivar os sons en Tux Paint: - Execute Tux Paint coa opción «sen estéreo»: + + Prema [Alt] + [S] mentres está en Tux Paint para desactivar + temporalmente os sons. (Prema de novo esa secuencia de teclas para + volver activar os sons.) + + Execute Tux Paint coa opción «sen son»: + o Execute «tuxpaint --nosound» dende a liña de ordes, dende o atallo + ou dende a icona do escritorio. + o Edite o ficheiro de configuración de Tux Paint (consulte a + «Documentación de opcións» para obter máis detalles) e engada unha + liña que conteña «nosound=yes». + o Ou use Tux Paint Config. e asegúrese de «Activar os efectos de son» + (baixo «Vídeo e son») non está marcado. + o Como alternativa, recompile Tux Paint coa compatibilidade de son + desactivada. (Vexa máis arriba e a documentación «Instalar». - * Execute «tuxpaint --nostereo» dende a liña de ordes, dende o - atallo ou dende a icona do escritorio. - * Edite o ficheiro de configuración de Tux Paint (consulte a - «Documentación de opcións» para obter máis detalles) e engada - unha liña que conteña «nostereo=yes». - * Ou use Tux Paint Config. e asegúrese de «Activar os efectos - estéreo» (baixo «Vídeo e son») non está marcado. - Os efectos de son soan estraños +A panorámica estéreo dos efectos de son é molesta; os efectos de son poden ser + monofónicos? - Isto podería ter que ver con como se inicializaron SDL e - SDL_mixer. (O tamaño do búfer escollido.) + Execute Tux Paint coa opción «sen estéreo»: - Envíenos un correo-e con detalles sobre o seu sistema informático. - (Sistema operativo e versión, tarxeta de son, que versión de Tux - Paint está a executar (execute «tuxpaint --version» para - verificar), etc.) + + Execute «tuxpaint --nostereo» dende a liña de ordes, dende o atallo ou + dende a icona do escritorio. + + Edite o ficheiro de configuración de Tux Paint (consulte a + «Documentación de opcións» para obter máis detalles) e engada unha liña + que conteña «nostereo=yes». + + Ou use Tux Paint Config. e asegúrese de «Activar os efectos estéreo» + (baixo «Vídeo e son») non está marcado. - ---------------------------------------------------------------------- + +Os efectos de son soan estraños + + Isto podería ter que ver con como se inicializaron SDL e SDL_mixer. (O + tamaño do búfer escollido.) + + Envíenos un correo-e con detalles sobre o seu sistema informático. (Sistema + operativo e versión, tarxeta de son, que versión de Tux Paint está a + executar (execute «tuxpaint --version» para verificar), etc.) + + + + +------------------------------------------------------------------------------- Problemas no modo de pantalla completa - Cando executo Tux Paint a pantalla completa e [Alt] + [Tab] está fóra, a - xanela vólvese negra. - Aparentemente é un erro na biblioteca SDL. Sentímolo. +Cando executo Tux Paint a pantalla completa e [Alt] + [Tab] está fóra, a xanela + vólvese negra. + Aparentemente é un erro na biblioteca SDL. Sentímolo. - Cando executo Tux Paint a pantalla completa, ten grandes bordos ao redor +Cando executo Tux Paint a pantalla completa, ten grandes bordos ao redor - Usuarios de Linux: o seu servidor X-Window probabelmente non estea - configurado coa capacidade de cambiar á resolución desexada: - 800×600. (ou a resolución que teña configurada para Tux Paint para - que funcione.) (Normalmente faise manualmente no servidor X-Window - premendo [Control] + [Alt] + [Keypad Plus (+)] e [Control] + [Alt] - + [Keypad Minus (-)].) + Usuarios de Linux: o seu servidor X-Window probabelmente non estea + configurado coa capacidade de cambiar á resolución desexada: 800×600. (ou a + resolución que teña configurada para Tux Paint para que funcione.) + (Normalmente faise manualmente no servidor X-Window premendo [Control] + + [Alt] + [Keypad Plus (+)] e [Control] + [Alt] + [Keypad Minus (-)].) - Para que isto funcione, o monitor debe admitir esa resolución e - cómpre que apareza na súa configuración do servidor X. + Para que isto funcione, o monitor debe admitir esa resolución e cómpre que + apareza na súa configuración do servidor X. - Comprobe a subsección «Display» da sección «Screen» do seu - ficheiro de configuración XFree86 ou X.org (normalmente - «/etc/X11/XF86Config-4» ou «/etc/X11/XF86Config», dependendo da - versión de XFree86 que estea a usar; 3.x ou 4.x, respectivamente, - ou «/etc/X11/xorg.conf» para X.org) + Comprobe a subsección «Display» da sección «Screen» do seu ficheiro de + configuración XFree86 ou X.org (normalmente «/etc/X11/XF86Config-4» ou «/ + etc/X11/XF86Config», dependendo da versión de XFree86 que estea a usar; 3.x + ou 4.x, respectivamente, ou «/etc/X11/xorg.conf» para X.org) - Engada «800x600» (ou as resolucións que queira) á liña «Modes» - apropiada. (por exemplo, na subsección «Display» que contén a - profundidade de cor de 24 bits («Depth 24»), que é o que Tux Paint - tenta usar.) + Engada «800x600» (ou as resolucións que queira) á liña «Modes» apropiada. + (por exemplo, na subsección «Display» que contén a profundidade de cor de + 24 bits («Depth 24»), que é o que Tux Paint tenta usar.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Teña en conta que algunhas distribucións de Linux teñen - ferramentas que poden facer estes cambios. Os usuarios de Debian - poden executar a orde «dpkg-reconfigure xserver-xfree86» como - superusuario (root), por exemplo. + Teña en conta que algunhas distribucións de Linux teñen ferramentas que + poden facer estes cambios. Os usuarios de Debian poden executar a orde + «dpkg-reconfigure xserver-xfree86» como superusuario (root), por exemplo. - Tux Paint segue a funcionar en modo de pantalla completa e quéroo na - xanela. - A opción «pantalla completa» está estabelecida. - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--fullscreen». +Tux Paint segue a funcionar en modo de pantalla completa e quéroo na xanela. - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--fullscreen» - aparece como un argumento da liña de ordes. + A opción «pantalla completa» está estabelecida. - Se non se está a enviar a opción «--fullscreen» na liña de ordes, - comprobe o ficheiro de configuración de Tux Paint para ver se hai - unha liña que diga: «fullscreen=yes». + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--fullscreen». - Retire esa liña ou simplemente execute Tux Paint co argumento da - liña de ordes «--windowed», que anulará o axuste do ficheiro de - configuración. + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--fullscreen» aparece como un argumento + da liña de ordes. - Ou use Tux Paint Config. e asegúrese de «Pantalla completa» (baixo - «Vídeo e son») non está marcado. + Se non se está a enviar a opción «--fullscreen» na liña de ordes, comprobe + o ficheiro de configuración de Tux Paint para ver se hai unha liña que + diga: «fullscreen=yes». - ---------------------------------------------------------------------- + Retire esa liña ou simplemente execute Tux Paint co argumento da liña de + ordes «--windowed», que anulará o axuste do ficheiro de configuración. + + Ou use Tux Paint Config. e asegúrese de «Pantalla completa» (baixo «Vídeo e + son») non está marcado. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint non funciona +Tux Paint non funciona - Se Tux Paint se interrómpe coa mensaxe: «You're already running a - copy of Tux Paint!», significa que foi iniciado nos últimos 30 - segundos. (En Unix/Linux, esta mensaxe aparecería nunha consola de - terminal se executase Tux Paint desde unha liña de ordes. En - Windows, esta mensaxe aparecería nun ficheiro chamado «stdout.txt» - no mesmo cartafol onde resideTuxPaint. exe (p. ex.: en «C:\Program - Files\TuxPaint»). + Se Tux Paint se interrómpe coa mensaxe: «You're already running a copy of + Tux Paint!», significa que foi iniciado nos últimos 30 segundos. (En Unix/ + Linux, esta mensaxe aparecería nunha consola de terminal se executase Tux + Paint desde unha liña de ordes. En Windows, esta mensaxe aparecería nun + ficheiro chamado «stdout.txt» no mesmo cartafol onde resideTuxPaint. exe + (p. ex.: en «C:\Program Files\TuxPaint»). - Un ficheiro de bloqueo («~/.tuxpaint/lockfile.dat» en Linux e - Unix, «userdata\lockfile.dat» en Windows) úsase para asegurarse de - que Tux Paint non se executa demasiadas veces á vez (por exemplo, - porque un cativo preme impaciente na súa icona máis dunha vez) . + Un ficheiro de bloqueo («~/.tuxpaint/lockfile.dat» en Linux e Unix, + «userdata\lockfile.dat» en Windows) úsase para asegurarse de que Tux Paint + non se executa demasiadas veces á vez (por exemplo, porque un cativo preme + impaciente na súa icona máis dunha vez) . - Mesmo se o ficheiro de bloqueo existe, contén a «hora» na que se - executou Tux Paint por última vez. Se pasaron máis de 30 segundos, - Tux Paint debería funcionar ben e simplemente actualiza o ficheiro - de bloqueo coa hora actual. + Mesmo se o ficheiro de bloqueo existe, contén a «hora» na que se executou + Tux Paint por última vez. Se pasaron máis de 30 segundos, Tux Paint debería + funcionar ben e simplemente actualiza o ficheiro de bloqueo coa hora + actual. - Se varios usuarios comparten o directorio onde se almacena este - ficheiro (por exemplo, nunha unidade de rede compartida), entón - terá que desactivar esta función. + Se varios usuarios comparten o directorio onde se almacena este ficheiro + (por exemplo, nunha unidade de rede compartida), entón terá que desactivar + esta función. - Para desactivar o ficheiro de bloqueo, engada o argumento - «--nolockfile» á liña de ordes de Tux Paint ou «nolockfile=yes» ao - ficheiro de configuración. + Para desactivar o ficheiro de bloqueo, engada o argumento «--nolockfile» á + liña de ordes de Tux Paint ou «nolockfile=yes» ao ficheiro de + configuración. - Non podo saír de Tux Paint - Está estabelecida a opción «non saír». Isto desactiva o botón - «Saír» na barra de ferramentas de Tux Paint (marcándoo) e impide - que se poida saír de Tux Paint a través da tecla [Escape]. - Se Tux Paint non está en modo de pantalla completa, só ten que - premer no botón de pechar a xanela na barra de título de Tux - Paint. (é dicir, o «ⓧ» que adoita estar na parte superior - dereita.) +Non podo saír de Tux Paint - Se Tux Paint está en modo de pantalla completa, terá que empregar - a secuencia [Maiúsculas] + [Control] + [Escape] no teclado para - saír de Tux Paint. + Está estabelecida a opción «non saír». Isto desactiva o botón «Saír» na + barra de ferramentas de Tux Paint (marcándoo) e impide que se poida saír de + Tux Paint a través da tecla [Escape]. - (Nota: con ou sen «non saír» estabelecido, sempre pode usar a - combinación [Alt] + [F4] no teclado para saír de Tux Paint.) + Se Tux Paint non está en modo de pantalla completa, só ten que premer no + botón de pechar a xanela na barra de título de Tux Paint. (é dicir, o «ⓧ» + que adoita estar na parte superior dereita.) - Non quero que se active o modo «non saír». + Se Tux Paint está en modo de pantalla completa, terá que empregar a + secuencia [Maiúsculas] + [Control] + [Escape] no teclado para saír de Tux + Paint. - Se está a executar Tux Paint dende unha liña de ordes, asegúrese - de que non está a pasarlle a opción «--noquit». + (Nota: con ou sen «non saír» estabelecido, sempre pode usar a combinación + [Alt] + [F4] no teclado para saír de Tux Paint.) - Se está a executar Tux Paint facendo dobre clic nunha icona, - comprobe as propiedades da icona para ver se «--noquit» aparece - como un argumento da liña de ordes. - Se non se está a enviar a opción «--noquit» na liña de ordes, - comprobe o ficheiro de configuración de Tux Paint para ver se hai - unha liña que diga: «noquit=yes». - Retire esa liña ou simplemente execute Tux Paint co argumento da - liña de ordes «--quit», que anulará o axuste do ficheiro de - configuración. +Non quero que se active o modo «non saír». - Ou use Tux Paint Config. e asegúrese de «Desactiva o botón de - saída e a tecla [Escape]» (baixo «Simplificación») non está - marcado. + Se está a executar Tux Paint dende unha liña de ordes, asegúrese de que non + está a pasarlle a opción «--noquit». - Tux Paint segue a escribir mensaxes estrañas na pantalla/nun ficheiro de - texto + Se está a executar Tux Paint facendo dobre clic nunha icona, comprobe as + propiedades da icona para ver se «--noquit» aparece como un argumento da + liña de ordes. - Algunhas mensaxes son normais, mais se Tux Paint está a ser - extremadamente detallado (como enumerar o nome de cada imaxe de - selo de goma que atopa ao cargalas), entón probabelmente foi - compilado coa saída de depuración activada. + Se non se está a enviar a opción «--noquit» na liña de ordes, comprobe o + ficheiro de configuración de Tux Paint para ver se hai unha liña que diga: + «noquit=yes». - Para cambialo, debe volver compilar Tux Paint dende o código - fonte. Asegúrese de eliminar ou comentar calquera liña que diga: + Retire esa liña ou simplemente execute Tux Paint co argumento da liña de + ordes «--quit», que anulará o axuste do ficheiro de configuración. - #define DEBUG + Ou use Tux Paint Config. e asegúrese de «Desactiva o botón de saída e a + tecla [Escape]» (baixo «Simplificación») non está marcado. - no ficheiro «tuxpaint.c» no directorio «src». - Tux Paint está a usar opcións que non especifiquei. - De xeito predeterminado, Tux Paint primeiro mira os ficheiros de - configuración para ver as opcións. +Tux Paint segue a escribir mensaxes estrañas na pantalla/nun ficheiro de texto - * Windows + Algunhas mensaxes son normais, mais se Tux Paint está a ser extremadamente + detallado (como enumerar o nome de cada imaxe de selo de goma que atopa ao + cargalas), entón probabelmente foi compilado coa saída de depuración + activada. - En Windows, Tux Paint examina primeiro o ficheiro de - configuración: + Para cambialo, debe volver compilar Tux Paint dende o código fonte. + Asegúrese de eliminar ou comentar calquera liña que diga: - tuxpaint.cfg + #define DEBUG - Finalmente, úsanse as opcións enviadas como argumentos da - liña de ordes. + no ficheiro «tuxpaint.c» no directorio «src». - * macOS - * Unix e Linux - En Unix e Linux, primeiro examine o ficheiro de configuración - de todo o sistema, que se atopa aquí: +Tux Paint está a usar opcións que non especifiquei. - /etc/tuxpaint/tuxpaint.conf + De xeito predeterminado, Tux Paint primeiro mira os ficheiros de + configuración para ver as opcións. - A continuación, examina o ficheiro de configuración persoal - do usuario: + + Windows - ~/.tuxpaintrc + En Windows, Tux Paint examina primeiro o ficheiro de configuración: - Finalmente, úsanse as opcións enviadas como argumentos da - liña de ordes. + tuxpaint.cfg - * Haiku + Finalmente, úsanse as opcións enviadas como argumentos da liña de + ordes. - Isto significa que se estabelece algo nun ficheiro de - configuración que non quere estabelecer, terá que cambiar o - ficheiro de configuración (se pode) ou anular a opción na liña de - ordes. + + macOS - Por exemplo, en Linux e Unix, se «/etc/tuxpaint/tuxpaint.conf» - inclúe esta opción para desactivar o son... + + Unix e Linux - nosound=yes + En Unix e Linux, primeiro examine o ficheiro de configuración de todo o + sistema, que se atopa aquí: - ...entón pode volver activar o son engadindo esta opción ao seu - propio ficheiro «.tuxpaintrc»: + /etc/tuxpaint/tuxpaint.conf - sound=yes + A continuación, examina o ficheiro de configuración persoal do usuario: - ... ou usando este argumento da liña de ordes: + ~/.tuxpaintrc - --sound + Finalmente, úsanse as opcións enviadas como argumentos da liña de + ordes. - Os usuarios de Linux e Unix tamén poden desactivar o ficheiro de - configuración de todo o sistema incluíndo o seguinte argumento da - liña de ordes: + + Haiku - --nosysconfig + Isto significa que se estabelece algo nun ficheiro de configuración que non + quere estabelecer, terá que cambiar o ficheiro de configuración (se pode) + ou anular a opción na liña de ordes. - Tux Paint só ollará «~/.tuxpaintrc» e os argumentos da liña de - ordes para determinar que opcións se deben estabelecer. + Por exemplo, en Linux e Unix, se «/etc/tuxpaint/tuxpaint.conf» inclúe esta + opción para desactivar o son... - ---------------------------------------------------------------------- + nosound=yes + + ...entón pode volver activar o son engadindo esta opción ao seu propio + ficheiro «.tuxpaintrc»: + + sound=yes + + ... ou usando este argumento da liña de ordes: + + --sound + + Os usuarios de Linux e Unix tamén poden desactivar o ficheiro de + configuración de todo o sistema incluíndo o seguinte argumento da liña de + ordes: + + --nosysconfig + + Tux Paint só ollará «~/.tuxpaintrc» e os argumentos da liña de ordes para + determinar que opcións se deben estabelecer. + + + + +------------------------------------------------------------------------------- Axuda / Contacto - Hai algunha pregunta que non ve respondida? Agradecémoslle que nolo diga. - Para elo, pode subscribirse e publicar na nosa lista de correo - «tuxpaint-users»: +Hai algunha pregunta que non ve respondida? Agradecémoslle que nolo diga. Para +elo, pode subscribirse e publicar na nosa lista de correo «tuxpaint-users»: - https://tuxpaint.org/lists/ + https://tuxpaint.org/lists/ - Ou ,póñase en contacto directamente co responsábel do desenvolvemento Bill - Kendrick: +Ou ,póñase en contacto directamente co responsábel do desenvolvemento Bill +Kendrick: + + bill@newbreedsoftware.com - bill@newbreedsoftware.com diff --git a/docs/gl_ES.UTF-8/INSTALL.txt b/docs/gl_ES.UTF-8/INSTALL.txt index ba88002c2..fd2a3e7b9 100644 --- a/docs/gl_ES.UTF-8/INSTALL.txt +++ b/docs/gl_ES.UTF-8/INSTALL.txt @@ -1,944 +1,944 @@ Tux Paint - versión 0.9.31 - Documentación da instalación + versión 0.9.31 + Documentación da instalación Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ - 13 de Maio de 2023 + 13 de Maio de 2023 - +----------------------------------------------------+ - |Índice | - |----------------------------------------------------| - | * Requirements | - | * Simple DirectMedia Layer library (libSDL) | - | * Outras bibliotecas | - | * Compiling and Installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Debugging | - | * Uninstalling Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +----------------------------------------------------+ ++---------------------------------------------------+ +| Índice | +|---------------------------------------------------| +| * Requirements | +| + Simple DirectMedia Layer library (libSDL) | +| + Outras bibliotecas | +| * Compiling and Installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Debugging | +| * Uninstalling Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++---------------------------------------------------+ - Requirements +Requirements Simple DirectMedia Layer library (libSDL) - Tux Paint require a «Simple DirectMedia Layer Library (libSDL)», unha - biblioteca de programación multimedia de código aberto dispoñíbel baixo a - licenza pública GNU Lesser General Public License (LGPL). +Tux Paint require a «Simple DirectMedia Layer Library (libSDL)», unha +biblioteca de programación multimedia de código aberto dispoñíbel baixo a +licenza pública GNU Lesser General Public License (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - As bibliotecas SDL están dispoñíbeis como código fonte ou como paquetes - RPM ou Debian para varias distribucións de Linux. Pódense descargar dende: +As bibliotecas SDL están dispoñíbeis como código fonte ou como paquetes RPM ou +Debian para varias distribucións de Linux. Pódense descargar dende: - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (opcional) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (opcional) - Normalmente tamén están dispoñíbeis xunto coa súa distribución de Linux - (p. ex.: nun medio de instalación ou dispoñíbeis a través dun software de - mantemento de paquetes como «apt» de Debian). +Normalmente tamén están dispoñíbeis xunto coa súa distribución de Linux (p. +ex.: nun medio de instalación ou dispoñíbeis a través dun software de +mantemento de paquetes como «apt» de Debian). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Outras bibliotecas +Outras bibliotecas - Tux Paint tamén aproveita outras bibliotecas libres con licenza LGPL. En - Linux, do mesmo xeito que SDL, deberían estar xa instaladas ou estar - dispoñíbeis para a súa instalación como parte da súa distribución de - Linux. +Tux Paint tamén aproveita outras bibliotecas libres con licenza LGPL. En Linux, +do mesmo xeito que SDL, deberían estar xa instaladas ou estar dispoñíbeis para +a súa instalación como parte da súa distribución de Linux. - libPNG +libPNG - Tux Paint utiliza o formato PNG (Portable Network Graphics – - Gráficos de Rede Portátiles) para os seus ficheiros de datos. A - imaxe SDL requirirá a instalación de libPNG. + Tux Paint utiliza o formato PNG (Portable Network Graphics – Gráficos de + Rede Portátiles) para os seus ficheiros de datos. A imaxe SDL requirirá a + instalación de libPNG. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint utiliza a configuración local do sistema xunto coa - biblioteca «gettext» para admitir varios idiomas (p. ex., o - español). Necesitará ter a biblioteca gettext instalada. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Só Linux/Unix) + Tux Paint utiliza a configuración local do sistema xunto coa biblioteca + «gettext» para admitir varios idiomas (p. ex., o español). Necesitará ter a + biblioteca gettext instalada. - A partir de Tux Paint 0.9.17, Tux Paint pode determinar o tamaño - de papel predeterminado do seu sistema (p. ex.: A4 ou Carta), ou - pódeselle indicar que use un tamaño de papel particular, grazas a - «libpaper». + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - As ferramentas «Texto» e «Etiqueta» de Tux Paint admiten linguaxes - bidireccionais grazas á biblioteca «FriBiDi». +libpaper (Só Linux/Unix) - http://fribidi.org/ + A partir de Tux Paint 0.9.17, Tux Paint pode determinar o tamaño de papel + predeterminado do seu sistema (p. ex.: A4 ou Carta), ou pódeselle indicar + que use un tamaño de papel particular, grazas a «libpaper». - Compatibilidade de SVG + https://github.com/naota/libpaper - A partir de Tux Paint 0.9.17, Tux Paint pode cargar imaxes SVG - (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) como - selos. Admítense dous conxuntos de bibliotecas e pódese desactivar - completamente a compatibilidade SVG (a través de «make SVG_LIB:=») - librsvg-2 & libCairo2 (bibliotecas máis recentes) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * Estes tamén dependen do seguinte: - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Bibliotecas SVG máis antigas - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * Estes tamén dependen do seguinte: - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Función de exportación de GIF animado + As ferramentas «Texto» e «Etiqueta» de Tux Paint admiten linguaxes + bidireccionais grazas á biblioteca «FriBiDi». - Para a compatibilidade da exportación de GIF animados - (presentacións de diapositivas), é necesaria a biblioteca - «libimagequant» (do proxecto «pngquant2»). + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado - 📜 En Linux e Unix, as versións anteriores de Tux Paint utilizaban - as ferramentas NetPBM para axudar á impresión. (Tux Paint xera un - PNG e convértese nun PostScript usando as ferramentas da liña de - ordes NetPBM «pngtopnm» e «pnmtops»). +Compatibilidade de SVG - http://netpbm.sourceforge.net/ + A partir de Tux Paint 0.9.17, Tux Paint pode cargar imaxes SVG (Scalable + Vector Graphics — Gráficos Vectoriais Escalábeis) como selos. Admítense + dous conxuntos de bibliotecas e pódese desactivar completamente a + compatibilidade SVG (a través de «make SVG_LIB:=») - Compiling and Installation + librsvg-2 & libCairo2 (bibliotecas máis recentes) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o Estes tamén dependen do seguinte: + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint publícase baixo a Licenza Pública Xeral de GNU (GPL) (consulte - «COPYING.txt» para máis detalles) e, polo tanto, o «código fonte» do - programa está dispoñíbel libremente. - ------------------------------------------------------------------ + Bibliotecas SVG máis antigas + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o Estes tamén dependen do seguinte: + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Función de exportación de GIF animado + + Para a compatibilidade da exportación de GIF animados (presentacións de + diapositivas), é necesaria a biblioteca «libimagequant» (do proxecto + «pngquant2»). + + https://github.com/ImageOptim/libimagequant + + + +Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado + + 📜 En Linux e Unix, as versións anteriores de Tux Paint utilizaban as + ferramentas NetPBM para axudar á impresión. (Tux Paint xera un PNG e + convértese nun PostScript usando as ferramentas da liña de ordes NetPBM + «pngtopnm» e «pnmtops»). + + http://netpbm.sourceforge.net/ + + + + +Compiling and Installation + +Tux Paint publícase baixo a Licenza Pública Xeral de GNU (GPL) (consulte +«COPYING.txt» para máis detalles) e, polo tanto, o «código fonte» do programa +está dispoñíbel libremente. + + ----------------------------------------------------------------------- Windows - 10 de Xullo de 2022 Shin-ichi TOYAMA +10 de Xullo de 2022 Shin-ichi TOYAMA - Compiling Set-Up +Compiling Set-Up - A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o - «Makefile» inclúe compatibilidade para construír nun sistema Windows - usando MinGW/MSYS (https://sourceforge.net/projects/msys2/). +A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o «Makefile» +inclúe compatibilidade para construír nun sistema Windows usando MinGW/MSYS ( +https://sourceforge.net/projects/msys2/). - Many tools and libraries are required to build Tux Paint. The package - management system "pacman" helps you install them automatically solving - complicated dependencies. +Many tools and libraries are required to build Tux Paint. The package +management system "pacman" helps you install them automatically solving +complicated dependencies. - MYSYS2 +MYSYS2 - Download the latest MSYS2 environment from https://www.msys2.org/ and - install it where you'd like (the default is "C:\msys64") +Download the latest MSYS2 environment from https://www.msys2.org/ and install +it where you'd like (the default is "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Within the MSYS2 shell, run the following command to install basic - development tools: +Within the MSYS2 shell, run the following command to install basic development +tools: - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to - the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build - environment. +Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to the " +MinGW 32bit (i686) toolchains" section if you need only a 32bit build +environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Within the MSYS2 shell, run the following command to install 64bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 64bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to - the "ImageMagick" section if you need only a 64bit build environment. +Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to the " +ImageMagick" section if you need only a 64bit build environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Within the MSYS2 shell, run the following command to install 32bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 32bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick is a compilation of command line tools to create, edit, - compose, or convert bitmap images supporting quite a large number of image - formats. Tux Paint uses two functions ("convert" and "composite") in it to - generate thumbnails for startar images and templates during the build - process. +ImageMagick is a compilation of command line tools to create, edit, compose, or +convert bitmap images supporting quite a large number of image formats. Tux +Paint uses two functions ("convert" and "composite") in it to generate +thumbnails for startar images and templates during the build process. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - Do not forget to enable "Install legacy utilities (e.g. convert)" while - installing it, because Tux Paint's build process uses them. +Do not forget to enable "Install legacy utilities (e.g. convert)" while +installing it, because Tux Paint's build process uses them. - Add the path to the directory in which ImageMagick is installed at the top - of your "PATH" environment variable. For example: +Add the path to the directory in which ImageMagick is installed at the top of +your "PATH" environment variable. For example: - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - You can make this permanent by adding the above to your the BASH shell - configuration file, "~/.bash_profile". +You can make this permanent by adding the above to your the BASH shell +configuration file, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - All the files needed for starting Tux Paint (and Tux Paint Config.) are - collected in the directory for binary distribution "bdist" directory under - "win32". You can start them by double-clicking their executable (.exe) - files in the "bdist" directory. +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup is used to build executable installer for Tux Paint. Therefore - you have to install it in the first place. +All the files needed for starting Tux Paint (and Tux Paint Config.) are +collected in the directory for binary distribution "bdist" directory under +"win32". You can start them by double-clicking their executable (.exe) files in +the "bdist" directory. - Inno Setup officially supports translations for only about 20 languages. - However, one of the great points of Tux Paint is it supports so many - languages. Therefore, the set up script "tuxpaint.iss" to build the - installer is written to use much more translations including unofficial - one which are available on "Inno Setup Translations". You have to download - translation files (.isl) required and put them in "Languages" directory - under the directory in which Inno Setup is installed. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup is used to build executable installer for Tux Paint. Therefore you +have to install it in the first place. - Then, you can easily build an executable installer by right-clicking on - the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" - on the list. It will run for a while, and eventually you will find a - "tuxpaint-X.Y.Z-windows--installer.exe" file in the same directory. +Inno Setup officially supports translations for only about 20 languages. +However, one of the great points of Tux Paint is it supports so many languages. +Therefore, the set up script "tuxpaint.iss" to build the installer is written +to use much more translations including unofficial one which are available on " +Inno Setup Translations". You have to download translation files (.isl) +required and put them in "Languages" directory under the directory in which +Inno Setup is installed. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Faga dobre clic no executábel do instalador de Tux Paint (ficheiro .EXE) e - siga as instrucións. +Then, you can easily build an executable installer by right-clicking on the +"tuxpaint.iss" icon in the "win32" directory and selecting "Compile" on the +list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z +-windows--installer.exe" file in the same directory. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - Após preguntaráselle se quere instalar accesos directos a Tux Paint no seu - menú de inicio de Windows e no escritorio de Windows. (Ámbalas dúas - opcións están definidas de xeito predeterminado.) +Faga dobre clic no executábel do instalador de Tux Paint (ficheiro .EXE) e siga +as instrucións. - A seguir preguntaráselle onde quere instalar Tux Paint. O valor - predeterminado debería ser axeitado, sempre que haxa espazo dispoñíbel. Se - non, escolla un lugar diferente. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - Neste punto, pode premer en «Instalar» para instalar Tux Paint. +Após preguntaráselle se quere instalar accesos directos a Tux Paint no seu menú +de inicio de Windows e no escritorio de Windows. (Ámbalas dúas opcións están +definidas de xeito predeterminado.) - Changing the Settings Using the Shortcut +A seguir preguntaráselle onde quere instalar Tux Paint. O valor predeterminado +debería ser axeitado, sempre que haxa espazo dispoñíbel. Se non, escolla un +lugar diferente. - Para cambiar os axustes do programa, prema co botón dereito no atallo de - TuxPaint e seleccione «Propiedades» (na parte inferior). +Neste punto, pode premer en «Instalar» para instalar Tux Paint. - Asegúrese de que a lapela «Atallo» está seleccionada na xanela que aparece - e examine o campo «Obxectivo:». Debería ver algo así: +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +Para cambiar os axustes do programa, prema co botón dereito no atallo de +TuxPaint e seleccione «Propiedades» (na parte inferior). - Agora pode engadir opcións de liña de ordes que se activarán ao facer - dobre clic na icona. +Asegúrese de que a lapela «Atallo» está seleccionada na xanela que aparece e +examine o campo «Obxectivo:». Debería ver algo así: - Por exemplo, para que o xogo se execute en modo de pantalla completa, con - formas sinxelas (sen opción de rotación) e en francés, engada as opcións - (após «TuxPaint.exe»), así: + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +Agora pode engadir opcións de liña de ordes que se activarán ao facer dobre +clic na icona. - (Vexa a documentación principal para obter unha lista completa das opcións - dispoñíbeis da liña de ordes.) +Por exemplo, para que o xogo se execute en modo de pantalla completa, con +formas sinxelas (sen opción de rotación) e en francés, engada as opcións (após +«TuxPaint.exe»), así: - Se se trabuca ou desaparece todo, use [Control] + [Z] para desfacer ou só - prema a tecla [Esc] e a caixa pecharase sen facer cambios (a non ser que - premera o botón «Aplicar»). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - Cando teña rematado, prema en «Aceptar». +(Vexa a documentación principal para obter unha lista completa das opcións +dispoñíbeis da liña de ordes.) - If Something Goes Wrong +Se se trabuca ou desaparece todo, use [Control] + [Z] para desfacer ou só prema +a tecla [Esc] e a caixa pecharase sen facer cambios (a non ser que premera o +botón «Aplicar»). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +Cando teña rematado, prema en «Aceptar». - Conterá unha descrición do que estaba mal. Normalmente só se debe a - maiúsculas e minúsculas incorrectas (maiúsculas «Z» no canto de minúsculas - «z») ou a falta (ou exceso) de «-» (guións). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +Conterá unha descrición do que estaba mal. Normalmente só se debe a maiúsculas +e minúsculas incorrectas (maiúsculas «Z» no canto de minúsculas «z») ou a falta +(ou exceso) de «-» (guións). + + ----------------------------------------------------------------------- Linux/Unix - Compilación: +Compilación: - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - Para compilar o programa dende o código fonte, simplemente execute a - seguinte orde dende un indicador do sistema (p. ex.: «$»): +Para compilar o programa dende o código fonte, simplemente execute a seguinte +orde dende un indicador do sistema (p. ex.: «$»): - $ make + $ make - Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de - «Cairo, libSVG, e svg-cairo»: +Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de +«Cairo, libSVG, e svg-cairo»: - Para desactivar a compatibilidade con SVG (por exemplo, se o seu sistema - non é compatíbel coa biblioteca de Cairo ou outras dependencias - relacionadas co SVG), pode executar «make» engadindo «SVG_LIB= SVG_CFLAGS= - NOSVGFLAG=NOSVG»: +Para desactivar a compatibilidade con SVG (por exemplo, se o seu sistema non é +compatíbel coa biblioteca de Cairo ou outras dependencias relacionadas co SVG), +pode executar «make» engadindo «SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG»: - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - Se non te unha tarxeta de son ou prefire construír o programa sen - asistencia de son (e polo tanto sen a dependencia SDL_mixer), pode - executar «make» con «SDL_MIXER_LIB=» engadido: +Se non te unha tarxeta de son ou prefire construír o programa sen asistencia de +son (e polo tanto sen a dependencia SDL_mixer), pode executar «make» con +«SDL_MIXER_LIB=» engadido: - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Outras opcións (p. ex.: rutas de instalación) poden ser anuladas; véxaas - en «Makefile» para máis detalles. +Outras opcións (p. ex.: rutas de instalación) poden ser anuladas; véxaas en +«Makefile» para máis detalles. - If you get errors +If you get errors - Se recibe algún erro durante o tempo de compilación, asegúrese de ter - instaladas as bibliotecas axeitadas (ver máis arriba). Se está a empregar - versións empaquetadas das bibliotecas (por exemplo, RPM en RedHat ou DEB - en Debian), asegúrese de obter tamén os correspondentes paquetes «-dev» ou - «-devel», se non, non poderá compilar Tux Paint (e outros programas) dende - o código fonte. +Se recibe algún erro durante o tempo de compilación, asegúrese de ter +instaladas as bibliotecas axeitadas (ver máis arriba). Se está a empregar +versións empaquetadas das bibliotecas (por exemplo, RPM en RedHat ou DEB en +Debian), asegúrese de obter tamén os correspondentes paquetes «-dev» ou +«-devel», se non, non poderá compilar Tux Paint (e outros programas) dende o +código fonte. - Installng +Installng - Supoñendo que non se produciron erros graves, agora pode instalar o - programa para que os usuarios do sistema poidan executalo. De xeito - predeterminado, isto debe facelo o usuario «root» («superusuario»). Cambie - a «root» escribindo a orde: +Supoñendo que non se produciron erros graves, agora pode instalar o programa +para que os usuarios do sistema poidan executalo. De xeito predeterminado, isto +debe facelo o usuario «root» («superusuario»). Cambie a «root» escribindo a +orde: - $ su + $ su - Introduza o contrasinal de «root» no indicador do sistema. Agora debería - ser «root» (cun indicador como «#»). Para instalar o programa e os seus - ficheiros de datos, escriba: +Introduza o contrasinal de «root» no indicador do sistema. Agora debería ser +«root» (cun indicador como «#»). Para instalar o programa e os seus ficheiros +de datos, escriba: - # make install + # make install - Finalmente, pode volver ao seu usuario habitual saíndo do modo de - superusuario: +Finalmente, pode volver ao seu usuario habitual saíndo do modo de superusuario: - # exit + # exit - Como alternativa, pode simplemente usar a orde «sudo» (po.ex.: en Ubuntu - Linux): +Como alternativa, pode simplemente usar a orde «sudo» (po.ex.: en Ubuntu +Linux): - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Cambiar onde van as cousas +Cambiar onde van as cousas - Pode cambiar onde irán as cousas axustando as variábeis de «Makefile» na - liña de ordes. «DESTDIR» úsase para colocar a saída nunha área de espera - para a creación de paquetes. «PREFIX» é a base de onde van todos os demais - ficheiros e, de xeito predeterminado, está estabelecido en «/usr/local». +Pode cambiar onde irán as cousas axustando as variábeis de «Makefile» na liña +de ordes. «DESTDIR» úsase para colocar a saída nunha área de espera para a +creación de paquetes. «PREFIX» é a base de onde van todos os demais ficheiros +e, de xeito predeterminado, está estabelecido en «/usr/local». - Outras variábeis son: +Outras variábeis son: - BIN_PREFIX - Onde se instalará o binario «tuxpaint». (Estabelécese como - «$(PREFIX)/bin»como predeterminado, p. ex.: «/usr/local/bin») +BIN_PREFIX + Onde se instalará o binario «tuxpaint». (Estabelécese como «$(PREFIX)/ + bin»como predeterminado, p. ex.: «/usr/local/bin») - DATA_PREFIX - Onde irán os ficheiros de datos (son, gráficos, pinceis, selos, - tipos de letra) e onde os buscará Tux Paint cando se execute. - (Estabelecer en «$(PREFIX)/share/tuxpaint») +DATA_PREFIX + Onde irán os ficheiros de datos (son, gráficos, pinceis, selos, tipos de + letra) e onde os buscará Tux Paint cando se execute. (Estabelecer en «$ + (PREFIX)/share/tuxpaint») - DOC_PREFIX - Onde irán os ficheiros de texto da documentación (o directorio - «docs»). (Estabelecer como «$(PREFIX)/share/doc/tuxpaint») +DOC_PREFIX + Onde irán os ficheiros de texto da documentación (o directorio «docs»). + (Estabelecer como «$(PREFIX)/share/doc/tuxpaint») - MAN_PREFIX - Onde irá a páxina do manual de Tux Paint. (Estabelecer como - «$(PREFIX)/share/man») +MAN_PREFIX + Onde irá a páxina do manual de Tux Paint. (Estabelecer como «$(PREFIX)/ + share/man») - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Onde irán as iconas e os lanzadores (para GNOME e KDE). - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Onde irán os ficheiros de tradución para Tux Paint e onde os buscará Tux + Paint. (Estabelécese en «$(PREFIX)/share/locale/») (A localización final + dun ficheiro de tradución estará no directorio da configuración local (por + exemplo, «es» para o español), dentro do subdirectorio «LC_MESSAGES»). - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Onde irán as iconas e os lanzadores (para GNOME e KDE). +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Onde irán os ficheiros de tradución para Tux Paint e onde os - buscará Tux Paint. (Estabelécese en «$(PREFIX)/share/locale/») (A - localización final dun ficheiro de tradución estará no directorio - da configuración local (por exemplo, «es» para o español), dentro - do subdirectorio «LC_MESSAGES»). - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - 5 de Xuño de 2022 Mark Kim +5 de Xuño de 2022 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prerequisites +Prerequisites - Although Tux Paint is built without the Xcode IDE, Xcode itself is still - required to build Tux Paint. Download it from the App Store, and launch it - once to accept its license agreements. You may also need to install the - Xcode command line tools using the command: +Although Tux Paint is built without the Xcode IDE, Xcode itself is still +required to build Tux Paint. Download it from the App Store, and launch it once +to accept its license agreements. You may also need to install the Xcode +command line tools using the command: - $ xcode-select --install + $ xcode-select --install - Building Tux Paint also requires various libraries. We install them from - MacPorts where possible, source code otherwise. Install MacPorts to the - default /opt/local path according to the instructions found on their - website: https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... but you should install any package that is required by the latest - version of Tux Paint. +Building Tux Paint also requires various libraries. We install them from +MacPorts where possible, source code otherwise. Install MacPorts to the default +/opt/local path according to the instructions found on their website: https:// +www.macports.org/ - ^* Not available from MacPorts as of this writing, see below. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... but you should install any package that is required by the latest version +of Tux Paint. - libimagequant is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. +^* Not available from MacPorts as of this writing, see below. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - WARNING: Having any UNIX-like toolset installed on your Mac besides - MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle - from being portable. Be sure Fink and Brew are not accessible from your - build environment. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - How to Build + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Simply, run: +WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts +and Xcode, such as Fink or Brew, will prevent your app bundle from being +portable. Be sure Fink and Brew are not accessible from your build environment. - % make - % make install +How to Build - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Simply, run: - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Known Issues +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * A macOS binary built on a specific version of macOS only runs on that - version of macOS or later. To ensure Tux Paint can run on the oldest - version of macOS possible, build it on the oldest version of macOS - available. As of this writing we know Tux Paint cannot be built to run - on macOS 10.7 or earlier. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - See "Old Versions of macOS" below for best-effort instructions on how - to obtain, install, and build Tux Paint on an old version of macOS. +Known Issues - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * A macOS binary built on a specific version of macOS only runs on that + version of macOS or later. To ensure Tux Paint can run on the oldest + version of macOS possible, build it on the oldest version of macOS + available. As of this writing we know Tux Paint cannot be built to run on + macOS 10.7 or earlier. - Old Versions of macOS + See "Old Versions of macOS" below for best-effort instructions on how to + obtain, install, and build Tux Paint on an old version of macOS. - Some old versions of macOS can be downloaded from Apple's support page: - https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Old Versions of macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Some old versions of macOS can be downloaded from Apple's support page: https:/ +/support.apple.com/en-us/HT211683 - As of this writing, the oldest version of macOS available on Apple's - support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" - partitioning scheme instead of the older MBR scheme, and "Mac OS Extended - (Journaled)" as the partition type instead of the newer APFS partition - type. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Upon launching the installer, if you get a popup about macOS being too old - or new to be installed, a bootable installer can be created using the - instructions found here: https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Once the old macOS is installed, you may find the Xcode on the App Store - is too new to run on the version of the old macOS. Old versions of Xcode - can be downloaded from Apple's Developer site in an area accessible with - free registration: https://developer.apple.com/download/more/ +As of this writing, the oldest version of macOS available on Apple's support +site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning +scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as +the partition type instead of the newer APFS partition type. - The list of macOS versions and the last version of Xcode compatible with - them are laid out nicely on the Wikipedia page on Xcode: - https://en.wikipedia.org/wiki/Xcode#Version_comparison_table +Upon launching the installer, if you get a popup about macOS being too old or +new to be installed, a bootable installer can be created using the instructions +found here: https://support.apple.com/en-mide/HT201372 - And because Xcode is being installed manually, you can skip the step to - install the Xcode command line tools (do not run "xcode-select --install") - but otherwise build Tux Paint using the same steps described in the - earlier part of this document. +Once the old macOS is installed, you may find the Xcode on the App Store is too +new to run on the version of the old macOS. Old versions of Xcode can be +downloaded from Apple's Developer site in an area accessible with free +registration: https://developer.apple.com/download/more/ - Recompiling MacPorts +The list of macOS versions and the last version of Xcode compatible with them +are laid out nicely on the Wikipedia page on Xcode: https://en.wikipedia.org/ +wiki/Xcode#Version_comparison_table - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +And because Xcode is being installed manually, you can skip the step to install +the Xcode command line tools (do not run "xcode-select --install") but +otherwise build Tux Paint using the same steps described in the earlier part of +this document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - 29 de Marzo de 2023 Pere Pujal i Carabantes (Edited - by Bill Kendrick) +29 de Marzo de 2023 Pere Pujal i Carabantes (Edited by +Bill Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prerequisites +Prerequisites - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - 7 de Maio de 2023 Luc Schrijvers (Edited by Bill - Kendrick) +7 de Maio de 2023 Luc Schrijvers (Edited by Bill Kendrick) - Prerequisites +Prerequisites - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Debugging +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file - on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled - by setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines - in "src/debug.h" and (re)compiling Tux Paint. +Debugging - Uninstalling Tux Paint +⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file on +Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled by +setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src +/debug.h" and (re)compiling Tux Paint. + +Uninstalling Tux Paint Windows - Uso do desinstalador +Uso do desinstalador - Se instalou os atallos do menú Inicio (o predeterminado), vaia ao cartafol - TuxPaint e seleccione «Desinstalar». Amosarase unha caixa que confirmará - que está a piques de desinstalar Tux Paint e, se está seguro de que quere - eliminar permanentemente Tux Paint, prema no botón «Desinstalar». +Se instalou os atallos do menú Inicio (o predeterminado), vaia ao cartafol +TuxPaint e seleccione «Desinstalar». Amosarase unha caixa que confirmará que +está a piques de desinstalar Tux Paint e, se está seguro de que quere eliminar +permanentemente Tux Paint, prema no botón «Desinstalar». - Cando remate, prema no botón pechar. +Cando remate, prema no botón pechar. - Usar o Panel de control +Usar o Panel de control - Tamén é posíbel usar a entrada «TuxPaint (só eliminar)« na sección - Engadir/Eliminar programas do Panel de control. +Tamén é posíbel usar a entrada «TuxPaint (só eliminar)« na sección Engadir/ +Eliminar programas do Panel de control. macOS - Delete "TuxPaint.app" from the "Applications" folder. Data files, - including the configuration files, stamps, and saved pictures, may be - found in "/Library/Application Support/TuxPaint" (all users) and - "/Users/USERNAME/Library/Application Support/TuxPaint" (individual users). +Delete "TuxPaint.app" from the "Applications" folder. Data files, including the +configuration files, stamps, and saved pictures, may be found in "/Library/ +Application Support/TuxPaint" (all users) and "/Users/USERNAME/Library/ +Application Support/TuxPaint" (individual users). Linux - Within the Tux Paint source directory (where you compiled Tux Paint), you - can use the "make uninstall" target to uninstall Tux Paint. By default, - this must be done by the "root" user ('superuser'), but if you installed - Tux Paint somewhere else (e.g., using a "PREFIX=..." setting to "make" and - "make install"), you may not, and will want to provide those same settings - here. (See the installation instructions above for further information.) +Within the Tux Paint source directory (where you compiled Tux Paint), you can +use the "make uninstall" target to uninstall Tux Paint. By default, this must +be done by the "root" user ('superuser'), but if you installed Tux Paint +somewhere else (e.g., using a "PREFIX=..." setting to "make" and "make +install"), you may not, and will want to provide those same settings here. (See +the installation instructions above for further information.) + diff --git a/docs/gl_ES.UTF-8/MAGIC-API.txt b/docs/gl_ES.UTF-8/MAGIC-API.txt index adee3fda4..59eb0fb4f 100644 --- a/docs/gl_ES.UTF-8/MAGIC-API.txt +++ b/docs/gl_ES.UTF-8/MAGIC-API.txt @@ -1,1273 +1,1279 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Magic Tool Plugin API Documentation + Magic Tool Plugin API Documentation Copyright © 2007-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - Abril 13, 2023 + Abril 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Prequisites | - | * Interfaces | - | * 'Magic' tool plugin functions | - | * Common arguments to plugin functions | - | * Required Plugin Functions | - | * Plugin "housekeeping" functions | - | * Plugin event functions | - | * Tux Paint Functions and Data | - | * Pixel Manipulations | - | * Helper Functions | - | * Informational | - | * Tux Paint System Calls | - | * Color Conversions | - | * Helper Macros in "tp_magic_api.h" | - | * Constant Definitions in "tp_magic_api.h" | - | * Compiling | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Installing | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Creating plugins with multiple effects | - | * Example Code | - | * Getting Help | - | * Glossary | - +----------------------------------------------------+ ++--------------------------------------------------+ +| Table of Contents | +|--------------------------------------------------| +| * Prequisites | +| * Interfaces | +| + 'Magic' tool plugin functions | +| o Common arguments to plugin functions | +| o Required Plugin Functions | +| # Plugin "housekeeping" functions | +| # Plugin event functions | +| + Tux Paint Functions and Data | +| o Pixel Manipulations | +| o Helper Functions | +| o Informational | +| o Tux Paint System Calls | +| o Color Conversions | +| + Helper Macros in "tp_magic_api.h" | +| + Constant Definitions in "tp_magic_api.h" | +| * Compiling | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Installing | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Creating plugins with multiple effects | +| * Example Code | +| * Getting Help | +| * Glossary | ++--------------------------------------------------+ - Overview +Overview - Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted - from routines that lived within the application itself, to a set of - 'plugins' that are loaded when Tux Paint starts up. +Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted from +routines that lived within the application itself, to a set of 'plugins' that +are loaded when Tux Paint starts up. - This division allows more rapid development of 'Magic' tools, and allows - programmers to create and test new tools without needing to integrate them - within the main Tux Paint source code. (Users of more professional - graphics tools, such as GIMP, should be familiar with this plugin - concept.) +This division allows more rapid development of 'Magic' tools, and allows +programmers to create and test new tools without needing to integrate them +within the main Tux Paint source code. (Users of more professional graphics +tools, such as GIMP, should be familiar with this plugin concept.) - Prerequisites +Prerequisites - Tux Paint is written in the C programming language, and uses the Simple - DirectMedia Layer library ('libSDL', or simply 'SDL'; available from - https://www.libsdl.org/). Therefore, for the moment at least, one must - understand the C language and how to compile C-based programs. Familiarity - with the SDL API is highly recommended, but some basic SDL concepts will - be covered in this document. +Tux Paint is written in the C programming language, and uses the Simple +DirectMedia Layer library ('libSDL', or simply 'SDL'; available from https:// +www.libsdl.org/). Therefore, for the moment at least, one must understand the C +language and how to compile C-based programs. Familiarity with the SDL API is +highly recommended, but some basic SDL concepts will be covered in this +document. - Interfaces +Interfaces - Those who create 'Magic' tool plugins for Tux Paint must provide some - interfaces (C functions) that Tux Paint may invoke. +Those who create 'Magic' tool plugins for Tux Paint must provide some +interfaces (C functions) that Tux Paint may invoke. - Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" - routines to load plugins (shared objects files; e.g., ".so" files on Linux - or ".dll" files on Windows) and find the functions within. +Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" routines +to load plugins (shared objects files; e.g., ".so" files on Linux or ".dll" +files on Windows) and find the functions within. - In turn, Tux Paint provides a number of helper functions that the plugin - may (or sometimes is required to) use. This is exposed as a C structure - (or "struct") which contains pointers to functions and other data inside - Tux Paint. A pointer to this structure gets passed along to the plugin's - functions as an argument when Tux Paint invokes them. +In turn, Tux Paint provides a number of helper functions that the plugin may +(or sometimes is required to) use. This is exposed as a C structure (or +"struct") which contains pointers to functions and other data inside Tux Paint. +A pointer to this structure gets passed along to the plugin's functions as an +argument when Tux Paint invokes them. - Plugins should #include the C header file "tp_magic_api.h", which exposes - the 'Magic' tool plugin API. Also, when you run the C compiler to build a - plugin, you should use the command-line tool "tp-magic-config" to get the - appropriate compiler flags (such as where the compiler can find the Tux - Paint plugin header file, as well as SDL's header files) for building a - plugin. (See "Compiling", below.) +Plugins should #include the C header file "tp_magic_api.h", which exposes the +'Magic' tool plugin API. Also, when you run the C compiler to build a plugin, +you should use the command-line tool "tp-magic-config" to get the appropriate +compiler flags (such as where the compiler can find the Tux Paint plugin header +file, as well as SDL's header files) for building a plugin. (See "Compiling", +below.) - The C header file and command-line tool mentioned above are included with - Tux Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package". +The C header file and command-line tool mentioned above are included with Tux +Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin +Development package". 'Magic' tool plugin functions - 'Magic' tool plugins must contain the functions listed below. Note: To - avoid 'namespace' collisions, each function's name must start with the - shared object's filename (e.g., "blur.so" or "blur.dll" would have - functions whose names begin with "blur_"). This includes private functions - (ones not used by Tux Paint directly), unless you declare those as - 'static'. - - Common arguments to plugin functions - - Here is a description of arguments that many of your plugin's functions - will need to accept. - - magic_api * api - - Pointer to a C structure containing pointers to Tux Paint - functions and other data that the plugin can (and sometimes - should) use. The contents of this struct are described below. - - Note: The magic_api struct is defined in the C header file - "tp_magic_api.h", which you should include at the top of your - plugin's C source file: - - #include "tp_magic_api.h" - - int which - An index the plugin should use to differentiate different 'Magic' - tools, if the plugin provides more than one. (If not, "which" will - always be 0.) See "Creating plugins with multiple effects", below. +'Magic' tool plugins must contain the functions listed below. Note: To avoid +'namespace' collisions, each function's name must start with the shared +object's filename (e.g., "blur.so" or "blur.dll" would have functions whose +names begin with "blur_"). This includes private functions (ones not used by +Tux Paint directly), unless you declare those as 'static'. - SDL_Surface * snapshot - A snapshot of the previous Tux Paint canvas, taken when the the - mouse was first clicked to activate the current magic tool. If you - don't continuously affect the image during one hold of the mouse - button, you should base your effects off the contents of this - canvas. (That is, read from "snapshot" and write to "canvas", - below.) - - SDL_Surface * canvas - The current Tux Paint drawing canvas. Your magical effects should - end up here! - - SDL_Rect * update_rect - A pointer to an SDL 'rectangle' structure that you use to tell Tux - Paint what part of the canvas has been updated. If your effect - affects a 32x32 area centered around the mouse pointer, you would - fill the SDL_Rect as follows: - - update_rect->x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Informational + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Informational - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Getting Help +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Getting Help - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Glossary +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Glossary + + * alpha: See "RGBA" + * &: See "ampersand" + * ampersand (pointers): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * ampersand (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bit" + * API: Application Programming Interface. TBD + * argument: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * backtick: See "grave" + * bit: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "byte" + * blue: See "RGBA" + * boolean 'or': A mathematical operation that results in a true value if + either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 + | 0" results in "0".) + * |: See "boolean 'or'" + * .: See "dot" + * `: See "grave" + * *: See "star" + * byte: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * callback: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * channel: TBD + * click: The action of pressing a button on a mouse. + * coordinates: A set of numbers corresponding to a physical position; for + example, in a two-dimensional (2D) image, "X" and "Y" coordinates specify + the position across (left-to-right) and down the image, respectively. In + SDL, the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * dimensions: The size of an object, in terms of its width (left to right) + and height (top to bottom). + * .dll: See "Shared Object" + * dot: ".". A symbol in C that references an element within a struct. + * drag: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "floating point" + * floating point: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * green: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * header: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * hue: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * linear: TBD + * macro: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Plugin: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * prototype: See "C function prototype" + * red: See "RGBA" + * release: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "ampersand" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * unsigned: In C, a variable that can store a numeric value can be declared + as either "signed" (the default), or "unsigned". In the former case, one + bit of the value is used to denote the sign of the value (either positive + or negative). In the latter case, the value can only be positive, but + benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * value: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Dimensions" + * (x,y): See "Coordinates" - * alpha: See "RGBA" - * &: See "ampersand" - * ampersand (pointers): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * ampersand (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bit" - * API: Application Programming Interface. TBD - * argument: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * backtick: See "grave" - * bit: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "byte" - * blue: See "RGBA" - * boolean 'or': A mathematical operation that results in a true value if - either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in - "1". "0 | 0" results in "0".) - * |: See "boolean 'or'" - * .: See "dot" - * `: See "grave" - * *: See "star" - * byte: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * callback: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * channel: TBD - * click: The action of pressing a button on a mouse. - * coordinates: A set of numbers corresponding to a physical position; - for example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * dimensions: The size of an object, in terms of its width (left to - right) and height (top to bottom). - * .dll: See "Shared Object" - * dot: ".". A symbol in C that references an element within a struct. - * drag: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "floating point" - * floating point: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * green: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * header: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * hue: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * linear: TBD - * macro: A C construct that looks similar to a C function, but is simply - a #define that is expanded 'inline'. For example, if you declared the - macro "#define ADD(A,B) ((A)+(B))", and then used it with "c = - ADD(1,2);", that line of code would literally expand to "c = ((1) + - (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Plugin: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * prototype: See "C function prototype" - * red: See "RGBA" - * release: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "ampersand" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * unsigned: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * value: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Dimensions" - * (x,y): See "Coordinates" diff --git a/docs/gl_ES.UTF-8/OPTIONS.txt b/docs/gl_ES.UTF-8/OPTIONS.txt index 3851b4993..069e25769 100644 --- a/docs/gl_ES.UTF-8/OPTIONS.txt +++ b/docs/gl_ES.UTF-8/OPTIONS.txt @@ -1,2062 +1,2221 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 -Documentación de opcións + Documentación de opcións Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ 13 de Xullo de 2023 - +----------------------------------------------------+ - |Índice | - |----------------------------------------------------| - | * Tux Paint Config. | - | * Ficheiro de configuración | - | * Opcións dispoñíbeis | - | * Video/Sound | - | * Mouse/Keyboard | - | * Simplificación | - | * Languages | - | * Impresión | - | * Gardar | - | * Data | - | * Accessibility | - | * Joystick | - | * Anulación da configuración do sistema. Opcións | - | * Opcións da liña de ordes | - | * Opcións informativas da liña de ordes | - | * Escoller un idioma diferente | - | * Idiomas dispoñíbeis | - | * Axustar o idioma do seu contorno | - | * Tipos de letra especiais | - +----------------------------------------------------+ ++----------------------------------------------------+ +| Índice | +|----------------------------------------------------| +| * Tux Paint Config. | +| * Ficheiro de configuración | +| * Opcións dispoñíbeis | +| + Video/Sound | +| + Mouse/Keyboard | +| + Simplificación | +| + Languages | +| + Impresión | +| + Gardar | +| + Data | +| + Accessibility | +| + Joystick | +| * Anulación da configuración do sistema. Opcións | +| * Opcións da liña de ordes | +| + Opcións informativas da liña de ordes | +| * Escoller un idioma diferente | +| + Idiomas dispoñíbeis | +| + Axustar o idioma do seu contorno | +| + Tipos de letra especiais | ++----------------------------------------------------+ - Tux Paint Config. +Tux Paint Config. - Está dispoñíbel unha ferramenta gráfica que lle permite cambiar o - comportamento de Tux Paint. Non obstante, se prefire non instalar e usar - esta ferramenta, ou quere comprender mellor as opcións dispoñíbeis, siga - lendo. +Está dispoñíbel unha ferramenta gráfica que lle permite cambiar o comportamento +de Tux Paint. Non obstante, se prefire non instalar e usar esta ferramenta, ou +quere comprender mellor as opcións dispoñíbeis, siga lendo. - Ficheiro de configuración +Ficheiro de configuración - Pode crear un ficheiro de configuración sinxelo para Tux Paint, que lerá - cada vez que o inicie. +Pode crear un ficheiro de configuración sinxelo para Tux Paint, que lerá cada +vez que o inicie. - O ficheiro é simplemente un ficheiro de texto sinxelo que contén as - opcións que quere activar habilitar: +O ficheiro é simplemente un ficheiro de texto sinxelo que contén as opcións que +quere activar habilitar: Usuarios de Linux e Unix - O ficheiro que debe crear chámase «.tuxpaintrc» e debería colocarse no seu - directorio persoal. (tamén coñecido como «~/.tuxpaintrc» ou - «$HOME/.tuxpaintrc») +O ficheiro que debe crear chámase «.tuxpaintrc» e debería colocarse no seu +directorio persoal. (tamén coñecido como «~/.tuxpaintrc» ou «$HOME +/.tuxpaintrc») - Ficheiro de configuración de todo o sistema +Ficheiro de configuración de todo o sistema - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf Usuarios de macOS - O ficheiro que debe crear chámase «tuxpaint.cfg» e debería colocalo no seu - cartafol persoal, baixo o subcartafol: Library/Application - Support/TuxPaint +O ficheiro que debe crear chámase «tuxpaint.cfg» e debería colocalo no seu +cartafol persoal, baixo o subcartafol: Library/Application Support/TuxPaint - Ficheiro de configuración de todo o sistema +Ficheiro de configuración de todo o sistema - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Usuarios de Windows - The file you should create is called "tuxpaint.cfg" and it should be - placed in in your personal AppData folder: C:\Users\nome de - usuario\AppData\Roaming\TuxPaint\ +The file you should create is called "tuxpaint.cfg" and it should be placed in +in your personal AppData folder: C:\Users\nome de usuario\AppData\Roaming\ +TuxPaint\ - Pode usar NotePad ou WordPad para crear este ficheiro. Asegúrese de - gardalo como texto simple e asegúrese de que o nome do ficheiro non teña - «.txt» ao final... +Pode usar NotePad ou WordPad para crear este ficheiro. Asegúrese de gardalo +como texto simple e asegúrese de que o nome do ficheiro non teña «.txt» ao +final... - Ficheiro de configuración de todo o sistema +Ficheiro de configuración de todo o sistema - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ You can disable reading of this file altogether, leaving the settings as - defaults (which can then be overridden by your personal config. file - and/or command-line arguments) by using the command-line option - "--nosysconfig". +⚙ You can disable reading of this file altogether, leaving the settings as +defaults (which can then be overridden by your personal config. file and/or +command-line arguments) by using the command-line option "--nosysconfig". - Opcións dispoñíbeis +Opcións dispoñíbeis - Os seguintes axustes pódense estabelecer no ficheiro de configuración. (A - configuración da liña de ordes substituirá estes. Vexa a sección «Opcións - da liña de ordes», a continuación.) +Os seguintes axustes pódense estabelecer no ficheiro de configuración. (A +configuración da liña de ordes substituirá estes. Vexa a sección «Opcións da +liña de ordes», a continuación.) Video/Sound - Video +Video - fullscreen=yes +fullscreen=yes - Executar o programa en modo de pantalla completa en vez de nunha - xanela. + Executar o programa en modo de pantalla completa en vez de nunha xanela. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "fullscreen=no". - In both cases, may be overridden by the command-line option - "--windowed". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "fullscreen=no". In both cases, may be + overridden by the command-line option "--windowed". - fullscreen=native - Executar o programa en modo de pantalla completa. Ademais, asume a - resolución actual da pantalla (estabelecida polo sistema - operativo). - windowsize=TAMAÑO +fullscreen=native - Executar o programa a un tamaño diferente (en modo xanela) ou a - unha resolución de pantalla diferente (en modo de pantalla - completa), en lugar do predeterminado (normalmente 800x600). + Executar o programa en modo de pantalla completa. Ademais, asume a + resolución actual da pantalla (estabelecida polo sistema operativo). - O valor TAMAÑO debería presentarse en píxeles, en formato «largo - por alto», cun «x» (X minúsculo) entre os valores. O tamaño pode - ser calquera que teña polo menos 640 de largo e polo menos 480 de - alto. - Algúns exemplos: - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=TAMAÑO - 💡 If only one display is available, and Tux Paint is being run in - windowed (not fullscreen) mode, and the chosen window size exceeds - the capabilities of the display, Tux Paint will fall back to the - display's dimensions. + Executar o programa a un tamaño diferente (en modo xanela) ou a unha + resolución de pantalla diferente (en modo de pantalla completa), en lugar + do predeterminado (normalmente 800x600). - orient=portrait + O valor TAMAÑO debería presentarse en píxeles, en formato «largo por alto», + cun «x» (X minúsculo) entre os valores. O tamaño pode ser calquera que teña + polo menos 640 de largo e polo menos 480 de alto. - Cambia as opcións de largo/alto dadas a Tux Paint, útiles para - xirar a xanela nas pantallas verticais, como unha tableta que está - en orientación de tableta. + Algúns exemplos: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 If only one display is available, and Tux Paint is being run in windowed + (not fullscreen) mode, and the chosen window size exceeds the capabilities + of the display, Tux Paint will fall back to the display's dimensions. - Ao executar Tux Paint en modo de pantalla completa, isto asume a - resolución actual da pantalla (anulando calquera opción - «windowsize»), segundo o estabelecido polo sistema operativo. - allowscreensaver=yes - De xeito predeterminado, Tux Paint impide que o protector de - pantalla do seu sistema se inicie. Pode anular isto empregando a - opción «allowscreensaver». Nota: Isto require a versión 1.2.12 ou - superior da biblioteca SDL. (Tamén pode facelo configurando a - variábel de contorno «SDL_VIDEO_ALLOW_SCREENSAVER» do seu sistema - en «1».) +orient=portrait - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both cases, - may be overridden by the command-line option - "--disablescreensaver". + Cambia as opcións de largo/alto dadas a Tux Paint, útiles para xirar a + xanela nas pantallas verticais, como unha tableta que está en orientación + de tableta. - Sound + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "orient=landscape". In both cases, may + be overridden by the command-line option "--orient=landscape". - nosound=yes - Desactivar os efectos de son. (Nota: Ao premer [Alt] + [S] non se - poden volver activar os sons se se desactivaron usando esta - opción). - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" or - "sound=yes". In both cases, may be overridden by the command-line - option "--sound". +native=yes - nostereo=yes + Ao executar Tux Paint en modo de pantalla completa, isto asume a resolución + actual da pantalla (anulando calquera opción «windowsize»), segundo o + estabelecido polo sistema operativo. - Desactivar a compatibilidade con panorama estéreo. (Útil para - usuarios con discapacidade auditiva nun oído ou lugares onde se - está a empregar un só altofalante ou auricular.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" or - "stereo=yes". In both cases, may be overridden by the command-line - option "--stereo". - Interface Size +allowscreensaver=yes - buttonsize=TAMAÑO + De xeito predeterminado, Tux Paint impide que o protector de pantalla do + seu sistema se inicie. Pode anular isto empregando a opción + «allowscreensaver». Nota: Isto require a versión 1.2.12 ou superior da + biblioteca SDL. (Tamén pode facelo configurando a variábel de contorno + «SDL_VIDEO_ALLOW_SCREENSAVER» do seu sistema en «1».) - Estabeleza o tamaño dos píxeles dos botóns na interface de usuario - de Tux Paint (substituíndo o predeterminado de «48»). Útil cando - se usan pantallas de alta densidade ou dispositivos de entrada - groseiros, como rastrexadores de ollos. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "allowscreensaver=no" or + "disablescreensaver=yes". In both cases, may be overridden by the + command-line option "--disablescreensaver". - O valor TAMAÑO debería presentarse en píxeles e pode estar entre - 24 e 192, inclusive. A maioría dos botóns son cadrados e isto - afectará ao seu largo e alto. - A value of "auto" may be provided, and Tux Paint will choose a - suitable button size based on the size of Tux Paint's window (or - fullscreen display). (For the default screen size of 800x600, it - will be the default button size: "48".) - 💡 Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux Paint's - chosen window size, the largest possible button size will be used. - (A note will appear in stderr.) - colorsrows=FILAS +Sound + +nosound=yes + + Desactivar os efectos de son. (Nota: Ao premer [Alt] + [S] non se poden + volver activar os sons se se desactivaron usando esta opción). + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nosound=no" or "sound=yes". In both + cases, may be overridden by the command-line option "--sound". + + + +nostereo=yes + + Desactivar a compatibilidade con panorama estéreo. (Útil para usuarios con + discapacidade auditiva nun oído ou lugares onde se está a empregar un só + altofalante ou auricular.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostereo=no" or "stereo=yes". In both + cases, may be overridden by the command-line option "--stereo". + + + + +Interface Size + +buttonsize=TAMAÑO + + Estabeleza o tamaño dos píxeles dos botóns na interface de usuario de Tux + Paint (substituíndo o predeterminado de «48»). Útil cando se usan pantallas + de alta densidade ou dispositivos de entrada groseiros, como rastrexadores + de ollos. + + O valor TAMAÑO debería presentarse en píxeles e pode estar entre 24 e 192, + inclusive. A maioría dos botóns son cadrados e isto afectará ao seu largo e + alto. + + A value of "auto" may be provided, and Tux Paint will choose a suitable + button size based on the size of Tux Paint's window (or fullscreen + display). (For the default screen size of 800x600, it will be the default + button size: "48".) + + 💡 Note: If the chosen button size would cause the buttons to be too large + for all required UI elements to appear under Tux Paint's chosen window + size, the largest possible button size will be used. (A note will appear in + stderr.) + + + +colorsrows=FILAS + + Cantas filas de botóns da paleta de cores amosar; útil cando se usa unha + gran paleta de cores (ver «colorfile», arriba) e/ou para usar con + dispositivos de entrada groseiros (como os rastrexadores de ollos). «FILAS» + pode estar entre «1» (o predeterminado) e «3». + + - Cantas filas de botóns da paleta de cores amosar; útil cando se - usa unha gran paleta de cores (ver «colorfile», arriba) e/ou para - usar con dispositivos de entrada groseiros (como os rastrexadores - de ollos). «FILAS» pode estar entre «1» (o predeterminado) e «3». Mouse/Keyboard - Cursor +Cursor - nofancycursors=yes +nofancycursors=yes - Isto desactiva as fantásticas formas do punteiro do rato en Tux - Paint e usa o punteiro normal do seu contorno. + Isto desactiva as fantásticas formas do punteiro do rato en Tux Paint e usa + o punteiro normal do seu contorno. - Nalgúns contornos, os cursores de fantasía causan problemas. Use - esta opción para evitalos. + Nalgúns contornos, os cursores de fantasía causan problemas. Use esta + opción para evitalos. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nofancycursors=no" or "fancycursors= + yes". In both cases, may be overridden by the command-line option + "--fancycursors". - hidecursor=yes - Isto agocha completamente as formas do punteiro do rato en Tux - Paint. - Isto é útil para dispositivos con pantalla táctil, como as - tabletas. +hidecursor=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "hidecursor=no" - or "showcursor=yes". In both cases, may be overridden by the - command-line option "--showcursor". + Isto agocha completamente as formas do punteiro do rato en Tux Paint. - Keyboard + Isto é útil para dispositivos con pantalla táctil, como as tabletas. - noshortcuts=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "hidecursor=no" or "showcursor=yes". In + both cases, may be overridden by the command-line option "--showcursor". - Isto desactiva os atallos de teclado (por exemplo,[Ctrl]-[S] para - gardar, [Ctrl]-[N] para unha nova imaxe, etc.) - Isto é útil para evitar que ordes non desexadas sexan activadas - por cativos que non teñen experiencia con teclados. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noshortcuts=no" - or "shortcuts=yes". In both cases, may be overridden by the - command-line option "--shortcuts". - Mouse +Keyboard - grab=yes +noshortcuts=yes - Tux Paint tentará «amarrar» o rato e o teclado, de xeito que o - rato estea confinado na xanela de Tux Paint e case toda a entrada - do teclado se lle pase directamente. + Isto desactiva os atallos de teclado (por exemplo,[Ctrl]-[S] para gardar, + [Ctrl]-[N] para unha nova imaxe, etc.) - Isto é útil para desactivar as accións do sistema operativo que - poidan sacar ao usuario de Tux Pain do ciclo de xanelast - [Alt]-[Tab], [Ctrl]-[Escape], etc. Isto é especialmente útil no - modo de pantalla completa. + Isto é útil para evitar que ordes non desexadas sexan activadas por cativos + que non teñen experiencia con teclados. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In + both cases, may be overridden by the command-line option "--shortcuts". - nowheelmouse=yes - Isto desactiva a compatibilidade para a roda dos ratos que a - teñen. (Normalmente, a roda desprazará o menú do selector á - dereita.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". - nobuttondistinction=yes +Mouse + +grab=yes + + Tux Paint tentará «amarrar» o rato e o teclado, de xeito que o rato estea + confinado na xanela de Tux Paint e case toda a entrada do teclado se lle + pase directamente. + + Isto é útil para desactivar as accións do sistema operativo que poidan + sacar ao usuario de Tux Pain do ciclo de xanelast [Alt]-[Tab], [Ctrl]- + [Escape], etc. Isto é especialmente útil no modo de pantalla completa. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "grab=no" or "dontgrab=yes". In both + cases, may be overridden by the command-line option "--dontgrab". + + + +nowheelmouse=yes + + Isto desactiva a compatibilidade para a roda dos ratos que a teñen. + (Normalmente, a roda desprazará o menú do selector á dereita.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". + In both cases, may be overridden by the command-line option "--wheelmouse". + + + +nobuttondistinction=yes + + Antes do Tux Paint 0.9.15, tamén se podían empregar os botóns medio e + dereito do rato para premer. Na versión 0.9.15, cambiouse para que só + funcionase o botón esquerdo do rato para non adestrar aos cativos a usar o + botón incorrecto. + + Porén, para os cativos que teñen problemas co rato, pódese desactivar esta + distinción entre os dous ou tres botóns do rato (devolvendo Tux Paint ao + seu antigo comportamento) usando esta opción. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobuttondistinction=no" or + "buttondistinction=yes". In both cases, may be overridden by the + command-line option "--buttondistinction". - Antes do Tux Paint 0.9.15, tamén se podían empregar os botóns - medio e dereito do rato para premer. Na versión 0.9.15, cambiouse - para que só funcionase o botón esquerdo do rato para non adestrar - aos cativos a usar o botón incorrecto. - Porén, para os cativos que teñen problemas co rato, pódese - desactivar esta distinción entre os dous ou tres botóns do rato - (devolvendo Tux Paint ao seu antigo comportamento) usando esta - opción. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". Simplificación - Interface Simplification +Interface Simplification - simpleshapes=yes +simpleshapes=yes - Desactive o paso de rotación da ferramenta «Forma». Prema, - arrastra e solte é todo o que se necesita para debuxar unha forma. + Desactive o paso de rotación da ferramenta «Forma». Prema, arrastra e solte + é todo o que se necesita para debuxar unha forma. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "simpleshapes=no" or "complexshapes= + yes". In both cases, may be overridden by the command-line option + "--complexshapes". - nooutlines=yes - Neste modo, amósanse contornos e liñas «elásticas» moito máis - sinxelas cando se usan as ferramentas Liñas, Formas, Selos e Goma. - Isto pode axudar cando Tux Paint se executa en computadores moi - lentos ou se amosa nunha pantalla remota de X-Window. +nooutlines=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nooutlines=no" - or "outlines=yes". In both cases, may be overridden by the - command-line option "--outlines". + Neste modo, amósanse contornos e liñas «elásticas» moito máis sinxelas + cando se usan as ferramentas Liñas, Formas, Selos e Goma. - uppercase=yes + Isto pode axudar cando Tux Paint se executa en computadores moi lentos ou + se amosa nunha pantalla remota de X-Window. - Todo o texto renderizarase só con maiúscula (por exemplo, «Pincel» - será «PINCEL»). Útil para os cativos que saben ler, pero que ata - agora só aprenderon maiúsculas. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nooutlines=no" or "outlines=yes". In + both cases, may be overridden by the command-line option "--outlines". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". - Tamaño inicial do selo - stampsize=TAMAÑO +uppercase=yes - Use esta opción para forzar a Tux Paint a estabelecer o tamaño - inicial de todos os selos. O valor TAMAÑO debería estar entre 0 - (máis pequeno) e 10 (máis grande). O tamaño é relativo aos tamaños - dispoñíbeis do selo, que depende do selo en si, e do tamaño actual - do lenzo de Tux Paint. + Todo o texto renderizarase só con maiúscula (por exemplo, «Pincel» será + «PINCEL»). Útil para os cativos que saben ler, pero que ata agora só + aprenderon maiúsculas. - Especifique «default» para que Tux Paint decida (o seu - comportamento estándar). + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "uppercase=no" or "mixedcase=yes". In + both cases, may be overridden by the command-line option "--mixedcase". - Control Simplification - noquit=yes - Desactivar o botón «Saír» na pantalla e evitar saír de Tux Paint - coa tecla [Escape]. - Usar a combinación de teclado [Alt] + [F4] ou premer no botón de - peche da xanela (asumindo que non está en modo de pantalla - completa) segue a funcionar para saír de Tux Paint. +Tamaño inicial do selo - Tamén pode usar a seguinte combinación de teclado para saír: - [Maiúsculas] + [Control] + [Escape]. +stampsize=TAMAÑO - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Use esta opción para forzar a Tux Paint a estabelecer o tamaño inicial de + todos os selos. O valor TAMAÑO debería estar entre 0 (máis pequeno) e 10 + (máis grande). O tamaño é relativo aos tamaños dispoñíbeis do selo, que + depende do selo en si, e do tamaño actual do lenzo de Tux Paint. - nostamps=yes + Especifique «default» para que Tux Paint decida (o seu comportamento + estándar). - Esta opción dille a Tux Paint que non cargue ningunha imaxe de - selo de caucho, o que á súa vez acaba desactivando a ferramenta - Selos. - Isto pode acelerar Tux Paint cando se carga por primeira vez e - reducir o uso de memoria mentres se está a executar. Por suposto, - ningún selo estará dispoñíbel. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" or - "stamps=yes". In both cases, may be overridden by the command-line - option "--stamps". - nostampcontrols=yes +Control Simplification - Algunhas imaxes da ferramenta Selos pódense reflectir, inverter - e/ou cambiar o seu tamaño. Esta opción desactiva os controis e só - fornece os selos básicos. +noquit=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be - overridden by the command-line option "--stampcontrols". + Desactivar o botón «Saír» na pantalla e evitar saír de Tux Paint coa tecla + [Escape]. - nostamprotation=yes + Usar a combinación de teclado [Alt] + [F4] ou premer no botón de peche da + xanela (asumindo que non está en modo de pantalla completa) segue a + funcionar para saír de Tux Paint. - This disables the rotation step of the Stamps tool, immediately - placing the stamp in its regular orientation (with any flipping or - mirroring applied) on the first click. + Tamén pode usar a seguinte combinación de teclado para saír: [Maiúsculas] + + [Control] + [Escape]. - 📜 Note: The stamp rotation feature was added to Tux Paint in - version 0.9.29. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noquit=no" or "quit=yes". In both + cases, may be overridden by the command-line option "--quit". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostamprotation=no" or "stamprotation=yes". In both cases, may be - overridden by the command-line option "--stamprotation". - nomagiccontrols=yes - Algunhas ferramentas de Maxia teñen a opción de actuar coma un - pincel ou afectar todo o lenzo á vez. Esta opción desactiva os - controis e só fornece a funcionalidade predeterminada (normalmente - en modo pintura). +nostamps=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be - overridden by the command-line option "--magiccontrols". + Esta opción dille a Tux Paint que non cargue ningunha imaxe de selo de + caucho, o que á súa vez acaba desactivando a ferramenta Selos. - nomagicsizes=yes + Isto pode acelerar Tux Paint cando se carga por primeira vez e reducir o + uso de memoria mentres se está a executar. Por suposto, ningún selo estará + dispoñíbel. - Some Magic tools offer various size settings. This option disables - the sizing control, and only provides the tools' default sizes. - (Some plugins may offer additional variations of a Magic tool, to - make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamps=no" or "stamps=yes". In both + cases, may be overridden by the command-line option "--stamps". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagicsizes=no" or "magicsizes=yes". In both cases, may be - overridden by the command-line option "--magicsizes". - noshapecontrols=yes - Desactivar os botóns de control que se amosan cando se usa a - ferramenta Formas que permiten cambiar como se debuxan as formas: - centradas arredor do clic inicial do rato ou cun canto co clic - inicial do rato. +nostampcontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be - overridden by the command-line option "--shapecontrols". + Algunhas imaxes da ferramenta Selos pódense reflectir, inverter e/ou + cambiar o seu tamaño. Esta opción desactiva os controis e só fornece os + selos básicos. - nolabel=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostampcontrols=no" or "stampcontrols= + yes". In both cases, may be overridden by the command-line option + "--stampcontrols". - Desactiva a ferramenta Etiqueta: a ferramenta que permite a - entrada de texto que se pode editar máis tarde. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" or - "label=yes". In both cases, may be overridden by the command-line - option "--label". - nobrushspacing=yes +nostamprotation=yes - Disables the brush spacing option of the Paint and Lines tools. - The brushes' default spacings will be used. + This disables the rotation step of the Stamps tool, immediately placing the + stamp in its regular orientation (with any flipping or mirroring applied) + on the first click. - 📜 Note: The brush spacing option was added to Tux Paint's user - interface in version 0.9.28. For more information on brush - spacing, see EXTENDING.html + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobrushspacing=no" or "brushspacing=yes". In both cases, may be - overridden by the command-line option "--brushspacing". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamprotation=no" or "stamprotation= + yes". In both cases, may be overridden by the command-line option + "--stamprotation". - notemplateexport=yes - Disables the ability to create a new Template image (based on a - saved drawing) from within the Open dialog. - 📜 Note: The Template creation feature was added to Tux Paint in - version 0.9.31. +nomagiccontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "notemplateexport=no" or "templateexport=yes". In both cases, may - be overridden by the command-line option "--templateexport". + Algunhas ferramentas de Maxia teñen a opción de actuar coma un pincel ou + afectar todo o lenzo á vez. Esta opción desactiva os controis e só fornece + a funcionalidade predeterminada (normalmente en modo pintura). - noerase=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagiccontrols=no" or "magiccontrols= + yes". In both cases, may be overridden by the command-line option + "--magiccontrols". + + + +nomagicsizes=yes + + Some Magic tools offer various size settings. This option disables the + sizing control, and only provides the tools' default sizes. (Some plugins + may offer additional variations of a Magic tool, to make a few sizes + possible, e.g. "Bricks" and "Googly Eyes".) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagicsizes=no" or "magicsizes=yes". + In both cases, may be overridden by the command-line option "--magicsizes". + + + +noshapecontrols=yes + + Desactivar os botóns de control que se amosan cando se usa a ferramenta + Formas que permiten cambiar como se debuxan as formas: centradas arredor do + clic inicial do rato ou cun canto co clic inicial do rato. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshapecontrols=no" or "shapecontrols= + yes". In both cases, may be overridden by the command-line option + "--shapecontrols". + + + +nolabel=yes + + Desactiva a ferramenta Etiqueta: a ferramenta que permite a entrada de + texto que se pode editar máis tarde. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nolabel=no" or "label=yes". In both + cases, may be overridden by the command-line option "--label". + + + +nobrushspacing=yes + + Disables the brush spacing option of the Paint and Lines tools. The + brushes' default spacings will be used. + + 📜 Note: The brush spacing option was added to Tux Paint's user interface in + version 0.9.28. For more information on brush spacing, see EXTENDING.html + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobrushspacing=no" or "brushspacing= + yes". In both cases, may be overridden by the command-line option + "--brushspacing". + + + +notemplateexport=yes + + Disables the ability to create a new Template image (based on a saved + drawing) from within the Open dialog. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "notemplateexport=no" or + "templateexport=yes". In both cases, may be overridden by the command-line + option "--templateexport". + + + +noerase=yes + + Disables the ability to erase saved drawings via the "Erase" button on the + Open dialog, or exported Template images (based on a saved drawing) via the + "Erase" button on the New dialog. Useful to prevent users from erasing + work, especially combined with the --saveovernew option. + + 📜 Note: This option was added to Tux Paint in version 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noerase=no" or "erase=yes". In both + cases, may be overridden by the command-line option "--erase". - Disables the ability to erase saved drawings via the "Erase" - button on the Open dialog, or exported Template images (based on a - saved drawing) via the "Erase" button on the New dialog. Useful to - prevent users from erasing work, especially combined with the - --saveovernew option. - 📜 Note: This option was added to Tux Paint in version 0.9.31. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noerase=no" or - "erase=yes". In both cases, may be overridden by the command-line - option "--erase". Languages - Language +Language - lang=IDIOMA +lang=IDIOMA - Run Tux Paint in one of the supported languages. Possible choices - for LANGUAGE currently include: + Run Tux Paint in one of the supported languages. Possible choices for + LANGUAGE currently include: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale IDIOMA - Execute Tux Paint nun dos idiomas compatíbeis. Vexa a sección - «Escoller un idioma diferente» a continuación para ver as cadeas - de configuración local (por exemplo, «de_DE» para o alemán) que - debe usar. - (Se a súa configuración local xa está configurada, por exemplo, - coa variábel de contorno «$LANG», esta opción non é necesaria, xa - que Tux Paint respecta a configuración do seu contorno, se é - posíbel). +--locale IDIOMA - mirrorstamps=yes + Execute Tux Paint nun dos idiomas compatíbeis. Vexa a sección «Escoller un + idioma diferente» a continuación para ver as cadeas de configuración local + (por exemplo, «de_DE» para o alemán) que debe usar. - Para os selos que se poden reflectir, esta opción estabeléceos de - xeito predeterminado na súa forma reflectida. + (Se a súa configuración local xa está configurada, por exemplo, coa + variábel de contorno «$LANG», esta opción non é necesaria, xa que Tux Paint + respecta a configuración do seu contorno, se é posíbel). - Isto pode ser útil para as persoas que prefiren as cousas de - dereita a esquerda no canto de de esquerda a dereita. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be - overridden by the command-line option "--dontmirrorstamps". - Tipos de letra +mirrorstamps=yes - sysfonts=yes + Para os selos que se poden reflectir, esta opción estabeléceos de xeito + predeterminado na súa forma reflectida. - Esta opción fai que Tux Paint tente cargar tipos de letra (para - usalos na ferramenta Texto) dende o seu sistema operativo. - Normalmente, Tux Paint só cargará os que foron incluídos con Tux - Paint. + Isto pode ser útil para as persoas que prefiren as cousas de dereita a + esquerda no canto de de esquerda a dereita. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" or - "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps= + yes". In both cases, may be overridden by the command-line option + "--dontmirrorstamps". - alllocalefonts=yes - Antes da versión 0.9.21, Tux Paint cargaba todos os tipos de letra - no seu propio directorio de tipos de letra, incluídos os - específicos da configuración local (por exemplo, o tibetano, que - non tiña caracteres latinos). A partir doa 0.9.21, o único tipo de - letra cargado dende o subdirectorio específico da configuración - local, se o hai, é o que coincide coa configuración local en que - se está a executar Tux Paint. - Para cargar todos os tipos de letra específicos das configuracións - locais (o comportamento antigo), configure esta opción. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may - be overridden by the command-line option "--currentlocalefont". +Tipos de letra + +sysfonts=yes + + Esta opción fai que Tux Paint tente cargar tipos de letra (para usalos na + ferramenta Texto) dende o seu sistema operativo. Normalmente, Tux Paint só + cargará os que foron incluídos con Tux Paint. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In + both cases, may be overridden by the command-line option "--nosysfonts". + + + +alllocalefonts=yes + + Antes da versión 0.9.21, Tux Paint cargaba todos os tipos de letra no seu + propio directorio de tipos de letra, incluídos os específicos da + configuración local (por exemplo, o tibetano, que non tiña caracteres + latinos). A partir doa 0.9.21, o único tipo de letra cargado dende o + subdirectorio específico da configuración local, se o hai, é o que coincide + coa configuración local en que se está a executar Tux Paint. + + Para cargar todos os tipos de letra específicos das configuracións locais + (o comportamento antigo), configure esta opción. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "alllocalefonts=no" or + "currentlocalefont=yes". In both cases, may be overridden by the + command-line option "--currentlocalefont". + + + +uifont=FONT NAME + + Esta opción fai que Tux Paint tente cargar tipos de letra (para usalos na + ferramenta Texto) dende o seu sistema operativo. Normalmente, Tux Paint só + cargará os que foron incluídos con Tux Paint. + + Specify "default" to let Tux Paint use its default font, "DejaVu Sans" (its + standard behavior). - uifont=FONT NAME - Esta opción fai que Tux Paint tente cargar tipos de letra (para - usalos na ferramenta Texto) dende o seu sistema operativo. - Normalmente, Tux Paint só cargará os que foron incluídos con Tux - Paint. - Specify "default" to let Tux Paint use its default font, "DejaVu - Sans" (its standard behavior). Impresión - Print Permissions +Print Permissions - noprint=yes +noprint=yes - Desactivar a función de impresión. + Desactivar a función de impresión. - printdelay=SEGUNDOS - Restrinxir a impresión para que só poida producirse unha vez cada - SEGUNDOS segundos. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printdelay=0". - In both cases, may be overridden by the command-line option - "--printdelay=0". +printdelay=SEGUNDOS - Show Printer Dialog + Restrinxir a impresión para que só poida producirse unha vez cada SEGUNDOS + segundos. - altprint=always + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "printdelay=0". In both cases, may be + overridden by the command-line option "--printdelay=0". - Isto fai que Tux Paint amose sempre o diálogo da impresora (ou, en - Linux/Unix, execute a orde «altprint») cando se preme no botón - «Imprimir». Noutras palabras, é como premer en «Imprimir» mentres - mantén premido [Alt], agás que non precisa manter premida [Alt] - cada vez. - altprint=never - Isto evita que Tux Paint nunca amose o diálogo da impresora (ou, - en Linux/Unix, execute «altprintcommand») cando se preme no botón - «Imprimir». Noutras palabras, fai que a tecla [Alt] non teña - efecto ao premer no botón «Imprimir». - altprint=mod +Show Printer Dialog - Este é o comportamento normal e predeterminado. Tux Paint amosa un - diálogo de impresora (ou, en Linux/Unix, executa a orde - «altprint»), cando se preme a tecla [Alt] mentres se preme no - botón «Imprimir». Premer en «Imprimir» sen manter premida [Alt] - imprime sen amosar un diálogo. +altprint=always - Save Printer Configuration + Isto fai que Tux Paint amose sempre o diálogo da impresora (ou, en Linux/ + Unix, execute a orde «altprint») cando se preme no botón «Imprimir». + Noutras palabras, é como premer en «Imprimir» mentres mantén premido [Alt], + agás que non precisa manter premida [Alt] cada vez. - printcfg=yes - (Só Windows e macOS) - Tux Paint empregará un ficheiro de configuración da impresora - cando imprima. Prema a tecla [Alt] mentres fai clic no botón - «Imprimir» en Tux Paint para que apareza unha xanela de diálogo - de impresión de Windows. +altprint=never - Any configuration changes made in this dialog will be saved to - the file "userdata/print.cfg" , and used again, as long as the - "printcfg" option is set. + Isto evita que Tux Paint nunca amose o diálogo da impresora (ou, en Linux/ + Unix, execute «altprintcommand») cando se preme no botón «Imprimir». + Noutras palabras, fai que a tecla [Alt] non teña efecto ao premer no botón + «Imprimir». - 💡 Note: This only works when not running Tux Paint in fullscreen - mode. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". - Print Commands +altprint=mod - printcommand=ORDE + Este é o comportamento normal e predeterminado. Tux Paint amosa un diálogo + de impresora (ou, en Linux/Unix, executa a orde «altprint»), cando se preme + a tecla [Alt] mentres se preme no botón «Imprimir». Premer en «Imprimir» + sen manter premida [Alt] imprime sen amosar un diálogo. - (Só Linux e Unix) - Use a orde ORDE para imprimir un ficheiro en formato PostScript - cando se preme no botón «Imprimir». Se esta opción non está - especificamente definida, a orde predeterminada é: - lpr - 📜 Nota: As versións de Tux Paint anteriores ao 0.9.15 enviaban - datos en formato PNG á orde de impresión (de xeito - predeterminado era «pngtopnm | pnmtops | lpr»). +Save Printer Configuration - Se estabeleceu unha alternativa printcommand no ficheiro de - configuración antes da versión 0.9.15, terá que cambiala. + printcfg=yes - altprintcommand=ORDE + (Só Windows e macOS) - (Só Linux e Unix) + Tux Paint empregará un ficheiro de configuración da impresora cando + imprima. Prema a tecla [Alt] mentres fai clic no botón «Imprimir» en + Tux Paint para que apareza unha xanela de diálogo de impresión de + Windows. - Use a orde ORDE para imprimir un ficheiro en formato PostScript - cando se preme no botón «Imprimir» mentres se mantén premida a - tecla modificadora [Alt]. (Iso utilizase normalmente para - fornecer un diálogo de impresión, semellante a cando se preme - [Alt]+«Imprimir» en Windows e macOS.) + Any configuration changes made in this dialog will be saved to the file + "userdata/print.cfg" , and used again, as long as the "printcfg" option + is set. - Se esta opción non está especificamente definida, a orde - predeterminada é o diálogo gráfico de impresión de KDE: + 💡 Note: This only works when not running Tux Paint in fullscreen mode. - kprinter + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "printcfg=no" or "noprintcfg= + yes". In both cases, may be overridden by the command-line option + "--noprintcfg". - Paper Size - papersize=TAMAÑO_DO_PAPEL - (Plataformas que usan o xerador interno PostScript de Tux Paint; - non Windows, macOS, BeOS ou Haiku). - Indica a Tux Paint que tamaño de PostScript debe xerar. Se non - se especifica ningún, Tux Paint comproba primeiro a súa variábel - de contorno $PAPER, após o ficheiro /etc/papersize e após usa o - tamaño de papel predeterminado da biblioteca «libpaper». + Print Commands - Os tamaños de papel válidos inclúen: letter, legal, tabloid, - executive, note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, - a9, a10, b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, - halfexecutive, halfnote, folio, quarto, ledger, archA, archB, - archC, archD, archE, flsa, flse, csheet, dsheet, esheet. + printcommand=ORDE -Gardar + (Só Linux e Unix) - Save Over Earlier Work + Use a orde ORDE para imprimir un ficheiro en formato PostScript cando + se preme no botón «Imprimir». Se esta opción non está especificamente + definida, a orde predeterminada é: - saveover=yes + lpr - Isto desactiva a pregunta «Gardar sobre a versión antiga...?» ao - gardar un ficheiro existente. Con esta opción, a versión - anterior sempre será substituída pola nova versión - automaticamente. + 📜 Nota: As versións de Tux Paint anteriores ao 0.9.15 enviaban datos en + formato PNG á orde de impresión (de xeito predeterminado era «pngtopnm + | pnmtops | lpr»). - saveover=new + Se estabeleceu unha alternativa printcommand no ficheiro de + configuración antes da versión 0.9.15, terá que cambiala. - Isto tamén desactiva a pregunta «Gardar sobre a versión - antiga...?» cando garda un ficheiro existente. Non obstante, - esta opción sempre gardará un novo ficheiro no canto de - sobrescribir a versión anterior. - saveover=ask - (Esta opción é redundante, xa que esta é a opción - predeterminada.) Ao gardar un debuxo existente, primeiro - preguntaráselle se quere gardar sobre a versión anterior ou non. + altprintcommand=ORDE - Starting Out + (Só Linux e Unix) - startblank=yes + Use a orde ORDE para imprimir un ficheiro en formato PostScript cando + se preme no botón «Imprimir» mentres se mantén premida a tecla + modificadora [Alt]. (Iso utilizase normalmente para fornecer un diálogo + de impresión, semellante a cando se preme [Alt]+«Imprimir» en Windows e + macOS.) - Isto fai que Tux Paint amose un lenzo en branco cando se inicia - por vez primeira, no canto de cargar a última imaxe que se - estaba a editar. + Se esta opción non está especificamente definida, a orde predeterminada + é o diálogo gráfico de impresión de KDE: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". + kprinter - newcolorslast=yes - Coloca as opcións de cor en branco no diálogo Novo ao final, de - xeito que se amosen primeiro os iniciadores e/ou modelos. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". - Save and Export Directories + Paper Size - savedir=DIRECTORIO + papersize=TAMAÑO_DO_PAPEL - Use esta opción para cambiar onde se atopa o directorio/cartafol - «saved» de Tux Paint, que é onde Tux Paint garda e abre imaxes. + (Plataformas que usan o xerador interno PostScript de Tux Paint; non + Windows, macOS, BeOS ou Haiku). - Se non o anula, a ubicación predeterminada é: + Indica a Tux Paint que tamaño de PostScript debe xerar. Se non se + especifica ningún, Tux Paint comproba primeiro a súa variábel de + contorno $PAPER, após o ficheiro /etc/papersize e após usa o tamaño de + papel predeterminado da biblioteca «libpaper». - * Linux e Unix: baixo un directorio agochado chamado - «.tuxpaint» no seu directorio persoal (tamén coñecido como - «~» ou «$HOME») - Exemplo: /home/username/.tuxpaint/saved/ - * Windows: Dentro un cartafol chamado «TuxPaint» no seu - cartafol «Application Data». - Exemplo: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS: Dentro un cartafol chamado «TuxPaint» no seu - cartafol «Application Support». - Exemplo: /Users/Username/Library/Application - Support/TuxPaint/saved/ + Os tamaños de papel válidos inclúen: letter, legal, tabloid, executive, + note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, + b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, + quarto, ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, + dsheet, esheet. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - 📜 Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - Exemplo: savedir=Z:\tuxpaint\ - exportdir=DIRECTORIO + Gardar - Use esta opción para cambiar onde Tux Paint exporta ficheiros - —imaxes individuais ou diaporamasositivas GIF animadas— uso - externo. + Save Over Earlier Work - Se non o anula, a ubicación predeterminada é: + saveover=yes - * Linux e Unix: se está dispoñíbel, onde queira que o seu - contorno de escritorio estea configurado para que se - almacenen imaxes, en función da configuración XDG (X - Desktop Group). (Probe a executar a liña de ordes - «xdg-user-dir PICTURES» para descubrilo.) - Normalmente (na configuración local inglesa), este será un - subdirectorio «Imaxes» no seu directorio persoal (é dicir, - «$HOME/Imaxes» tamén coñecido como «~/Imaxes»). - Tux Paint volverá usar ese directorio habitual, se non se - pode ler a configuración XDG, ou non se estabelece nada - «XDG_PICTURES_DIR». - * Windows: Directorio «As miñas imaxes» para cada usuario - (normalmente «c:\Users\NOME_DE_USUARIO\Pictures»). - Pode abrir directamente o cartafol do seguinte xeito: - * Prema a tecla «[Windows]+[R]» para abrir o diálogo - «Executar...». - * Escriba «Shell: As miñas imaxes« na caixa de texto e - prema en [Aceptar.] - * macOS — TBD! + Isto desactiva a pregunta «Gardar sobre a versión antiga...?» ao gardar + un ficheiro existente. Con esta opción, a versión anterior sempre será + substituída pola nova versión automaticamente. - 💡 Note: When the defaults are used, a new "TuxPaint" - subdirectory will be created and used. (e.g., - "~/Imaxes/TuxPaint") When the "--exportdir" option is used, the - exact path specified will be used (no "TuxPaint" subdirectory is - created). - - O directorio en si (p. ex.: «~/Imaxes/TuxPaint») crearase, se - non existe. - Se o directorio pai (por exemplo, «~/Imaxes/TuxPaint») tampouco - existe, Tux Paint tentará crealo tamén (pero non ningún - directorio superior a ese). - Exemplo: exportdir=/home/penguin/TuxPaintExports + saveover=new - More Saving Options + Isto tamén desactiva a pregunta «Gardar sobre a versión antiga...?» + cando garda un ficheiro existente. Non obstante, esta opción sempre + gardará un novo ficheiro no canto de sobrescribir a versión anterior. - nosave=yes - Isto desactiva a capacidade de Tux Paint para gardar ficheiros - (e, polo tanto, desactiva o botón «Gardar» na pantalla). Pode - usarse en situacións nas que o programa só se usa para - divertirse ou nun contorno de proba. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". + saveover=ask - autosave=yes + (Esta opción é redundante, xa que esta é a opción predeterminada.) Ao + gardar un debuxo existente, primeiro preguntaráselle se quere gardar + sobre a versión anterior ou non. - Isto impide a Tux Paint preguntar se quere gardar a imaxe actual - ao saír e supón que si. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - reversesort=yes - - This reverses the sorting of the Open and Slideshow dialogs, - placing the newest images at the top of the list. - - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "reversesort=no" or "noreversesort=yes". In both cases, may be - overridden by the command-line option "--noreversesort". - -Data - - Lockfile - nolockfile=yes + Starting Out - De xeito predeterminado, Tux Paint usa o que se coñece como - «ficheiro de bloqueo» para evitar que se inicie máis dunha vez - en 30 segundos. (Isto é para evitar executar accidentalmente - varias copias; por exemplo, premendo dúas veces nun iniciador - dun só clic ou simplemente premendo impacientemente na icona - varias veces.) + startblank=yes - Para facer que Tux Paint ignore o ficheiro de bloqueo, - permitindo que se execute de novo, aínda que se lanzase hai - menos de 30 segundos, active este axuste no ficheiro de - configuración ou execute Tux Paint coa opción --nolockfile na - liña de ordes. + Isto fai que Tux Paint amose un lenzo en branco cando se inicia por vez + primeira, no canto de cargar a última imaxe que se estaba a editar. - De xeito predeterminado, o ficheiro de bloqueo almacénase en - «~/.tuxpaint/» en Linux e Unix e en «userdata\» en Windows. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "startblank=no" or "startlast= + yes". In both cases, may be overridden by the command-line option + "--startlast". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". - - Data Directory - - datadir=DIRECTORIO - - Use esta opción para cambiar onde Tux Paint busca ficheiros de - datos persoais (pinceis, selos, imaxes de comezo, modelos e - tipos de letra específicos do usuario actual). - - Tux Paint buscará subdirectorios/subcartafoles chamados - «brushes», «stamps», «starters», «templates», «fonts» no - directorio de datos especificado. - - Se non o anula, a ubicación predeterminada é: - - * Linux e Unix: baixo un directorio agochado chamado - «.tuxpaint» no seu directorio persoal (tamén coñecido como - «~» ou «$HOME») - Exemplo: /home/username/.tuxpaint/brushes/ - * Windows: Dentro un cartafol chamado «TuxPaint» no seu - cartafol «Application Data». - Exemplo: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS: Dentro un cartafol chamado «TuxPaint» no seu - cartafol «Application Support». - Exemplo: /Users/Username/Library/Application - Support/TuxPaint/brushes/ - 📜 Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. + newcolorslast=yes - Exemplo: datadir=/home/johnny/tuxpaint-data/ + Coloca as opcións de cor en branco no diálogo Novo ao final, de xeito + que se amosen primeiro os iniciadores e/ou modelos. - Color Palette File + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "newcolorslast=no" or + "newcolorsfirst=yes". In both cases, may be overridden by the + command-line option "--newcolorsfirst". - colorfile=NOME_DE_FICHEIRO - Pode anular a paleta de cores predeterminada de Tux Paint - creando un ficheiro de texto ASCII simple que describa as cores - que quere e apuntando a ese ficheiro usando a opción - «colorfile». - O ficheiro debería incluír unha cor por liña. As cores defínense - en función dos seus valores vermello, verde e azul, cada un de 0 - (apagado) a 255 (máis brillante). (Para obter máis información, - vexa o artigo «Modelo de cor RGB (en inglés) de Wikipedia). - - As cores pódense enumerar usando tres números decimais (por - exemplo, «255 68 136») ou un «triplete» hexadecimal de 6 ou 3 - díxitos de longo (por exemplo, «#ff4488» ou «#F48»). - - Após a definición da cor (na mesma liña) pode introducir texto - para describir a cor. Tux amosará este texto cando se prema na - cor. (Por exemplo, «#FFF Branco coma a neve.») - - Como exemplo, pode ver as cores predeterminadas empregadas - actualmente en Tux Paint en: «default_colors.txt». - NOTAS: Debe separar os valores decimais con espazos e comezar os - valores hexadecimais cun carácter de libra/signo de númeral - («#»). En hexadecimais de 3 díxitos, cada díxito úsase tanto - para a metade alta como para a baixa do byte, polo que «#FFF» é - o mesmo que «#FFFFFF» e non que «#F0F0F0». + Save and Export Directories -Accessibility + savedir=DIRECTORIO - Mouse + Use esta opción para cambiar onde se atopa o directorio/cartafol + «saved» de Tux Paint, que é onde Tux Paint garda e abre imaxes. - mouse-accessibility=yes + Se non o anula, a ubicación predeterminada é: - Neste modo, no canto de premer, arrastrar e soltar (por exemplo, - para debuxar), premese, móvese e premese de novo para rematar o - movemento. + o Linux e Unix: baixo un directorio agochado chamado «.tuxpaint» no + seu directorio persoal (tamén coñecido como «~» ou «$HOME») + Exemplo: /home/username/.tuxpaint/saved/ + o Windows: Dentro un cartafol chamado «TuxPaint» no seu cartafol + «Application Data». + Exemplo: C:\Documents and Settings\Username\Application Data\ + TuxPaint\saved\ + o macOS: Dentro un cartafol chamado «TuxPaint» no seu cartafol + «Application Support». + Exemplo: /Users/Username/Library/Application Support/TuxPaint/saved + / - Keyboard + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - keyboard=yes + 📜 Note: Prior to version 0.9.18, Tux Paint would also use the setting + or default for "savedir" as the place to search for personal data files + (brushes, stamps, starters and fonts). As of version 0.9.18, they may + be specified separately (see the "datadir" option, below). - Isto permite empregar as teclas de frecha do teclado para - controlar o punteiro do rato. (por exemplo, para contornos sen - rato ou persoas con discapacidade ou problemas de - accesibilidade) + Exemplo: savedir=Z:\tuxpaint\ - Funcionalidades: - * Movemento fino dentro do lenzo ou movemento groseiro se se - mantén premida Shift. - * Movemento groseiro dentro das áreas dos botóns da - ferramenta. - * Principais controis: - * [Left]/[Right]/[Up]/[Down], teclado numérico [1] ata - [9]: mover o rato - * [Space]/[5]: premer co rato (agás cando se empregan as - ferramentas de «Texto» ou de «Etiqueta») - * [Insert]/[F5]: premer co rato (sempre) - * [F4] fai saltar o rato entre as «Ferramentas», «Cores» - e as áreas do lenzo - * Se o rato está dentro da sección «Ferramentas» á - esquerda ou na sección «Cores» na parte inferior: - * [F7]/[F8]: mover cara abaixo/arriba entre os - botóns, respectivamente (só sección de - ferramentas) - * [F11]/[F12]: mover ao botón anterior/seguinte, - respectivamente - * Para premer e arrastrar, manteña premida unha das teclas de - «clic» (p. ex.: [Insert]) e use as teclas de movemento (p. - ex.: [Left]). - 💡 Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a 'click' - key to start clicking, movement keys to move around (which - will draw), and another 'click' key to end the click (stop - drawing). + exportdir=DIRECTORIO - * Aínda se pode usar un rato e/ou unha panca de mando - (joystick) normais (para que poida, por exemplo, moverse co - rato e premer co teclado ou viceversa) + Use esta opción para cambiar onde Tux Paint exporta ficheiros —imaxes + individuais ou diaporamasositivas GIF animadas— uso externo. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "mouse=yes". In both cases, may be overridden by the - command-line option "--mouse". + Se non o anula, a ubicación predeterminada é: - Onscreen Keyboard + o Linux e Unix: se está dispoñíbel, onde queira que o seu contorno de + escritorio estea configurado para que se almacenen imaxes, en + función da configuración XDG (X Desktop Group). (Probe a executar a + liña de ordes «xdg-user-dir PICTURES» para descubrilo.) + Normalmente (na configuración local inglesa), este será un + subdirectorio «Imaxes» no seu directorio persoal (é dicir, «$HOME/ + Imaxes» tamén coñecido como «~/Imaxes»). + Tux Paint volverá usar ese directorio habitual, se non se pode ler + a configuración XDG, ou non se estabelece nada «XDG_PICTURES_DIR». + o Windows: Directorio «As miñas imaxes» para cada usuario + (normalmente «c:\Users\NOME_DE_USUARIO\Pictures»). + Pode abrir directamente o cartafol do seguinte xeito: + # Prema a tecla «[Windows]+[R]» para abrir o diálogo + «Executar...». + # Escriba «Shell: As miñas imaxes« na caixa de texto e prema en + [Aceptar.] + o macOS — TBD! - onscreen-keyboard=yes + 💡 Note: When the defaults are used, a new "TuxPaint" subdirectory will + be created and used. (e.g., "~/Imaxes/TuxPaint") When the "--exportdir" + option is used, the exact path specified will be used (no "TuxPaint" + subdirectory is created). - Presenta un teclado en pantalla sobre que se pode premer cando - empregan as ferramentas Texto e Etiqueta. + O directorio en si (p. ex.: «~/Imaxes/TuxPaint») crearase, se non + existe. - onscreen-keyboard-layout=NOME DA DISPOSICIÓN + Se o directorio pai (por exemplo, «~/Imaxes/TuxPaint») tampouco existe, + Tux Paint tentará crealo tamén (pero non ningún directorio superior a + ese). - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Nota: Usar esta opción implica automaticamente - onscreen-keyboard=yes, polo que estabelecer ambas as cousas é - redundante. + Exemplo: exportdir=/home/penguin/TuxPaintExports - onscreen-keyboard-disable-change=yes - Desactiva a posibilidade de cambiar o deseño do teclado en - pantalla cando se usan as ferramentas Texto e Etiqueta, útil - para simplificar as cousas para os máis pequechos. - Nota: Usar esta opción implica automaticamente - onscreen-keyboard=yes, polo que estabelecer ambas as cousas é - redundante. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". -Joystick + More Saving Options - Main Device + nosave=yes - joystick-dev=N + Isto desactiva a capacidade de Tux Paint para gardar ficheiros (e, polo + tanto, desactiva o botón «Gardar» na pantalla). Pode usarse en + situacións nas que o programa só se usa para divertirse ou nun contorno + de proba. - Especifica que dispositivo de mando debe ser usado por Tux - Paint. O valor predeterminado é 0 (a primeira panca de mando — - joystick). + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nosave=no" or "save=yes". In + both cases, may be overridden by the command-line option "--save". - joystick-slowness=VELOCIDADE - Estabelece un atraso en cada movemento do eixo, permitindo - atrasar a panca de mando (joystick). Os valores permitidos van - de 0 a 500. O valor predeterminado é 15. - joystick-threshold=LIMIAR + autosave=yes - Estabelece o nivel mínimo de movemento do eixe para comezar a - mover o punteiro. Os valores permitidos son de 0 a 32766. O - valor predeterminado é 3200. + Isto impide a Tux Paint preguntar se quere gardar a imaxe actual ao + saír e supón que si. - joystick-maxsteps=PASOS + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "autosave=no" or "noautosave= + yes". In both cases, may be overridden by the command-line option + "--noautosave". - Define os píxeles máximos que moverá o punteiro á vez. Os - valores permitidos van do 1 ao 7. O valor predeterminado é 7. - Hat - joystick-hat-slowness=VELOCIDADE + reversesort=yes - Estabelece un atraso en cada movemento automático, o que permite - diminuír a velocidade do sombreiro. Os valores permitidos van de - 0 a 500. O valor predeterminado é 15. + This reverses the sorting of the Open and Slideshow dialogs, placing + the newest images at the top of the list. - joystick-hat-timeout=MILISEGUNDOS + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "reversesort=no" or + "noreversesort=yes". In both cases, may be overridden by the + command-line option "--noreversesort". - Estabelece o atraso após de que o punteiro comezará a moverse - automaticamente se se mantén premido o sombreiro. Os valores - permitidos van de 0 a 3000. O valor predeterminado é 1000. - Buttons to Disable - joystick-buttons-ignore=BOTÓN1,BOTÓN2,... - Un conxunto de números de botóns do mando (joystick), como se ve - en SDL, que deben ignorarse. Se non, a menos que sexan - utilizados por unha das opcións «joystick-btn-» anteriores, os - botóns veranse como un botón esquerdo do rato. + Data - Button Shortcuts + Lockfile - joystick-btn-escape=NÚMERO DE BOTÓN + nolockfile=yes - Selecciona o número do botón da panca de control (joystick), tal - e como o ve SDL, que se usará para xerar un evento de escape. - Útil para desactivar os diálogos e saír. + De xeito predeterminado, Tux Paint usa o que se coñece como «ficheiro + de bloqueo» para evitar que se inicie máis dunha vez en 30 segundos. + (Isto é para evitar executar accidentalmente varias copias; por + exemplo, premendo dúas veces nun iniciador dun só clic ou simplemente + premendo impacientemente na icona varias veces.) - joystick-btn-brush=NÚMERO DE BOTÓN + Para facer que Tux Paint ignore o ficheiro de bloqueo, permitindo que + se execute de novo, aínda que se lanzase hai menos de 30 segundos, + active este axuste no ficheiro de configuración ou execute Tux Paint + coa opción --nolockfile na liña de ordes. - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de pinceis. + De xeito predeterminado, o ficheiro de bloqueo almacénase en «~ + /.tuxpaint/» en Linux e Unix e en «userdata\» en Windows. - joystick-btn-stamp=NÚMERO DE BOTÓN + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nolockfile=no" or "lockfile= + yes". In both cases, may be overridden by the command-line option + "--lockfile". - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de selos. - joystick-btn-lines=NÚMERO DE BOTÓN - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de liñas. - joystick-btn-shapes=NÚMERO DE BOTÓN + Data Directory - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de formas. + datadir=DIRECTORIO - joystick-btn-text=NÚMERO DE BOTÓN + Use esta opción para cambiar onde Tux Paint busca ficheiros de datos + persoais (pinceis, selos, imaxes de comezo, modelos e tipos de letra + específicos do usuario actual). - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de texto. + Tux Paint buscará subdirectorios/subcartafoles chamados «brushes», + «stamps», «starters», «templates», «fonts» no directorio de datos + especificado. - joystick-btn-label=NÚMERO DE BOTÓN + Se non o anula, a ubicación predeterminada é: - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de etiquetas. + o Linux e Unix: baixo un directorio agochado chamado «.tuxpaint» no + seu directorio persoal (tamén coñecido como «~» ou «$HOME») + Exemplo: /home/username/.tuxpaint/brushes/ + o Windows: Dentro un cartafol chamado «TuxPaint» no seu cartafol + «Application Data». + Exemplo: C:\Documents and Settings\Username\Application Data\ + TuxPaint\brushes\ + o macOS: Dentro un cartafol chamado «TuxPaint» no seu cartafol + «Application Support». + Exemplo: /Users/Username/Library/Application Support/TuxPaint/ + brushes/ - joystick-btn-fill=NÚMERO DE BOTÓN + 📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting + or default as for "savedir" to search for data files. As of version + 0.9.18, they may be specified separately. - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a select the fill tool. + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - joystick-btn-magic=NÚMERO DE BOTÓN + Exemplo: datadir=/home/johnny/tuxpaint-data/ - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a seleccionar a ferramenta de máxia. - joystick-btn-undo=NÚMERO DE BOTÓN - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a invocar a ferramenta de desfacer. - joystick-btn-redo=NÚMERO DE BOTÓN + Color Palette File - Selecciona o número do botón da panca de mando (joystick), tal e - como o ve SDL, que será un atallo para seleccionar ferramenta de - refacer. + colorfile=NOME_DE_FICHEIRO - joystick-btn-eraser=NÚMERO DE BOTÓN + Pode anular a paleta de cores predeterminada de Tux Paint creando un + ficheiro de texto ASCII simple que describa as cores que quere e + apuntando a ese ficheiro usando a opción «colorfile». - Selecciona o número do botón da panca de mando (joystick), tal e - como o ve SDL, que será un atallo para seleccionar ferramenta de - goma de borrar. + O ficheiro debería incluír unha cor por liña. As cores defínense en + función dos seus valores vermello, verde e azul, cada un de 0 (apagado) + a 255 (máis brillante). (Para obter máis información, vexa o artigo « + Modelo de cor RGB (en inglés) de Wikipedia). - joystick-btn-new=NÚMERO DE BOTÓN + As cores pódense enumerar usando tres números decimais (por exemplo, + «255 68 136») ou un «triplete» hexadecimal de 6 ou 3 díxitos de longo + (por exemplo, «#ff4488» ou «#F48»). - Selecciona o número do botón da panca de mando (joystick), como - o ve SDL, que será un atallo para iniciar o diálogo para crear - un novo debuxo. + Após a definición da cor (na mesma liña) pode introducir texto para + describir a cor. Tux amosará este texto cando se prema na cor. (Por + exemplo, «#FFF Branco coma a neve.») - joystick-btn-open=NÚMERO DE BOTÓN + Como exemplo, pode ver as cores predeterminadas empregadas actualmente + en Tux Paint en: «default_colors.txt». - Selecciona o número do botón da panca de mando (joystick), como - o ve SDL, que será un atallo para iniciar o diálogo para abrir - un debuxo existente. + NOTAS: Debe separar os valores decimais con espazos e comezar os + valores hexadecimais cun carácter de libra/signo de númeral («#»). En + hexadecimais de 3 díxitos, cada díxito úsase tanto para a metade alta + como para a baixa do byte, polo que «#FFF» é o mesmo que «#FFFFFF» e + non que «#F0F0F0». - joystick-btn-save=NÚMERO DE BOTÓN - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a garda o debuxo. - joystick-btn-pgsetup=NÚMERO DE BOTÓN - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a inicia o diálogo de configuración da páxina - para imprimir. - - joystick-btn-print=NÚMERO DE BOTÓN - - Selecciona o número do botón do joystick, como o ve SDL, que - será un atallo a imprimir. - - Anulación da configuración do sistema. Opcións - - (Para usuarios de Linux e Unix) - - Se algunha das opcións anteriores está estabelecida en - «/etc/tuxpaint/tuxpaint.config», pode anulala no seu propio ficheiro - «~/.tuxpaintrc». - - Para opcións verdadeiro/falso, como «noprint» e «grab», pode simplemente - dicir que son iguais a «no» no seu ficheiro «~/.tuxpaintrc»: - - noprint=no - uppercase=no - - Ou pode usar opcións semellantes ás opcións de anulación da liña de - ordes que se describen a continuación. Por exemplo: - - print=yes - mixedcase=yes - - Opcións da liña de ordes - - Options may also be issued on the command-line when you go to launch Tux - Paint. - - --fullscreen - --LARGOxALTO - --buttonsize=TAMAÑO - --colorsrows=FILAS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SEGUNDOS - --printcfg - --altprintnever - --altprintalways - --papersize=TAMAÑO_DO_PAPEL - --printcommand=ORDE - --altprintcommand=ORDE - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=TAMAÑO - --keyboard - --savedir DIRECTORIO - --datadir DIRECTORIO - --exportdir DIRECTORIO - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang IDIOMA - --colorfile FICHEIRO - - Estas activan ou corresponden ás opcións do ficheiro de - configuración descritas anteriormente. - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - Estas opcións pódense usar para anular calquera axuste feito no - ficheiro de configuración. (Se a opción non está configurada - no(s) ficheiro(s) de configuración, non será necesaria ningunha - opción de anulación.) - - --nosysconfig - - En Linux e Unix, isto evita ler o ficheiro de configuración de - todo o sistema, «/etc/tuxpaint/tuxpaint.conf». - - Só se empregará o seu propio ficheiro de configuración, - «~/.tuxpaintrc», se existe. - -Opcións informativas da liña de ordes - - As seguintes opcións amosan un texto informativo na pantalla. Non - obstante, Tux Paint non se inicia nin se executa despois. - - --version - --verbose-version - - Amosa o número de versión e a data da copia de Tux Paint que - está a executar. O «--verbose-version» tamén lista as opcións de - tempo de compilación definidas. (Vexa INSTALL [INSTALAR] e FAQ - [Preguntas frecuentes] ). - - --copying - - Amosa información breve sobre a licenza para copiar Tux Paint. - - --usage - - Amosa a lista de opcións de liña de ordes dispoñíbeis. - - --help - - Amosa unha breve axuda sobre o uso de Tux Paint. - - --lang help - - Amosa unha lista de idiomas dispoñíbeis en Tux Paint. - - --joystick-dev list - - Amosa a lista de pancas de mando (joysticks) conectados - dispoñíbeis para Tux Paint. - - Escoller un idioma diferente - - Tux Paint foi traducido a varios idiomas. Para acceder ás traducións, - pode usar a opción «--lang» na liña de ordes para estabelecer o idioma - (por exemplo, «--lang spanish») ou usar o axuste «lang=» no ficheiro de - configuración (p. ex.: «lang=spanish»). - - Tux Paint tamén respecta o contorno local actual. (Pode anulalo na liña - de ordes usando a opción «--locale»; vexa consulta arriba). - - Use the option "--lang help" to list the language options available. - -Idiomas dispoñíbeis - - +----------------------------------------------------------------------+ - | | | |Combinación de | - |Código do idioma|Idioma |Idioma |teclas de ciclo| - | |(nome nativo) |(nome en inglés) |de método de | - | | | |entrada | - |----------------+-------------------+-----------------+---------------| - |C | |English | | - |----------------+-------------------+-----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+-------------------+-----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+-------------------+-----------------+---------------| - |ak_GH | |Akan | | - |----------------+-------------------+-----------------+---------------| - |am_ET | |Amharic | | - |----------------+-------------------+-----------------+---------------| - |an_ES | |Aragones | | - |----------------+-------------------+-----------------+---------------| - |ar_SA | |Arabic | | - |----------------+-------------------+-----------------+---------------| - |as_IN | |Assamese | | - |----------------+-------------------+-----------------+---------------| - |ast_ES | |Asturian | | - |----------------+-------------------+-----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+-------------------+-----------------+---------------| - |bm_ML | |Bambara | | - |----------------+-------------------+-----------------+---------------| - |bn_IN | |Bengali | | - |----------------+-------------------+-----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+-------------------+-----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+-------------------+-----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+-------------------+-----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+-------------------+-----------------+---------------| - |brx_IN | |Bodo | | - |----------------+-------------------+-----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+-------------------+-----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+-------------------+-----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+-------------------+-----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+-------------------+-----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+-------------------+-----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+-------------------+-----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+-------------------+-----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+-------------------+-----------------+---------------| - |doi_IN | |Dogri | | - |----------------+-------------------+-----------------+---------------| - |et_EE | |Estonian | | - |----------------+-------------------+-----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+-------------------+-----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |en_CA | |Canadian English | | - |----------------+-------------------+-----------------+---------------| - |en_GB | |British English | | - |----------------+-------------------+-----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |eo | |Esperanto | | - |----------------+-------------------+-----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+-------------------+-----------------+---------------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+-------------------+-----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+-------------------+-----------------+---------------| - |fa_IR | |Persian | | - |----------------+-------------------+-----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+-------------------+-----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+-------------------+-----------------+---------------| - |fo_FO | |Faroese | | - |----------------+-------------------+-----------------+---------------| - |fr_FR |Français |French | | - |----------------+-------------------+-----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+-------------------+-----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+-------------------+-----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+-------------------+-----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+-------------------+-----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+-------------------+-----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+-------------------+-----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+-------------------+-----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+-------------------+-----------------+---------------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+-------------------+-----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+-------------------+-----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+-------------------+-----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+-------------------+-----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |ka_GE | |Georgian | | - |----------------+-------------------+-----------------+---------------| - |kab | |Kabyle | | - |----------------+-------------------+-----------------+---------------| - |km_KH | |Khmer | | - |----------------+-------------------+-----------------+---------------| - |kn_IN | |Kannada | | - |----------------+-------------------+-----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+-------------------+-----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+-------------------+-----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+-------------------+-----------------+---------------| - |lg_UG | |Luganda | | - |----------------+-------------------+-----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+-------------------+-----------------+---------------| - |lv_LV | |Latvian | | - |----------------+-------------------+-----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+-------------------+-----------------+---------------| - |mai_IN | |Maithili | | - |----------------+-------------------+-----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+-------------------+-----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+-------------------+-----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+-------------------+-----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+-------------------+-----------------+---------------| - |mr_IN | |Marathi | | - |----------------+-------------------+-----------------+---------------| - |ms_MY | |Malay | | - |----------------+-------------------+-----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+-------------------+-----------------+---------------| - |ne_NP |Nepali | | | - |----------------+-------------------+-----------------+---------------| - |nl_NL | |Dutch | | - |----------------+-------------------+-----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk| | - |----------------+-------------------+-----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+-------------------+-----------------+---------------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+-------------------+-----------------+---------------| - |oc_FR | |Occitan | | - |----------------+-------------------+-----------------+---------------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+-------------------+-----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+-------------------+-----------------+---------------| - |or_IN |Odia |Oriya | | - |----------------+-------------------+-----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+-------------------+-----------------+---------------| - |pt_BR |Portugês Brazileiro|Brazilian | | - | | |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |ro_RO | |Romanian | | - |----------------+-------------------+-----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+-------------------+-----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+-------------------+-----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+-------------------+-----------------+---------------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+-------------------+-----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+-------------------+-----------------+---------------| - |si_LK | |Sinhala | | - |----------------+-------------------+-----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+-------------------+-----------------+---------------| - |sk_SK | |Slovak | | - |----------------+-------------------+-----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+-------------------+-----------------+---------------| - |son | |Songhay | | - |----------------+-------------------+-----------------+---------------| - |sq_AL | |Albanian | | - |----------------+-------------------+-----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+-------------------+-----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+-------------------+-----------------+---------------| - |su_ID | |Sundanese | | - |----------------+-------------------+-----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+-------------------+-----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+-------------------+-----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+-------------------+-----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+-------------------+-----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+-------------------+-----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+-------------------+-----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+-------------------+-----------------+---------------| - |tr_TR | |Turkish | | - |----------------+-------------------+-----------------+---------------| - |tw_GH | |Twi | | - |----------------+-------------------+-----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+-------------------+-----------------+---------------| - |ur_IN | |Urdu | | - |----------------+-------------------+-----------------+---------------| - |ve_ZA | |Venda | | - |----------------+-------------------+-----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+-------------------+-----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+-------------------+-----------------+---------------| - |wa_BE | |Walloon | | - |----------------+-------------------+-----------------+---------------| - |wo_SN | |Wolof | | - |----------------+-------------------+-----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+-------------------+-----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+-------------------+-----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+-------------------+-----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+-------------------+-----------------+---------------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - Estes idiomas requiren os seus propios tipos de letra, xa que non - se representan usando un conxunto de caracteres latinos, como os demais. - Vexa a sección «Tipos de letra especiais», a continuación. - - 💡 Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods while - the Text tool is active. - -Axustar o idioma do seu contorno - - Cambiar a súa configuración local afectará a gran parte do seu contorno. - - Como se indicou anteriormente, ademais de permitirche escoller o idioma - en tempo de execución empregando opcións de liña de ordes («--lang» e - «--locale»), Tux Paint respecta o axuste da configuración local do seu - contorno. - - Se aínda non estabeleceu a configuración local do seu contorno, o - seguinte explicará brevemente como: - - Usuarios de Linux/Unix - - Primeiro, asegúrese de que a configuración local que quere usar está - activada editando o ficheiro «/etc/locale.gen» no seu sistema e logo - executando o programa «locale-gen» como superusuario «root». - - 💡 Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration dialog. - Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the - "localeconf" package may need to be installed first), or you may need to - edit the file "/var/lib/locales/supported.d/local" first, and add - locales they want, from the list found in "/usr/share/i18n/SUPPORTED". - - Após, antes de executar Tux Paint, configure a súa variábel de contorno - «$LANG» a unha das configuracións locais mencionadas anteriormente. (Se - quere que todos os programas que se poidan traducir o sexan, pode que - queira colocar o seguinte no seu script de inicio de sesión; por - exemplo, «~/.profile», «~/.bashrc», «~/.cshrc», etc.) - - Por exemplo, nunha consola Bourne (como BASH): - - export LANG=es_ES ; \ - tuxpaint - - E nunha consola C (como TCSH): - - setenv LANG es_ES ; \ - tuxpaint - - Usuarios de Windows - - Tux Paint recoñecerá a configuración local actual e empregará de xeito - predeterminado os ficheiros apropiados. Polo tanto, esta sección é só - para persoas que proban idiomas diferentes. - - O máis sinxelo é empregar o interruptor «--lang» no atallo (ver «INSTALL - [INSTALAR]»). Non obstante, usando unha xanela de indicador do sistema - de MSDOS, tamén é posíbel emitir unha orde coma esta: - - set LANG=es_ES - - ...que estabelecerá o idioma para toda a vida desa xanela DOS. - - Para obter algo máis permanente, pode estabelecer unha «variábel de - contorno» usando o diálogo «Propiedades do sistema» do seguinte xeito: - - * Prema a combinación de teclas «[Windows]+[R]» para abrir o diálogo - «Executar...». - * Escriba «sysdm.cpl» na caixa de texto e prema no botón «[OK]» para - abrir o diálogo «Propiedades do sistema». - * Seleccione a lapela «Avanzado». - * Prema no botón «Variábeis de contorno...». - * Edite o valor do parámetr «LANG») (créeo, se non existe). - -Tipos de letra especiais - - Algúns idiomas requiren que se instalen tipos de letra especiais. Estes - ficheiros de letra (que están en formato TrueType (TTF)), son demasiado - grandes para incluílos coa descarga de Tux Paint e están dispoñíbeis por - separado. (Vexa a táboa anterior, na sección «Escoller un idioma - diferente»). - - 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user interface, - rather than using "SDL_ttf" directly. Unless your copy of Tux Paint was - built without Pango support, special fonts should no longer be - necessary. + Accessibility - Cando se executa Tux Paint nun idioma que require o seu propio tipo de - letra, Tux Paint tentará cargar o ficheiro de letra dende o directorio - «fonts» do sistema (nun subdirectorio «locale»). O nome do ficheiro - corresponde ás dúas primeiras letras do código «local» do idioma (por - exemplo, «ko» para coreano, «ja» para xaponés, «zh_tw» para chinés - tradicional). + Mouse - Por exemplo, en Linux ou Unix, cando Tux Paint se executa en coreano (é - dicir, coa opción «--lang korean»), Tux Paint tentará cargar o seguinte - ficheiro de tipo de letra: + mouse-accessibility=yes - /usr/share/tuxpaint/fonts/locale/ko.ttf + Neste modo, no canto de premer, arrastrar e soltar (por exemplo, para + debuxar), premese, móvese e premese de novo para rematar o movemento. - You can download fonts for supported languages from Tux Paint's website, - https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') - En Unix e Linux, pode usar o Makefile que vén co tipo de letra para - instalalo no lugar adecuado. + + + Keyboard + + keyboard=yes + + Isto permite empregar as teclas de frecha do teclado para controlar o + punteiro do rato. (por exemplo, para contornos sen rato ou persoas con + discapacidade ou problemas de accesibilidade) + + Funcionalidades: + + o Movemento fino dentro do lenzo ou movemento groseiro se se mantén + premida Shift. + o Movemento groseiro dentro das áreas dos botóns da ferramenta. + o Principais controis: + # [Left]/[Right]/[Up]/[Down], teclado numérico [1] ata [9]: mover + o rato + # [Space]/[5]: premer co rato (agás cando se empregan as + ferramentas de «Texto» ou de «Etiqueta») + # [Insert]/[F5]: premer co rato (sempre) + # [F4] fai saltar o rato entre as «Ferramentas», «Cores» e as + áreas do lenzo + # Se o rato está dentro da sección «Ferramentas» á esquerda ou na + sección «Cores» na parte inferior: + @ [F7]/[F8]: mover cara abaixo/arriba entre os botóns, + respectivamente (só sección de ferramentas) + @ [F11]/[F12]: mover ao botón anterior/seguinte, + respectivamente + o Para premer e arrastrar, manteña premida unha das teclas de «clic» + (p. ex.: [Insert]) e use as teclas de movemento (p. ex.: [Left]). + + 💡 Note: The "mouse accessibility" feature works with the keyboard + mouse controls. With both options enabled, painting tools can be + used to draw by pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another 'click' key to + end the click (stop drawing). + + o Aínda se pode usar un rato e/ou unha panca de mando (joystick) + normais (para que poida, por exemplo, moverse co rato e premer co + teclado ou viceversa) + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "keyboard=no" or "mouse=yes". In + both cases, may be overridden by the command-line option "--mouse". + + + + + Onscreen Keyboard + + onscreen-keyboard=yes + + Presenta un teclado en pantalla sobre que se pode premer cando empregan + as ferramentas Texto e Etiqueta. + + + + onscreen-keyboard-layout=NOME DA DISPOSICIÓN + + Selects the initial layout for the on-screen keyboard when using the + Text and Label tools. + Nota: Usar esta opción implica automaticamente onscreen-keyboard=yes, + polo que estabelecer ambas as cousas é redundante. + + + + onscreen-keyboard-disable-change=yes + + Desactiva a posibilidade de cambiar o deseño do teclado en pantalla + cando se usan as ferramentas Texto e Etiqueta, útil para simplificar as + cousas para os máis pequechos. + Nota: Usar esta opción implica automaticamente onscreen-keyboard=yes, + polo que estabelecer ambas as cousas é redundante. + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be overridden + by the command-line option "--onscreen-keyboard-disable-change=no". + + + + + Joystick + + Main Device + + joystick-dev=N + + Especifica que dispositivo de mando debe ser usado por Tux Paint. O + valor predeterminado é 0 (a primeira panca de mando — joystick). + + + + joystick-slowness=VELOCIDADE + + Estabelece un atraso en cada movemento do eixo, permitindo atrasar a + panca de mando (joystick). Os valores permitidos van de 0 a 500. O + valor predeterminado é 15. + + + + joystick-threshold=LIMIAR + + Estabelece o nivel mínimo de movemento do eixe para comezar a mover o + punteiro. Os valores permitidos son de 0 a 32766. O valor + predeterminado é 3200. + + + + joystick-maxsteps=PASOS + + Define os píxeles máximos que moverá o punteiro á vez. Os valores + permitidos van do 1 ao 7. O valor predeterminado é 7. + + + + + Hat + + joystick-hat-slowness=VELOCIDADE + + Estabelece un atraso en cada movemento automático, o que permite + diminuír a velocidade do sombreiro. Os valores permitidos van de 0 a + 500. O valor predeterminado é 15. + + + + joystick-hat-timeout=MILISEGUNDOS + + Estabelece o atraso após de que o punteiro comezará a moverse + automaticamente se se mantén premido o sombreiro. Os valores permitidos + van de 0 a 3000. O valor predeterminado é 1000. + + + + + Buttons to Disable + + joystick-buttons-ignore=BOTÓN1,BOTÓN2,... + + Un conxunto de números de botóns do mando (joystick), como se ve en + SDL, que deben ignorarse. Se non, a menos que sexan utilizados por unha + das opcións «joystick-btn-» anteriores, os botóns veranse como un botón + esquerdo do rato. + + + + +Button Shortcuts + + joystick-btn-escape=NÚMERO DE BOTÓN + + Selecciona o número do botón da panca de control (joystick), tal e como + o ve SDL, que se usará para xerar un evento de escape. Útil para + desactivar os diálogos e saír. + + + + joystick-btn-brush=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de pinceis. + + + + joystick-btn-stamp=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de selos. + + + + joystick-btn-lines=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de liñas. + + + + joystick-btn-shapes=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de formas. + + + + joystick-btn-text=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de texto. + + + + joystick-btn-label=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de etiquetas. + + + + joystick-btn-fill=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a select the fill tool. + + + + joystick-btn-magic=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a seleccionar a ferramenta de máxia. + + + + joystick-btn-undo=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a invocar a ferramenta de desfacer. + + + + joystick-btn-redo=NÚMERO DE BOTÓN + + Selecciona o número do botón da panca de mando (joystick), tal e como o + ve SDL, que será un atallo para seleccionar ferramenta de refacer. + + + + joystick-btn-eraser=NÚMERO DE BOTÓN + + Selecciona o número do botón da panca de mando (joystick), tal e como o + ve SDL, que será un atallo para seleccionar ferramenta de goma de + borrar. + + + + joystick-btn-new=NÚMERO DE BOTÓN + + Selecciona o número do botón da panca de mando (joystick), como o ve + SDL, que será un atallo para iniciar o diálogo para crear un novo + debuxo. + + + + joystick-btn-open=NÚMERO DE BOTÓN + + Selecciona o número do botón da panca de mando (joystick), como o ve + SDL, que será un atallo para iniciar o diálogo para abrir un debuxo + existente. + + + + joystick-btn-save=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a garda o debuxo. + + + + joystick-btn-pgsetup=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a inicia o diálogo de configuración da páxina para imprimir. + + + + joystick-btn-print=NÚMERO DE BOTÓN + + Selecciona o número do botón do joystick, como o ve SDL, que será un + atallo a imprimir. + + + + + Anulación da configuración do sistema. Opcións + + (Para usuarios de Linux e Unix) + + Se algunha das opcións anteriores está estabelecida en «/etc/tuxpaint/ + tuxpaint.config», pode anulala no seu propio ficheiro «~/.tuxpaintrc». + + Para opcións verdadeiro/falso, como «noprint» e «grab», pode simplemente + dicir que son iguais a «no» no seu ficheiro «~/.tuxpaintrc»: + + noprint=no + uppercase=no + + Ou pode usar opcións semellantes ás opcións de anulación da liña de ordes + que se describen a continuación. Por exemplo: + + print=yes + mixedcase=yes + + Opcións da liña de ordes + + Options may also be issued on the command-line when you go to launch Tux + Paint. + + --fullscreen + --LARGOxALTO + --buttonsize=TAMAÑO + --colorsrows=FILAS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SEGUNDOS + --printcfg + --altprintnever + --altprintalways + --papersize=TAMAÑO_DO_PAPEL + --printcommand=ORDE + --altprintcommand=ORDE + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=TAMAÑO + --keyboard + --savedir DIRECTORIO + --datadir DIRECTORIO + --exportdir DIRECTORIO + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang IDIOMA + --colorfile FICHEIRO + + Estas activan ou corresponden ás opcións do ficheiro de configuración + descritas anteriormente. + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + Estas opcións pódense usar para anular calquera axuste feito no + ficheiro de configuración. (Se a opción non está configurada no(s) + ficheiro(s) de configuración, non será necesaria ningunha opción de + anulación.) + + + + --nosysconfig + + En Linux e Unix, isto evita ler o ficheiro de configuración de todo o + sistema, «/etc/tuxpaint/tuxpaint.conf». + + Só se empregará o seu propio ficheiro de configuración, «~ + /.tuxpaintrc», se existe. + + + + + Opcións informativas da liña de ordes + + As seguintes opcións amosan un texto informativo na pantalla. Non obstante, + Tux Paint non se inicia nin se executa despois. + + --version + --verbose-version + + Amosa o número de versión e a data da copia de Tux Paint que está a + executar. O «--verbose-version» tamén lista as opcións de tempo de + compilación definidas. (Vexa INSTALL [INSTALAR] e FAQ [Preguntas + frecuentes] ). + + + + --copying + + Amosa información breve sobre a licenza para copiar Tux Paint. + + + + --usage + + Amosa a lista de opcións de liña de ordes dispoñíbeis. + + + + --help + + Amosa unha breve axuda sobre o uso de Tux Paint. + + + + --lang help + + Amosa unha lista de idiomas dispoñíbeis en Tux Paint. + + + + --joystick-dev list + + Amosa a lista de pancas de mando (joysticks) conectados dispoñíbeis + para Tux Paint. + + + + + Escoller un idioma diferente + + Tux Paint foi traducido a varios idiomas. Para acceder ás traducións, pode + usar a opción «--lang» na liña de ordes para estabelecer o idioma (por + exemplo, «--lang spanish») ou usar o axuste «lang=» no ficheiro de + configuración (p. ex.: «lang=spanish»). + + Tux Paint tamén respecta o contorno local actual. (Pode anulalo na liña de + ordes usando a opción «--locale»; vexa consulta arriba). + + Use the option "--lang help" to list the language options available. + + Idiomas dispoñíbeis + + +-------------------------------------------------------------------------+ + | | | Idioma | Combinación de | + | Código do idioma | Idioma | (nome en | teclas de ciclo | + | | (nome nativo) | inglés) | de método de | + | | | | entrada | + |------------------+------------------+----------------+------------------| + | C | | English | | + |------------------+------------------+----------------+------------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+----------------+------------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+----------------+------------------| + | ak_GH | | Akan | | + |------------------+------------------+----------------+------------------| + | am_ET | | Amharic | | + |------------------+------------------+----------------+------------------| + | an_ES | | Aragones | | + |------------------+------------------+----------------+------------------| + | ar_SA | | Arabic | | + |------------------+------------------+----------------+------------------| + | as_IN | | Assamese | | + |------------------+------------------+----------------+------------------| + | ast_ES | | Asturian | | + |------------------+------------------+----------------+------------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+----------------+------------------| + | bm_ML | | Bambara | | + |------------------+------------------+----------------+------------------| + | bn_IN | | Bengali | | + |------------------+------------------+----------------+------------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+----------------+------------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+----------------+------------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+----------------+------------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+----------------+------------------| + | brx_IN | | Bodo | | + |------------------+------------------+----------------+------------------| + | bs_BA | | Bosnian | | + |------------------+------------------+----------------+------------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+----------------+------------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+----------------+------------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+----------------+------------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+----------------+------------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+----------------+------------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+----------------+------------------| + | de_DE | Deutsch | German | | + |------------------+------------------+----------------+------------------| + | doi_IN | | Dogri | | + |------------------+------------------+----------------+------------------| + | et_EE | | Estonian | | + |------------------+------------------+----------------+------------------| + | el_GR (*) | | Greek | | + |------------------+------------------+----------------+------------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_GB | | British | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+----------------+------------------| + | eo | | Esperanto | | + |------------------+------------------+----------------+------------------| + | es_ES | Español | Spanish | | + |------------------+------------------+----------------+------------------| + | es_MX | Español-Mejicano | Mexican | | + | | | Spanish | | + |------------------+------------------+----------------+------------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+----------------+------------------| + | fa_IR | | Persian | | + |------------------+------------------+----------------+------------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+----------------+------------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+----------------+------------------| + | fo_FO | | Faroese | | + |------------------+------------------+----------------+------------------| + | fr_FR | Français | French | | + |------------------+------------------+----------------+------------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+----------------+------------------| + | gd_GB | Ghaidhlig | Scottish | | + | | | Gaelic | | + |------------------+------------------+----------------+------------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+----------------+------------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+----------------+------------------| + | gu_IN | | Gujarati | | + |------------------+------------------+----------------+------------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+----------------+------------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+----------------+------------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+----------------+------------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+----------------+------------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+----------------+------------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+----------------+------------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+----------------+------------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+----------------+------------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+----------------+------------------| + | ja_JP (*) | | Japanese | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | ka_GE | | Georgian | | + |------------------+------------------+----------------+------------------| + | kab | | Kabyle | | + |------------------+------------------+----------------+------------------| + | km_KH | | Khmer | | + |------------------+------------------+----------------+------------------| + | kn_IN | | Kannada | | + |------------------+------------------+----------------+------------------| + | ko_KR (*) | | Korean | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | kok@roman | | Konkani | | + | | | (Roman) | | + |------------------+------------------+----------------+------------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+----------------+------------------| + | ku_TR | | Kurdish | | + |------------------+------------------+----------------+------------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+----------------+------------------| + | lg_UG | | Luganda | | + |------------------+------------------+----------------+------------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+----------------+------------------| + | lv_LV | | Latvian | | + |------------------+------------------+----------------+------------------| + | mk_MK | | Macedonian | | + |------------------+------------------+----------------+------------------| + | mai_IN | | Maithili | | + |------------------+------------------+----------------+------------------| + | ml_IN | | Malayalam | | + |------------------+------------------+----------------+------------------| + | mn_MN | | Mongolian | | + |------------------+------------------+----------------+------------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+----------------+------------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+----------------+------------------| + | mr_IN | | Marathi | | + |------------------+------------------+----------------+------------------| + | ms_MY | | Malay | | + |------------------+------------------+----------------+------------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+----------------+------------------| + | ne_NP | Nepali | | | + |------------------+------------------+----------------+------------------| + | nl_NL | | Dutch | | + |------------------+------------------+----------------+------------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+----------------+------------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+----------------+------------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+----------------+------------------| + | oc_FR | | Occitan | | + |------------------+------------------+----------------+------------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+----------------+------------------| + | pa_IN | | Punjabi | | + |------------------+------------------+----------------+------------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+----------------+------------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+----------------+------------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+----------------+------------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+----------------+------------------| + | ro_RO | | Romanian | | + |------------------+------------------+----------------+------------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+----------------+------------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+----------------+------------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+----------------+------------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+----------------+------------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+----------------+------------------| + | si_LK | | Sinhala | | + |------------------+------------------+----------------+------------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sd_IN | | Sindhi | | + |------------------+------------------+----------------+------------------| + | sk_SK | | Slovak | | + |------------------+------------------+----------------+------------------| + | sl_SI | | Slovenian | | + |------------------+------------------+----------------+------------------| + | son | | Songhay | | + |------------------+------------------+----------------+------------------| + | sq_AL | | Albanian | | + |------------------+------------------+----------------+------------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+----------------+------------------| + | sr_RS@latin | | Serbian | | + | | | (latin) | | + |------------------+------------------+----------------+------------------| + | su_ID | | Sundanese | | + |------------------+------------------+----------------+------------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+----------------+------------------| + | sw_TZ | | Swahili | | + |------------------+------------------+----------------+------------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+----------------+------------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+----------------+------------------| + | th_TH (*) | | Thai | | + |------------------+------------------+----------------+------------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+----------------+------------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+----------------+------------------| + | tr_TR | | Turkish | | + |------------------+------------------+----------------+------------------| + | tw_GH | | Twi | | + |------------------+------------------+----------------+------------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+----------------+------------------| + | ur_IN | | Urdu | | + |------------------+------------------+----------------+------------------| + | ve_ZA | | Venda | | + |------------------+------------------+----------------+------------------| + | vec | Venèto | Venetian | | + |------------------+------------------+----------------+------------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+----------------+------------------| + | wa_BE | | Walloon | | + |------------------+------------------+----------------+------------------| + | wo_SN | | Wolof | | + |------------------+------------------+----------------+------------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+----------------+------------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+----------------+------------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+----------------+------------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+----------------+------------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - Estes idiomas requiren os seus propios tipos de letra, xa que non se + representan usando un conxunto de caracteres latinos, como os demais. Vexa + a sección «Tipos de letra especiais», a continuación. + + 💡 Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) listed + can be used to cycle through the supported input methods while the Text + tool is active. + + Axustar o idioma do seu contorno + + Cambiar a súa configuración local afectará a gran parte do seu contorno. + + Como se indicou anteriormente, ademais de permitirche escoller o idioma en + tempo de execución empregando opcións de liña de ordes («--lang» e + «--locale»), Tux Paint respecta o axuste da configuración local do seu + contorno. + + Se aínda non estabeleceu a configuración local do seu contorno, o seguinte + explicará brevemente como: + + Usuarios de Linux/Unix + + Primeiro, asegúrese de que a configuración local que quere usar está + activada editando o ficheiro «/etc/locale.gen» no seu sistema e logo + executando o programa «locale-gen» como superusuario «root». + + 💡 Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration dialog. + Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the + "localeconf" package may need to be installed first), or you may need to + edit the file "/var/lib/locales/supported.d/local" first, and add locales + they want, from the list found in "/usr/share/i18n/SUPPORTED". + + Após, antes de executar Tux Paint, configure a súa variábel de contorno + «$LANG» a unha das configuracións locais mencionadas anteriormente. (Se + quere que todos os programas que se poidan traducir o sexan, pode que + queira colocar o seguinte no seu script de inicio de sesión; por exemplo, + «~/.profile», «~/.bashrc», «~/.cshrc», etc.) + + Por exemplo, nunha consola Bourne (como BASH): + + export LANG=es_ES ; \ + tuxpaint + + E nunha consola C (como TCSH): + + setenv LANG es_ES ; \ + tuxpaint + + Usuarios de Windows + + Tux Paint recoñecerá a configuración local actual e empregará de xeito + predeterminado os ficheiros apropiados. Polo tanto, esta sección é só para + persoas que proban idiomas diferentes. + + O máis sinxelo é empregar o interruptor «--lang» no atallo (ver «INSTALL + [INSTALAR]»). Non obstante, usando unha xanela de indicador do sistema de + MSDOS, tamén é posíbel emitir unha orde coma esta: + + set LANG=es_ES + + ...que estabelecerá o idioma para toda a vida desa xanela DOS. + + Para obter algo máis permanente, pode estabelecer unha «variábel de + contorno» usando o diálogo «Propiedades do sistema» do seguinte xeito: + + + Prema a combinación de teclas «[Windows]+[R]» para abrir o diálogo + «Executar...». + + Escriba «sysdm.cpl» na caixa de texto e prema no botón «[OK]» para + abrir o diálogo «Propiedades do sistema». + + Seleccione a lapela «Avanzado». + + Prema no botón «Variábeis de contorno...». + + Edite o valor do parámetr «LANG») (créeo, se non existe). + + Tipos de letra especiais + + Algúns idiomas requiren que se instalen tipos de letra especiais. Estes + ficheiros de letra (que están en formato TrueType (TTF)), son demasiado + grandes para incluílos coa descarga de Tux Paint e están dispoñíbeis por + separado. (Vexa a táboa anterior, na sección «Escoller un idioma diferente + »). + + 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, which + utilizes the "Pango" library to render text in the user interface, rather + than using "SDL_ttf" directly. Unless your copy of Tux Paint was built + without Pango support, special fonts should no longer be necessary. + + Cando se executa Tux Paint nun idioma que require o seu propio tipo de + letra, Tux Paint tentará cargar o ficheiro de letra dende o directorio « + fonts» do sistema (nun subdirectorio «locale»). O nome do ficheiro + corresponde ás dúas primeiras letras do código «local» do idioma (por + exemplo, «ko» para coreano, «ja» para xaponés, «zh_tw» para chinés + tradicional). + + Por exemplo, en Linux ou Unix, cando Tux Paint se executa en coreano (é + dicir, coa opción «--lang korean»), Tux Paint tentará cargar o seguinte + ficheiro de tipo de letra: + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + You can download fonts for supported languages from Tux Paint's website, + https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + + En Unix e Linux, pode usar o Makefile que vén co tipo de letra para + instalalo no lugar adecuado. + diff --git a/docs/gl_ES.UTF-8/PNG.txt b/docs/gl_ES.UTF-8/PNG.txt index 9da12e968..020f674af 100644 --- a/docs/gl_ES.UTF-8/PNG.txt +++ b/docs/gl_ES.UTF-8/PNG.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 Documentación PNG Copyright © 2007-2022 by varios colaboradores; see AUTHORS.txt. @@ -7,85 +7,87 @@ 4 de Xuño de 2022 - Sobre os PNG +Sobre os PNG - 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 - que non é «con perda» como os JPEG: a perda permite que os ficheiros sexan - moito máis pequenos, mais introduce «erros» na imaxe cando se gardan) e - admite cores de 24 bits (16,7 millóns de cores), así como unha «canle - alfa» completo, é dicir, cada píxel pode ter un grao de transparencia - variábel. +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 que +non é «con perda» como os JPEG: a perda permite que os ficheiros sexan moito +máis pequenos, mais introduce «erros» na imaxe cando se gardan) e admite cores +de 24 bits (16,7 millóns de cores), así como unha «canle alfa» completo, é +dicir, cada píxel pode ter un grao de transparencia 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) - convérteno na mellor opción para Tux Paint. (A compatibilidade de Tux - Paint co formato PNG procede da biblioteca de código aberto SDL_Image, que - á súa vez a obtén da biblioteca libPNG.) +Estas características (apertura, perda, compresión, transparencia/alfa) +convérteno na mellor opción para Tux Paint. (A compatibilidade de Tux Paint co +formato PNG procede da biblioteca de código aberto SDL_Image, que á súa vez a +obtén da biblioteca libPNG.) - A compatibilidade con moitas cores permite utilizar imaxes de «selo de - caucho» de calidade fotográfica en Tux Paint e a transparencia alfa - permite pinceis de alta calidade. +A compatibilidade con moitas cores permite utilizar imaxes de «selo de caucho» +de calidade fotográfica en Tux Paint e a transparencia alfa permite pinceis de +alta calidade. Como facer imaxes PNG - A continuación amosarase unha lista moi breve de xeitos de crear PNG ou - converter as imaxes existentes a PNG. +A continuación amosarase unha lista moi breve de xeitos de crear PNG ou +converter as imaxes existentes a PNG. - GIMP & Krita +GIMP & Krita - GIMP e Krita son dúas excelentes ferramentas coas que crear imaxes - PNG para usar en Tux Paint , ambos son programas de debuxo - interactivo e edición de fotos de código aberto de alta calidade. + GIMP e Krita son dúas excelentes ferramentas coas que crear imaxes PNG para + usar en Tux Paint , ambos son programas de debuxo interactivo e edición de + 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 - NetPBM - As ferramentas de Mapas de bits Portátil –Portable - Bitmap– (coñecidas colectivamente como «NetPBM») son - unha colección de ferramentas de liña de ordes de - código aberto que converten a e dende varios - formatos, incluíndo GIF, TIFF, BMP, PNG e moitos - máis. +Ferramentas da liña de ordes - É 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/. + NetPBM - cjpeg/djpeg + As ferramentas de Mapas de bits Portátil –Portable Bitmap– (coñecidas + colectivamente como «NetPBM») son unha colección de ferramentas de liña + de ordes de código aberto que converten a e dende varios 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/. + + + + cjpeg/djpeg + + Os programas de liña de ordes «cjpeg» e «djpeg» converten entre o + formato NetPBM Calquera mapa portátil –Portable Any Map– (PNM) e os + JPEG. É 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 https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Usuarios de Macintosh + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - Os programas de liña de ordes «cjpeg» e «djpeg» - converten entre o formato NetPBM Calquera mapa - portátil –Portable Any Map– (PNM) e os JPEG. É - 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 https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Usuarios de Macintosh - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/gl_ES.UTF-8/README.txt b/docs/gl_ES.UTF-8/README.txt index 057184abf..3cdf94d1a 100644 --- a/docs/gl_ES.UTF-8/README.txt +++ b/docs/gl_ES.UTF-8/README.txt @@ -1,1375 +1,1368 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 - Un sinxelo programa de debuxo para cativos + Un sinxelo programa de debuxo para cativos Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt. https://tuxpaint.org/ 13 de Xullo de 2023 - +-------------------------------------------------------------+ - |Índice | - |-------------------------------------------------------------| - |I. Sobre Tux Paint | - |II. Uso de Tux Paint | - | A. Inicio de Tux Paint | - | B. Pantalla de título | - | C. Pantalla principal | - | D. Ferramentas dispoñíbeis | - | 1. Ferramentas de debuxo | - | a. Ferramenta «Pintar» (pinceis) | - | b. Ferramenta «Selo» (selos de caucho) | - | c. Ferramenta «Liñas» | - | d. Ferramenta «Formas» | - | e. Ferramentas «Texto» e «Etiquetas» | - | f. Ferramenta «Encher» | - | g. Ferramenta «Maxia» (efectos especiais) | - | h. Ferramenta de «Goma» (de borrar) | - | 2. Outros controis | - | a. "Undo" and "Redo" Commands | - | b. Orde «Novo» | - | c. Orde «Abrir» | - | d. Orde «Gardar» | - | e. Orde «Imprimir» | - | f. Orde «Diapositivas» (en «Abrir») | - | g. Orde «Saír» | - | h. Silenciar o son | - | E. Controlling Tux Paint | - |III. Carga doutras imaxes en Tux Paint | - |IV. Máis información | - |V. Como obter axuda | - |VI. Como participar | - +-------------------------------------------------------------+ ++--------------------------------------------------------+ +| Índice | +|--------------------------------------------------------| +| I. Sobre Tux Paint | +| II. Uso de Tux Paint | +| A. Inicio de Tux Paint | +| B. Pantalla de título | +| C. Pantalla principal | +| D. Ferramentas dispoñíbeis | +| 1. Ferramentas de debuxo | +| a. Ferramenta «Pintar» (pinceis) | +| b. Ferramenta «Selo» (selos de caucho) | +| c. Ferramenta «Liñas» | +| d. Ferramenta «Formas» | +| e. Ferramentas «Texto» e «Etiquetas» | +| f. Ferramenta «Encher» | +| g. Ferramenta «Maxia» (efectos especiais) | +| h. Ferramenta de «Goma» (de borrar) | +| 2. Outros controis | +| a. "Undo" and "Redo" Commands | +| b. Orde «Novo» | +| c. Orde «Abrir» | +| d. Orde «Gardar» | +| e. Orde «Imprimir» | +| f. Orde «Diapositivas» (en «Abrir») | +| g. Orde «Saír» | +| h. Silenciar o son | +| E. Controlling Tux Paint | +| III. Carga doutras imaxes en Tux Paint | +| IV. Máis información | +| V. Como obter axuda | +| VI. Como participar | ++--------------------------------------------------------+ - I. Sobre Tux Paint +I. Sobre Tux Paint A. Que é «Tux Paint»? - Tux Paint é un programa de debuxo libre e de balde deseñado para cativos - (3 ou máis anos). Ten unha interface sinxela e doada de usar, divertidos - efectos de son e unha mascota de debuxos animados que axuda a guiar aos - cativos mentres usan o programa. Ofrece un lenzo en branco e unha ampla - variedade de ferramentas de debuxo para axudar ao seu cativo a ser - creativo. +Tux Paint é un programa de debuxo libre e de balde deseñado para cativos (3 ou +máis anos). Ten unha interface sinxela e doada de usar, divertidos efectos de +son e unha mascota de debuxos animados que axuda a guiar aos cativos mentres +usan o programa. Ofrece un lenzo en branco e unha ampla variedade de +ferramentas de debuxo para axudar ao seu cativo a ser creativo. B. Objectives - Doado e divertido - Tux Paint pretende ser un sinxelo programa de debuxo para cativos - pequenos. Non está pensado como unha ferramenta de debuxo de uso - xeral. Preténdese que sexa divertido e doado de usar. Os efectos - de son e un personaxe de debuxos animados permiten que o usuario - saiba o que está pasando e o mantén entretido. Tamén hai formas de - punteiro de rato estilo debuxo animado de gran tamaño. +Doado e divertido + Tux Paint pretende ser un sinxelo programa de debuxo para cativos pequenos. + Non está pensado como unha ferramenta de debuxo de uso xeral. Preténdese + que sexa divertido e doado de usar. Os efectos de son e un personaxe de + debuxos animados permiten que o usuario saiba o que está pasando e o mantén + entretido. Tamén hai formas de punteiro de rato estilo debuxo animado de + gran tamaño. - Ampliabilidade - Tux Paint é ampliábel. Os pinceis e as formas do «selo de caucho» - arrastrarse e soltarse. Por exemplo, un profesor pode soltar unha - colección de formas de animais e pedirlles aos seus alumnos que - debuxen un ecosistema. Cada forma pode ter un son que se reproduce - e datos textuais que se amosan cando o cativo selecciona a forma. +Ampliabilidade + Tux Paint é ampliábel. Os pinceis e as formas do «selo de caucho» + arrastrarse e soltarse. Por exemplo, un profesor pode soltar unha colección + de formas de animais e pedirlles aos seus alumnos que debuxen un + ecosistema. Cada forma pode ter un son que se reproduce e datos textuais + que se amosan cando o cativo selecciona a forma. - Portabilidade - Tux Paint é portátil entre varias plataformas informáticas: - Windows, Macintosh, Linux, etc. A interface ten o mesmo aspecto en - todas. Tux Paint funciona adecuadamente en sistemas antigos e - pódese construír para funcionar mellor en sistemas lentos. +Portabilidade + Tux Paint é portátil entre varias plataformas informáticas: Windows, + Macintosh, Linux, etc. A interface ten o mesmo aspecto en todas. Tux Paint + funciona adecuadamente en sistemas antigos e pódese construír para + funcionar mellor en sistemas lentos. - Simplicidade - Non hai acceso directo ás complexidades subxacentes do computador. - A imaxe actual consérvase cando se pecha o programa e volve - aparecer cando se reinicia. Para gardar imaxes non é necesario - crear nomes de ficheiro nin usar o teclado. A apertura dunha imaxe - faise seleccionándoa nunha colección de miniaturas. O acceso a - outros ficheiros da computadora está restrinxido. +Simplicidade + Non hai acceso directo ás complexidades subxacentes do computador. A imaxe + actual consérvase cando se pecha o programa e volve aparecer cando se + reinicia. Para gardar imaxes non é necesario crear nomes de ficheiro nin + usar o teclado. A apertura dunha imaxe faise seleccionándoa nunha colección + de miniaturas. O acceso a outros ficheiros da computadora está restrinxido. + +Accessibility + Tux Paint offers a number of accessibility options, including increasing + the size of control buttons, changing the UI font, options to control the + cursor (mouse pointer) using the keyboard or other input devices (joystick, + gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks. - Accessibility - Tux Paint offers a number of accessibility options, including - increasing the size of control buttons, changing the UI font, - options to control the cursor (mouse pointer) using the keyboard - or other input devices (joystick, gamepad, etc.), an on-screen - keyboard, and "stick" mouse clicks. C. Licenza - Tux Paint é un proxecto de código aberto, software libre publicado baixo a - licenza pública xeral GNU (GPL). É de balde e o «código fonte» detrás do - programa está dispoñíbel. (Isto permite a outras persoas engadir funcións, - corrixir erros e usar partes do programa no seu propio software GPL). +Tux Paint é un proxecto de código aberto, software libre publicado baixo a +licenza pública xeral GNU (GPL). É de balde e o «código fonte» detrás do +programa está dispoñíbel. (Isto permite a outras persoas engadir funcións, +corrixir erros e usar partes do programa no seu propio software GPL). - Consulte o texto completo da licenza GPL en COPYING.txt. +Consulte o texto completo da licenza GPL en COPYING.txt. D. What's New in Tux Paint version 0.9.31? - Fuzzy Erasers - Fuzzy-edged round erasers have been added to the Eraser tool +Fuzzy Erasers + Fuzzy-edged round erasers have been added to the Eraser tool - New Magic tools - Loops, Ribbon, Smooth, and Squiggles +New Magic tools + Loops, Ribbon, Smooth, and Squiggles - Create templates from Open dialog - Saved drawings can be turned into templates (used to make new - drawings) via a new option in the Open dialog. (This feature may - be deactivated using the "notemplateexport" simplification - option.) +Create templates from Open dialog + Saved drawings can be turned into templates (used to make new drawings) via + a new option in the Open dialog. (This feature may be deactivated using the + "notemplateexport" simplification option.) - User interface font may be overridden - The font used for the user interface (button labels, dialog - pop-ups, and instructions) can be overridden from its default - ("DejaVu Sans"). (See the "uifont" configuration option. Use - "--listfonts" to see a list of available fonts.) +User interface font may be overridden + The font used for the user interface (button labels, dialog pop-ups, and + instructions) can be overridden from its default ("DejaVu Sans"). (See the + "uifont" configuration option. Use "--listfonts" to see a list of available + fonts.) - File Erase may be disabled - Controls to erase saved work — saved drawings (via the Open - dialog) and exported templates (via the New dialog) — can be - disabled. (See the "noerase" configuration option.) +File Erase may be disabled - "Controlling Tux Paint" documentation - A brief overview of how Tux Paint can be controlled — mouse, - tablet, touchscreen, joystick, and keyboard — has been added to - the README documentation. + Controls to erase saved work — saved drawings (via the Open dialog) and + exported templates (via the New dialog) — can be disabled. (See the + "noerase" configuration option.) - See CHANGES.txt for the complete list of changes. +"Controlling Tux Paint" documentation - II. Uso de Tux Paint + A brief overview of how Tux Paint can be controlled — mouse, tablet, + touchscreen, joystick, and keyboard — has been added to the README + documentation. + + +See CHANGES.txt for the complete list of changes. + +II. Uso de Tux Paint A. Inicio de Tux Paint - 1. Usuarios de Linux/Unix +1. Usuarios de Linux/Unix - Tux Paint should have placed a launcher icon in your KDE and/or GNOME - menus, under 'Graphics.' +Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus, +under 'Graphics.' - Como alternativa, pode executar a seguinte orde nun indicador do sistema - (e dicir, «$»): +Como alternativa, pode executar a seguinte orde nun indicador do sistema (e +dicir, «$»): - $ tuxpaint + $ tuxpaint - Se se producen erros, amosaranse no terminal (en STDERR). +Se se producen erros, amosaranse no terminal (en STDERR). - 2. Usuarios de Windows +2. Usuarios de Windows - [Icona de Tux Paint] - Tux Paint +[Icona de Tux Paint] + Tux Paint - Se instalou Tux Paint no seu computador usando o «Instalador de Tux - Paint», teralle preguntado se quería un atallo no menú «Inicio» e/ou un - atallo de escritorio. Se aceptou, pode executar Tux Paint dende a sección - «Tux Paint» do menú «Inicio» (p. ex.: en «Todos os programas») ou premendo - dúas veces na icona «Tux Paint» do seu escritorio. se fixo que o - instalador colocara un alí. +Se instalou Tux Paint no seu computador usando o «Instalador de Tux Paint», +teralle preguntado se quería un atallo no menú «Inicio» e/ou un atallo de +escritorio. Se aceptou, pode executar Tux Paint dende a sección «Tux Paint» do +menú «Inicio» (p. ex.: en «Todos os programas») ou premendo dúas veces na icona +«Tux Paint» do seu escritorio. se fixo que o instalador colocara un alí. - Se está a usar a versión «portátil» (ficheiro ZIP) de Tux Paint ou se usou - o «Instalador de Tux Paint», pero escolleu non ter instalados atallos, - terá que facer dobre clic na icona «tuxpaint.exe» no cartafol «Tux Paint» - do seu computador. +Se está a usar a versión «portátil» (ficheiro ZIP) de Tux Paint ou se usou o +«Instalador de Tux Paint», pero escolleu non ter instalados atallos, terá que +facer dobre clic na icona «tuxpaint.exe» no cartafol «Tux Paint» do seu +computador. - De xeito predeterminado, o «Instalador de Tux Paint» colocará o cartafol - de Tux Paint en «C:\Program Files\», aínda que é posíbel que o teña - cambiado vostede cando executou o instalador. +De xeito predeterminado, o «Instalador de Tux Paint» colocará o cartafol de Tux +Paint en «C:\Program Files\», aínda que é posíbel que o teña cambiado vostede +cando executou o instalador. - Se usou a descarga de «ficheiro ZIP», o cartafol de Tux Paint estará onde - teña extraído o contido do ficheiro ZIP. +Se usou a descarga de «ficheiro ZIP», o cartafol de Tux Paint estará onde teña +extraído o contido do ficheiro ZIP. - 3. Usuarios de macOS +3. Usuarios de macOS - Simplemente fai dobre clic na icona «Tux Paint». +Simplemente fai dobre clic na icona «Tux Paint». - [Pantalla de título] +[Pantalla de título] B. Pantalla de título - Cando se cargue por primeira vez Tux Paint, aparecerá unha pantalla de - título/recoñecementos. +Cando se cargue por primeira vez Tux Paint, aparecerá unha pantalla de título/ +recoñecementos. - Unha vez completada a carga, prema unha tecla, faga clic ou toque na - xanela de Tux Paint para continuar. (Ou, após aproximadamente 5 segundos, - a pantalla do título desaparecerá automaticamente.) +Unha vez completada a carga, prema unha tecla, faga clic ou toque na xanela de +Tux Paint para continuar. (Ou, após aproximadamente 5 segundos, a pantalla do +título desaparecerá automaticamente.) C. Pantalla principal - A pantalla principal divídese nas seguintes seccións: +A pantalla principal divídese nas seguintes seccións: - [Ferramentas: Pintar, Selo, Liñas, Formas, Texto, Maxia, Etiqueta, - Desfacer, Refacer, Borrador, Novo, Abrir, Gardar, Imprimir, Saír] +[Ferramentas: Pintar, Selo, Liñas, Formas, Texto, Maxia, Etiqueta, Desfacer, + Refacer, Borrador, Novo, Abrir, Gardar, Imprimir, Saír] +Lado esquerdo: Barra de Ferramentas - Lado esquerdo: Barra de Ferramentas + A barra de ferramentas contén os controis de debuxo e edición. - A barra de ferramentas contén os controis de debuxo e edición. - [Lenzo] - Medio: Lenzo de debuxo + [Lenzo] +Medio: Lenzo de debuxo - A parte máis grande da pantalla, no centro, é o lenzo de debuxo. - Aquí é, obviamente, onde debuxa. + A parte máis grande da pantalla, no centro, é o lenzo de debuxo. Aquí é, + obviamente, onde debuxa. - 💡 Nota: O tamaño do lenzo de debuxo depende do tamaño de Tux - Paint. Pode cambiar o tamaño de Tux Paint empregando a ferramenta - de configuración Tux Paint Config. ou por outros medios. Consulte - a documentación das Opcións para obter máis detalles. + 💡 Nota: O tamaño do lenzo de debuxo depende do tamaño de Tux Paint. Pode + cambiar o tamaño de Tux Paint empregando a ferramenta de configuración Tux + Paint Config. ou por outros medios. Consulte a documentación das Opcións + para obter máis detalles. - [Selectores: pinceis, letras, formas, selos] - Lado dereito: Selector - Dependendo da ferramenta actual, o selector amosa cousas - diferentes. p. ex.: cando se selecciona a ferramenta Pincel ou - Liña, amosa os distintos pinceis dispoñíbeis. Cando se selecciona - a ferramenta Selo de caucho, amosa as diferentes formas que pode - usar. Cando se selecciona a ferramenta Texto ou Etiqueta, amosa - varios tipos de letra. + [Selectores: pinceis, letras, formas, selos] +Lado dereito: Selector - [Cores: negro, branco, vermello, rosa, laranxa, amarelo, verde, - cian, azul, roxo, marrón, gris] + Dependendo da ferramenta actual, o selector amosa cousas diferentes. p. + ex.: cando se selecciona a ferramenta Pincel ou Liña, amosa os distintos + pinceis dispoñíbeis. Cando se selecciona a ferramenta Selo de caucho, amosa + as diferentes formas que pode usar. Cando se selecciona a ferramenta Texto + ou Etiqueta, amosa varios tipos de letra. - Máis abaixo: Cores - When the active tool supports colors, a palette of colors choices - will be shown near the bottom of the screen. Click one to choose a - color, and it will be used by the active tool. (For example, the - "Paint" tool will use it as the color to draw with the chosen - brush, and the "Fill" tool will use it as the color to use when - flood-filling an area of the picture.) - On the far right are three special color options: - * Color Picker - The "color picker" (which has an outline of an eye-dropper) - allows you to pick a color found within your drawing. - (A shortcut key is available to access this feature quickly; - see below.) - * Rainbow Palette - The rainbow palette allows you to pick any color by choosing - the hue, saturation, and value of the color you want. A box - on the left displays hundreds of hues — from red at the top - through to violet at the bottom — at hundreds of - saturation/intensity levels — from pale & washed-out on the - left through to pure on the right. A grey vertical bar - provides access to hundreds of value levels — from lighest at - the top through to darkest at the bottom. - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. - You may also set this tool's color to that of other color - choices: - * Whichever built-in color is selected, if any - * The Color Picker's current color - * The Color Mixer's current color - * Color Mixer - The "color mixer" (which has silhouette of a paint palette) - allows you to create colors by blending primary additive - colors — red, yellow, and blue — along with white (to - "tint"), grey (to "tone"), and black (to "shade"). - You may click any button multiple times (for example, red + - red + yellow results in a red-orange color). The ratios of - colors added are shown at the bottom. - You can start over (reset to no colors in your picture) by - clicking the "Clear" button. You can also undo or redo - multiple steps of mixing, in case you made a mistake (without - having to start over). - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. + [Cores: negro, branco, vermello, rosa, laranxa, amarelo, verde, cian, azul, + roxo, marrón, gris] +Máis abaixo: Cores - ⌨ When the active tool supports colors, a shortcut may be used for - quick access to the "color picker" option. Hold the [Control] key - while clicking, and the color under the mouse cursor will be shown - at the bottom. You may drag around to canvas to find the color you - want. When you release the mouse button, the color under the - cursor will be selected. If you release the mouse outside of the - canvas (e.g., over the "Tools" area), the color selection will be - left unchanged. (This is similar to clicking the "Back" button - that's available when bringing up the "color picker" option via - its button the color palette.) + When the active tool supports colors, a palette of colors choices will be + shown near the bottom of the screen. Click one to choose a color, and it + will be used by the active tool. (For example, the "Paint" tool will use it + as the color to draw with the chosen brush, and the "Fill" tool will use it + as the color to use when flood-filling an area of the picture.) - ⚙ Note: You can define your own colors for Tux Paint. See the - "Options" documentation. + On the far right are three special color options: + + Color Picker + The "color picker" (which has an outline of an eye-dropper) allows you + to pick a color found within your drawing. + (A shortcut key is available to access this feature quickly; see + below.) + + Rainbow Palette + The rainbow palette allows you to pick any color by choosing the hue, + saturation, and value of the color you want. A box on the left displays + hundreds of hues — from red at the top through to violet at the bottom + — at hundreds of saturation/intensity levels — from pale & washed-out + on the left through to pure on the right. A grey vertical bar provides + access to hundreds of value levels — from lighest at the top through to + darkest at the bottom. + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + You may also set this tool's color to that of other color choices: + o Whichever built-in color is selected, if any + o The Color Picker's current color + o The Color Mixer's current color + + Color Mixer + The "color mixer" (which has silhouette of a paint palette) allows you + to create colors by blending primary additive colors — red, yellow, and + blue — along with white (to "tint"), grey (to "tone"), and black (to + "shade"). + You may click any button multiple times (for example, red + red + + yellow results in a red-orange color). The ratios of colors added are + shown at the bottom. + You can start over (reset to no colors in your picture) by clicking the + "Clear" button. You can also undo or redo multiple steps of mixing, in + case you made a mistake (without having to start over). + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + + ⌨ When the active tool supports colors, a shortcut may be used for quick + access to the "color picker" option. Hold the [Control] key while clicking, + and the color under the mouse cursor will be shown at the bottom. You may + drag around to canvas to find the color you want. When you release the + mouse button, the color under the cursor will be selected. If you release + the mouse outside of the canvas (e.g., over the "Tools" area), the color + selection will be left unchanged. (This is similar to clicking the "Back" + button that's available when bringing up the "color picker" option via its + button the color palette.) + + ⚙ Note: You can define your own colors for Tux Paint. See the "Options" + documentation. + + + + (Consello de exemplo: «Escolle unha figura. Preme para marcar o centro, + arrastra e solta cando teña o tamaño que queiras. Move arredor para + invertela, e preme para debuxala.») +Abaixo de todo: Área de axuda + + Na parte inferior da pantalla, Tux, o pingüín de Linux, ofrece consellos e + outra información mentres usa Tux Paint. - (Consello de exemplo: «Escolle unha figura. Preme para marcar o - centro, arrastra e solta cando teña o tamaño que queiras. Move - arredor para invertela, e preme para debuxala.») - Abaixo de todo: Área de axuda - Na parte inferior da pantalla, Tux, o pingüín de Linux, ofrece - consellos e outra información mentres usa Tux Paint. D. Ferramentas dispoñíbeis - 1. Ferramentas de debuxo - - a. Ferramenta «Pintar» (pinceis) - - A ferramenta Pincel permítelle debuxar a man alzada usando varios - pinceis (escollidos no Selector da dereita) e cores (escollidos na - Paleta de cores cara á parte inferior). - - Se mantén premido o botón do rato e move o rato, irá debuxando a - medida que se move. - - Some brushes are animated — they change their shape as you draw - them. A good example of this is the vines brush that ships with - Tux Paint. These brushes will have a small "filmstrip" icon drawn - on their Selector buttons. - - Other brushes are directional — they will draw a different shape - depending on what direction you are painting with them. An example - of this is the arrow brush that ships with Tux Paint. These - brushes have a small 8-way arrow icon drawn on their Selector - buttons. - - Finally, some brushes can be both direction and animated. Examples - of this are the cat and squirrel brushes that ship with Tux Paint. - These brushes will have both the "filmstrip" and 8-way arrow - icons. - - Mentres debuxa, soa un son. Canto maior sexa o pincel, menor será - o ton. - - Espazado do pincel - - The space between each position where a brush is applied to the - canvas can vary. Some brushes (such as the footprints and - flower) are spaced, by default, far enough apart that they don't - overlap. Other brushes (such as the basic circular ones) are - spaced closely, so they make a continuous stroke. - - The default spacing of brushes may be overridden using by - clicking within the triangular-shaped series of bars at the - bottom right; the larger the bar, the wider the spacing. Brush - spacing affects both tools that use the brushes: the "Paint" - tool and the "Lines" tool. - - ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't - display the brush spacing controls. See the "Options" - documentation. - - b.Ferramenta «Selo» (selos de caucho) - - A ferramenta Selo é como un conxunto de selos de cacho ou - adhesivos. Permítelle pegar imaxes fotográficas ou debuxadas - previamente (como a imaxe dun cabalo, unha árbore ou a lúa) na súa - imaxe. - - As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be. Click on the canvas where you wish to place the stamp. - - Stamp Categories - Pode haber numerosas categorías de selos (por - exemplo, animais, plantas, espazo exterior, - vehículos, persoas, etc.). Use as frechas esquerda e - dereita preto da parte inferior do selector para - percorrer as coleccións. - - Stamp Rotation - - Using the rotation toggle button near the bottom - right, you can enable a rotation step when placing - stamps. Once you've placed the stamp, choose the - angle to rotate it by moving the mouse around the - canvas. Click the mouse button again and the stamp - will be added to the drawing. - - ⚙ Note: If "stamp rotation" option is disabled, the - stamp will be drawn on the canvas when you let go of - the mouse button. (There's no rotation step.) See the - "Options" documentation to learn about the "stamp - rotation" ("stamprotation") option. - - 📜 Note: The stamp rotation feature was added to Tux - Paint in version 0.9.29. - - Stamp Controls - - Antes de «estampar» unha imaxe no seu debuxo, ás - veces pódense aplicar varios efectos (dependendo do - selo): - - * Algúns selos pódense colorea ou matizar. Se a - paleta de cores baixo o lenzo está activada, - pode premer nas cores para cambiar o ton ou a - cor do selo antes de colocalo na imaxe. - * Os selos poden reducirse e expandirse premendo - dentro da serie de barras de forma triangular na - parte inferior dereita; canto maior sexa a - barra, máis grande aparecerá o selo na súa - imaxe. - * Moitos selos poden inverterse verticalmente ou - amosarse como unha imaxe reflectida, usando os - botóns de control na parte inferior dereita. - - ⚙ Note: If the "nostampcontrols" option is set, Tux - Paint won't display the Rotation, Mirror, Flip, or - sizing controls for stamps. See the "Options" - documentation. - - Stamp Sounds - - Diferentes selos poden ter diferentes efectos sonoros - e/ou sons descritivos (falados). Os botóns da área de - axuda na parte inferior esquerda (preto de Tux, o - pingüín de Linux) permiten reproducir de novo os - efectos de son e os sons descritivos para o selo - seleccionado nese momento. - - c.Ferramenta «Liñas» - - Esta ferramenta permítelle debuxar liñas rectas empregando os - diversos pinceis e cores que normalmente emprega co pincel. - - Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line will - show where the line will be drawn. At the bottom, you'll see the - angle of your line, in degrees. A line going straight to the right - is 0°, a line going straight up is 90°, a line going straight left - is 180°, a line going straight down is 270°, and so on. - - Solte o rato para completar a liña. Soará un «chimpo». - - Some brushes are animated, and will show a pattern of shapes along - the line. Others are directional, and will show a different shape - depending on the angle of the brush. And finally some are both - animated and directional. See "Paint", above, to learn more. - - Different brushes have different spacing, leaving either a series - of individual shapes, or a continuous stroke of the brush shape. - Brush spacing may be adjusted. See the brush spacing section of - the "Paint" tool, above, to learn more. - - d.Ferramenta «Formas» - - Esta ferramenta permítelle debuxar algunhas formas sinxelas - enchidas e sen encher. - - Seleccione unha forma do selector da dereita (círculo, cadrado, - óvalo, etc.). - - Use as opcións da parte inferior dereita para escoller o - comportamento da ferramenta de forma: - - Formas dende o centro - The shape will expand from where you initially - clicked, and will be centered around that position. - - 📜 This was Tux Paint's only behavior through version - 0.9.24.) - - Formas dende cantos - The shape will extend with one corner starting from - where you initially clicked. This is the default - method of most other traditional drawing software. - - 📜 This option was added starting with Tux Paint - version 0.9.25. - - ⚙ Nota: Se os controis de forma están desactivados (p. ex.: coa - opción «noshapecontrols»), non se presentarán os controis e - empregarase o método «formas dende o centro». - - No lenzo, fprema co rato e manteña o botón premido para estirar a - forma dende onde fixo clic. Algunhas formas poden cambiar a - proporción (por exemplo, o rectángulo e o óvalo poden ser máis - largos que altos ou máis altos que largos), outros non (por - exemplo, cadrados e círculos). - - For shapes that can change proportion, the aspect ratio of the - shape will be shown at the bottom. For example: "1:1" will be - shown if it is "square" (as tall as it is wide); "2:1" if it is - either twice as wide as it is tall, or twice as tall as it is - wide; and so on. - - Solte o rato cando remate de estirar. - - Modo de formas normais - - Now you can move the mouse around the canvas to - rotate the shape. The angle your shape is rotated - will be shown at the bottom, in degrees (similar to - the "Lines" tool, described above). - - Prema de novo no botón do rato e a forma debuxarase - na cor actual. - - Modo de formas simples - If the "simple shapes" option is enabled, the shape - will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) - - ⚙ See the "Options" documentation to learn about the - "simple shapes" ("simpleshapes") option. - - e.Ferramentas «Texto» e «Etiquetas» - - Choose a font (from the 'Letters' available on the right) and a - color (from the color palette near the bottom). You may also apply - a bold, and/or an italic styling effect to the text. Click on the - screen and a cursor will appear. Type text and it will show up on - the screen. (You can change the font, color, and styling while - entering the text, before it is applied to the canvas.) - - Prema [Intro] ou [Retorno] e o texto será debuxado na imaxe e o - cursor moverase cara abaixo unha liña. - - Como alternativa, prema [Tab] e o texto será debuxado na imaxe, - mais o cursor moverase á dereita do texto, no canto de baixar unha - liña e á esquerda. (Isto pode ser útil para crear unha liña de - texto con cores, tipos de letra, estilos e tamaños mesturados.) - - Ao premer noutro lugar da imaxe mentres a entrada de texto aínda - está activa, a liña de texto actual moverase a esa posición (onde - pode continuar editándoa). - - Comparación de «Texto» con «Etiqueta» - - A ferramenta Texto é a ferramenta de entrada de texto - orixinal en Tux Paint. O texto introducido usando - esta ferramenta non se pode modificar nin mover máis - tarde, xa que pasa a formar parte do debuxo. Non - obstante, por mor de que o texto pasa a formar parte - da imaxe, pódese debuxar ou modificar empregando os - efectos da ferramenta Maxia (p. ex.: luxado, - tinguido, realce, etc.) - - Ao usar a ferramenta Etiqueta (que foi engadida a Tux - Paint na versión 0.9.22), o texto «flota» sobre a - imaxe e os detalles da etiqueta (o texto, a posición - da etiqueta , a opción de letra e a cor) almacénanse - por separado. Isto permite recolocar ou editar a - etiqueta máis adiante. - - To edit a label, click the label selection button. - All labels in the drawing will appear highlighted. - Click one — or use the [Tab] key to cycle through all - the labels, and the [Intro] or [Retorno] key to - select one — and you may then edit the label. (Use - they [Backspace] key to erase characters, and other - keys to add text to the label; click in the canvas to - reposition the label; click in the palette to change - the color of the text in the label; etc.) - - You may "apply" a label to the canvas, painting the - text into the picture as if it had been added using - the Text tool, by clicking the label application - button. (This feature was added in Tux Paint version - 0.9.28.) All labels in the drawing will appear - highlighted, and you select one just as you do when - selecting a label to edit. The chosen label will be - removed, and the text will be added directly to the - canvas. - - ⚙ A ferramenta Etiqueta pódese desactivar (p. ex.: - seleccionando «Desactivar a ferramenta "Etiqueta"» en - Tux Paint Config. ou executando Tux Paint coa opción - «nolabel»). - - Introdución de caracteres internacionais - - Tux Paint permite introducir caracteres en diferentes - idiomas. A maioría dos caracteres latinos (A-Z, ñ, è, - etc.) poden introducirse directamente. Algúns idiomas - requiren que Tux Paint pase a un modo de entrada - alternativo antes de introducilos e algúns caracteres - deben compoñerse premendo varias teclas. - - Cando a configuración local de Tux Paint está - estabelecida nun dos idiomas que fornecen modos de - entrada alternativos, úsase unha tecla para pasar do - modo normal (caracteres latinos) ao modo ou modos - específicos da configuración local. - - Currently supported locales, the input methods - available, and the key to toggle or cycle modes, are - listed below. - - * Japanese — Romanized Hiragana and Romanized - Katakana — tecla [Alt] da dereita or tecla [Alt] - da esquerda - * Coreano — Hangul 2-Bul — tecla [Alt] da dereita - or tecla [Alt] da esquerda - * Chinés tradicional — tecla [Alt] da dereita ou - tecla [Alt] da esquerda - * Tailandés — tecla [Alt] da dereita - - 💡 Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change - fonts to see the characters you're trying to type. - - Teclado en pantalla - - An optional on-screen keyboard is available for the - Text and Label tools, which can provide a variety of - layouts and character composition (e.g., composing - "a" and "e" into "æ"). - - ⚙ See the "Options" and "Extending Tux Paint" - documentation for more information. - - f.Ferramenta «Encher» - - A ferramenta «Encher» inunda unha área contigua do seu debuxo - cunha cor da súa escolla. Ofrécense tres opcións de recheo: - * Sólida: prema unha vez para encher unha área cunha cor - sólida. - * Brush — click and drag to fill an area with a solid color - using freehand painting. - * Lineal: prema e arrastra para encher a área cunha cor que se - esvae (un gradiente) cara a onde arrastra o rato. - * Radial: prema unha vez para encher unha área cunha cor que se - esvae (un gradiente) radialmente, centrado no lugar onde - premeu. - * Shaped — click once to fill an area with a color that fades - away (a gradient), following the contours of the shape you're - filling. - - 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see - below). Prior to Tux Paint 0.9.26, the "Fill" tool only offered - the 'Solid' method of filling. 'Shaped' fill was introduced in Tux - Paint 0.9.29. - - g.Ferramenta «Maxia» (efectos especiais) - - A ferramenta Maxia é realmente un conxunto de ferramentas - especiais. Seleccione un dos efectos «máxicos» no selector da - dereita. Após, dependendo da ferramenta, pode premer e arrastrar - arredor da imaxe e/ou simplemente premer na imaxe unha vez para - aplicar o efecto. - - Magic Controls - - Se a ferramenta pode usarse premendo e arrastrando, estará - dispoñíbel un botón de «pintura» á esquerda, baixo a lista de - ferramentas Maxia na parte dereita da pantalla. Se a ferramenta - pode afectar toda a imaxe á vez, haberá un botón «imaxe - completa» á dereita. - - ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't - display the painting or entire picture controls. See the - "Options" documentation. - - 💡 If the magic controls are disabled, the Magic plugin may make - separate tools available, one for painting and one that affects - the entire pictre. - - Magic Sizing - - Some tools offer different sizing options. If so, a slider will - appear at the bottom right side of the screen. This may affect - the radius of a special effect (e.g., Darken) or painted object - (e.g., Patterns), or other attributes (e.g., large versus small - Brick shapes). - - ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't - display the sizing controls. See the "Options" documentation. - - 💡 If the sizing option is disabled, the Magic plugin may simply - offer a default size (e.g., Patterns), or it may make separate - tools available with different pre-set sizes (e.g., Bricks and - Googly Eyes). - - 📜 This option was added starting with Tux Paint version 0.9.30. - - Consulte as instrucións de cada ferramenta Máxica (no cartafol - «magic-docs»). - - h.Ferramenta de «Goma» (de borrar) - - Esta ferramenta é similar ao pincel. Onde queira que prema (ou - prema e arrastre), a imaxe borrarase. (Pode ser branco, doutra cor - ou a unha imaxe de fondo, dependendo da imaxe.) - - A number of eraser sizes are available, with both square and round - shapes. Fuzzy-edged round shapes are also available. - - Ao mover o rato, un contorno cadrado segue o punteiro, amosando - que parte da imaxe se borrará a branco. - - Ao borralo, reprodúcese un son de borrado «rechiante». - - ⌨ Hold the [X] key while clicking for quick access to a small - sharp round eraser (not available when the Text or Label tools are - selected, when you're in the process of rotating a stamp or shape, - or when using an interactive magic tool). Release the mouse to - return to your currently-selected tool. - - 2. Outros controis - - a."Undo" and "Redo" Commands - - Clicking the "Undo" button will undo (revert) the last drawing - action. You can even undo more than once! - - ⌨ Nota: Tamén pode premer [Control / ⌘] + [Z] no teclado para - Desfacer. - - Clicking the "Redo" button will redo the drawing action you just - un-did via the "Undo" command. - - Mentres non volva debuxar, pode refacer tantas veces como teña - desfeito. - - ⌨ Nota: Tamén pode premer [Control / ⌘] + [R] no teclado para - Refacer. - - b.Orde «Novo» - - Ao premer no botón «Novo» iniciarase un novo debuxo. Aparecerá un - diálogo no que pode escoller comezar unha nova imaxe cunha cor de - fondo sólida ou usando unha imaxe «de Inicio» ou «modelo» (ver - máis abaixo). Primeiro preguntaráselle se realmente quere facelo. - - ⌨ Nota: Tamén pode premer [Control / ⌘] + [N] no teclado para - iniciar un novo debuxo. +1. Ferramentas de debuxo - Special Solid Background Color Choices - Along with the preset solid colors, you can also - choose colors using a rainbow palette or a "color - mixer". These operate identically to the options - found in the color palette shown below the canvas - when drawing a picture. See Main Screen > Lower: - Colors > Special color options for details. +a. Ferramenta «Pintar» (pinceis) - Imaxes «de comezo» e de «modelo» - * As «imaxes de inicio» poden comportarse como - unha páxina dun libro para colorar: un contorno - en branco e negro dunha imaxe, que logo pode - colorar e o contorno negro permanecerá intacto, - ou como unha fotografía en 3D, onde debuxa entre - primeiro plano e a capa de fondo. - * Os «modelos» son similares, pero simplemente - fornecen un debuxo de fondo para poder - traballar. A diferenza das «imaxes de inicio», - non hai ningunha capa que permaneza no primeiro - plano de nada que debuxe na imaxe. + A ferramenta Pincel permítelle debuxar a man alzada usando varios pinceis + (escollidos no Selector da dereita) e cores (escollidos na Paleta de cores + cara á parte inferior). - Cando se usa a ferramenta «Borrador», reaparecerá a - imaxe orixinal da «imaxe de inicio» ou do «modelo». - As ferramentas máxicas «Inverter» e «Espello» tamén - afectan á orientación da «imaxe de inicio» ou do - «modelo». + Se mantén premido o botón do rato e move o rato, irá debuxando a medida que + se move. - Cando carga unha «imaxe de inicio» ou un «modelo», - debuxa nel(a) e logo preme en «Gardar», crea un novo - ficheiro de imaxe; non sobrescribe o orixinal, polo - que pode usalo de novo máis adiante (accedendo a el - dende o diálogo «Novo»). + Some brushes are animated — they change their shape as you draw them. A + good example of this is the vines brush that ships with Tux Paint. These + brushes will have a small "filmstrip" icon drawn on their Selector buttons. - ⚙ You can create your own 'Starter' and Template - images. See the Extending Tux Paint documentation's - sections on 'Starters' and Templates. + Other brushes are directional — they will draw a different shape depending + on what direction you are painting with them. An example of this is the + arrow brush that ships with Tux Paint. These brushes have a small 8-way + arrow icon drawn on their Selector buttons. - 💡 You can also convert your saved drawings into - Templates directly within Tux Paint, from the 'Open' - dialog. See "Open", below. + Finally, some brushes can be both direction and animated. Examples of this + are the cat and squirrel brushes that ship with Tux Paint. These brushes + will have both the "filmstrip" and 8-way arrow icons. - Erasing Exported Template Images + Mentres debuxa, soa un son. Canto maior sexa o pincel, menor será o ton. - If you've selected a Template in your personal - templates folder, and it was created from within Tux - Paint (using the "Template" button in the "Open" - dialog), you may remove it from within Tux Paint, - too. An 'Erase' (trash can) button will appear at the - lower right of the list. Click it to erase the - selected template. (You will be asked to confirm.) + Espazado do pincel - 💡 Note: On Linux, Windows, and macOS, the picture - will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you - change your mind). - ⚙ Note: The 'Erase' button may be disabled, via the - "noerase" option. + The space between each position where a brush is applied to the canvas + can vary. Some brushes (such as the footprints and flower) are spaced, + by default, far enough apart that they don't overlap. Other brushes + (such as the basic circular ones) are spaced closely, so they make a + continuous stroke. - ⚙ Note: The solid colors can be placed at the end of the 'New' - dialog (below the Starters and Templates), via the "newcolorslast" - option. + The default spacing of brushes may be overridden using by clicking + within the triangular-shaped series of bars at the bottom right; the + larger the bar, the wider the spacing. Brush spacing affects both tools + that use the brushes: the "Paint" tool and the "Lines" tool. - c.Orde «Abrir» + ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't display + the brush spacing controls. See the "Options" documentation. - Isto amosa unha lista de todas as imaxes que gardou. Se hai máis - do que pode caber na pantalla, use as frechas arriba e abaixo na - parte superior e inferior da lista para desprazarse pola lista de - imaxes. - Prema nunha imaxe para seleccionala e logo... - * Click the green 'Open' button at the lower left of the list - to load the selected picture. You will then be able to edit - it. - (Como alternativa, pode facer dobre clic na icona dunha imaxe - para cargala.) +b.Ferramenta «Selo» (selos de caucho) - 💡 If choose to open a picture, and your current drawing - hasn't been saved, you will be prompted as to whether you - want to save it or not. (See "Save," below.) + A ferramenta Selo é como un conxunto de selos de cacho ou adhesivos. + Permítelle pegar imaxes fotográficas ou debuxadas previamente (como a imaxe + dun cabalo, unha árbore ou a lúa) na súa imaxe. - * Prema no botón marrón «Borrar» (cesta do lixo) na parte - inferior dereita da lista para borrar a imaxe seleccionada. - (Pediráselle que o confirme). + As you move the mouse around the canvas, an outline follows the mouse, + showing where the stamp will be placed, and how big it will be. Click on + the canvas where you wish to place the stamp. - 📜 Note: On Linux (as of version 0.9.22), Windows (as of - version 0.9.27), and macOS (as of version 0.9.29), the - picture will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you change your - mind). + Stamp Categories + Pode haber numerosas categorías de selos (por exemplo, animais, + plantas, espazo exterior, vehículos, persoas, etc.). Use as frechas + esquerda e dereita preto da parte inferior do selector para percorrer + as coleccións. - ⚙ Note: The 'Erase' button may be disabled, via the "noerase" - option. + Stamp Rotation - * Click the 'Export' button near the lower right to export the - selected picture to your export folder. (e.g., - "~/Pictures/TuxPaint/") + Using the rotation toggle button near the bottom right, you can enable + a rotation step when placing stamps. Once you've placed the stamp, + choose the angle to rotate it by moving the mouse around the canvas. + Click the mouse button again and the stamp will be added to the + drawing. - From the "Open" screen you can also: - * Click the blue 'Slides' (slide projector) button at the lower - left to go to slideshow mode. See "Slides", below, for - details. + ⚙ Note: If "stamp rotation" option is disabled, the stamp will be drawn + on the canvas when you let go of the mouse button. (There's no rotation + step.) See the "Options" documentation to learn about the "stamp + rotation" ("stamprotation") option. - * Click the blue 'Template' button at the lower left to go to - convert the selected picture into a new template, which can - be used as the basis for new drawings. + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - 📜 Note: The Template creation feature was added to Tux Paint - in version 0.9.31. To learn how to create Templates outside - of Tux Paint, see Extending Tux Paint - ⚙ The Template creation feature can be disabled (e.g., by - selecting "Disable 'Make Template'" in Tux Paint Config. or - running Tux Paint with the "notemplateexport" option). - * Prema no botón de frecha vermello «Atrás» situado na parte - inferior dereita da lista para cancelar e volver á imaxe que - debuxaba. + Stamp Controls - ⌨ Nota: Tamén pode premer [Control / ⌘] + [O] no teclado para - activar o diálogo «Abrir». + Antes de «estampar» unha imaxe no seu debuxo, ás veces pódense aplicar + varios efectos (dependendo do selo): - d.Orde «Gardar» + o Algúns selos pódense colorea ou matizar. Se a paleta de cores baixo + o lenzo está activada, pode premer nas cores para cambiar o ton ou + a cor do selo antes de colocalo na imaxe. + o Os selos poden reducirse e expandirse premendo dentro da serie de + barras de forma triangular na parte inferior dereita; canto maior + sexa a barra, máis grande aparecerá o selo na súa imaxe. + o Moitos selos poden inverterse verticalmente ou amosarse como unha + imaxe reflectida, usando os botóns de control na parte inferior + dereita. - Isto garda a súa imaxe actual. + ⚙ Note: If the "nostampcontrols" option is set, Tux Paint won't display + the Rotation, Mirror, Flip, or sizing controls for stamps. See the " + Options" documentation. - Se non o gardou antes, creará unha nova entrada na lista de imaxes - gardadas. (é dicir, creará un novo ficheiro) - 💡 Nota: Non lle pedirá nada (por exemplo, un nome de ficheiro). - Simplemente gardará a imaxe e reproducirá un efecto de son - «obturador de cámara». - Se xa gardou a imaxe antes, ou esta é unha imaxe que acaba de - cargar coa orde «Abrir», primeiro preguntaráselle se quere gardar - sobre a versión antiga ou crear unha nova entrada (un novo - ficheiro). + Stamp Sounds - ⚙ Nota: Se foron estabelecidas as opcións «saveover» ou - «saveovernew», non preguntará antes de gardar. Vexa a - documentación de «Opcións». + Diferentes selos poden ter diferentes efectos sonoros e/ou sons + descritivos (falados). Os botóns da área de axuda na parte inferior + esquerda (preto de Tux, o pingüín de Linux) permiten reproducir de novo + os efectos de son e os sons descritivos para o selo seleccionado nese + momento. - ⌨ Nota: Tamén pode premer [Control / ⌘] + [S] no teclado para - gardar. - e.Orde «Imprimir» - Prema neste botón e imprimirase a súa imaxe. - Na maioría das plataformas, tamén pode manter premida a tecla - [Alt] (chamada [Opción] en Mac) ao premer no botón «Imprimir» para - obter unhja caixa de diálogo coa impresora. Teña en conta que isto - pode non funcionar se está a executar Tux Paint en modo de - pantalla completa. Vexa a continuación. - Desactivar a impresión - Pódese estabelecer a opción «noprint», que - desactivará o botón «Imprimir» de Tux Paint. +c.Ferramenta «Liñas» - ⚙ Vexa a documentación de «Opcións. + Esta ferramenta permítelle debuxar liñas rectas empregando os diversos + pinceis e cores que normalmente emprega co pincel. - Restrición da impresión + Click the mouse and hold it to choose the starting point of the line. As + you move the mouse around, a thin 'rubber-band' line will show where the + line will be drawn. At the bottom, you'll see the angle of your line, in + degrees. A line going straight to the right is 0°, a line going straight up + is 90°, a line going straight left is 180°, a line going straight down is + 270°, and so on. - Pódese estabelecer a opción «printdelay», que só - permitirá imprimir ocasionalmente, cada tantos - segundos, segundo o configure vostede. + Solte o rato para completar a liña. Soará un «chimpo». - Por exemplo, con «printdelay=60» no ficheiro de - configuración de Tux Paint, a impresión só pode - producirse unha vez por minuto (60 segundos). + Some brushes are animated, and will show a pattern of shapes along the + line. Others are directional, and will show a different shape depending on + the angle of the brush. And finally some are both animated and directional. + See "Paint", above, to learn more. - ⚙ Vexa a documentación de «Opcións. + Different brushes have different spacing, leaving either a series of + individual shapes, or a continuous stroke of the brush shape. Brush spacing + may be adjusted. See the brush spacing section of the "Paint" tool, above, + to learn more. - Ordes de impresión - (Só Linux e Unix) - Tux Paint imprime creando unha representación - PostScript da imaxe e envíaa a un programa externo. - De xeito predeterminado, o programa é: +d.Ferramenta «Formas» - lpr + Esta ferramenta permítelle debuxar algunhas formas sinxelas enchidas e sen + encher. - Esta orde pódese cambiar axustando unha opción - «printcommand» no ficheiro de configuración de Tux - Paint. + Seleccione unha forma do selector da dereita (círculo, cadrado, óvalo, + etc.). - Pódese invocar unha orde de impresión alternativa - mantendo premida a tecla «[Alt]» ao premer no botón - «Imprimir», sempre que non estea en modo de pantalla - completa, execútase un programa alternativo. De xeito - predeterminado, o programa é o diálogo de impresión - gráfica de KDE: + Use as opcións da parte inferior dereita para escoller o comportamento da + ferramenta de forma: - kprinter + Formas dende o centro + The shape will expand from where you initially clicked, and will be + centered around that position. - Esta orde pódese cambiar axustando unha opción - «altprintcommand» no ficheiro de configuración de Tux - Paint. + 📜 This was Tux Paint's only behavior through version 0.9.24.) - ⚙ Vexa a documentación de «Opcións. - Axustes de impresión - (Windows e macOS) + Formas dende cantos + The shape will extend with one corner starting from where you initially + clicked. This is the default method of most other traditional drawing + software. - De xeito predeterminado, Tux Paint simplemente - imprime na impresora predeterminada cos axustes - predeterminados cando se preme o botón «Imprimir». + 📜 This option was added starting with Tux Paint version 0.9.25. - Non obstante, se mantén premida a tecla [Alt] (ou - [Opción]) mentres cando preme no botón «Imprimir», - sempre que non estea en modo de pantalla completa, - aparecerá o diálogo da impresora do seu sistema - operativo no que poderá cambiar os axustes. - Pode gardar os cambios na configuración da impresora - entre as sesións de Tux Paint axustando a opción - «printcfg». - Se se usa a opción «printcfg», os axustes da - impresora cargaranse dende o ficheiro «printcfg.cfg» - no seu cartafol persoal (ver a continuación). - Calquera cambio tamén se gardará alí. - ⚙ Vexa a documentación de «Opcións. + ⚙ Nota: Se os controis de forma están desactivados (p. ex.: coa opción + «noshapecontrols»), non se presentarán os controis e empregarase o método + «formas dende o centro». - Dialogo de opcións da impresora + No lenzo, fprema co rato e manteña o botón premido para estirar a forma + dende onde fixo clic. Algunhas formas poden cambiar a proporción (por + exemplo, o rectángulo e o óvalo poden ser máis largos que altos ou máis + altos que largos), outros non (por exemplo, cadrados e círculos). - De xeito predeterminado, Tux Paint só amosa o diálogo - da impresora (ou, en Linux/Unix, executa - «altprintcommand»; p. ex.: «kprinter» no canto de - «lpr») se se mantén premida a tecla [Alt] (ou - [Opción]) ao premer no botón «Imprimir». + For shapes that can change proportion, the aspect ratio of the shape will + be shown at the bottom. For example: "1:1" will be shown if it is "square" + (as tall as it is wide); "2:1" if it is either twice as wide as it is tall, + or twice as tall as it is wide; and so on. - Non obstante, este comportamento pódese cambiar. Pode - facer que o diálogo da impresora apareza sempre - usando «--altprintalways» na liña de ordes ou - «altprint=always» no ficheiro de configuración de Tux - Paint. Pola contra, pode evitar que a tecla - [Alt]/[Opción] teña ningún efecto empregando - «--altprintnever» ou «altprint=never». + Solte o rato cando remate de estirar. - ⚙ Vexa a documentación de «Opcións. + Modo de formas normais - f.Orde «Diapositivas» (en «Abrir») + Now you can move the mouse around the canvas to rotate the shape. The + angle your shape is rotated will be shown at the bottom, in degrees + (similar to the "Lines" tool, described above). - O botón «Diapositivas» está dispoñíbel no diálogo «Abrir». Pode - usarse para reproducir unha animación sinxela dentro de Tux Paint - ou un diaporama. Tamén pode exportar un GIF animado baseado nas - imaxes escollidas. + Prema de novo no botón do rato e a forma debuxarase na cor actual. - Escolla de imaxes - Cando entra na sección «Diapositivas» de Tux Paint, - amosase unha lista dos seus ficheiros gardados, do - mesmo xeito que o diálogo «Abrir». - Prema en cada unha das imaxes que quere amosar nun - diaporama ao modo de presentación de diapositivas, - unha por unha. Aparecerá un díxito sobre cada imaxe, - indicándolle en que orde se amosarán. + Modo de formas simples + If the "simple shapes" option is enabled, the shape will be drawn on + the canvas when you let go of the mouse button. (There's no rotation + step.) - Pode premer nunha imaxe seleccionada para desmarcala - (sacala do diaporama). Prema de novo se quere - engadila ao final da lista. + ⚙ See the "Options" documentation to learn about the "simple shapes" + ("simpleshapes") option. - Estabelecer a velocidade de reprodución - Pódese usar unha escala desprazábel na parte inferior - esquerda da pantalla (xunto ao botón «Reproducir») - para axustar a velocidade do diaporama ou do GIF - animado, de máis lenta a máis rápida. Escolla o - axuste máis á esquerda para desactivar o avance - automático durante a reprodución dentro de Tux Paint; - terá que premer unha tecla ou facer clic para ir á - seguinte diapositiva (ver a continuación). - 💡 Nota: O axuste máis lento non avanza - automaticamente entre as diapositivas. Úseo para - cando queira percorrelas manualmente. (Isto non se - aplica a un GIF animado exportado). - Reprodución en Tux Paint - To play a slideshow within Tux Paint, click the - 'Play' button. - 💡 Note: If you hadn't selected any images, then all - of your saved images will be played in the slideshow! +e.Ferramentas «Texto» e «Etiquetas» - Durante a presentación de diapositivas, prema - [Espazo], [Intro] ou [Retorno] ou o [Frecha cara á - dereita] —ou prema no botón «Seguinte»— na parte - inferior esquerda para avanzar manualmente á seguinte - diapositiva. Prema [Frecha cara arriba] para volver á - diapositiva anterior. + Choose a font (from the 'Letters' available on the right) and a color (from + the color palette near the bottom). You may also apply a bold, and/or an + italic styling effect to the text. Click on the screen and a cursor will + appear. Type text and it will show up on the screen. (You can change the + font, color, and styling while entering the text, before it is applied to + the canvas.) - Prema [Escape] ou prema no botón «Atrás» na parte - inferior dereita para saír do diaporama e volver á - pantalla de selección de imaxes do diaporama. + Prema [Intro] ou [Retorno] e o texto será debuxado na imaxe e o cursor + moverase cara abaixo unha liña. - Exportar un GIF animado + Como alternativa, prema [Tab] e o texto será debuxado na imaxe, mais o + cursor moverase á dereita do texto, no canto de baixar unha liña e á + esquerda. (Isto pode ser útil para crear unha liña de texto con cores, + tipos de letra, estilos e tamaños mesturados.) - Prema no botón «Exportar GIF» preto da parte inferior - dereita para que Tux Paint xere un ficheiro GIF - animado baseado nas imaxes seleccionadas. + Ao premer noutro lugar da imaxe mentres a entrada de texto aínda está + activa, a liña de texto actual moverase a esa posición (onde pode continuar + editándoa). - 💡 Note: At least two images must be selected. (To - export a single image, use the 'Export' option from - the main 'Open' dialog.) If no images are selected, - Tux Paint will not attempt to generate a GIF based on - all saved images. + Comparación de «Texto» con «Etiqueta» - Ao premer [Escape] durante o proceso de exportación - abortarase e volverá ao diálogo «Diaporama». + A ferramenta Texto é a ferramenta de entrada de texto orixinal en Tux + Paint. O texto introducido usando esta ferramenta non se pode modificar + nin mover máis tarde, xa que pasa a formar parte do debuxo. Non + obstante, por mor de que o texto pasa a formar parte da imaxe, pódese + debuxar ou modificar empregando os efectos da ferramenta Maxia (p. ex.: + luxado, tinguido, realce, etc.) - Prema en «Atrás» na pantalla de selección de imaxes de - diapositivas para volver ao diálogo «Abrir». + Ao usar a ferramenta Etiqueta (que foi engadida a Tux Paint na versión + 0.9.22), o texto «flota» sobre a imaxe e os detalles da etiqueta (o + texto, a posición da etiqueta , a opción de letra e a cor) almacénanse + por separado. Isto permite recolocar ou editar a etiqueta máis adiante. - g.Orde «Saír» + To edit a label, click the label selection button. All labels in the + drawing will appear highlighted. Click one — or use the [Tab] key to + cycle through all the labels, and the [Intro] or [Retorno] key to + select one — and you may then edit the label. (Use they [Backspace] key + to erase characters, and other keys to add text to the label; click in + the canvas to reposition the label; click in the palette to change the + color of the text in the label; etc.) - Ao premer no botón «Saír», pechando a xanela de Tux Paint ou - premendo a tecla [Escape] sairase de Tux Paint. + You may "apply" a label to the canvas, painting the text into the + picture as if it had been added using the Text tool, by clicking the + label application button. (This feature was added in Tux Paint version + 0.9.28.) All labels in the drawing will appear highlighted, and you + select one just as you do when selecting a label to edit. The chosen + label will be removed, and the text will be added directly to the + canvas. - Primeiro preguntaráselle se realmente quere saír. + ⚙ A ferramenta Etiqueta pódese desactivar (p. ex.: seleccionando + «Desactivar a ferramenta "Etiqueta"» en Tux Paint Config. ou executando + Tux Paint coa opción «nolabel»). - If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new - image, you will then be asked if you want to save over the old - version, or create a new entry. (See "Save" above.) - ⚙ Nota: Se se garda a imaxe, volverá cargarse automaticamente a - próxima vez que execute Tux Paint, a non ser que estea configurada - a opción «startblank». - ⚙ Nota: O botón «Saír» de Tux Paint e saír a través da tecla - [Escape] pode estar desactivado mediante a opción «noquit». + Introdución de caracteres internacionais - Nese caso, pódese usar o botón «pechar a xanela» na barra de - título de Tux Paint (se non está en modo pantalla completa) ou a - secuencia de teclas [Alt] + [F4] para saír. + Tux Paint permite introducir caracteres en diferentes idiomas. A + maioría dos caracteres latinos (A-Z, ñ, è, etc.) poden introducirse + directamente. Algúns idiomas requiren que Tux Paint pase a un modo de + entrada alternativo antes de introducilos e algúns caracteres deben + compoñerse premendo varias teclas. - Se ningún das dúas é posíbel, pódese usar a secuencia de teclas - [Maiúsculas] + [Control / ⌘] + [Escape] para saír. + Cando a configuración local de Tux Paint está estabelecida nun dos + idiomas que fornecen modos de entrada alternativos, úsase unha tecla + para pasar do modo normal (caracteres latinos) ao modo ou modos + específicos da configuración local. - ⚙ Vexa a documentación de «Opcións. + Currently supported locales, the input methods available, and the key + to toggle or cycle modes, are listed below. - h.Silenciar o son + o Japanese — Romanized Hiragana and Romanized Katakana — tecla [Alt] + da dereita or tecla [Alt] da esquerda + o Coreano — Hangul 2-Bul — tecla [Alt] da dereita or tecla [Alt] da + esquerda + o Chinés tradicional — tecla [Alt] da dereita ou tecla [Alt] da + esquerda + o Tailandés — tecla [Alt] da dereita + + 💡 Note: Many fonts do not include all characters for all languages, so + sometimes you'll need to change fonts to see the characters you're + trying to type. + + + + Teclado en pantalla + + An optional on-screen keyboard is available for the Text and Label + tools, which can provide a variety of layouts and character composition + (e.g., composing "a" and "e" into "æ"). + + ⚙ See the "Options" and "Extending Tux Paint" documentation for more + information. + + + + + + +f.Ferramenta «Encher» + + A ferramenta «Encher» inunda unha área contigua do seu debuxo cunha cor da + súa escolla. Ofrécense tres opcións de recheo: + + Sólida: prema unha vez para encher unha área cunha cor sólida. + + Brush — click and drag to fill an area with a solid color using + freehand painting. + + Lineal: prema e arrastra para encher a área cunha cor que se esvae (un + gradiente) cara a onde arrastra o rato. + + Radial: prema unha vez para encher unha área cunha cor que se esvae (un + gradiente) radialmente, centrado no lugar onde premeu. + + Shaped — click once to fill an area with a color that fades away (a + gradient), following the contours of the shape you're filling. + + 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see below). + Prior to Tux Paint 0.9.26, the "Fill" tool only offered the 'Solid' method + of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29. + + + +g.Ferramenta «Maxia» (efectos especiais) + + A ferramenta Maxia é realmente un conxunto de ferramentas especiais. + Seleccione un dos efectos «máxicos» no selector da dereita. Após, + dependendo da ferramenta, pode premer e arrastrar arredor da imaxe e/ou + simplemente premer na imaxe unha vez para aplicar o efecto. + + Magic Controls + + + Se a ferramenta pode usarse premendo e arrastrando, estará dispoñíbel + un botón de «pintura» á esquerda, baixo a lista de ferramentas Maxia na + parte dereita da pantalla. Se a ferramenta pode afectar toda a imaxe á + vez, haberá un botón «imaxe completa» á dereita. + + ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't display + the painting or entire picture controls. See the "Options" + documentation. + + 💡 If the magic controls are disabled, the Magic plugin may make + separate tools available, one for painting and one that affects the + entire pictre. + + Magic Sizing + + + Some tools offer different sizing options. If so, a slider will appear + at the bottom right side of the screen. This may affect the radius of a + special effect (e.g., Darken) or painted object (e.g., Patterns), or + other attributes (e.g., large versus small Brick shapes). + + ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't display + the sizing controls. See the "Options" documentation. + + 💡 If the sizing option is disabled, the Magic plugin may simply offer a + default size (e.g., Patterns), or it may make separate tools available + with different pre-set sizes (e.g., Bricks and Googly Eyes). + + 📜 This option was added starting with Tux Paint version 0.9.30. + + Consulte as instrucións de cada ferramenta Máxica (no cartafol + «magic-docs»). + + + +h.Ferramenta de «Goma» (de borrar) + + Esta ferramenta é similar ao pincel. Onde queira que prema (ou prema e + arrastre), a imaxe borrarase. (Pode ser branco, doutra cor ou a unha imaxe + de fondo, dependendo da imaxe.) + + A number of eraser sizes are available, with both square and round shapes. + Fuzzy-edged round shapes are also available. + + Ao mover o rato, un contorno cadrado segue o punteiro, amosando que parte + da imaxe se borrará a branco. + + Ao borralo, reprodúcese un son de borrado «rechiante». + + ⌨ Hold the [X] key while clicking for quick access to a small sharp round + eraser (not available when the Text or Label tools are selected, when + you're in the process of rotating a stamp or shape, or when using an + interactive magic tool). Release the mouse to return to your + currently-selected tool. + + + + +2. Outros controis + +a."Undo" and "Redo" Commands + + Clicking the "Undo" button will undo (revert) the last drawing action. You + can even undo more than once! + + ⌨ Nota: Tamén pode premer [Control / ⌘] + [Z] no teclado para Desfacer. + + Clicking the "Redo" button will redo the drawing action you just un-did via + the "Undo" command. + + Mentres non volva debuxar, pode refacer tantas veces como teña desfeito. + + ⌨ Nota: Tamén pode premer [Control / ⌘] + [R] no teclado para Refacer. + + + +b.Orde «Novo» + + Ao premer no botón «Novo» iniciarase un novo debuxo. Aparecerá un diálogo + no que pode escoller comezar unha nova imaxe cunha cor de fondo sólida ou + usando unha imaxe «de Inicio» ou «modelo» (ver máis abaixo). Primeiro + preguntaráselle se realmente quere facelo. + + ⌨ Nota: Tamén pode premer [Control / ⌘] + [N] no teclado para iniciar un + novo debuxo. + + Special Solid Background Color Choices + Along with the preset solid colors, you can also choose colors using a + rainbow palette or a "color mixer". These operate identically to the + options found in the color palette shown below the canvas when drawing + a picture. See Main Screen > Lower: Colors > Special color options for + details. + + Imaxes «de comezo» e de «modelo» + o As «imaxes de inicio» poden comportarse como unha páxina dun libro + para colorar: un contorno en branco e negro dunha imaxe, que logo + pode colorar e o contorno negro permanecerá intacto, ou como unha + fotografía en 3D, onde debuxa entre primeiro plano e a capa de + fondo. + o Os «modelos» son similares, pero simplemente fornecen un debuxo de + fondo para poder traballar. A diferenza das «imaxes de inicio», non + hai ningunha capa que permaneza no primeiro plano de nada que + debuxe na imaxe. + + Cando se usa a ferramenta «Borrador», reaparecerá a imaxe orixinal da + «imaxe de inicio» ou do «modelo». As ferramentas máxicas «Inverter» e + «Espello» tamén afectan á orientación da «imaxe de inicio» ou do + «modelo». + + Cando carga unha «imaxe de inicio» ou un «modelo», debuxa nel(a) e logo + preme en «Gardar», crea un novo ficheiro de imaxe; non sobrescribe o + orixinal, polo que pode usalo de novo máis adiante (accedendo a el + dende o diálogo «Novo»). + + ⚙ You can create your own 'Starter' and Template images. See the + Extending Tux Paint documentation's sections on 'Starters' and + Templates. + + 💡 You can also convert your saved drawings into Templates directly + within Tux Paint, from the 'Open' dialog. See "Open", below. + + + + Erasing Exported Template Images + + If you've selected a Template in your personal templates folder, and it + was created from within Tux Paint (using the "Template" button in the + "Open" dialog), you may remove it from within Tux Paint, too. An + 'Erase' (trash can) button will appear at the lower right of the list. + Click it to erase the selected template. (You will be asked to + confirm.) + + 💡 Note: On Linux, Windows, and macOS, the picture will be placed in + your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + + + ⚙ Note: The solid colors can be placed at the end of the 'New' dialog + (below the Starters and Templates), via the "newcolorslast" option. + + + +c.Orde «Abrir» + + Isto amosa unha lista de todas as imaxes que gardou. Se hai máis do que + pode caber na pantalla, use as frechas arriba e abaixo na parte superior e + inferior da lista para desprazarse pola lista de imaxes. + + Prema nunha imaxe para seleccionala e logo... + + Click the green 'Open' button at the lower left of the list to load the + selected picture. You will then be able to edit it. + + (Como alternativa, pode facer dobre clic na icona dunha imaxe para + cargala.) + + 💡 If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.) + + + Prema no botón marrón «Borrar» (cesta do lixo) na parte inferior + dereita da lista para borrar a imaxe seleccionada. (Pediráselle que o + confirme). + + 📜 Note: On Linux (as of version 0.9.22), Windows (as of version + 0.9.27), and macOS (as of version 0.9.29), the picture will be placed + in your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + Click the 'Export' button near the lower right to export the selected + picture to your export folder. (e.g., "~/Pictures/TuxPaint/") + + From the "Open" screen you can also: + + Click the blue 'Slides' (slide projector) button at the lower left to + go to slideshow mode. See "Slides", below, for details. + + + Click the blue 'Template' button at the lower left to go to convert the + selected picture into a new template, which can be used as the basis + for new drawings. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. To learn how to create Templates outside of Tux Paint, see + Extending Tux Paint + + ⚙ The Template creation feature can be disabled (e.g., by selecting + "Disable 'Make Template'" in Tux Paint Config. or running Tux Paint + with the "notemplateexport" option). + + + Prema no botón de frecha vermello «Atrás» situado na parte inferior + dereita da lista para cancelar e volver á imaxe que debuxaba. + + ⌨ Nota: Tamén pode premer [Control / ⌘] + [O] no teclado para activar o + diálogo «Abrir». + + + +d.Orde «Gardar» + + Isto garda a súa imaxe actual. + + Se non o gardou antes, creará unha nova entrada na lista de imaxes + gardadas. (é dicir, creará un novo ficheiro) + + 💡 Nota: Non lle pedirá nada (por exemplo, un nome de ficheiro). Simplemente + gardará a imaxe e reproducirá un efecto de son «obturador de cámara». + + Se xa gardou a imaxe antes, ou esta é unha imaxe que acaba de cargar coa + orde «Abrir», primeiro preguntaráselle se quere gardar sobre a versión + antiga ou crear unha nova entrada (un novo ficheiro). + + ⚙ Nota: Se foron estabelecidas as opcións «saveover» ou «saveovernew», non + preguntará antes de gardar. Vexa a documentación de «Opcións». + + ⌨ Nota: Tamén pode premer [Control / ⌘] + [S] no teclado para gardar. + + + +e.Orde «Imprimir» + + Prema neste botón e imprimirase a súa imaxe. + + Na maioría das plataformas, tamén pode manter premida a tecla [Alt] + (chamada [Opción] en Mac) ao premer no botón «Imprimir» para obter unhja + caixa de diálogo coa impresora. Teña en conta que isto pode non funcionar + se está a executar Tux Paint en modo de pantalla completa. Vexa a + continuación. + + Desactivar a impresión + + Pódese estabelecer a opción «noprint», que desactivará o botón + «Imprimir» de Tux Paint. + + ⚙ Vexa a documentación de «Opcións. + + + + Restrición da impresión + + Pódese estabelecer a opción «printdelay», que só permitirá imprimir + ocasionalmente, cada tantos segundos, segundo o configure vostede. + + Por exemplo, con «printdelay=60» no ficheiro de configuración de Tux + Paint, a impresión só pode producirse unha vez por minuto (60 + segundos). + + ⚙ Vexa a documentación de «Opcións. + + + + Ordes de impresión + + (Só Linux e Unix) + + Tux Paint imprime creando unha representación PostScript da imaxe e + envíaa a un programa externo. De xeito predeterminado, o programa é: + + lpr + + Esta orde pódese cambiar axustando unha opción «printcommand» no + ficheiro de configuración de Tux Paint. + + Pódese invocar unha orde de impresión alternativa mantendo premida a + tecla «[Alt]» ao premer no botón «Imprimir», sempre que non estea en + modo de pantalla completa, execútase un programa alternativo. De xeito + predeterminado, o programa é o diálogo de impresión gráfica de KDE: + + kprinter + + Esta orde pódese cambiar axustando unha opción «altprintcommand» no + ficheiro de configuración de Tux Paint. + + ⚙ Vexa a documentación de «Opcións. + + + + Axustes de impresión + + (Windows e macOS) + + De xeito predeterminado, Tux Paint simplemente imprime na impresora + predeterminada cos axustes predeterminados cando se preme o botón + «Imprimir». + + Non obstante, se mantén premida a tecla [Alt] (ou [Opción]) mentres + cando preme no botón «Imprimir», sempre que non estea en modo de + pantalla completa, aparecerá o diálogo da impresora do seu sistema + operativo no que poderá cambiar os axustes. + + Pode gardar os cambios na configuración da impresora entre as sesións + de Tux Paint axustando a opción «printcfg». + + Se se usa a opción «printcfg», os axustes da impresora cargaranse dende + o ficheiro «printcfg.cfg» no seu cartafol persoal (ver a continuación). + Calquera cambio tamén se gardará alí. + + ⚙ Vexa a documentación de «Opcións. + + + + Dialogo de opcións da impresora + + De xeito predeterminado, Tux Paint só amosa o diálogo da impresora (ou, + en Linux/Unix, executa «altprintcommand»; p. ex.: «kprinter» no canto + de «lpr») se se mantén premida a tecla [Alt] (ou [Opción]) ao premer no + botón «Imprimir». + + Non obstante, este comportamento pódese cambiar. Pode facer que o + diálogo da impresora apareza sempre usando «--altprintalways» na liña + de ordes ou «altprint=always» no ficheiro de configuración de Tux + Paint. Pola contra, pode evitar que a tecla [Alt]/[Opción] teña ningún + efecto empregando «--altprintnever» ou «altprint=never». + + ⚙ Vexa a documentación de «Opcións. + + + + + + +f.Orde «Diapositivas» (en «Abrir») + + O botón «Diapositivas» está dispoñíbel no diálogo «Abrir». Pode usarse para + reproducir unha animación sinxela dentro de Tux Paint ou un diaporama. + Tamén pode exportar un GIF animado baseado nas imaxes escollidas. + + Escolla de imaxes + + Cando entra na sección «Diapositivas» de Tux Paint, amosase unha lista + dos seus ficheiros gardados, do mesmo xeito que o diálogo «Abrir». + + Prema en cada unha das imaxes que quere amosar nun diaporama ao modo de + presentación de diapositivas, unha por unha. Aparecerá un díxito sobre + cada imaxe, indicándolle en que orde se amosarán. + + Pode premer nunha imaxe seleccionada para desmarcala (sacala do + diaporama). Prema de novo se quere engadila ao final da lista. + + + + Estabelecer a velocidade de reprodución + + Pódese usar unha escala desprazábel na parte inferior esquerda da + pantalla (xunto ao botón «Reproducir») para axustar a velocidade do + diaporama ou do GIF animado, de máis lenta a máis rápida. Escolla o + axuste máis á esquerda para desactivar o avance automático durante a + reprodución dentro de Tux Paint; terá que premer unha tecla ou facer + clic para ir á seguinte diapositiva (ver a continuación). + + 💡 Nota: O axuste máis lento non avanza automaticamente entre as + diapositivas. Úseo para cando queira percorrelas manualmente. (Isto non + se aplica a un GIF animado exportado). + + + + Reprodución en Tux Paint + + To play a slideshow within Tux Paint, click the 'Play' button. + + 💡 Note: If you hadn't selected any images, then all of your saved + images will be played in the slideshow! + + Durante a presentación de diapositivas, prema [Espazo], [Intro] ou + [Retorno] ou o [Frecha cara á dereita] —ou prema no botón «Seguinte»— + na parte inferior esquerda para avanzar manualmente á seguinte + diapositiva. Prema [Frecha cara arriba] para volver á diapositiva + anterior. + + Prema [Escape] ou prema no botón «Atrás» na parte inferior dereita para + saír do diaporama e volver á pantalla de selección de imaxes do + diaporama. + + + + Exportar un GIF animado + + Prema no botón «Exportar GIF» preto da parte inferior dereita para que + Tux Paint xere un ficheiro GIF animado baseado nas imaxes + seleccionadas. + + 💡 Note: At least two images must be selected. (To export a single + image, use the 'Export' option from the main 'Open' dialog.) If no + images are selected, Tux Paint will not attempt to generate a GIF based + on all saved images. + + Ao premer [Escape] durante o proceso de exportación abortarase e + volverá ao diálogo «Diaporama». + + + + + Prema en «Atrás» na pantalla de selección de imaxes de diapositivas para + volver ao diálogo «Abrir». + + + +g.Orde «Saír» + + Ao premer no botón «Saír», pechando a xanela de Tux Paint ou premendo a + tecla [Escape] sairase de Tux Paint. + + Primeiro preguntaráselle se realmente quere saír. + + If you choose to quit, and you haven't saved the current picture, you will + first be asked if wish to save it. If it's not a new image, you will then + be asked if you want to save over the old version, or create a new entry. + (See "Save" above.) + + ⚙ Nota: Se se garda a imaxe, volverá cargarse automaticamente a próxima vez + que execute Tux Paint, a non ser que estea configurada a opción + «startblank». + + ⚙ Nota: O botón «Saír» de Tux Paint e saír a través da tecla [Escape] pode + estar desactivado mediante a opción «noquit». + + Nese caso, pódese usar o botón «pechar a xanela» na barra de título de Tux + Paint (se non está en modo pantalla completa) ou a secuencia de teclas + [Alt] + [F4] para saír. + + Se ningún das dúas é posíbel, pódese usar a secuencia de teclas + [Maiúsculas] + [Control / ⌘] + [Escape] para saír. + + ⚙ Vexa a documentación de «Opcións. + + + +h.Silenciar o son + + Non hai ningún botón de control na pantalla neste momento, pero ao usar a + secuencia de teclado [Alt] + [S], os efectos de son pódense desactivar e + volver activar (silenciado e sactivado) mentres o programa está en + execución. + + Teña en conta que se os sons están completamente desactivados mediante a + opción «nosound», a combinación de teclas [Alt] + [S] non ten efecto. (é + dicir, non se pode usar para activar os sons cando o pai ou o profesor + quere que estean desactivados). + + ⚙ Vexa a documentación de «Opcións. - Non hai ningún botón de control na pantalla neste momento, pero ao - usar a secuencia de teclado [Alt] + [S], os efectos de son pódense - desactivar e volver activar (silenciado e sactivado) mentres o - programa está en execución. - Teña en conta que se os sons están completamente desactivados - mediante a opción «nosound», a combinación de teclas [Alt] + [S] - non ten efecto. (é dicir, non se pode usar para activar os sons - cando o pai ou o profesor quere que estean desactivados). - ⚙ Vexa a documentación de «Opcións. E. Controlling Tux Paint - 1. Using a Mouse or Trackball +1. Using a Mouse or Trackball - Tux Paint's main mode of operation is via any device that appears to your - operating system as a mouse, including standard mice, trackballs, and - trackpads, as well as drawing tablets (usually operated with a stylus) and - touch screens (operated with a finger and/or a stylus) (see "Using a - Tablet or Touchscreen" below for more information). +Tux Paint's main mode of operation is via any device that appears to your +operating system as a mouse, including standard mice, trackballs, and +trackpads, as well as drawing tablets (usually operated with a stylus) and +touch screens (operated with a finger and/or a stylus) (see "Using a Tablet or +Touchscreen" below for more information). - For drawing and controlling Tux Paint, only a single mouse button is used - — typically, on multi-button mice, this will the left mouse button, but - this can usually be configured at the operating system level. By default, - Tux Paint will ignore input from the other button(s). If a user attempts - to use the other button(s), a pop-up dialog will eventually appear - reminding them that only one button is recognized Tux Paint. However, you - may configure Tux Paint to accept any button as input (see the Options - documentation). +For drawing and controlling Tux Paint, only a single mouse button is used — +typically, on multi-button mice, this will the left mouse button, but this can +usually be configured at the operating system level. By default, Tux Paint will +ignore input from the other button(s). If a user attempts to use the other +button(s), a pop-up dialog will eventually appear reminding them that only one +button is recognized Tux Paint. However, you may configure Tux Paint to accept +any button as input (see the Options documentation). - a. Scrolling +a. Scrolling - Many input devices offer a way to quickly scroll within applications — - many mice have a scroll wheel, trackballs have scroll rings, and trackpads - recognize certain "scroll" gestures (e.g., two-finger vertical motion, or - vertical motion on the edge of the trackpad). Tux Paint supports scrolling - input to allow quick scrolling through certain lists (e.g., Stamps, Magic - tools, and the New and Open dialogs). +Many input devices offer a way to quickly scroll within applications — many +mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize +certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion +on the edge of the trackpad). Tux Paint supports scrolling input to allow quick +scrolling through certain lists (e.g., Stamps, Magic tools, and the New and +Open dialogs). - Tux Paint will also automatically scroll if you click and hold the mouse - down on an scroll button — the "up" and "down" arrow buttons that appear - above and below scrolling lists. +Tux Paint will also automatically scroll if you click and hold the mouse down +on an scroll button — the "up" and "down" arrow buttons that appear above and +below scrolling lists. - b. Mouse Accessibility +b. Mouse Accessibility - Other devices that appear as a mouse can be used to control Tux Paint. For - example: - * Head pointing/tracking devices - * Eye gaze trackers - * Foot mice +Other devices that appear as a mouse can be used to control Tux Paint. For +example: - Tux Paint offers a "sticky mouse click" accessibility setting, where a - single click begins a click-and-drag operation, and a subsequent click - ends it. (See the Options documentation.) + * Head pointing/tracking devices + * Eye gaze trackers + * Foot mice - 2. Using a Tablet or Touchscreen +Tux Paint offers a "sticky mouse click" accessibility setting, where a single +click begins a click-and-drag operation, and a subsequent click ends it. (See +the Options documentation.) - As noted above, Tux Paint recognizes any device that appears as a mouse. - This means drawing tablets and touchscreens may be used. However, these - devices often support other features beyond X/Y motion, button clicks, and - scroll-wheel motion. Currently, those additional features are not - supported by Tux Paint. Some examples: - * Pressure and angle - * Eraser tip - * Multi-touch gestures +2. Using a Tablet or Touchscreen - 3. Using a Joystick-like Device +As noted above, Tux Paint recognizes any device that appears as a mouse. This +means drawing tablets and touchscreens may be used. However, these devices +often support other features beyond X/Y motion, button clicks, and scroll-wheel +motion. Currently, those additional features are not supported by Tux Paint. +Some examples: - Tux Paint may be configured to recognize input from any game controller - that appears to your operating system as a joystick. That even includes - modern game console controllers connected via USB or Bluetooth (e.g., - Nintendo Switch or Microsoft Xbox game pads)! + * Pressure and angle + * Eraser tip + * Multi-touch gestures - Numerous configuration options are available to best suit the device being - used, and the user's needs. Analog input will be used for coarse movement, - and digital "hat" input for fine movement. Buttons on the controller can - be mapped to different Tux Paint controls (e.g., acting as the [Escape] - key, switching to the Paint tool, invoking Undo and Redo operations, - etc.). See the Options documentation for more details. +3. Using a Joystick-like Device - 4. Using the Keyboard +Tux Paint may be configured to recognize input from any game controller that +appears to your operating system as a joystick. That even includes modern game +console controllers connected via USB or Bluetooth (e.g., Nintendo Switch or +Microsoft Xbox game pads)! - Tux Paint offers an option to allow the keyboard to be used to control the - mouse pointer. This includes motion and clicking, as well as shortcuts to - navigate between and within certain parts of the interface. See the - Options documentation for more details. +Numerous configuration options are available to best suit the device being +used, and the user's needs. Analog input will be used for coarse movement, and +digital "hat" input for fine movement. Buttons on the controller can be mapped +to different Tux Paint controls (e.g., acting as the [Escape] key, switching to +the Paint tool, invoking Undo and Redo operations, etc.). See the Options +documentation for more details. - III. Carga doutras imaxes en Tux Paint +4. Using the Keyboard + +Tux Paint offers an option to allow the keyboard to be used to control the +mouse pointer. This includes motion and clicking, as well as shortcuts to +navigate between and within certain parts of the interface. See the Options +documentation for more details. + +III. Carga doutras imaxes en Tux Paint A. Overview - O diálogo «Abrir» de Tux Paint só amosa as imaxes que creou con Tux Paint. - Entón, que facer se quere cargar algún outro debuxo ou incluso unha - fotografía en Tux Paint para poder editala ou debuxar sobre ela? +O diálogo «Abrir» de Tux Paint só amosa as imaxes que creou con Tux Paint. +Entón, que facer se quere cargar algún outro debuxo ou incluso unha fotografía +en Tux Paint para poder editala ou debuxar sobre ela? - Pode simplemente converter a imaxe ao formato que usa Tux Paint –PNG - (Portable Network Graphics – Gráficos de Rede Portátiles)– e colocala no - directorio/cartafol «saved» de Tux Paint. Aquí é onde se atopa (de xeito - predeterminado: +Pode simplemente converter a imaxe ao formato que usa Tux Paint –PNG (Portable +Network Graphics – Gráficos de Rede Portátiles)– e colocala no directorio/ +cartafol «saved» de Tux Paint. Aquí é onde se atopa (de xeito predeterminado: - Windows 10, 8, 7, Vista - Dentro do cartafol «AppData» do usuario, p. : «C:\Users\nome de - usuario\AppData\Roaming\TuxPaint\saved\». +Windows 10, 8, 7, Vista + Dentro do cartafol «AppData» do usuario, p. : «C:\Users\nome de usuario\ + AppData\Roaming\TuxPaint\saved\». - Windows 2000, XP - Dentro do cartafol «Application Data» do usuario, p. : - «C:\Documents and Settings\nome de usuario\Application - Data\TuxPaint\saved\». +Windows 2000, XP + Dentro do cartafol «Application Data» do usuario, p. : «C:\Documents and + Settings\nome de usuario\Application Data\TuxPaint\saved\». - macOS - Dentro do cartafol «Library» do usuario, p. : «/Users/nome de - usuario/Library/Application Support/Tux Paint/saved/». +macOS + Dentro do cartafol «Library» do usuario, p. : «/Users/nome de usuario/ + Library/Application Support/Tux Paint/saved/». - Linux/Unix - Dentro dun directorio agochado «.tuxpaint», no seu directorio - persoal («$HOME»), p. ex.: «/home/nome de - usuario/.tuxpaint/saved/». +Linux/Unix + Dentro dun directorio agochado «.tuxpaint», no seu directorio persoal + («$HOME»), p. ex.: «/home/nome de usuario/.tuxpaint/saved/». - 💡 Nota: É tamén dende este cartafol dende onde pode copiar ou abrir imaxes - debuxadas en Tux Paint usando outras aplicacións, aínda que pode usar a - opción «Exportar» do diálogo «Abrir» de Tux Paint para copialas a unha - localización de acceso máis doado e seguro. + +💡 Nota: É tamén dende este cartafol dende onde pode copiar ou abrir imaxes +debuxadas en Tux Paint usando outras aplicacións, aínda que pode usar a opción +«Exportar» do diálogo «Abrir» de Tux Paint para copialas a unha localización de +acceso máis doado e seguro. B. Uso do script de importación, «tuxpaint-import» - Os usuarios de Linux e Unix poden usar o script «tuxpaint-import» que se - instala ao instalar Tux Paint. Emprega algunhas ferramentas NetPBM para - converter a imaxe («anytopnm»), redimensionala de xeito que poida caber no - lenzo de Tux Paint («pnmscale») e convertela a PNG («pnmtopng»). +Os usuarios de Linux e Unix poden usar o script «tuxpaint-import» que se +instala ao instalar Tux Paint. Emprega algunhas ferramentas NetPBM para +converter a imaxe («anytopnm»), redimensionala de xeito que poida caber no +lenzo de Tux Paint («pnmscale») e convertela a PNG («pnmtopng»). - Tamén usa a orde «date» para obter a hora e a data actual, que é a - convención de nomes de ficheiros que usa Tux Paint para os ficheiros - gardados. (Lembre que nunca se lle pide un «nome de ficheiro» cando vai - gardar ou abrir imaxes.) +Tamén usa a orde «date» para obter a hora e a data actual, que é a convención +de nomes de ficheiros que usa Tux Paint para os ficheiros gardados. (Lembre que +nunca se lle pide un «nome de ficheiro» cando vai gardar ou abrir imaxes.) - Para usar este script, abonda con executalo dende unha liña de ordes e - fornecerlle o nome do ficheiro que quere converter. +Para usar este script, abonda con executalo dende unha liña de ordes e +fornecerlle o nome do ficheiro que quere converter. - They will be converted and placed in your Tux Paint "saved" directory. +They will be converted and placed in your Tux Paint "saved" directory. - 💡 Note: If you're doing this for a different user (e.g., your child) - you'll need to make sure to run the command under their account.) +💡 Note: If you're doing this for a different user (e.g., your child) you'll +need to make sure to run the command under their account.) - Exemplo: +Exemplo: - $ tuxpaint-import avoa.jpg - avoa.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import avoa.jpg + avoa.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - A primeira liña («tuxpaint-import avoa.jpg») é a orde a executar. As dúas - liñas seguintes son a saída do programa mentres funciona. +A primeira liña («tuxpaint-import avoa.jpg») é a orde a executar. As dúas liñas +seguintes son a saída do programa mentres funciona. - Agora pode cargar Tux Paint e unha versión desa imaxe orixinal estará - dispoñíbel no diálogo «Abrir». Só ten que premer dúas veces na súa icona. +Agora pode cargar Tux Paint e unha versión desa imaxe orixinal estará +dispoñíbel no diálogo «Abrir». Só ten que premer dúas veces na súa icona. C. Importar imaxes manualmente - Os usuarios de Windows, macOS e Haiku que queiran importar imaxes - arbitrarias a Tux Paint deben facelo mediante un proceso manual. +Os usuarios de Windows, macOS e Haiku que queiran importar imaxes arbitrarias a +Tux Paint deben facelo mediante un proceso manual. - Cargue un programa gráfico que sexa quen tanto de cargar a súa imaxe como - de gardar un ficheiro en formato PNG. (Vexa o ficheiro de documentación - «PNG.html» para obter unha lista do software suxerido e outras - referencias.) +Cargue un programa gráfico que sexa quen tanto de cargar a súa imaxe como de +gardar un ficheiro en formato PNG. (Vexa o ficheiro de documentación «PNG.html» +para obter unha lista do software suxerido e outras referencias.) - Cando Tux Paint carga unha imaxe que non ten o mesmo tamaño que o seu - lenzo de debuxo, escala (e ás veces mancha os bordos) da imaxe para que se - axuste ao lenzo. +Cando Tux Paint carga unha imaxe que non ten o mesmo tamaño que o seu lenzo de +debuxo, escala (e ás veces mancha os bordos) da imaxe para que se axuste ao +lenzo. - Para evitar que a imaxe se estire ou manche, pode redimensionala ao tamaño - do lenzo de Tux Paint. Este tamaño depende do tamaño da xanela de Tux - Paint ou da resolución coa que se executa Tux Paint, se está en pantalla - completa. (Nota: A resolución predeterminada é 800x600.) Vexa «Cálculo das - dimensións da imaxe», a continuación. +Para evitar que a imaxe se estire ou manche, pode redimensionala ao tamaño do +lenzo de Tux Paint. Este tamaño depende do tamaño da xanela de Tux Paint ou da +resolución coa que se executa Tux Paint, se está en pantalla completa. (Nota: A +resolución predeterminada é 800x600.) Vexa «Cálculo das dimensións da imaxe», a +continuación. - 1. Naming the File +1. Naming the File - Gardar a imaxe en formato PNG. Recoméndase encarecidamente que nomee o - ficheiro usando a data e hora actuais, xa que esa é a convención que usa - Tux Paint: +Gardar a imaxe en formato PNG. Recoméndase encarecidamente que nomee o ficheiro +usando a data e hora actuais, xa que esa é a convención que usa Tux Paint: - AAAAMMDDhhmmss.png + AAAAMMDDhhmmss.png - * AAAA = Ano - * MM = Mes (dous díxitos, «01»-«12») - * DD = Día do mes (dous díxitos, «01»-«31») - * HH = Hora (dous díxitos, en formato 24 horas, «00»-«23») - * mm = Minuto (dous díxitos, «00»-«59») - * ss = Segundo (dous díxitos, «00»-«59») + * AAAA = Ano + * MM = Mes (dous díxitos, «01»-«12») + * DD = Día do mes (dous díxitos, «01»-«31») + * HH = Hora (dous díxitos, en formato 24 horas, «00»-«23») + * mm = Minuto (dous díxitos, «00»-«59») + * ss = Segundo (dous díxitos, «00»-«59») - Exemplo: «20210731110500.png», para o 31 de xullo de 2021 ás 11:05am. +Exemplo: «20210731110500.png», para o 31 de xullo de 2021 ás 11:05am. - Coloque este ficheiro PNG no seu directorio/cartafol «saved» de Tux Paint. - (Ver arriba.) +Coloque este ficheiro PNG no seu directorio/cartafol «saved» de Tux Paint. (Ver +arriba.) - 2. Cálculo das dimensións da imaxe +2. Cálculo das dimensións da imaxe - É preciso reescribir esta parte da documentación xa que se engadiu a nova - opción «buttonsize». Polo de agora, tente debuxar e gardar unha imaxe - dentro de Tux Paint, logo determine o tamaño (largo e alto en píxeles) que - obtivo e tente igualar iso ao escalar a(s) imaxe(s) que está a importar en - Tux Paint. +É preciso reescribir esta parte da documentación xa que se engadiu a nova +opción «buttonsize». Polo de agora, tente debuxar e gardar unha imaxe dentro de +Tux Paint, logo determine o tamaño (largo e alto en píxeles) que obtivo e tente +igualar iso ao escalar a(s) imaxe(s) que está a importar en Tux Paint. - IV.Máis información +IV.Máis información - Outra documentación incluída con Tux Paint (que se atopa no - cartafol/directorio «docs») inclúe: +Outra documentación incluída con Tux Paint (que se atopa no cartafol/directorio +«docs») inclúe: - Using Tux Paint: - * OPTIONS.html - Instrucións detalladas sobre a liña de ordes e as opcións do - ficheiro de configuración para aqueles que non queiran usar a - ferramenta Tux Paint Config. para xestionar a configuración - de Tux Paint. - * Documentación da ferramenta «Maxia» («magic-docs») - Documentación para cada unha das ferramentas de «Maxia» - instaladas actualmente. +Using Tux Paint: + + OPTIONS.html + Instrucións detalladas sobre a liña de ordes e as opcións do ficheiro + de configuración para aqueles que non queiran usar a ferramenta Tux + Paint Config. para xestionar a configuración de Tux Paint. + + Documentación da ferramenta «Maxia» («magic-docs») + Documentación para cada unha das ferramentas de «Maxia» instaladas + actualmente. - How to extend Tux Paint: - * EXTENDING.html - Instrucións detalladas sobre a ampliación de Tux Paint: - creación de pinceis, selos, imaxes de inicio e modelos; - engadir fontes; e crear novos deseños de teclado en pantalla - e métodos de entrada. - * PNG.html - Notas sobre a creación de imaxes de mapa de bits (ráster) en - formato PNG para usar en Tux Paint. - * SVG.html - Notas sobre a creación de imaxes vectoriais en formato SVG - para usar en Tux Paint. - Technical information: - * INSTALL.html - Instrucións para compilar e instalar Tux Paint, cando - proceda. - * SIGNALS.html - Información sobre os sinais POSIX aos que responde Tux Paint. - * MAGIC-API.html - Creating new Magic tools using Tux Paint's plugin API. +How to extend Tux Paint: + + EXTENDING.html + Instrucións detalladas sobre a ampliación de Tux Paint: creación de + pinceis, selos, imaxes de inicio e modelos; engadir fontes; e crear + novos deseños de teclado en pantalla e métodos de entrada. + + PNG.html + Notas sobre a creación de imaxes de mapa de bits (ráster) en formato + PNG para usar en Tux Paint. + + SVG.html + Notas sobre a creación de imaxes vectoriais en formato SVG para usar en + Tux Paint. - Development history and license: - * AUTHORS.txt - Lista de autores e colaboradores. - * CHANGES.txt - Resumo do que cambiou entre as versións de Tux Paint. - * COPYING.txt - Tux Paint's software license, the GNU General Public License - (GPL) - V.Como obter axuda +Technical information: + + INSTALL.html + Instrucións para compilar e instalar Tux Paint, cando proceda. + + SIGNALS.html + Información sobre os sinais POSIX aos que responde Tux Paint. + + MAGIC-API.html + Creating new Magic tools using Tux Paint's plugin API. - If you need help, there are numerous ways to interact with Tux Paint - developers and other users: - * Informar dos erros ou solicitar novas funcións a través do sistema de - seguimento de erros do proxecto - * Participe nas distintas listas de correo do proxecto - * Ou póñase en contacto directamente cos desenvolvedores - Para obter máis información, visite a páxina «Contacto» do sitio web - oficial de Tux Paint: https://tuxpaint.org/contact/ +Development history and license: + + AUTHORS.txt + Lista de autores e colaboradores. + + CHANGES.txt + Resumo do que cambiou entre as versións de Tux Paint. + + COPYING.txt + Tux Paint's software license, the GNU General Public License (GPL) - VI.Como participar - Tux Paint is a volunteer-driven project, and we're happy to accept your - help in a variety of ways: - * Traducir Tux Paint a outro idioma - * Mellorar as traducións existentes - * Crear ilustracións (selos, imaxes de inicio, modelos, pinceis) - * Engadir ou mellorar funcións ou ferramentas máxicas - * Crear un currículo na aula - * Promover ou axudar a outras persoas a usar Tux Paint - Para obter máis información, visite a páxina «Colabora connosco» do sitio - web oficial de Tux Paint: https://tuxpaint.org/help/ +V.Como obter axuda - VII.Follow the Tux Paint project on social media +If you need help, there are numerous ways to interact with Tux Paint developers +and other users: - Tux Paint maintains a presence on a variety of social media networks, - where we post updates and artwork. - * Join the Tux Paint page on Facebook - * Follow @TuxPaintDevs on Instagram - * Follow @tuxpaint@floss.social on Mastodon - * Follow u/TuxPaintDevs on Reddit - * Follow @TuxPaintDevs on Threads - * Follow Tux Paint on Tumblr - * Follow @TuxPaintTweets on Twitter + * Informar dos erros ou solicitar novas funcións a través do sistema de + seguimento de erros do proxecto + * Participe nas distintas listas de correo do proxecto + * Ou póñase en contacto directamente cos desenvolvedores - VIII. Trademark notices +Para obter máis información, visite a páxina «Contacto» do sitio web oficial de +Tux Paint: https://tuxpaint.org/contact/ + +VI.Como participar + +Tux Paint is a volunteer-driven project, and we're happy to accept your help in +a variety of ways: + + * Traducir Tux Paint a outro idioma + * Mellorar as traducións existentes + * Crear ilustracións (selos, imaxes de inicio, modelos, pinceis) + * Engadir ou mellorar funcións ou ferramentas máxicas + * Crear un currículo na aula + * Promover ou axudar a outras persoas a usar Tux Paint + +Para obter máis información, visite a páxina «Colabora connosco» do sitio web +oficial de Tux Paint: https://tuxpaint.org/help/ + +VII.Follow the Tux Paint project on social media + +Tux Paint maintains a presence on a variety of social media networks, where we +post updates and artwork. + + * Join the Tux Paint page on Facebook + * Follow @TuxPaintDevs on Instagram + * Follow @tuxpaint@floss.social on Mastodon + * Follow u/TuxPaintDevs on Reddit + * Follow @TuxPaintDevs on Threads + * Follow Tux Paint on Tumblr + * Follow @TuxPaintTweets on Twitter + +VIII. Trademark notices + + * "Linux" is a registered trademark of Linus Torvalds. + * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. + * "Apple" and "macOS" are registered trademarks of Apple Inc. + * "Facebook", "Instagram", and "Threads" are registered trademarks of Meta + Platforms, Inc. + * "Mastodon" is a registered trademark of Mastodon gGmbH. + * "Reddit" is a registered trademark of Reddit, Inc. + * "Tumblr" is a registered trademark of Tumblr, Inc. + * "Twitter" is a registered trademark of X Corp. - * "Linux" is a registered trademark of Linus Torvalds. - * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. - * "Apple" and "macOS" are registered trademarks of Apple Inc. - * "Facebook", "Instagram", and "Threads" are registered trademarks of - Meta Platforms, Inc. - * "Mastodon" is a registered trademark of Mastodon gGmbH. - * "Reddit" is a registered trademark of Reddit, Inc. - * "Tumblr" is a registered trademark of Tumblr, Inc. - * "Twitter" is a registered trademark of X Corp. diff --git a/docs/gl_ES.UTF-8/SIGNALS.txt b/docs/gl_ES.UTF-8/SIGNALS.txt index dc35180c5..7e667c4e7 100644 --- a/docs/gl_ES.UTF-8/SIGNALS.txt +++ b/docs/gl_ES.UTF-8/SIGNALS.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 Documentación de sinais Copyright © 2019-2022 by varios colaboradores; see AUTHORS.txt. @@ -7,49 +7,52 @@ 4 de Xuño de 2022 - Tux Paint responde aos seguintes sinais (que poden enviarse ao proceso do - programa a través de «kill» ou «killall», por exemplo). +Tux Paint responde aos seguintes sinais (que poden enviarse ao proceso do +programa a través de «kill» ou «killall», por exemplo). - 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 - dixera ao contorno de escritorio que peche Tux Paint (por exemplo, - premendo nun botón de peche da xanela ou premendo [Alt] + [F4] na - maioría dos sistemas). + Tux Paint responde coma se se premese o botón «Saír» ou se lle dixera ao + contorno de escritorio que peche Tux Paint (por exemplo, premendo nun botón + de peche da xanela ou premendo [Alt] + [F4] na maioría dos sistemas). - Dende a interface principal, Tux Paint preguntará se quere ou non - saír e (a non ser que sexa anulado pol a opción de gardado - automático, p. ex.: «--autosavex) se quere gardar o debuxo actual - (se non está gardado) , e se é así, e é unha versión modificada - dun debuxo existente (a non ser que sexa anulado polas opcións de - gardar sobre imaxes antigas ou gardar sempre imaxes novas; por - exemplo, «--saveover« e «--saveovernew», respectivamente), se - quere ou non sobreescribir o debuxo existente ou gardalo nun novo - ficheiro. + Dende a interface principal, Tux Paint preguntará se quere ou non saír e (a + non ser que sexa anulado pol a opción de gardado automático, p. ex.: + «--autosavex) se quere gardar o debuxo actual (se non está gardado) , e se + é así, e é unha versión modificada dun debuxo existente (a non ser que sexa + anulado polas opcións de gardar sobre imaxes antigas ou gardar sempre + imaxes novas; por exemplo, «--saveover« e «--saveovernew», + respectivamente), se quere ou non sobreescribir o debuxo existente ou + gardalo nun novo ficheiro. - Exemplo: killall tuxpaint + Exemplo: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint responde axustando a súa opción de gardar - automaticamente (coma se fora publicada con «--autosave»), así - como a opción de gardar sempre novas imaxes (coma se se publicase - con «--saveovernew») no caso de recibir un sinal de SIGUSR1 ou de - gardar sempre sobre a imaxe existente (coma se se publicase con - «--saveover») no caso de recibir SIGUSR2. Entón Tux Paint envíase - 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 - inmediato, sen facer preguntas. +SIGUSR1 & SIGUSR2 + + Tux Paint responde axustando a súa opción de gardar automaticamente (coma + se fora publicada con «--autosave»), así como a opción de gardar sempre + novas imaxes (coma se se publicase con «--saveovernew») no caso de recibir + un sinal de SIGUSR1 ou de gardar sempre sobre a imaxe existente (coma se se + publicase con «--saveover») no caso de recibir SIGUSR2. Entón Tux Paint + envíase 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 inmediato, + sen facer preguntas. + + Exemplo: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - Exemplo: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/gl_ES.UTF-8/SVG.txt b/docs/gl_ES.UTF-8/SVG.txt index 77dca71ca..db00c94c5 100644 --- a/docs/gl_ES.UTF-8/SVG.txt +++ b/docs/gl_ES.UTF-8/SVG.txt @@ -1,5 +1,5 @@ Tux Paint - versión 0.9.31 + versión 0.9.31 Documentación SVG Copyright © 2007-2022 by varios colaboradores; see AUTHORS.txt. @@ -7,31 +7,31 @@ 4 de Xuño de 2022 - Sobre os SVG +Sobre os SVG - SVG (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) é un - estándar aberto usado para describir gráficos vectoriais bidimensionais. É - xenial para diagramas e formas, mentres que PNG son mellores para - fotografías. Os ficheiros SVG son un pouco como instrucións sobre como - facer unha imaxe. Isto significa que poden cambiarse de sen que aparezan - pixelados ou bloques. +SVG (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) é un estándar +aberto usado para describir gráficos vectoriais bidimensionais. É xenial para +diagramas e formas, mentres que PNG son mellores para fotografías. Os ficheiros +SVG son un pouco como instrucións sobre como facer unha imaxe. Isto significa +que poden cambiarse de sen que aparezan 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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt b/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt index 669267f3c..d994e8d56 100644 --- a/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt +++ b/docs/gl_ES.UTF-8/tuxpaint-quickstart-guide.txt @@ -1,215 +1,210 @@ - Tux Paint 0.9.29 Quickstart Guide +Tux Paint 0.9.29 Quickstart Guide Tools (Drawing) - 🖌Paint +🖌Paint - * Choose a brush on the right. - * Some brushes are animated 🎞, some are directional ✲, some are both. - * Change brush spacing with the bars 📶 at the bottom right. - * Choose a color (see "Colors"). - * Click/tap and drag in the canvas to paint. + * Choose a brush on the right. + * Some brushes are animated 🎞, some are directional ✲, some are both. + * Change brush spacing with the bars 📶 at the bottom right. + * Choose a color (see "Colors"). + * Click/tap and drag in the canvas to paint. - ⌧Selos +⌧Selos - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Choose a stamp on the right. - * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near - the bottom right. - * Some stamps allow you to choose their color (see "Colors"). - * Change stamp size with the bars 📶 at the bottom right. - * Rotation ⟳ may be enabled, if desired. - * Click/tap in the canvas to place a stamp. - * If rotation is enabled, drag to rotate it, and click/tap again to - add it to the drawing. - * Some stamps play sound effects; press the speaker 🕪 button to hear it - again. - * Some stamps play descriptive sounds; press the headphones 🎧 button to - hear it again. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Choose a stamp on the right. + * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the + bottom right. + * Some stamps allow you to choose their color (see "Colors"). + * Change stamp size with the bars 📶 at the bottom right. + * Rotation ⟳ may be enabled, if desired. + * Click/tap in the canvas to place a stamp. + + If rotation is enabled, drag to rotate it, and click/tap again to add + it to the drawing. + * Some stamps play sound effects; press the speaker 🕪 button to hear it + again. + * Some stamps play descriptive sounds; press the headphones 🎧 button to hear + it again. - ⚟Lines +⚟Lines - * (See Paint) - * Click/tap and drag to draw a line. + * (See Paint) + * Click/tap and drag to draw a line. - ⭓Shapes +⭓Shapes - * Choose a shape on the right. - * Select whether you want to extend the shape from the center ⧈, or a - corner ◰, using controls at the bottom right. - * 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. + * Choose a shape on the right. + * Select whether you want to extend the shape from the center ⧈, or a corner + ◰, using controls at the bottom right. + * Click/tap to position, and drag to set the size of the shape. + * Drag to rotate it, and click/tap again to add it to the drawing. - 🄰Text +🄰Text - * Choose a font on the right. - * Select whether you want the text bold 𝗔 and/or italic 𝘈, using - controls near the bottom right. - * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom - right. - * Choose a color (see "Colors"). - * Click/tap the canvas to position an insertion cursor. - * Enter text via your keyboard or the on-screen keyboard. - * 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 - and begin entering more text one line down. - * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and - continue entering more text immediately to the right. - * Using the on-screen keyboard: - * "Cmp" can be used to compose characters, e.g. Cmp ' a results in - á. - * "AltGr" can be used to quickly access more characters. - * Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. - "ABC") + * Choose a font on the right. + * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls + near the bottom right. + * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom + right. + * Choose a color (see "Colors"). + * Click/tap the canvas to position an insertion cursor. + * Enter text via your keyboard or the on-screen keyboard. + * 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 and + begin entering more text one line down. + * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and + continue entering more text immediately to the right. + * Using the on-screen keyboard: + + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á. + + "AltGr" can be used to quickly access more characters. + + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC") - 🅰Label +🅰Label - * (See Text) - * Labels float 'above' the drawing; you cannot paint or stamp over them, - apply Magic effects, etc. - * Labels may be edited, repositioned, and styled after they've been - added to the drawing. - * Click/tap the ☝ button near the lower right to choose a label. - Click/tap the label you wish to modify, then click/tap somewhere else - in the canvas to reposition, or change the font/style, change color, - and/or type to edit the text. - * Or, use the 🖑 button near the lower right to "flatten" a label, - applying it to the canvas; it may no longer be edited with the Label - tool. + * (See Text) + * Labels float 'above' the drawing; you cannot paint or stamp over them, + apply Magic effects, etc. + * Labels may be edited, repositioned, and styled after they've been added to + the drawing. + * Click/tap the ☝ button near the lower right to choose a label. Click/tap + the label you wish to modify, then click/tap somewhere else in the canvas + to reposition, or change the font/style, change color, and/or type to edit + the text. + * Or, use the 🖑 button near the lower right to "flatten" a label, applying it + to the canvas; it may no longer be edited with the Label tool. - 🪣Fill +🪣Fill - * Choose a fill mode on the right. - * Choose a color (see "Colors"). - * Click/tap (and drag, with Brush and Linear modes) to fill an area of - the picture with a color. - * Solid - Flood-fills an area with a solid color - * Brush - Paints with a solid color, without drawing outside the - chosen area - * Linear - Fills the area with a linear gradient (drag to choose - angle and gradient) - * Radial - Fills the area with a radial gradient, centered where - you clicked/tapped - * Shaped - Fills the area with a gradient that follows the contours - of the area being filled + * Choose a fill mode on the right. + * Choose a color (see "Colors"). + * Click/tap (and drag, with Brush and Linear modes) to fill an area of the + picture with a color. + + Solid - Flood-fills an area with a solid color + + Brush - Paints with a solid color, without drawing outside the chosen + area + + Linear - Fills the area with a linear gradient (drag to choose angle + and gradient) + + Radial - Fills the area with a radial gradient, centered where you + clicked/tapped + + Shaped - Fills the area with a gradient that follows the contours of + the area being filled - 🪄Magic +🪄Magic - * Choose a magic tool on the right. - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some - affect the entire drawing 🖻🪄, and some offer both options; use the - controls at the bottom right. - * Some magic tools offer various sizes; change it with the bars 📶 at the - bottom right. - * Some magic tools allow you to choose their color. + * Choose a magic tool on the right. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some + affect the entire drawing 🖻🪄, and some offer both options; use the controls + at the bottom right. + * Some magic tools offer various sizes; change it with the bars 📶 at the + bottom right. + * Some magic tools allow you to choose their color. - 🖓Desfacer +🖓Desfacer - * Use to undo the most recent changes (multiple undo available). - * Shortcut: [Ctrl]+[Z] + * Use to undo the most recent changes (multiple undo available). + * Shortcut: [Ctrl]+[Z] - 🖒Refacer +🖒Refacer - * Use to redo the most recent undone change (multiple redo available). - * Shortcut: [Ctrl]+[R] + * Use to redo the most recent undone change (multiple redo available). + * Shortcut: [Ctrl]+[R] - ◪Eraser +◪Eraser - * Choose the size and shape of the eraser on the right. - * Click/tap and drag to erase parts of the picture (solid color, or - starter or template image). - * Shortcut: [X] and click/tap in the drawing (not always available) + * Choose the size and shape of the eraser on the right. + * Click/tap and drag to erase parts of the picture (solid color, or starter + or template image). + * Shortcut: [X] and click/tap in the drawing (not always available) Tools (Controls) - 🗏New +🗏New - * Choose a solid color, starter, or template image to start with. - * Starters allow drawing "under" a picture (e.g., a coloring book - outline), sometimes with a background layer, too. - * Templates are pictures to start with (background only). - * Eraser tool ◪ reveals the solid color, or starter/template - background. - * Click/tap "🕮⮫Open" to begin a new drawing. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Shortcut: [Ctrl]+[N] + * Choose a solid color, starter, or template image to start with. + + Starters allow drawing "under" a picture (e.g., a coloring book + outline), sometimes with a background layer, too. + + Templates are pictures to start with (background only). + + Eraser tool ◪ reveals the solid color, or starter/template background. + * Click/tap "🕮⮫Open" to begin a new drawing. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Shortcut: [Ctrl]+[N] - 🕮⮫Open +🕮⮫Open - * Choose a previously-saved drawing to open (or export or erase). - * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. - * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" - folder. - * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle - Bin. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Click/tap "📽Slides" to switch to slideshow mode: - * Click/tap two or more of your previously-saved drawings, in the - order you want them shown. Numbers will appear on them. - * Choose the playback speed using the bars 📶 near the lower left. - * Click/tap "⯈Play" to watch the slideshow/animation. - * Or, click/tap "🎞GIF Export" to save an animated GIF of the - animation to your system's "Pictures" folder. - * Click/tap "⤺Back" to return to the Open dialog. - * Shortcut: [Ctrl]+[O] + * Choose a previously-saved drawing to open (or export or erase). + * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. + * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" + folder. + * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Click/tap "📽Slides" to switch to slideshow mode: + + Click/tap two or more of your previously-saved drawings, in the order + you want them shown. Numbers will appear on them. + + Choose the playback speed using the bars 📶 near the lower left. + + Click/tap "⯈Play" to watch the slideshow/animation. + + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to + your system's "Pictures" folder. + + Click/tap "⤺Back" to return to the Open dialog. + * Shortcut: [Ctrl]+[O] - 🕮⮪Save +🕮⮪Save - * Click/tap to save your drawing. - * If you've saved previously, you'll be prompted whether to overwrite - the previously-saved drawing (a la "File→Save") or create a new saved - drawing (a la "File→Save As...") - * Shortcut: [Ctrl]+[S] + * Click/tap to save your drawing. + * If you've saved previously, you'll be prompted whether to overwrite the + previously-saved drawing (a la "File→Save") or create a new saved drawing + (a la "File→Save As...") + * Shortcut: [Ctrl]+[S] - 🖶Print +🖶Print - * Click/tap to print your drawing. - * Hold [Alt] or [Option] while clicking/tapping to bring up printer - dialog, if available. - * Shortcut: [Ctrl]+[P] + * Click/tap to print your drawing. + * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog, + if available. + * Shortcut: [Ctrl]+[P] - 🗙Quit +🗙Quit - * Click/tap to quit Tux Paint. - * Shortcut: [Esc] + * Click/tap to quit Tux Paint. + * Shortcut: [Esc] Colors - * Click/tap to choose a color to use with the Paint, Lines, and Shapes - tools, and Stamps and Magic tools that support colors. - * Use the pipette / color picker 💉 button to choose a color from a pixel - in your current drawing. - * Shortcut: When colors are available, press [Ctrl] and click/tap - in your drawing, to quickly pick a color from your drawing. - * Click/tap the rainbow 🌈 button to choose a arbitrary color. - * Click/tap in the rainbow square to pick a color (hue and - saturation). - * Click/tap in the grey gradient bar to adjust brightness (value). - * Click/tap the green checkbox ✓ to accept. - * Click/tap "⤺Back" to abort and dismiss the palette. - * You may grab the currently-chosen built-in color (if any), the - color in the pipette / color picker, or the color in the color - mixer, by clicking one of the colored arrow ⇫ buttons. - * Click/tap the paint palette 🎨 button to create a color by mixing - primary colors: red, yellow, and blue, and white (tint), grey (tone), - and black (shade). - * Click/tap the green checkbox ✓ to accept. - * Color mixing offers its own 🖓Undo and 🖒Redo options. - * Click/tap "🗑Clear" to start over with no mixed colors. - * Click/tap "⤺Back" to abort and dismiss the color mixer. + * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools, + and Stamps and Magic tools that support colors. + * Use the pipette / color picker 💉 button to choose a color from a pixel in + your current drawing. + + Shortcut: When colors are available, press [Ctrl] and click/tap in your + drawing, to quickly pick a color from your drawing. + * Click/tap the rainbow 🌈 button to choose a arbitrary color. + + Click/tap in the rainbow square to pick a color (hue and saturation). + + Click/tap in the grey gradient bar to adjust brightness (value). + + Click/tap the green checkbox ✓ to accept. + + Click/tap "⤺Back" to abort and dismiss the palette. + + You may grab the currently-chosen built-in color (if any), the color in + the pipette / color picker, or the color in the color mixer, by + clicking one of the colored arrow ⇫ buttons. + * Click/tap the paint palette 🎨 button to create a color by mixing primary + colors: red, yellow, and blue, and white (tint), grey (tone), and black + (shade). + + Click/tap the green checkbox ✓ to accept. + + Color mixing offers its own 🖓Undo and 🖒Redo options. + + Click/tap "🗑Clear" to start over with no mixed colors. + + Click/tap "⤺Back" to abort and dismiss the color mixer. Shortcuts while drawing: - * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access - * [X]+Click/tap - Quick eraser ◪ access - * [Ctrl]+[Z] - 🖓Undo - * [Ctrl]+[R] - 🖒Redo - * [Ctrl]+[N] - 🗏New - * [Ctrl]+[O] - 🕮⮫Open - * [Ctrl]+[S] - 🕮⮪Save - * [Ctrl]+[P] - 🖶Print - * [Alt]+[S] - Toggle sound effects on/off - * [Esc] - ⤺Back or 🗙Quit + * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access + * [X]+Click/tap - Quick eraser ◪ access + * [Ctrl]+[Z] - 🖓Undo + * [Ctrl]+[R] - 🖒Redo + * [Ctrl]+[N] - 🗏New + * [Ctrl]+[O] - 🕮⮫Open + * [Ctrl]+[S] - 🕮⮪Save + * [Ctrl]+[P] - 🖶Print + * [Alt]+[S] - Toggle sound effects on/off + * [Esc] - ⤺Back or 🗙Quit + +Last updated: 9 de Maio de 2023 - Last updated: 9 de Maio de 2023 diff --git a/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt index c90c8475f..8a4813a31 100644 --- a/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/is_IS.UTF-8/ADVANCED-STAMPS-HOWTO.txt @@ -1,296 +1,287 @@ Tux Paint version 0.9.31 Advanced Stamps 'How-To' - Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. + Copyright © 2006-2022 by Albert Cahalan and others; see AUTHORS.txt. https://tuxpaint.org/ - júní 4, 2022 + júní 4, 2022 - ---------------------------------------------------------------------- - - +----------------------------------------+ - |Table of Contents | - |----------------------------------------| - | * About this 'How-To' | - | * Image choice is crucial | - | * Prepare the mask | - | * Replace the fringe and junk pixels | - | * Save the image for Tux Paint | - +----------------------------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++----------------------------------------+ +| Table of Contents | +|----------------------------------------| +| * About this 'How-To' | +| * Image choice is crucial | +| * Prepare the mask | +| * Replace the fringe and junk pixels | +| * Save the image for Tux Paint | ++----------------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- About this 'How-To' - This 'How-To' assumes that you want to make an excellent Tux Paint - stamp, in PNG bitmapped format, from a JPEG image (e.g., a digital - photograph). There are easier and faster methods that produce lower - quality. + This 'How-To' assumes that you want to make an excellent Tux Paint stamp, + in PNG bitmapped format, from a JPEG image (e.g., a digital photograph). + There are easier and faster methods that produce lower quality. - This 'How-To' assumes you are dealing with normal opaque objects. - Dealing with semi-transparent objects (fire, moving fan blade, kid's - balloon) or light-giving objects (fire, lightbulb, sun) is best done - with custom software. Images with perfect solid-color backgrounds are - also best done with custom software, but are not troublesome to do as - follows. + This 'How-To' assumes you are dealing with normal opaque objects. Dealing + with semi-transparent objects (fire, moving fan blade, kid's balloon) or + light-giving objects (fire, lightbulb, sun) is best done with custom + software. Images with perfect solid-color backgrounds are also best done + with custom software, but are not troublesome to do as follows. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Image choice is crucial - License + License - If you wish to submit artwork to the Tux Paint developers for - consideration for inclusion in the official project, or if you wish to - release your own copy of Tux Paint, bundled with your own graphics, - you need an image that is compatible with the GNU General Public - License used by Tux Paint. + If you wish to submit artwork to the Tux Paint developers for + consideration for inclusion in the official project, or if you wish to + release your own copy of Tux Paint, bundled with your own graphics, you + need an image that is compatible with the GNU General Public License + used by Tux Paint. - Images produced by the US government are Public Domain, but be aware - that the US government sometimes uses other images on the web. Google - image queries including either site:gov or site:mil will supply many - suitable images. (Note: the *.mil sites include non-military content, - too!) + Images produced by the US government are Public Domain, but be aware + that the US government sometimes uses other images on the web. Google + image queries including either site:gov or site:mil will supply many + suitable images. (Note: the *.mil sites include non-military content, + too!) - Your own images can be placed in the Public Domain or a suitable - license, such as the Creative Commons CC0 by declaring it so. (Hire a - lawyer if you feel the need for legal advice.) + Your own images can be placed in the Public Domain or a suitable + license, such as the Creative Commons CC0 by declaring it so. (Hire a + lawyer if you feel the need for legal advice.) - For personal use, any image you can legitimately modify and use for - your own personal use should be fine. + For personal use, any image you can legitimately modify and use for + your own personal use should be fine. - Image Size and Orientation + Image Size and Orientation - You need an image that has a useful orientation. Perspective is an - enemy. Images that show an object from the corner are difficult to fit - into a nice drawing. As a general rule, telephoto side views are the - best. The impossible ideal is that, for example, two wheels of a car - are perfectly hidden behind the other two. + You need an image that has a useful orientation. Perspective is an + enemy. Images that show an object from the corner are difficult to fit + into a nice drawing. As a general rule, telephoto side views are the + best. The impossible ideal is that, for example, two wheels of a car + are perfectly hidden behind the other two. - 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 - need lots of rotation (30 to 60 degrees) are next best, and images - that need just a few degrees are worst. Rotation will also make an - image darker because most image editing software is very bad about - gamma handling. (Rotation is only legitimate for gamma=1.0 images.) + 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 + need lots of rotation (30 to 60 degrees) are next best, and images that + need just a few degrees are worst. Rotation will also make an image + darker because most image editing software is very bad about gamma + handling. (Rotation is only legitimate for gamma=1.0 images.) - 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 - across if you can. You can shrink this later to hide your mistakes. + 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 + across if you can. You can shrink this later to hide your mistakes. - 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 - will need to draw new ones. If only one is buried, you might be able - to copy the other one as a replacement. + 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 to + copy the other one as a replacement. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the image - First of all, be sure to avoid re-saving the image as a JPEG. This - causes quality loss. There is a special tool called jpegtran that lets - you crop an image without the normal quality loss. + First of all, be sure to avoid re-saving the image as a JPEG. This causes + quality loss. There is a special tool called jpegtran that lets you crop an + image without the normal quality loss. - jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - 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 - as needed. Save the image — choose whatever native format supports - layers, masks, alpha, etc. GIMP users should choose "XCF", and Adobe - Photoshop users should choose "PSD", for example. + 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 as + needed. Save the image — choose whatever native format supports layers, + masks, alpha, etc. GIMP users should choose "XCF", and Adobe Photoshop + users should choose "PSD", for example. - If you have rotated or cropped the image in your image editor, flatten - it now. You need to have just one RGB layer without mask or alpha. + If you have rotated or cropped the image in your image editor, flatten it + 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 - top to bottom you will need something like this: + Open the layers dialog box. Replicate the one layer several times. From top + to bottom you will need something like this: - 1. unmodified image (write-protect this if you can) - 2. an image you will modify — the "work in progress" layer - 3. solid green (write-protect this if you can) - 4. solid magenta (write-protect this if you can) - 5. 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 + 3. solid green (write-protect this if you can) + 4. solid magenta (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 - start with a selection, or by using the grayscale value of the WIP - layer. You might invert the mask. + Give the work in progress (WIP) layer a rough initial mask. You might start + with a selection, or by using the grayscale value of the WIP layer. You + might invert the mask. - 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 - instructions later. + 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 + instructions later. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Prepare the mask - Get used to doing [Control]-click and [Alt]-click on the thumbnail - images in the layers dialog. You will need this to control what you are - looking at and what you are editing. Sometimes you will be editing - things you can't see. For example, you might edit the mask of the WIP - layer while looking at the unmodified image. Pay attention so you don't - screw up. Always verify that you are editing the right thing. + Get used to doing [Control]-click and [Alt]-click on the thumbnail images + in the layers dialog. You will need this to control what you are looking at + and what you are editing. Sometimes you will be editing things you can't + see. For example, you might edit the mask of the WIP layer while looking at + the unmodified image. Pay attention so you don't screw up. Always verify + that you are editing the right thing. - Set an unmodified image as what you will view (the top one is easiest). - Set the WIP mask as what you will edit. At some point, perhaps not - immediately, you should magnify the image to about 400% (each pixel of - the image is seen and edited as a 4x4 block of pixels on your screen). + Set an unmodified image as what you will view (the top one is easiest). Set + the WIP mask as what you will edit. At some point, perhaps not immediately, + you should magnify the image to about 400% (each pixel of the image is seen + 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 - you can select the object or background somewhat accurately by color, do - so. As needed to avoid selecting any pixels that should be partially - opaque (generally at the edge of the object) you should grow, shrink, - and invert the selection. + Select parts of the image that need to be 100% opaque or 0% opaque. If you + can select the object or background somewhat accurately by color, do so. As + needed to avoid selecting any pixels that should be partially opaque + (generally at the edge of the object) you should grow, shrink, and invert + the selection. - Fill the 100% opaque areas with white, and the 0% opaque areas with - black. This is most easily done by drag-and-drop from the - foreground/background color indicator. You should not see anything - happen, because you are viewing the unmodified image layer while editing - the mask of the WIP layer. Large changes might be noticable in the - thumbnail. + Fill the 100% opaque areas with white, and the 0% opaque areas with black. + This is most easily done by drag-and-drop from the foreground/background + color indicator. You should not see anything happen, because you are + viewing the unmodified image layer while editing the mask of the WIP layer. + Large changes might be noticable in the 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 - mask, which should be a white object on a black background (probably - with unedited grey at the edge). Now display the WIP layer normally, so - that the mask is active. This should show your object over top of the - next highest enabled layer, which should be green or magenta as needed - for maximum contrast. You might wish to flip back and forth between - those backgrounds by repeatedly clicking to enable/disable the green - layer. Fix any obvious and easy problems by editing the mask while - viewing the mask. + Check your work. Hide the top unmodified image layer. Display just the + mask, which should be a white object on a black background (probably with + unedited grey at the edge). Now display the WIP layer normally, so that the + mask is active. This should show your object over top of the next highest + enabled layer, which should be green or magenta as needed for maximum + contrast. You might wish to flip back and forth between those backgrounds + by repeatedly clicking to enable/disable the green layer. Fix any obvious + and easy problems by editing the mask while viewing the mask. - Go back to viewing the top unmodified layer while editing the WIP mask. - Set your drawing tool the paintbrush. For the brush, choose a small - fuzzy circle. The 5x5 size is good for most uses. + Go back to viewing the top unmodified layer while editing the WIP mask. Set + your drawing tool the paintbrush. For the brush, choose a small fuzzy + circle. The 5x5 size is good for most uses. - With a steady hand, trace around the image. Use black around the - outside, and white around the inside. Avoid making more than one pass - without switching colors (and thus sides). + With a steady hand, trace around the image. Use black around the outside, + and white around the inside. Avoid making more than one pass without + switching colors (and thus sides). - Flip views a bit, checking to see that the mask is working well. When - the WIP layer is composited over the green or magenta, you should see a - tiny bit of the original background as an ugly fringe around the edge. - If this fringe is missing, then you made the object mask too small. The - fringe consists of pixels that are neither 100% object nor 0% object. - For them, the mask should be neither 100% nor 0%. The fringe gets - removed soon. + Flip views a bit, checking to see that the mask is working well. When the + WIP layer is composited over the green or magenta, you should see a tiny + bit of the original background as an ugly fringe around the edge. If this + fringe is missing, then you made the object mask too small. The fringe + consists of pixels that are neither 100% object nor 0% object. For them, + the mask should be neither 100% nor 0%. The fringe gets removed soon. - 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 - expected color. Invert the selection, then paint these away using the - pencil tool. Do this operation for both white and black. + 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 expected + color. Invert the selection, then paint these away using the pencil tool. + Do this operation for both white and black. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Replace the fringe and junk pixels - Still viewing the mask, select by color. Choose black. Shrink the - selection by several pixels, being sure to NOT shrink from the edges of - the mask (the shrink helps you avoid and recover from mistakes). + Still viewing the mask, select by color. Choose black. Shrink the selection + by several pixels, being sure to NOT shrink from the edges of the mask (the + shrink helps you avoid and recover from mistakes). - Now disable the mask. View and edit the unmasked WIP layer. Using the - color picker tool, choose a color that is average for the object. - Drag-and-drop this color into the selection, thus removing most of the - non-object pixels. + Now disable the mask. View and edit the unmasked WIP layer. Using the color + picker tool, choose a color that is average for the object. Drag-and-drop + this color into the selection, thus removing most of the non-object pixels. - 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 - has multiple colors that are very different, you should split up your - selection so that you can color the nearby background to be similar. + 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 has + multiple colors that are very different, you should split up your selection + 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 - editing and viewing the WIP image. Frequent layer visibility changes - will help you to see what you are doing. You are likely to use all of: + Now you will paint away the existing edge fringe. Be sure that you are + editing and viewing the WIP image. Frequent layer visibility changes will + help you to see what you are doing. You are likely to use all of: - * composited over green (mask enabled) - * composited over magenta (mask enabled) - * original (the top or bottom layer) - * composited over the original (mask enabled) - * raw WIP layer (mask disabled) + + composited over green (mask enabled) + + composited over magenta (mask enabled) + + original (the top or bottom layer) + + composited over the original (mask enabled) + + raw WIP layer (mask disabled) - To reduce accidents, you may wish to select only those pixels that are - not grey in the mask. (Select by color from the mask, choose black, add - mode, choose white, invert. Alternately: Select all, select by color - from the mask, subtract mode, choose black, choose white.) If you do - this, you'll probably want to expand the selection a bit and/or hide the - "crawling ants" line that marks the selection. + To reduce accidents, you may wish to select only those pixels that are not + grey in the mask. (Select by color from the mask, choose black, add mode, + choose white, invert. Alternately: Select all, select by color from the + mask, subtract mode, choose black, choose white.) If you do this, you'll + probably want to expand the selection a bit and/or hide the "crawling ants" + line that marks the selection. - 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 - generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy - brushes with about 70% opacity.) Unusual drawing modes can be helpful - with semi-transparent objects. + 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 + generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy + brushes with about 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. - 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 - magenta or green, must be removed for obvious reasons. The outside - fringe must also be removed because it will become visible when the - image is scaled down. As an example, consider a 2x2 region of pixels at - the edge of a sharp-edged object. The left half is black and 0% opaque. - The right half is white and 100% opaque. That is, we have a white object - on a black background. When Tux Paint scales this to 50% (a 1x1 pixel - area), the result will be a grey 50% opaque pixel. The correct result - would be a white 50% opaque pixel. To get this result, we would paint - away the black pixels. They matter, despite being 0% opaque. + 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 + magenta or green, must be removed for obvious reasons. The outside fringe + must also be removed because it will become visible when the image is + scaled down. As an example, consider a 2x2 region of pixels at the edge of + a sharp-edged object. The left half is black and 0% opaque. The right half + is white and 100% opaque. That is, we have a white object on a black + background. When Tux Paint scales this to 50% (a 1x1 pixel area), the + result will be a grey 50% opaque pixel. The correct result would be a white + 50% opaque pixel. To get this result, we would paint away the black pixels. + They matter, despite being 0% opaque. - Tux Paint can scale images down by a very large factor, so it is - important to extend the edge of your object outward by a great deal. - Right at the edge of your object, you should be very accurate about - this. As you go outward away from the object, you can get a bit sloppy. - It is reasonable to paint outward by a dozen pixels or more. The farther - you go, the more Tux Paint can scale down without creating ugly color - fringes. For areas that are more than a few pixels away from the object - edge, you should use the pencil tool (or sloppy select with - drag-and-drop color) to ensure that the result will compress well. + Tux Paint can scale images down by a very large factor, so it is important + to extend the edge of your object outward by a great deal. Right at the + edge of your object, you should be very accurate about this. As you go + outward away from the object, you can get a bit sloppy. It is reasonable to + paint outward by a dozen pixels or more. The farther you go, the more Tux + Paint can scale down without creating ugly color fringes. For areas that + are more than a few pixels away from the object edge, you should use the + pencil tool (or sloppy select with drag-and-drop color) to ensure that the + result will compress well. - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Save the image for Tux Paint - It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, you - can try saving your image directly as a PNG. Be sure to read it back in - again to verify that the 0% opaque areas didn't turn black or white, - which would create fringes when Tux Paint scales the image down. If you - need to scale your image to save space (and hide your mistakes), you are - almost certain to destroy all the 0% opaque areas. So here is a better - way... + It is very easy to ruin your hard work. Image editors can silently destroy + pixels in 0% opaque areas. The conditions under which this happens may vary + from version to version. If you are very trusting, you can try saving your + image directly as a PNG. Be sure to read it back in again to verify that + the 0% opaque areas didn't turn black or white, which would create fringes + when Tux Paint scales the image down. If you need to scale your image to + save space (and hide your mistakes), you are almost certain to destroy all + the 0% opaque areas. So here is a better way... - A Safer Way to Save + A Safer Way to Save - Drag the mask from the layers dialog to the unused portion of the - toolbar (right after the last drawing tool). This will create a new - image consisting of one layer that contains the mask data. Scale this - as desired, remembering the settings you use. Often you should start - with an image that is about 700 to 1500 pixels across, and end up with - one that is 300 to 400. + Drag the mask from the layers dialog to the unused portion of the + toolbar (right after the last drawing tool). This will create a new + image consisting of one layer that contains the mask data. Scale this + as desired, remembering the settings you use. Often you should start + with an image that is about 700 to 1500 pixels across, and end up with + one that is 300 to 400. - Save the mask image as a NetPBM portable greymap (".pgm") file. (If - you are using an old release of The GIMP, you might need to convert - the image to greyscale before you can save it.) Choose the more - compact "RAW PGM" format. (The second character of the file should be - the ASCII digit "5", hex byte 0x35.) + Save the mask image as a NetPBM portable greymap (".pgm") file. (If you + are using an old release of The GIMP, you might need to convert the + image to greyscale before you can save it.) Choose the more compact + "RAW PGM" format. (The second character of the file should be the ASCII + 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 - did with the mask, drag this from the layers dialog to the toolbar. - You 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 - painted-away surroundings, without any mask thumbnail in the layers - dialog. If you scaled the mask, then scale this image in exactly the - same way. Save this image as a NetPBM portable pixmap (".ppm") file. - (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.) + 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. You + 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 + painted-away surroundings, without any mask thumbnail in the layers + dialog. If you scaled the mask, then scale this image in exactly the + same way. Save this image as a NetPBM portable pixmap (".ppm") file. + (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.) - Now you need to merge the two files into one. Do that with the - pnmtopng command, like this: + Now you need to merge the two files into one. Do that with the pnmtopng + command, like this: + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/is_IS.UTF-8/ENVVARS.txt b/docs/is_IS.UTF-8/ENVVARS.txt index 5498ada7a..51b2406ff 100644 --- a/docs/is_IS.UTF-8/ENVVARS.txt +++ b/docs/is_IS.UTF-8/ENVVARS.txt @@ -1,5 +1,5 @@ Tux Paint - version 0.9.31 + version 0.9.31 Environment Variables Documentation Copyright © 2021-2023 by various contributors; see AUTHORS.txt. @@ -7,91 +7,97 @@ maí 5, 2023 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint understands a number of environment variables, either directly, - or indirectly by the libraries that it utilizes. +Tux Paint understands a number of environment variables, either directly, or +indirectly by the libraries that it utilizes. Storage-related environment variables - HOME +HOME - Specifies the user's "home directory", which is used to locate - numerous other files or directories. In some cases, it is utilized - as part of a fall-back location, when other environment variables - (elsewhere in this documentation) are not set. Sometimes, the - location to use can be overridden by options provided on the - command-line or via Tux Paint's configuration file. See the - "OPTIONS" documentation for details. + Specifies the user's "home directory", which is used to locate numerous + other files or directories. In some cases, it is utilized as part of a + fall-back location, when other environment variables (elsewhere in this + documentation) are not set. Sometimes, the location to use can be + overridden by options provided on the command-line or via Tux Paint's + configuration file. See the "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 basis of where Tux Paint saves and loads users' drawings - * The location of a user's private collection of data files — - stamps, brushes, etc. — (versus those available system wide) + + The location of Tux Paint's configuration file + + The basis of where Tux Paint saves and loads users' drawings + + The location of a user's private collection of data files — stamps, + brushes, etc. — (versus those available system wide) - XDG_CONFIG_HOME - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's configuration files. - Specifically, where to find "user-dirs.dirs", where the - "XDG_PICTURES_DIR" might be defined. It is used for exporting - drawings and animated GIFs. Generally it's set to something like - "$HOME/Pictures/". If not specified, Tux Paint checks in the - directory "$HOME/.config/". If the configuration cannot be found, - Tux Paint simply exports drawings and GIFs to "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's configuration files. Specifically, where to find + "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used + for exporting drawings and animated GIFs. Generally it's set to something + like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory + "$HOME/.config/". If the configuration cannot be found, Tux Paint simply + exports drawings and GIFs to "$HOME". - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's data directories. - Specifically, where to find the "Trash" directory. It is used when - deleting images from Tux Paint's "Open" dialog. If not set, the - location "$HOME/.local/share/Trash/" is used, if available. If - not, images are simply deleted, rather than moved anywhere. - TEMP - Specifies the location where temporary files may be created. Only - used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if - not set. +XDG_DATA_HOME + + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's data directories. Specifically, where to find + the "Trash" directory. It is used when deleting images from Tux Paint's + "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is + used, if available. If not, images are simply deleted, rather than moved + anywhere. + + + +TEMP + + Specifies the location where temporary files may be created. Only used by + Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set. Language-related environment variables - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Specify the language Tux Paint should utilize in its user interface. + Overridde by the "--lang" and "--locale" command-line options or their + configuration file counterparts. The "LANGUAGE" environment variable is + used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES", + and finally "LANG". - LC_ALL - LC_MESSAGES - Specify the language Tux Paint should utilize in its user - interface. Overridde by the "--lang" and "--locale" command-line - options or their configuration file counterparts. The "LANGUAGE" - environment variable is used, if set. If not, "LC_ALL" is used as - a fallback. Then "LC_MESSAGES", and finally "LANG". Display-related environment variables - The following are a few of the environment variables supported by Simple - DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying - graphics, playing sounds, and receiving mouse, keyboard, and joystick - input — and which may be useful to users of Tux Paint. +The following are a few of the environment variables supported by Simple +DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics, +playing sounds, and receiving mouse, keyboard, and joystick input — and which +may be useful to users of Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Specifies whether Tux Paint should allow a screensaver to run. Can be set + to '1' (true) by Tux Paint itself by issuing the command-line option + "--allowscreensaver" or its configuration file counterpart. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Specifies whether Tux Paint should allow a screensaver to run. Can - be set to '1' (true) by Tux Paint itself by issuing the - command-line option "--allowscreensaver" or its configuration file - counterpart. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/is_IS.UTF-8/EXTENDING.txt b/docs/is_IS.UTF-8/EXTENDING.txt index 048429992..f6e1b30fd 100644 --- a/docs/is_IS.UTF-8/EXTENDING.txt +++ b/docs/is_IS.UTF-8/EXTENDING.txt @@ -1,1054 +1,1071 @@ Extending Tux Paint - version 0.9.31 + version 0.9.31 Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - maí 29, 2023 + maí 29, 2023 - +------------------------------------------+ - |Table of Contents | - |------------------------------------------| - | * Where Files Go | - | * Standard Files | - | * Personal Files | - | * Brushes | - | * Brush Options | - | * Stamps | - | * Stamp Images | - | * Stamp Descriptive Text | - | * Stamp Sound Effects | - | * Stamp Descriptive Sound | - | * Stamp Options | - | * Pre-Mirrored and Flipped Stamps | - | * Fonts | - | * 'Starters' | - | * Coloring-Book Style Starters | - | * Scene-Style Starters | - | * Starter Options | - | * 'Templates' | - | * Template Options | - | * Translations | - | * Alternative Input Methods | - | * On-screen Keyboard | - | * Magic Tools | - +------------------------------------------+ ++-----------------------------------------+ +| Table of Contents | +|-----------------------------------------| +| * Where Files Go | +| + Standard Files | +| + Personal Files | +| * Brushes | +| + Brush Options | +| * Stamps | +| + Stamp Images | +| + Stamp Descriptive Text | +| + Stamp Sound Effects | +| + Stamp Descriptive Sound | +| + Stamp Options | +| + Pre-Mirrored and Flipped Stamps | +| * Fonts | +| * 'Starters' | +| + Coloring-Book Style Starters | +| + Scene-Style Starters | +| + Starter Options | +| * 'Templates' | +| + Template Options | +| * Translations | +| * Alternative Input Methods | +| * On-screen Keyboard | +| * Magic Tools | ++-----------------------------------------+ - If you wish to add or change things like Brushes, Starters, Rubber Stamps, - and other content used by Tux Paint, you can do so fairly easily by simply - adding, changing, or removing files where Tux Paint looks for them. +If you wish to add or change things like Brushes, Starters, Rubber Stamps, and +other content used by Tux Paint, you can do so fairly easily by simply adding, +changing, or removing files where Tux Paint looks for them. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Where Files Go +Where Files Go Standard Files - Tux Paint looks for its various data files in its 'data' directory. +Tux Paint looks for its various data files in its 'data' directory. - Linux and Unix +Linux and Unix - Where this directory goes depends on what value was set for - "DATA_PREFIX" when Tux Paint was built. See 'Install - documentation' for details. + Where this directory goes depends on what value was set for "DATA_PREFIX" + when Tux Paint was built. See 'Install documentation' for details. - By default, though, the directory is: + By default, though, the directory is: - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - If you installed from a package, it is more likely to be: + If you installed from a package, it is more likely to be: - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint looks for a directory called 'data' in the same - directory as the executable. This is the directory that the - installer used when installing Tux Paint e.g.: - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint looks for a directory called 'data' in the same directory as the + executable. This is the directory that the installer used when installing + Tux Paint e.g.: - Tux Paint stores its data files inside the "Tux Paint" application - icon (which is actually a special kind of folder on macOS & Mac OS - X before it). The following steps explain how to get to the - folders within it: + C:\Program Files\TuxPaint\data - 1. Bring up a 'context' menu by holding the [Control] key and - clicking the Tux Paint icon the in Finder. (If you have a - mouse with more than one button, you can simply right-click - the icon.) - 2. Select "Show Contents" from the menu that appears. A new - Finder window will appear with a folder inside called - "Contents". - 3. Open the "Contents" folder and open the "Resources" folder - found inside. - 4. There, you will find various sub-folders, such as "starters", - "stamps", "brushes", etc. Adding new content to these folders - will make the content available to any user that launches - this copy (icon) of Tux Paint. - 💡 Note: If you install a newer version of Tux Paint and replace or - discard the old version, you will lose changes made by following - the instructions above, so keep backups of your new content - (stamps, brushes, etc.). - Tux Paint also looks for files in a "TuxPaint" folder that you can - place in your system's "Application Support" folder (found under - "Library" at the root of your filesystem): +macOS + + Tux Paint stores its data files inside the "Tux Paint" application icon + (which is actually a special kind of folder on macOS & Mac OS X before it). + The following steps explain how to get to the folders within it: + + 1. Bring up a 'context' menu by holding the [Control] key and clicking the + Tux Paint icon the in Finder. (If you have a mouse with more than one + button, you can simply right-click the icon.) + 2. Select "Show Contents" from the menu that appears. A new Finder window + will appear with a folder inside called "Contents". + 3. Open the "Contents" folder and open the "Resources" folder found + inside. + 4. There, you will find various sub-folders, such as "starters", "stamps", + "brushes", etc. Adding new content to these folders will make the + content available to any user that launches this copy (icon) of Tux + Paint. + + 💡 Note: If you install a newer version of Tux Paint and replace or discard + the old version, you will lose changes made by following the instructions + above, so keep backups of your new content (stamps, brushes, etc.). + + Tux Paint also looks for files in a "TuxPaint" folder that you can place in + your system's "Application Support" folder (found under "Library" at the + root of your filesystem): + + /Library/Application Support/TuxPaint/ + + When you upgrade to a newer version of Tux Paint, the contents of this + "TuxPaint" folder will stay the same, and remain accessible by all users of + Tux Paint. + - /Library/Application Support/TuxPaint/ - When you upgrade to a newer version of Tux Paint, the contents of - this "TuxPaint" folder will stay the same, and remain accessible - by all users of Tux Paint. Personal Files - You can also create brushes, stamps, 'starters', templates, and fonts in - your own user account directory (folder) for Tux Paint to find. +You can also create brushes, stamps, 'starters', templates, and fonts in your +own user account directory (folder) for Tux Paint to find. - Windows +Windows - Your personal Tux Paint folder is stored in your personal - "Application Data". For example, on newer Windows: + Your personal Tux Paint folder is stored in your personal "Application + Data". For example, on newer Windows: - C:\Documents and Settings\(username)\Application Data\TuxPaint\ + C:\Documents and Settings\(username)\Application Data\TuxPaint\ - macOS - Your personal Tux Paint folder is stored in your personal - "Application Support" folder: - /Users/(username)/Library/Application Support/TuxPaint/ +macOS - Linux and Unix + Your personal Tux Paint folder is stored in your personal "Application + Support" folder: - Your personal Tux Paint files go into a 'hidden directory' found - in your account's home directory: "$(HOME)/.tuxpaint/" (also known - as "~/.tuxpaint/"). + /Users/(username)/Library/Application Support/TuxPaint/ - That is, if your home directory is "/home/tux", then your personal - Tux Paint files go in "/home/tux/.tuxpaint/". - Don't forget the period (".") before the "tuxpaint"! - To add your own brushes, stamps, 'starters,' templates, and fonts, create - subdirectories under your personal Tux Paint directory named "brushes", - "stamps", "starters", "templates", "fonts", respectively. +Linux and Unix - (For example, if you created a brush named "flower.png", you would put it - in "~/.tuxpaint/brushes/" under Linux or Unix.) + Your personal Tux Paint files go into a 'hidden directory' found in your + account's home directory: "$(HOME)/.tuxpaint/" (also known as "~/.tuxpaint/ + "). - Brushes + That is, if your home directory is "/home/tux", then your personal Tux + Paint files go in "/home/tux/.tuxpaint/". - The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux - Paint are simply PNG image files. + Don't forget the period (".") before the "tuxpaint"! - The alpha (transparency) of the PNG image is used to determine the shape - of the brush, which means that the shape can be 'anti-aliased' and even - partially-transparent! - Greyscale pixels in the brush PNG will be drawn using the - currently-selected color in Tux Paint. Color pixels will be tinted. + + +To add your own brushes, stamps, 'starters,' templates, and fonts, create +subdirectories under your personal Tux Paint directory named "brushes", "stamps +", "starters", "templates", "fonts", respectively. + +(For example, if you created a brush named "flower.png", you would put it in "~ +/.tuxpaint/brushes/" under Linux or Unix.) + +Brushes + +The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux Paint +are simply PNG image files. + +The alpha (transparency) of the PNG image is used to determine the shape of the +brush, which means that the shape can be 'anti-aliased' and even +partially-transparent! + +Greyscale pixels in the brush PNG will be drawn using the currently-selected +color in Tux Paint. Color pixels will be tinted. Brush Options - Aside from a graphical shape, brushes can also be given other attributes. - To do this, you need to create a 'data file' for the brush. +Aside from a graphical shape, brushes can also be given other attributes. To do +this, you need to create a 'data file' for the brush. - A brush's data file is simply a plain ASCII text file containing the - options for the brush. +A brush's data file is simply a plain ASCII text file containing the options +for the brush. - The file has the same name as the PNG image, but a ".dat" extension. - (e.g., "brush.png"'s data file is the text file "brush.dat", found in the - same directory.) +The file has the same name as the PNG image, but a ".dat" extension. (e.g., +"brush.png"'s data file is the text file "brush.dat", found in the same +directory.) - Brush Spacing +Brush Spacing - As of Tux Paint version 0.9.16, you can now specify the spacing - for brushes (that is, how often they are drawn). By default, the - spacing will be the brush's height, divided by 4. + As of Tux Paint version 0.9.16, you can now specify the spacing for brushes + (that is, how often they are drawn). By default, the spacing will be the + brush's height, divided by 4. - Add a line containing the line "spacing=N" to the brush's data - file, where "N" is the spacing you want for the brush. (The lower - the number, the more often the brush is drawn.) + Add a line containing the line "spacing=N" to the brush's data file, where + "N" is the spacing you want for the brush. (The lower the number, the more + often the brush is drawn.) - Animated Brushes - As of Tux Paint version 0.9.16, you may now create animated - brushes. As the brush is used, each frame of the animation is - drawn. - Lay each frame out across a wide PNG image. For example, if your - brush is 30x30 and you have 5 frames, the image should be 150x30. +Animated Brushes - Add a line containing the line "frames=N" to the brush's data - file, where "N" is the number of frames in the brush. + As of Tux Paint version 0.9.16, you may now create animated brushes. As the + brush is used, each frame of the animation is drawn. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Lay each frame out across a wide PNG image. For example, if your brush is + 30x30 and you have 5 frames, the image should be 150x30. - Directional Brushes + Add a line containing the line "frames=N" to the brush's data file, where " + N" is the number of frames in the brush. - As of Tux Paint version 0.9.16, you may now create directional - brushes. As the brush is used, different shapes are drawn, - depending on the direction the brush is going. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - The directional shapes are divided into a 3x3 square in a PNG - image. For example, if your brush is 30x30, the image should be - 90x90, and each of the direction's shapes placed in a 3x3 grid. - The center region is used for no motion. The top right is used for - motion that's both up, and to the right. And so on. - Add a line containing the word "directional" to the brush's data - file. - Rotating Brushes +Directional Brushes - As of Tux Paint version 0.9.27, you may now create rotating - brushes. As the brush is used, it is rotated 360 degrees, - depending on the direction the brush is going. + As of Tux Paint version 0.9.16, you may now create directional brushes. As + the brush is used, different shapes are drawn, depending on the direction + the brush is going. - Add a line containing the word "rotate" to the brush's data file. + The directional shapes are divided into a 3x3 square in a PNG image. For + example, if your brush is 30x30, the image should be 90x90, and each of the + direction's shapes placed in a 3x3 grid. The center region is used for no + motion. The top right is used for motion that's both up, and to the right. + And so on. - Animated Directional or Rotating Brushes + Add a line containing the word "directional" to the brush's data file. - You may mix both animated and either directional or rotating - features into one brush. Use both options desired ("frames=N" and - "directional" or "rotate"), in separate lines in the brush's - ".dat" file. - For directional brushes, lay the brush out so that each 3x3 set of - directional shapes are laid out across a wide PNG image. For - example, if the brush is 30x30 and there are 5 frames, it would be - 450x90. (The leftmost 150x90 pixels of the image represent the 9 - direction shapes for the first frame, for example.) - Place the brush image PNGs (and any data text files) in the "brushes" - directory. +Rotating Brushes - 💡 Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + As of Tux Paint version 0.9.27, you may now create rotating brushes. As the + brush is used, it is rotated 360 degrees, depending on the direction the + brush is going. - Stamps + Add a line containing the word "rotate" to the brush's data file. - All stamp-related files go in the "stamps" directory. It's useful to - create subdirectories and sub-subdirectories there to organize the stamps. - (For example, you can have a "holidays" folder with "halloween" and - "christmas" sub-folders.) + + +Animated Directional or Rotating Brushes + + You may mix both animated and either directional or rotating features into + one brush. Use both options desired ("frames=N" and "directional" or " + rotate"), in separate lines in the brush's ".dat" file. + + For directional brushes, lay the brush out so that each 3x3 set of + directional shapes are laid out across a wide PNG image. For example, if + the brush is 30x30 and there are 5 frames, it would be 450x90. (The + leftmost 150x90 pixels of the image represent the 9 direction shapes for + the first frame, for example.) + + + + +Place the brush image PNGs (and any data text files) in the "brushes" +directory. + +💡 Note: If your new brushes all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +Stamps + +All stamp-related files go in the "stamps" directory. It's useful to create +subdirectories and sub-subdirectories there to organize the stamps. (For +example, you can have a "holidays" folder with "halloween" and "christmas" +sub-folders.) Stamp Images - Rubber Stamps in Tux Paint can be made up of a number of separate files. - The one file that is required is, of course, the picture itself. +Rubber Stamps in Tux Paint can be made up of a number of separate files. The +one file that is required is, of course, the picture itself. - As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or - SVG vector images. They can be full-color or greyscale. The alpha - (transparency) channel of PNGs is used to determine the actual shape of - the picture (otherwise you'll stamp a large rectangle on your drawings). +As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or SVG +vector images. They can be full-color or greyscale. The alpha (transparency) +channel of PNGs is used to determine the actual shape of the picture (otherwise +you'll stamp a large rectangle on your drawings). - PNGs can be any size, and Tux Paint (by default) provides a set of sizing - buttons to let the user scale the stamp up (larger) and down (smaller). +PNGs can be any size, and Tux Paint (by default) provides a set of sizing +buttons to let the user scale the stamp up (larger) and down (smaller). - SVGs are vector-based, and will be scaled appropriately for the canvas - size being used in Tux Paint. +SVGs are vector-based, and will be scaled appropriately for the canvas size +being used in Tux Paint. - 💡 Note: If your new PNG-based stamps all come out as solid squares or - rectangles, it's because you forgot to use alpha transparency! See the - 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new PNG-based stamps all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in - detail, how to make PNG images which will scale perfectly when used as - stamps in Tux Paint. +⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in detail, +how to make PNG images which will scale perfectly when used as stamps in Tux +Paint. Stamp Descriptive Text - Tux Paint will display descriptive text when a stamp is selected. These - are placed in plain text files with the same name as the PNG or SVG, but - with a ".txt" filename extension. (e.g., "stamp.png"'s description is - stored in "stamp.txt" in the same directory.) +Tux Paint will display descriptive text when a stamp is selected. These are +placed in plain text files with the same name as the PNG or SVG, but with a +".txt" filename extension. (e.g., "stamp.png"'s description is stored in +"stamp.txt" in the same directory.) - The first line of the text file will be used as the US English description - of the stamp's image. It must be encoded in UTF-8. +The first line of the text file will be used as the US English description of +the stamp's image. It must be encoded in UTF-8. - Localization Support +Localization Support - Additional lines can be added to the text file to provide - translations of the description, to be displayed when Tux Paint is - running in a different locale (like French or Spanish). + Additional lines can be added to the text file to provide translations of + the description, to be displayed when Tux Paint is running in a different + locale (like French or Spanish). - The beginning of the line should correspond to the language code - of the language in question (e.g., "fr" for French, and "zh_TW" - for Traditional Chinese), followed by ".utf8=" and the translated - description (Unicode, encoded in UTF-8). + The beginning of the line should correspond to the language code of the + language in question (e.g., "fr" for French, and "zh_TW" for Traditional + Chinese), followed by ".utf8=" and the translated description (Unicode, + encoded in UTF-8). - For Tux Paint developers: There are scripts in the "po" directory - for converting the text files to PO format (and back) for easy - translation to different languages. Therefore you should never add - or change translations in the ".txt" files directly. + For Tux Paint developers: There are scripts in the "po" directory for + converting the text files to PO format (and back) for easy translation to + different languages. Therefore you should never add or change translations + in the ".txt" files directly. + + If no translation is available for the language Tux Paint is currently + running in, the US English text is used. + + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. - If no translation is available for the language Tux Paint is - currently running in, the US English text is used. - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. Stamp Sound Effects - Tux Paint can play a sound effect when a stamp is selected. For example, - the sound of a duck quaking when selecting a duck, or a brief piece of - music when a musical instrument is chosen. Files may be in "WAVE (".wav")" - or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG or - SVG image. (e.g., "stamp.svg"'s sound effect is the sound file "stamp.ogg" - in the same directory.) +Tux Paint can play a sound effect when a stamp is selected. For example, the +sound of a duck quaking when selecting a duck, or a brief piece of music when a +musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis +(".ogg")" formats, and are given same name as the PNG or SVG image. (e.g., +"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same +directory.) - Localization Support +Localization Support - For sounds for different locales (e.g., if the sound is someone - saying a word, and you want translated versions of the word said), - also create WAV or OGG files with the locale's label in the - filename, in the form: "stamp_LOCALE.EXT" + For sounds for different locales (e.g., if the sound is someone saying a + word, and you want translated versions of the word said), also create WAV + or OGG files with the locale's label in the filename, in the form: + "stamp_LOCALE.EXT" - The sound effect that will be played when the stamp corresponding - to the image file "stamp.png" is selected, and when Tux Paint is - using the Spanish locale, would be "stamp_es.wav". Under the - French locale, it would be "stamp_fr.wav". Under the Brazilian - Portuguese locale, "stamp_pt_BR.wav". And so on... + The sound effect that will be played when the stamp corresponding to the + image file "stamp.png" is selected, and when Tux Paint is using the Spanish + locale, would be "stamp_es.wav". Under the French locale, it would be + "stamp_fr.wav". Under the Brazilian Portuguese locale, "stamp_pt_BR.wav". + And so on... - If no localized sound effect can be loaded, Tux Paint will attempt - to load the 'default' sound file. (e.g., "stamp.wav") + If no localized sound effect can be loaded, Tux Paint will attempt to load + the 'default' sound file. (e.g., "stamp.wav") - 💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive - Sound', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound', +below. Stamp Descriptive Sound - Tux Paint can also play a descriptive sound when a stamp is selected. For - example, the sound of someone saying the word "duck" when selecting a - duck, or the name of a musical instrument when one is chosen. Files may be - in "WAVE (".wav")" or "OGG Vorbis (".ogg")" formats, and are given same - name as the PNG or SVG image, with "_desc" at the end. (e.g., - "stamp.svg"'s descriptive sound is the sound file "stamp_desc.ogg" in the - same directory.) +Tux Paint can also play a descriptive sound when a stamp is selected. For +example, the sound of someone saying the word "duck" when selecting a duck, or +the name of a musical instrument when one is chosen. Files may be in "WAVE +(".wav")" or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG +or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound +is the sound file "stamp_desc.ogg" in the same directory.) - Localization Support +Localization Support + + For descriptive sounds for different locales, also create WAV or OGG files + with both "_desc" and the locale's label in the filename, in the form: + "stamp_desc_LOCALE.EXT" + + The descriptive sound that will be played when the stamp corresponding to + the image file "stamp.png" is selected, and when Tux Paint is using the + Spanish locale, would be "stamp_desc_es.wav". Under the French locale, it + would be "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, + "stamp_desc_pt_BR.wav". And so on... + + If no localized descriptive sound can be loaded, Tux Paint will attempt to + load the 'default' sound file. (e.g., "stamp_desc.wav") - For descriptive sounds for different locales, also create WAV or - OGG files with both "_desc" and the locale's label in the - filename, in the form: "stamp_desc_LOCALE.EXT" - The descriptive sound that will be played when the stamp - corresponding to the image file "stamp.png" is selected, and when - Tux Paint is using the Spanish locale, would be - "stamp_desc_es.wav". Under the French locale, it would be - "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, - "stamp_desc_pt_BR.wav". And so on... - If no localized descriptive sound can be loaded, Tux Paint will - attempt to load the 'default' sound file. (e.g., "stamp_desc.wav") Stamp Options - Aside from a graphical shape, a textual description, a sound effect, and a - descriptive sound, stamps can also be given other attributes. To do this, - you need to create a 'data file' for the stamp. +Aside from a graphical shape, a textual description, a sound effect, and a +descriptive sound, stamps can also be given other attributes. To do this, you +need to create a 'data file' for the stamp. - A stamp's data file is simply a plain ASCII text file containing the - options for the stamp. +A stamp's data file is simply a plain ASCII text file containing the options +for the stamp. - The file has the same name as the PNG or SVG image, but a ".dat" - extension. (e.g., "stamp.png"'s data file is the text file "stamp.dat", - found in the same directory.) +The file has the same name as the PNG or SVG image, but a ".dat" extension. +(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same +directory.) - Colored Stamps +Colored Stamps - Stamps can be made to be either "colorable" or "tintable." + Stamps can be made to be either "colorable" or "tintable." - Colorable + Colorable - "Colorable" stamps they work much like brushes - you - pick the stamp to get the shape, and then pick the - color you want it to be. (Symbol stamps, like the - mathematical and musical ones, are an example.) + "Colorable" stamps they work much like brushes - you pick the stamp to + get the shape, and then pick the color you want it to be. (Symbol + stamps, like the mathematical and musical ones, are an example.) - Nothing about the original image is used except the - transparency (from "alpha" channel). The color of the - stamp comes out solid. + Nothing about the original image is used except the transparency (from + "alpha" channel). The color of the stamp comes out solid. - Add a line containing the word "colorable" to the - stamp's data file. + Add a line containing the word "colorable" to the stamp's data file. - Tinted - "Tinted" stamps are similar to "colorable" ones, - except the details of the original image are kept. - (To put it technically, the original image is used, - but its hue is changed, based on the - currently-selected color.) - Add a line containing the word "tintable" to the - stamp's data file. + Tinted - Tinting Options: + "Tinted" stamps are similar to "colorable" ones, except the details of + the original image are kept. (To put it technically, the original image + is used, but its hue is changed, based on the currently-selected + color.) - Depending on the contents of your stamp, you might - want to have Tux Paint use one of a number of methods - when tinting it. Add one of the following lines to - the stamp's data file: + Add a line containing the word "tintable" to the stamp's data file. - Normal tinter — "tinter=normal" (the default) - This is the normal tinting mode. First, - the primary hue of the stamp is - determined. (For example, a picture of a - flower with a stem will have the petal - color seen as the primary hue of the - overall image.) Next, the most highly - saturated part of the picture is found. - With "normal tinter", the range of hue - used to do this starts out within ±18° - of the pimary hue found in step 1. (If - none can be found, it widens the range - by 50% and tries again.) Finally, the - image is tinted. Anything falling within - 50% of the range (e.g., ±27°) is altered - to have the hue of the color chosen by - the user. - Narrow tinter — "tinter=narrow" - This like the "normal" option described - above, but starts a narrower hue range - of ±6°. Anything found within 50% of the - range (e.g. ±9°) is tinted. If too much - of your stamp is being tinted, try this - option. - 'Any hue' tinter — "tinter=anyhue" - This remaps all hues in the stamp. It - works similarly to the "anyhue" and - "narrow" options described above, but - the hue range is ±180°. + Tinting Options: - Vector tinter — "tinter=vector" - This maps 'black through white' to - 'black through destination'. + Depending on the contents of your stamp, you might want to have Tux + Paint use one of a number of methods when tinting it. Add one of the + following lines to the stamp's data file: - Unalterable Stamps + Normal tinter — "tinter=normal" (the default) + This is the normal tinting mode. First, the primary hue of the + stamp is determined. (For example, a picture of a flower with a + stem will have the petal color seen as the primary hue of the + overall image.) Next, the most highly saturated part of the picture + is found. With "normal tinter", the range of hue used to do this + starts out within ±18° of the pimary hue found in step 1. (If none + can be found, it widens the range by 50% and tries again.) Finally, + the image is tinted. Anything falling within 50% of the range + (e.g., ±27°) is altered to have the hue of the color chosen by the + user. - By default, a stamp can be flipped upside down, shown as a mirror - image, or both. This is done using the control buttons below the - stamp selector, at the lower right side of the screen in Tux - Paint. + Narrow tinter — "tinter=narrow" + This like the "normal" option described above, but starts a + narrower hue range of ±6°. Anything found within 50% of the range + (e.g. ±9°) is tinted. If too much of your stamp is being tinted, + try this option. - Sometimes, it doesn't make sense for a stamp to be flippable or - mirrored; for example, stamps of letters or numbers. Sometimes - stamps are symmetrical, so letting the user flip or mirror them - isn't useful. + 'Any hue' tinter — "tinter=anyhue" + This remaps all hues in the stamp. It works similarly to the + "anyhue" and "narrow" options described above, but the hue range is + ±180°. - To prevent a stamp from being flipped vertically, add the option - "noflip" to the stamp's data file. + Vector tinter — "tinter=vector" + This maps 'black through white' to 'black through destination'. - To prevent a stamp from being mirrored horizontally, add the - option "nomirror" to the stamp's data file. - Initial Stamp Size - By default, Tux Paint assumes that your stamp is sized - appropriately for unscaled display on a 608x472 canvas. This was - the original Tux Paint canvas size, provided by a 640x480 screen. - Tux Paint will then adjust the stamp according to the current - canvas size and, if enabled, the user's stamp size controls. - If your stamp would be too big or too small, you can specify a - scale factor. If your stamp would be 2.5 times as wide (or tall) - as it should be, add one of the following options, which represent - the same adjustment, to the stamp's data file. (An equals sign, - "=", may be included after the word "scale".) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Windows Users - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. +Unalterable Stamps + + By default, a stamp can be flipped upside down, shown as a mirror image, or + both. This is done using the control buttons below the stamp selector, at + the lower right side of the screen in Tux Paint. + + Sometimes, it doesn't make sense for a stamp to be flippable or mirrored; + for example, stamps of letters or numbers. Sometimes stamps are + symmetrical, so letting the user flip or mirror them isn't useful. + + To prevent a stamp from being flipped vertically, add the option "noflip" + to the stamp's data file. + + To prevent a stamp from being mirrored horizontally, add the option " + nomirror" to the stamp's data file. + + + +Initial Stamp Size + + By default, Tux Paint assumes that your stamp is sized appropriately for + unscaled display on a 608x472 canvas. This was the original Tux Paint + canvas size, provided by a 640x480 screen. Tux Paint will then adjust the + stamp according to the current canvas size and, if enabled, the user's + stamp size controls. + + If your stamp would be too big or too small, you can specify a scale + factor. If your stamp would be 2.5 times as wide (or tall) as it should be, + add one of the following options, which represent the same adjustment, to + the stamp's data file. (An equals sign, "=", may be included after the word + "scale".) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Windows Users + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. + + + Pre-Mirrored and Flipped Stamps - In some cases, you may wish to provide a pre-drawn version of a stamp's - mirror-image, flipped image, or even both. For example, imagine a picture - of a fire truck with the words "Fire Department" written across the side. - You probably do not want that text to appear backwards when the image is - flipped! +In some cases, you may wish to provide a pre-drawn version of a stamp's +mirror-image, flipped image, or even both. For example, imagine a picture of a +fire truck with the words "Fire Department" written across the side. You +probably do not want that text to appear backwards when the image is flipped! - To create a mirrored version of a stamp that you want Tux Paint to use, - rather than mirroring one on its own, simply create a second ".png" or - ".svg" graphics file with the same name, except with "_mirror" before the - filename extension. +To create a mirrored version of a stamp that you want Tux Paint to use, rather +than mirroring one on its own, simply create a second ".png" or ".svg" graphics +file with the same name, except with "_mirror" before the filename extension. - For example, for the stamp "stamp.png" you would create another file named - "stamp_mirror.png", which will be used when the stamp is mirrored (rather - than using a backwards version of "stamp.png"). +For example, for the stamp "stamp.png" you would create another file named +"stamp_mirror.png", which will be used when the stamp is mirrored (rather than +using a backwards version of "stamp.png"). - As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with - "_flip" in the name, and/or an image that is both mirrored and flipped, by - naming it "_mirror_flip". +As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with " +_flip" in the name, and/or an image that is both mirrored and flipped, by +naming it "_mirror_flip". - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - Fonts +Fonts - The fonts used by Tux Paint are TrueType Fonts (TTF). +The fonts used by Tux Paint are TrueType Fonts (TTF). - Simply place them in the "fonts" directory. Tux Paint will load the font - and provide four different sizes in the 'Letters' selector when using the - 'Text' and 'Label' tools. +Simply place them in the "fonts" directory. Tux Paint will load the font and +provide four different sizes in the 'Letters' selector when using the 'Text' +and 'Label' tools. - 'Starters' +'Starters' - 'Starter' images appear in the 'New' dialog, along with solid color - background choices. +'Starter' images appear in the 'New' dialog, along with solid color background +choices. - When you use a 'starter' image, make modifications, and save it, the - original 'starter' image is not overwritten. Additionally, as you edit - your new picture, the contents of the original 'starter' can affect it. +When you use a 'starter' image, make modifications, and save it, the original +'starter' image is not overwritten. Additionally, as you edit your new picture, +the contents of the original 'starter' can affect it. Coloring-Book Style Starters - The most basic kind of 'starter' is similar to a picture in a coloring - book. It's an outline of a shape which you can then color in and add - details to. In Tux Paint, as you draw, type text, or stamp stamps, the - outline remains 'above' what you draw. You can erase the parts of the - drawing you made, but you can't erase the outline. +The most basic kind of 'starter' is similar to a picture in a coloring book. +It's an outline of a shape which you can then color in and add details to. In +Tux Paint, as you draw, type text, or stamp stamps, the outline remains 'above' +what you draw. You can erase the parts of the drawing you made, but you can't +erase the outline. - To create this kind of 'starter' image, simply create an outlined black - and white picture in a paint program, and save it as a raster PNG file, or - vector SVG. If saving as a PNG, you may optionally render the image as - black-and-transparent, rather than black-and-white, but (as of Tux Paint - 0.9.21) this is not required. +To create this kind of 'starter' image, simply create an outlined black and +white picture in a paint program, and save it as a raster PNG file, or vector +SVG. If saving as a PNG, you may optionally render the image as +black-and-transparent, rather than black-and-white, but (as of Tux Paint +0.9.21) this is not required. Scene-Style Starters - Along with the 'coloring-book' style overlay, you can also provide a - separate background image as part of a 'starter' picture. The overlay acts - the same: it can't be drawn over, erased, or affected by 'Magic' tools. - However, the background can be! +Along with the 'coloring-book' style overlay, you can also provide a separate +background image as part of a 'starter' picture. The overlay acts the same: it +can't be drawn over, erased, or affected by 'Magic' tools. However, the +background can be! - When the 'Eraser' tool is used on a picture based on this kind of - 'starter' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'starter' image. +When the 'Eraser' tool is used on a picture based on this kind of 'starter' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'starter' image. - By creating both an overlay and a background, you can create a 'starter' - which simulates depth. Imagine a background that shows the ocean, and an - overlay that's a picture of a reef. You can then draw (or stamp) fish in - the picture. They'll appear in the ocean, but never 'in front of' the - reef. +By creating both an overlay and a background, you can create a 'starter' which +simulates depth. Imagine a background that shows the ocean, and an overlay +that's a picture of a reef. You can then draw (or stamp) fish in the picture. +They'll appear in the ocean, but never 'in front of' the reef. - To create this kind of 'starter' picture, simply create an overlay (with - transparency) and save it as a PNG. Then create another image (without - transparency), and save it with the same filename, but with "-back" (short - for 'background') appended to the name. (e.g., "starter-back.png" would be - the background ocean picture that corresponds to the overlay, or - foreground.) +To create this kind of 'starter' picture, simply create an overlay (with +transparency) and save it as a PNG. Then create another image (without +transparency), and save it with the same filename, but with "-back" (short for +'background') appended to the name. (e.g., "starter-back.png" would be the +background ocean picture that corresponds to the overlay, or foreground.) - For best results, 'starter' images should be at least the same size as Tux - Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" - section of Tux Paint's main documentation (README) for details on sizing.) - If they are not, they will be stretched or scaled. This is done without - affecting the shape ("aspect ratio"); however some smudging may be applied - to the edges. +For best results, 'starter' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. - Place them in the "starters" directory. When the 'New' dialog is accessed - in Tux Paint, the 'starter' images will appear in the screen that appears, - after the various solid color choices. +Place them in the "starters" directory. When the 'New' dialog is accessed in +Tux Paint, the 'starter' images will appear in the screen that appears, after +the various solid color choices. - 💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'starter' image, it - will always be affected by it.) +💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a 'starter' image, it will always be affected by it.) Starter Options - Aside from an image, starters can also be given other attributes. To do - this, you need to create a 'data file' for the starter. (Note: Tux Paint - prior to version 0.9.29 did not support starter options.) +Aside from an image, starters can also be given other attributes. To do this, +you need to create a 'data file' for the starter. (Note: Tux Paint prior to +version 0.9.29 did not support starter options.) - A starter's data file is simply a plain ASCII text file containing the - options for the starter. +A starter's data file is simply a plain ASCII text file containing the options +for the starter. - The file has the same name as the image, but a ".dat" extension. (e.g., - "starter.png"'s data file is the text file "starter.dat", found in the - same directory.) +The file has the same name as the image, but a ".dat" extension. (e.g., +"starter.png"'s data file is the text file "starter.dat", found in the same +directory.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + Colors may be listed using three decimal numbers (e.g., "255 68 136") or a + 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "#F48"). - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - 'Templates' + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - 'Template' images also appear in the 'New' dialog, along with solid color - background choices and 'Starters'. (Note: Tux Paint prior to version - 0.9.22 did not have the 'Template' feature.) + Focusing on the top of a starter image stretched to fit the width of the + canvas. - Unlike pictures drawn in Tux Paint by users and then opened later, opening - a 'template' creates a new drawing. When you save, the 'template' image is - not overwritten. Unlike 'starters', there is no immutable 'layer' above - the canvas. You may draw over any part of it. - When the 'Eraser' tool is used on a picture based on this kind of - 'template' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'template' image. + [ Landscape-shaped image of the ground with the sun at the top. ] - 'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) - format). No preparation or conversion should be required. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - For best results, 'template' images should be at least the same size as - Tux Paint's drawing canvas. (See the "Loading Other Pictures into Tux - Paint" section of Tux Paint's main documentation (README) for details on - sizing.) If they are not, they will be stretched or scaled. This is done - without affecting the shape ("aspect ratio"); however some smudging may be - applied to the edges. - Place them in the "templates" directory. When the 'New' dialog is accessed - in Tux Paint, the 'template' images will appear in the screen that - appears, after the various solid color choices. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +'Templates' + +'Template' images also appear in the 'New' dialog, along with solid color +background choices and 'Starters'. (Note: Tux Paint prior to version 0.9.22 did +not have the 'Template' feature.) + +Unlike pictures drawn in Tux Paint by users and then opened later, opening a +'template' creates a new drawing. When you save, the 'template' image is not +overwritten. Unlike 'starters', there is no immutable 'layer' above the canvas. +You may draw over any part of it. + +When the 'Eraser' tool is used on a picture based on this kind of 'template' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'template' image. + +'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) format). +No preparation or conversion should be required. + +For best results, 'template' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. + +Place them in the "templates" directory. When the 'New' dialog is accessed in +Tux Paint, the 'template' images will appear in the screen that appears, after +the various solid color choices. + +💡 Note: 'Templates' are 'attached' to saved pictures, via a small text file +that has the same name as the saved file, but with ".dat" as the extension. +This allows it to continue to affect the drawing even after Tux Paint has been +quit, or another picture is loaded or a new image is created. (In other words, +if you base a drawing on a 'template' image, it will always be affected by it.) - 💡 Note: 'Templates' are 'attached' to saved pictures, via a small text - file that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'template' image, it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Translations +Translations - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - To translate Tux Paint to a new language, copy the translation template - file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder - "src/po/"). Rename the copy as a ".po" file, with an appropriate name for - the locale you're translating to (e.g., "es.po" for Spanish; or "pt_BR.po" - for Brazilian Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese - spoken in Portugal.) +To translate Tux Paint to a new language, copy the translation template file, +"tuxpaint.pot" (found in Tux Paint's source code, in the folder "src/po/"). +Rename the copy as a ".po" file, with an appropriate name for the locale you're +translating to (e.g., "es.po" for Spanish; or "pt_BR.po" for Brazilian +Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese spoken in Portugal.) - Open the newly-created ".po" file — you can edit in a plain text edtior, - such as Emacs, Pico or VI on Linux, or NotePad on Windows. The original - English text used in Tux Paint is listed in lines starting with "msgid". - Enter your translations of each of these pieces of text in the empty - "msgstr" lines directly below the corresponding "msgid" lines. (Note: Do - not remove the quotes.) +Open the newly-created ".po" file — you can edit in a plain text edtior, such +as Emacs, Pico or VI on Linux, or NotePad on Windows. The original English text +used in Tux Paint is listed in lines starting with "msgid". Enter your +translations of each of these pieces of text in the empty "msgstr" lines +directly below the corresponding "msgid" lines. (Note: Do not remove the +quotes.) - Example: +Example: - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - Various tools exist to manage gettext translation catalogs, so you don't - have to edit them by hand in a text editor. Here are a few: - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +Various tools exist to manage gettext translation catalogs, so you don't have +to edit them by hand in a text editor. Here are a few: - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - To edit an existing translation, download the latest ".po" file for that - language, and edit it as described above. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - You may send new or edited translation files to Bill Kendrick, lead - developer of Tux Paint, at: bill@newbreedsoftware.com, or post them to the - "tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). +To edit an existing translation, download the latest ".po" file for that +language, and edit it as described above. - Alternatively, if you have an account with SourceForge.net, you can - request to be added to the "tuxpaint" project and receive write-access to - the Git source code repository so that you may commit your changes - directly. +You may send new or edited translation files to Bill Kendrick, lead developer +of Tux Paint, at: bill@newbreedsoftware.com, or post them to the +"tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). - 💡 Note: Support for new locales requires making additions to Tux Paint's - source code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the - Makefile, to ensure the ".po" files are compiled into ".mo" files, and - available for use at runtime. +Alternatively, if you have an account with SourceForge.net, you can request to +be added to the "tuxpaint" project and receive write-access to the Git source +code repository so that you may commit your changes directly. - Alternative Input Methods +💡 Note: Support for new locales requires making additions to Tux Paint's source +code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the Makefile, +to ensure the ".po" files are compiled into ".mo" files, and available for use +at runtime. - Tux Paint's 'Text' and 'Label' tools can provide alternative input methods - for some languages. For example, when Tux Paint is running with a Japanese - locale, the right [Alt] key can be pressed to cycle between Latin, - Romanized Hiragana and Romanized Katakana modes. This allows native - characters and words to be entered into the 'Text' and 'Label' tools by - typing one or more keys on a keyboard with Latin characters (e.g., a US - QWERTY keyboard). +Alternative Input Methods - To create an input method for a new locale, create a text file with a name - based on the locale (e.g., "ja" for Japanese), with ".im" as the extension - (e.g., "ja.im"). +Tux Paint's 'Text' and 'Label' tools can provide alternative input methods for +some languages. For example, when Tux Paint is running with a Japanese locale, +the right [Alt] key can be pressed to cycle between Latin, Romanized Hiragana +and Romanized Katakana modes. This allows native characters and words to be +entered into the 'Text' and 'Label' tools by typing one or more keys on a +keyboard with Latin characters (e.g., a US QWERTY keyboard). - The ".im" file can have multiple character mapping sections for different - character mapping modes. For example, on a Japanese typing system, typing - [K] [A] in Hiragana mode generates a different Unicode character ("か") - than typing [K] [A] in Katakana mode ("カ"). +To create an input method for a new locale, create a text file with a name +based on the locale (e.g., "ja" for Japanese), with ".im" as the extension +(e.g., "ja.im"). - List the character mappings in this file, one per line. Each line should - contain (separated by whitespace): +The ".im" file can have multiple character mapping sections for different +character mapping modes. For example, on a Japanese typing system, typing [K] +[A] in Hiragana mode generates a different Unicode character ("か") than typing +[K] [A] in Katakana mode ("カ"). - * the Unicode value of the character, in hexadecimal (more than one - character can be listed, separated by a colon (':'), this allowing - some sequences to map to words) - * the keycode sequence (the ASCII characters that must be entered to - generate the Unicode character) - * a flag (or "-" if none) +List the character mappings in this file, one per line. Each line should +contain (separated by whitespace): - Start additional character mapping sections with a line containign the - word "section". + * the Unicode value of the character, in hexadecimal (more than one character + can be listed, separated by a colon (':'), this allowing some sequences to + map to words) + * the keycode sequence (the ASCII characters that must be entered to generate + the Unicode character) + * a flag (or "-" if none) - Example: +Start additional character mapping sections with a line containign the word +"section". - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +Example: - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new input methods requires making additions to Tux - Paint's source code ("/src/im.c"), and requires updates to the Makefile, - to ensure the ".im" files are available for use at runtime. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - On-screen Keyboard +💡 Note: Support for new input methods requires making additions to Tux Paint's +source code ("/src/im.c"), and requires updates to the Makefile, to ensure the +".im" files are available for use at runtime. - As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an - on-screen keyboard that allows the pointer (via a mouse, eye-tracking - systems, etc.) to be used to input characters. Files that describe the - layout and available keys are stored in Tux Paint "osk" directory. Each - keyboard layout is defined by a number of files (some of which may be - shared by different layouts). +On-screen Keyboard - We'll use the QWERTY keyboard as an example: +As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an +on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, +etc.) to be used to input characters. Files that describe the layout and +available keys are stored in Tux Paint "osk" directory. Each keyboard layout is +defined by a number of files (some of which may be shared by different +layouts). + +We'll use the QWERTY keyboard as an example: Layout overview file ("qwerty.layout") - This is a text file that specifies the other files used to describe the - layout and key mappings. +This is a text file that specifies the other files used to describe the layout +and key mappings. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - The "keyboardlist" line describes which layouts to switch to, when the - user clicks the left and right buttons on the keyboard. (See below.) +The "keyboardlist" line describes which layouts to switch to, when the user +clicks the left and right buttons on the keyboard. (See below.) Keyboard layout file ("qwerty.h_layout") - This describes how big the keyboard is (as a "width × height" grid), and - lists each key with its numeric keycode (see the "keymap" file, below), - the width it should be drawn at (typically "1.0", to take one space on the - keyboard, but in the example below, notice the "TAB" and "SPACE" keys are - much wider), the character or text to display on the key, depending on - which modifier keys have been pressed (one each for: no modifiers, - [Shift], [AltGr], and [Shift] + [AltGr]), and finally whether or not the - key is affected by the [CapsLock] key (use "1") or [AltGr] (alternate - graphics) key (use "2"), or not at all (use "0"). +This describes how big the keyboard is (as a "width × height" grid), and lists +each key with its numeric keycode (see the "keymap" file, below), the width it +should be drawn at (typically "1.0", to take one space on the keyboard, but in +the example below, notice the "TAB" and "SPACE" keys are much wider), the +character or text to display on the key, depending on which modifier keys have +been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] + +[AltGr]), and finally whether or not the key is affected by the [CapsLock] key +(use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use +"0"). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # Arrow to left will change to the previous keyboard - KEY 2 1.0 <- <- <- <- 0 + # Arrow to left will change to the previous keyboard + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # The ALT or ALTGR keys are used in im to switch the input mode - KEY 64 2.0 Alt Alt Alt Alt 0 + # The ALT or ALTGR keys are used in im to switch the input mode + KEY 64 2.0 Alt Alt Alt Alt 0 - # Space - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Space + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # Arrow to right will change to the next keyboard - KEY 1 1.0 -> -> -> -> 0 + # Arrow to right will change to the next keyboard + KEY 1 1.0 -> -> -> -> 0 - Notice here that alphabetic keys ([Q], [W], etc.) will be affected by - [CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will - not. +Notice here that alphabetic keys ([Q], [W], etc.) will be affected by +[CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will not. - Keycodes up to "8" are reserved for internal use. The ones currently used - are described below. +Keycodes up to "8" are reserved for internal use. The ones currently used are +described below. - * 0 — empty button - * 1 — next layout (per the layout file's "keyboardlist" setting) - * 2 — previous layout (per the layout file's "keyboardlist" setting) + * 0 — empty button + * 1 — next layout (per the layout file's "keyboardlist" setting) + * 2 — previous layout (per the layout file's "keyboardlist" setting) Keymap file ("us-intl-altgr-dead-keys.keymap") - This file defines which numeric keycodes (seen in the keyboard layout - files, such as "qwerty.h_layout" described above) should be mapped to - which actual characters that an application such as Tux Paint expects to - receive when keys (e.g., on a real keyboard) are pressed. +This file defines which numeric keycodes (seen in the keyboard layout files, +such as "qwerty.h_layout" described above) should be mapped to which actual +characters that an application such as Tux Paint expects to receive when keys +(e.g., on a real keyboard) are pressed. - If you're using an operating system such as Linux, which runs X-Window and - has the "xmodmap" command-line tool available, you can run it with the - ("print keymap expressions" option, "-pke", to generate a keymap file. +If you're using an operating system such as Linux, which runs X-Window and has +the "xmodmap" command-line tool available, you can run it with the ("print +keymap expressions" option, "-pke", to generate a keymap file. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Composemap file ("en_US.UTF-8_Compose") - This file describes single characters that can be composed by multiple - inputs. For example, "[Compose]" followed by "[A]" and "[E]" can be used - to create the "æ" character. +This file describes single characters that can be composed by multiple inputs. +For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the +"æ" character. - The file that comes with Tux Paint is based on the US English UTF-8 - (Unicode) composemap that comes with X.Org's X Window system. The current - version from the Xlib library has a web located page at - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +The file that comes with Tux Paint is based on the US English UTF-8 (Unicode) +composemap that comes with X.Org's X Window system. The current version from +the Xlib library has a web located page at https://www.x.org/releases/current/ +doc/libX11/i18n/compose/en_US.UTF-8.html. Keysym definitions file ("keysymdef.h") - This file (which is a C programming language header file) is also from the - X Window System. It defines the Unicode values of each keycap (e.g., - "XK_equal" corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). +This file (which is a C programming language header file) is also from the X +Window System. It defines the Unicode values of each keycap (e.g., "XK_equal" +corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - It is unlikely that any modification will be required of this file. +It is unlikely that any modification will be required of this file. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/is_IS.UTF-8/FAQ.txt b/docs/is_IS.UTF-8/FAQ.txt index 38ec57cc3..13fb22faf 100644 --- a/docs/is_IS.UTF-8/FAQ.txt +++ b/docs/is_IS.UTF-8/FAQ.txt @@ -6,610 +6,612 @@ júlí 13, 2023 - ---------------------------------------------------------------------- - - +------------------------------+ - |Table of Contents | - |------------------------------| - | * Drawing-related | - | * Interface Problems | - | * Printing | - | * Saving | - | * Audio Problems | - | * Fullscreen Mode Problems | - | * Other Problems | - | * Help / Contact | - +------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++------------------------------+ +| Table of Contents | +|------------------------------| +| * Drawing-related | +| * Interface Problems | +| * Printing | +| * Saving | +| * Audio Problems | +| * Fullscreen Mode Problems | +| * Other Problems | +| * Help / Contact | ++------------------------------+ +------------------------------------------------------------------------------- Drawing-related - Fonts I added to Tux Paint only show squares - The TrueType Font you're using might have the wrong encoding. If - it's 'custom' encoded, for example, you can try running it through - FontForge (http://fontforge.sourceforge.net/) to convert it to an - ISO-8859 format. (Email us if you need help with special fonts.) +Fonts I added to Tux Paint only show squares + The TrueType Font you're using might have the wrong encoding. If it's + 'custom' encoded, for example, you can try running it through FontForge ( + http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format. + (Email us if you need help with special fonts.) - The Rubber Stamp tool is greyed out! +The Rubber Stamp tool is greyed out! - This means that Tux Paint either couldn't find any stamp images, - or was asked not to load them. + This means that Tux Paint either couldn't find any stamp images, or was + asked not to load them. - If you installed Tux Paint, but did not install the separate, - optional "Stamps" collection, quit Tux Paint and install it now. - It should be available from the same place you got the main Tux - Paint program. (Note: As of version 0.9.14, Tux Paint comes with a - small collection of example stamps.) + If you installed Tux Paint, but did not install the separate, optional + "Stamps" collection, quit Tux Paint and install it now. It should be + available from the same place you got the main Tux Paint program. (Note: As + of version 0.9.14, Tux Paint comes with a small collection of example + stamps.) - If you don't want to install the default collection of stamps, you - can just create your own. See the "Extending Tux Paint" - documentation for more on creating PNG and SVG image files, TXT - text description files, Ogg Vorbis, MP3 or WAV sound files, and - DAT text data files that make up stamps. + If you don't want to install the default collection of stamps, you can just + create your own. See the "Extending Tux Paint" documentation for more on + creating PNG and SVG image files, TXT text description files, Ogg Vorbis, + MP3 or WAV sound files, and DAT text data files that make up stamps. - 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.) + 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. + 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 - Tux Paint was built with low-quality (but faster) stamp outlines. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: +Stamp outlines are always rectangles - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint was built with low-quality (but faster) stamp outlines. - in the "tuxpaint.c" file in the "src" directory. + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + in the "tuxpaint.c" file in the "src" directory. + + + + +------------------------------------------------------------------------------- Interface Problems - Stamp thumbnails in the Stamp Selector look bad +Stamp thumbnails in the Stamp Selector look bad - Tux Paint was probably compiled with the faster, lower quality - thumbnail code enabled. Run the command: "tuxpaint - --verbose-version" from a command line. If, amongst the other - output, you see the text: "Low Quality Thumbnails enabled", then - this is what's happening. + Tux Paint was probably compiled with the faster, lower quality thumbnail + code enabled. Run the command: "tuxpaint --verbose-version" from a command + line. If, amongst the other output, you see the text: "Low Quality + Thumbnails enabled", then this is what's happening. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - #define LOW_QUALITY_THUMBNAILS + #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 - "Low Quality Thumbnails" is probably enabled. See: "Stamp - thumbnails in the Stamp Selector look bad", above. - All of the text is in uppercase! - The "uppercase" option is on. +Pictures in the 'Open' dialog look bad + "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the + Stamp Selector look bad", above. - Either change/remove the "uppercase" option, or you can override - it with "--mixedcase" on the command line or either "uppercase=no" - or "mixedcase=yes" in a configuration file. +All of the text is in uppercase! - Tux Paint is in a different language - Make sure your locale setting is correct. See "Tux Paint won't - switch to my language", below. + The "uppercase" option is on. - Tux Paint won't switch to my language - * Linux and Unix users: Make sure the locale is available + Either change/remove the "uppercase" option, or you can override it with + "--mixedcase" on the command line or either "uppercase=no" or "mixedcase= + yes" in a configuration file. - Make sure the locale you want is available. Check your - "/etc/locale.gen" file. See the "Options Documentation" for - the locales Tux Paint uses (especially when using the - "--lang" option). +Tux Paint is in a different language + Make sure your locale setting is correct. See "Tux Paint won't switch to my + language", below. - Note: Debian and derivative (e.g., Ubuntu) users can simply - run "dpkg-reconfigure locales" if the locales are managed by - "dpkg". +Tux Paint won't switch to my language + + Linux and Unix users: Make sure the locale is available - * If you're using the "--lang" command-line option + Make sure the locale you want is available. Check your "/etc/ + locale.gen" file. See the "Options Documentation" for the locales Tux + Paint uses (especially when using the "--lang" option). - Try using the "--locale" command-line option, or your - operating system's locale settings (e.g., the "$LANG" - environment variable), and please e-mail us regarding your - trouble. + Note: Debian and derivative (e.g., Ubuntu) users can simply run + "dpkg-reconfigure locales" if the locales are managed by "dpkg". - * If you're using the "--locale" command-line option + + If you're using the "--lang" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + Try using the "--locale" command-line option, or your operating + system's locale settings (e.g., the "$LANG" environment variable), and + please e-mail us regarding your trouble. - * If you're trying to use your Operating System's locale + + If you're using the "--locale" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + If this doesn't work, please e-mail us regarding your trouble. - * Make sure you have the necessary font + + If you're trying to use your Operating System's locale - Some translations require their own font. Chinese and Korean, - for example, need Chinese and Korean TrueType Fonts installed - and placed in the proper location, respectively. + If this doesn't work, please e-mail us regarding your trouble. - The appropriate fonts for such locales can be downloaded from - the Tux Paint website: + + Make sure you have the necessary font - https://tuxpaint.org/download/fonts/ + Some translations require their own font. Chinese and Korean, for + example, need Chinese and Korean TrueType Fonts installed and placed in + the proper location, respectively. - ---------------------------------------------------------------------- + The appropriate fonts for such locales can be downloaded from the Tux + Paint website: + + https://tuxpaint.org/download/fonts/ + + + + +------------------------------------------------------------------------------- Printing - Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) +Tux Paint won't print, gives an error, or prints garbage (Unix/Linux) - Tux Paint prints by creating a PostScript rendition of the picture - and sending it to an external command. By default, this command is - the "lpr" printing tool. + Tux Paint prints by creating a PostScript rendition of the picture and + sending it to an external command. By default, this command is the "lpr" + printing tool. - If that program is not available (for example, you're using CUPS, - the Common Unix Printing System, and do not have "cups-lpr" - installed), you will need to specify an appropriate command using - the "printcommand" option in Tux Paint's configuration file. (See - the "Options Documentation".) + If that program is not available (for example, you're using CUPS, the + Common Unix Printing System, and do not have "cups-lpr" installed), you + will need to specify an appropriate command using the "printcommand" option + in Tux Paint's configuration file. (See the "Options Documentation".) - 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. + 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. + 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 - The "print delay" option is on. You can only print once every X - seconds. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--printdelay=..." option. +I get the message "You can't print yet!" when I go to print - 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 - command-line argument. + The "print delay" option is on. You can only print once every X seconds. - If a "--printdelay=..." option isn't being sent on the command - line, check Tux Paint's configuration file for a line reading: - "printdelay=...". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--printdelay=..." option. - Either remove that line, set the delay value to 0 (no delay), or - decrease the delay to a value you prefer. (See the "Options - Documentation".) + 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 + command-line argument. - Or, you can simply run Tux Paint with the command-line argument: - "--printdelay=0", which will override the configuration file's - setting, and allow unlimited printing. (You won't have to wait - between prints.) + If a "--printdelay=..." option isn't being sent on the command line, check + Tux Paint's configuration file for a line reading: "printdelay=...". - I simply can't print! The button is greyed out! + Either remove that line, set the delay value to 0 (no delay), or decrease + the delay to a value you prefer. (See the "Options Documentation".) - The "no print" option is on. + Or, you can simply run Tux Paint with the command-line argument: + "--printdelay=0", which will override the configuration file's setting, and + allow unlimited printing. (You won't have to wait between prints.) - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noprint" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--noprint" is listed as a - command-line argument. - If a "--noprint" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "noprint=yes". +I simply can't print! The button is greyed out! - Either remove that line, or simply run Tux Paint with the - command-line argument: "--print", which will override the - configuration file's setting. + The "no print" option is on. - Or use Tux Paint Config. and make sure "Allow Printing" (under - "Printing") is checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noprint" option. - ---------------------------------------------------------------------- + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--noprint" is listed as a command-line + argument. + + If a "--noprint" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noprint=yes". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--print", which will override the configuration file's setting. + + Or use Tux Paint Config. and make sure "Allow Printing" (under "Printing") + is checked. + + + + +------------------------------------------------------------------------------- Saving - Where does Tux Paint save my drawings? +Where does Tux Paint save my drawings? - Unless you asked Tux Paint to save into a specific location (using - the "savedir" option), Tux Paint saves into a standard location on - your local drive: + Unless you asked Tux Paint to save into a specific location (using the + "savedir" option), Tux Paint saves into a standard location on your local + drive: - Windows Vista, Windows 8, Windows 10, Windows 11 - In the user's "AppData" folder: - e.g., - C:\Users\Username\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + In the user's "AppData" folder: + e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved - macOS - In the user's "Application Support" folder: - e.g., /Users/Username/Library/Applicaton - Support/TuxPaint/saved/ + macOS + In the user's "Application Support" folder: + e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - In the user's home directory ("$HOME"), under a - ".tuxpaint" subfolder: - e.g., /home/username/.tuxpaint/saved/ + Linux / Unix + In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder: + e.g., /home/username/.tuxpaint/saved/ - The images are stored as PNG bitmaps, which most modern programs - should be able to load (image editors, word processors, web - browsers, etc.) - Tux Paint always saves over my old picture + The images are stored as PNG bitmaps, which most modern programs should be + able to load (image editors, word processors, web browsers, etc.) - The "save over" option is enabled. (This disables the prompt that - would appear when you click 'Save.') - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveover" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--saveover" is listed as a - command-line argument. +Tux Paint always saves over my old picture - If a "--saveover" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=yes". + The "save over" option is enabled. (This disables the prompt that would + appear when you click 'Save.') - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveover" option. - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + 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 command-line + argument. - Also, see "Tux Paint always saves a new picture!", below. + If a "--saveover" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=yes". - Tux Paint always saves a new picture! + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. - The "never save over" option is enabled. (This disables the prompt - that would appear when you click 'Save.') + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveovernew" option. + Also, see "Tux Paint always saves a new picture!", below. - 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 - command-line argument. - If a "--saveovernew" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=new". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. +Tux Paint always saves a new picture! - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "Saving") is checked. + The "never save over" option is enabled. (This disables the prompt that + would appear when you click 'Save.') - Also, see "Tux Paint always saves over my old picture!", above. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveovernew" option. - ---------------------------------------------------------------------- + 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 + command-line argument. + + If a "--saveovernew" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=new". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under + "Saving") is checked. + + Also, see "Tux Paint always saves over my old picture!", above. + + + + +------------------------------------------------------------------------------- Audio Problems - There's no sound! - * First, check the obvious: - * Are your speakers connected and turned on? - * Is the volume turned up on your speakers? - * Is the volume turned up in your Operating System's - "mixer?" - * Are you certain you're using a computer with a sound - card? - * Are any other programs running that use sound? (They may - be 'blocking' Tux Paint from accessing your sound - device) - * (Unix/Linux) Are you using a sound system, such as aRts, - ESD or GStreamer? If so, try setting the - "SDL_AUDIODRIVER" environment variable before running - Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run - 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? +There's no sound! + + First, check the obvious: + o Are your speakers connected and turned on? + o Is the volume turned up on your speakers? + o Is the volume turned up in your Operating System's "mixer?" + o Are you certain you're using a computer with a sound card? + o Are any other programs running that use sound? (They may be + 'blocking' Tux Paint from accessing your sound device) + o (Unix/Linux) Are you using a sound system, such as aRts, ESD or + GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment + variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER= + arts"). Or, run 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 - program is "blocking" the sound device), then Tux Paint may - be running with a "no sound" option. + If sound seems to work otherwise (and you're sure no other program is + "blocking" the sound device), then Tux Paint may be running with a "no + sound" option. - If you're running Tux Paint from a command-line, make sure - you're not giving it a "--nosound" option. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--nosound" option. - If you're running Tux Paint by double-clicking an icon, check - the properties of the icon to see if "--nosound" is listed as - a command-line argument. + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--nosound" is listed as a + command-line argument. - If a "--nosound" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "nosound=yes". + If a "--nosound" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "nosound=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--sound", which will override the - configuration file's setting. + Either remove that line, or simply run Tux Paint with the command-line + argument: "--sound", which will override the configuration file's + setting. - Or, you can simply run Tux Paint with the command-line - argument: "Enable Sound Effects", which will override the - configuration file's setting, and allow unlimited printing. - (You won't have to wait between prints.) + Or, you can simply run Tux Paint with the command-line argument: + "Enable Sound Effects", which will override the configuration file's + setting, and allow unlimited printing. (You won't have to wait between + prints.) - * Were sounds temporarily disabled? + + Were sounds temporarily disabled? - Even if sounds are enabled in Tux Paint, it is possible to - disable and re-enable them temporarily using the [Alt] + [S] - key sequence. Try pressing those keys to see if sounds begin - working again. + Even if sounds are enabled in Tux Paint, it is possible to disable and + re-enable them temporarily using the [Alt] + [S] key sequence. Try + pressing those keys to see if sounds begin 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. - To test whether sound support was enabled when Tux Paint was - compiled, run Tux Paint from a command line, like so: + Tux Paint may have been compiled with sound support disabled. To test + whether sound support was enabled when Tux Paint was compiled, run Tux + Paint from a command line, like so: - tuxpaint --verbose-version + tuxpaint --verbose-version - If, amongst the other information, you see "Sound disabled", - then the version of Tux Paint you're running has sound - disabled. Recompile Tux Paint, and be sure NOT to build the - "nosound" target. (i.e., don't run "make nosound") Be sure - the SDL_mixer library and its development headers are - available! + If, amongst the other information, you see "Sound disabled", then the + version of Tux Paint you're running has sound disabled. Recompile Tux + Paint, and be sure NOT to build the "nosound" target. (i.e., don't run + "make nosound") Be sure the SDL_mixer library and its development + headers are available! - Tux Paint makes too much noise! Can I turn them off? - Yes, there are a number of ways to disable sounds in Tux Paint: - * Press [Alt] + [S] while in Tux Paint to temporarily disable - sounds. (Press that key sequence again to re-enable sounds.) - * Run Tux Paint with the "no sound" option: - * Run "tuxpaint --nosound" from the command line or - shortcut or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nosound=yes". - * Or use Tux Paint Config. and make sure "Enable Sound - Effects" (under "Video & Sound") is not checked. - * Alternatively, recompile Tux Paint with sound support - disabled. (See above, and the 'Install' documentation. +Tux Paint makes too much noise! Can I turn them off? - The stereo panning of sound effects is bothersome; can sound effects be - monophonic? + Yes, there are a number of ways to disable sounds in Tux Paint: - Run Tux Paint with the "no stereo" option: + + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds. + (Press that key sequence again to re-enable sounds.) + + Run Tux Paint with the "no sound" option: + o Run "tuxpaint --nosound" from the command line or shortcut or + desktop icon. + o Edit Tux Paint's configuration file (see "Options Documentation" + for details) and add a line containing "nosound=yes". + o Or use Tux Paint Config. and make sure "Enable Sound Effects" + (under "Video & Sound") is not checked. + o Alternatively, recompile Tux Paint with sound support disabled. + (See above, and the 'Install' documentation. - * Run "tuxpaint --nostereo" from the command line or shortcut - or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nostereo=yes". - * Or use Tux Paint Config. and make sure "Enable Stereo - Effects" (under "Video & Sound") is not checked. - The sound effects sound strange +The stereo panning of sound effects is bothersome; can sound effects be + monophonic? - This could have to do with how SDL and SDL_mixer were initialized. - (The buffer size chosen.) + Run Tux Paint with the "no stereo" option: - Please e-mail us with details about your computer system. - (Operating system and version, sound card, which version of Tux - Paint you're running (run "tuxpaint --version" to verify), and so - on.) + + Run "tuxpaint --nostereo" from the command line or shortcut or desktop + icon. + + Edit Tux Paint's configuration file (see "Options Documentation" for + details) and add a line containing "nostereo=yes". + + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under + "Video & Sound") is not checked. - ---------------------------------------------------------------------- + +The sound effects sound strange + + This could have to do with how SDL and SDL_mixer were initialized. (The + buffer size chosen.) + + Please e-mail us with details about your computer system. (Operating system + and version, sound card, which version of Tux Paint you're running (run + "tuxpaint --version" to verify), and so on.) + + + + +------------------------------------------------------------------------------- Fullscreen Mode Problems - When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns - black! - This is apparently a bug in the SDL library. Sorry. +When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black! + This is apparently a bug in the SDL library. Sorry. - When I run Tux Paint full-screen, it has large borders around it +When I run Tux Paint full-screen, it has large borders around it - Linux users - Your X-Window server is probably not set with the - ability to switch to the desired resolution: 800×600. (or whatever - resolution you have Tux Paint set to run at.) (This is typically - done manually under the X-Window server by pressing [Control] + - [Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus - (-)].) + Linux users - Your X-Window server is probably not set with the ability to + switch to the desired resolution: 800×600. (or whatever resolution you have + Tux Paint set to run at.) (This is typically done manually under the + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and + [Control] + [Alt] + [Keypad Minus (-)].) - For this to work, your monitor must support that resolution, and - you need to have it listed in your X server configuration. + For this to work, your monitor must support that resolution, and you need + to have it listed in your X server configuration. - Check the "Display" subsection of the "Screen" section of your - XFree86 or X.org configuration file (typically - "/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the - version of XFree86 you're using; 3.x or 4.x, respectively, or - "/etc/X11/xorg.conf" for X.org). + Check the "Display" subsection of the "Screen" section of your XFree86 or + X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/ + XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x, + respectively, or "/etc/X11/xorg.conf" for X.org). - Add "800x600" (or whatever resolution(s) you want) to the - appropriate "Modes" line. (e.g., in the "Display" subsection that - contains 24-bit color depth ("Depth 24"), which is what Tux Paint - tries to use.) + Add "800x600" (or whatever resolution(s) you want) to the appropriate + "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color + depth ("Depth 24"), which is what Tux Paint tries to use.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Note that some Linux distributions have tools that can make these - changes for you. Debian users can run the command - "dpkg-reconfigure xserver-xfree86" as root, for example. + Note that some Linux distributions have tools that can make these changes + for you. Debian users can run the command "dpkg-reconfigure + xserver-xfree86" as root, for example. - Tux Paint keeps running in Full Screen mode - I want it windowed! - The "fullscreen" option is set. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--fullscreen" option. +Tux Paint keeps running in Full Screen mode - I want it windowed! - 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 - command-line argument. + The "fullscreen" option is set. - If a "--fullscreen" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "fullscreen=yes". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--fullscreen" option. - Either remove that line, or simply run Tux Paint with the - command-line argument: "--windowed", which will override the - configuration file's setting. + 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 command-line + argument. - Or use Tux Paint Config. and make sure "Fullscreen" (under "Video - & Sound") is not checked. + If a "--fullscreen" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "fullscreen=yes". - ---------------------------------------------------------------------- + Either remove that line, or simply run Tux Paint with the command-line + argument: "--windowed", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound") + is not checked. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint won't run +Tux Paint won't run - If Tux Paint aborts with the message: "You're already running a - copy of Tux Paint!", this means it has been launched in the last - 30 seconds. (On Unix/Linux, this message would appear in a - terminal console if you ran Tux Paint from a command-line. On - Windows, this message would appear in a file named "stdout.txt" in - the same folder where TuxPaint.exe resides (e.g., in "C:\Program - Files\TuxPaint"). + If Tux Paint aborts with the message: "You're already running a copy of Tux + Paint!", this means it has been launched in the last 30 seconds. (On Unix/ + Linux, this message would appear in a terminal console if you ran Tux Paint + from a command-line. On Windows, this message would appear in a file named + "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\ + Program Files\TuxPaint"). - A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, - "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint - isn't run too many times at once (e.g., due to a child impatiently - clicking its icon more than once). + A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\ + lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many + times at once (e.g., due to a child impatiently clicking its icon more than + once). - Even if the lockfile exists, it contains the 'time' Tux Paint was - last run. If it's been more than 30 seconds, Tux Paint should run - fine, and simply update the lockfile with the current time. + Even if the lockfile exists, it contains the 'time' Tux Paint was last run. + If it's been more than 30 seconds, Tux Paint should run fine, and simply + 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. + 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. + To disable the lockfile, add the "--nolockfile" argument to Tux Paint's + command-line, or "nolockfile=yes" to the configuration file. - I can't quit Tux Paint - The "no quit" option is set. This disables the "Quit" button in - Tux Paint's toolbar (greying it out), and prevents Tux Paint from - being exited via the [Escape] key. - If Tux Paint is not in fullscreen mode, simply click the window - close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper - right.) +I can't 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. + The "no quit" option is set. This disables the "Quit" button in Tux Paint's + toolbar (greying it out), and prevents Tux Paint from being exited via the + [Escape] key. - (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 not in fullscreen mode, simply click the window close + button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.) - I don't want "no quit" mode enabled! + If Tux Paint is in fullscreen mode, you will need to use the [Shift] + + [Control] + [Escape] sequence on the keyboard to quit Tux Paint. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noquit" option. + (Note: with or without "no quit" set, you can always use the [Alt] + [F4] + combination on your keyboard to quit Tux Paint.) - 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 - command-line argument. - If a "--noquit" option isn't being sent on the command line, check - Tux Paint's configuration file for a line reading: "noquit=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--quit", which will override the - configuration file's setting. +I don't want "no quit" mode enabled! - Or use Tux Paint Config. and make sure "Disable Quit Button and - [Escape] Key" (under "Simplification") is not checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noquit" option. - Tux Paint keeps writing weird messages to the screen / to a text file + 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 command-line + argument. - A few messages are normal, but if Tux Paint is being extremely - verbose (like listing the name of every rubber-stamp image it - finds while loading them), then it was probably compiled with - debugging output turned on. + If a "--noquit" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noquit=yes". - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + Either remove that line, or simply run Tux Paint with the command-line + argument: "--quit", which will override the configuration file's setting. - #define DEBUG + Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape] + Key" (under "Simplification") is not checked. - in the "tuxpaint.c" file in the "src" directory. - Tux Paint is using options I didn't specify! - By default, Tux Paint first looks at configuration files for - options. +Tux Paint keeps writing weird messages to the screen / to a text file - * Windows + A few messages are normal, but if Tux Paint is being extremely verbose + (like listing the name of every rubber-stamp image it finds while loading + them), then it was probably compiled with debugging output turned on. - Under Windows, Tux Paint first examines the configuration - file: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - tuxpaint.cfg + #define DEBUG - Finally, any options sent as command-line arguments are used. + in the "tuxpaint.c" file in the "src" directory. - * macOS - * Unix and Linux - Under Unix and Linux, it first examines the system-wide - configuration file, located here: +Tux Paint is using options I didn't specify! - /etc/tuxpaint/tuxpaint.conf + By default, Tux Paint first looks at configuration files for options. - It then examines the user's personal configuration file: + + Windows - ~/.tuxpaintrc + Under Windows, Tux Paint first examines the configuration file: - Finally, any options sent as command-line arguments are used. + tuxpaint.cfg - * Haiku + Finally, any options sent as command-line arguments are used. - This means that if anything is set in a configuration file that - you don't want set, you'll need to either change the config. file - (if you can), or override the option on the command-line. + + macOS - For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" - includes this option to disable sound... + + Unix and Linux - nosound=yes + Under Unix and Linux, it first examines the system-wide configuration + file, located here: - ...then you can reenable sound by either adding this option to - your own ".tuxpaintrc" file: + /etc/tuxpaint/tuxpaint.conf - sound=yes + It then examines the user's personal configuration file: - ...or by using this command-line argument: + ~/.tuxpaintrc - --sound + Finally, any options sent as command-line arguments are used. - Linux and Unix users can also disable the system-wide - configuration file by including the following command-line - argument: + + Haiku - --nosysconfig + This means that if anything is set in a configuration file that you don't + want set, you'll need to either change the config. file (if you can), or + override the option on the command-line. - Tux Paint will then only look at "~/.tuxpaintrc" and command-line - arguments to determine what options should be set. + For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes + this option to disable sound... - ---------------------------------------------------------------------- + nosound=yes + + ...then you can reenable sound by either adding this option to your own + ".tuxpaintrc" file: + + sound=yes + + ...or by using this command-line argument: + + --sound + + Linux and Unix users can also disable the system-wide configuration file by + including the following command-line argument: + + --nosysconfig + + Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments + to determine what options should be set. + + + + +------------------------------------------------------------------------------- Help / Contact - Any questions you don't see answered? Please let us know! You can - subscribe and post to our "tuxpaint-users" mailing list: +Any questions you don't see answered? Please let us know! You can subscribe and +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 diff --git a/docs/is_IS.UTF-8/INSTALL.txt b/docs/is_IS.UTF-8/INSTALL.txt index 757a7a7d9..f10f1017d 100644 --- a/docs/is_IS.UTF-8/INSTALL.txt +++ b/docs/is_IS.UTF-8/INSTALL.txt @@ -1,936 +1,935 @@ Tux Paint - version 0.9.31 - Installation Documentation + version 0.9.31 + Installation Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - maí 13, 2023 + maí 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Requirements | - | * Simple DirectMedia Layer library (libSDL) | - | * Other Libraries | - | * Compiling and Installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Debugging | - | * Uninstalling Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +----------------------------------------------------+ ++---------------------------------------------------+ +| Table of Contents | +|---------------------------------------------------| +| * Requirements | +| + Simple DirectMedia Layer library (libSDL) | +| + Other Libraries | +| * Compiling and Installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Debugging | +| * Uninstalling Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++---------------------------------------------------+ - Requirements +Requirements Simple DirectMedia Layer library (libSDL) - Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open - Source multimedia programming library available under the GNU Lesser - General Public License (LGPL). +Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open +Source multimedia programming library available under the GNU Lesser General +Public License (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - The SDL libraries are available as source-code, or as RPM or Debian - packages for various distributions of Linux. They can be downloaded from: +The SDL libraries are available as source-code, or as RPM or Debian packages +for various distributions of Linux. They can be downloaded from: - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) - They are also typically available along with your Linux distribution (e.g. - on an installation media, or available via package maintainance software - like Debian's "apt"). +They are also typically available along with your Linux distribution (e.g. on +an installation media, or available via package maintainance software like +Debian's "apt"). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Other Libraries +Other Libraries - Tux Paint also takes advantage of a number of other free, LGPL'd - libraries. Under Linux, just like SDL, they should either already be - installed, or are readily available for installation as part of your Linux - distribution. +Tux Paint also takes advantage of a number of other free, LGPL'd libraries. +Under Linux, just like SDL, they should either already be installed, or are +readily available for installation as part of your Linux distribution. - libPNG +libPNG - Tux Paint uses PNG (Portable Network Graphics) format for its data - files. SDL_image will require libPNG be installed. + Tux Paint uses PNG (Portable Network Graphics) format for its data files. + SDL_image will require libPNG be installed. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint uses your system's locale settings along with the - "gettext" library to support various languages (e.g., Spanish). - You'll need the gettext library installed. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Linux/Unix only) + Tux Paint uses your system's locale settings along with the "gettext" + library to support various languages (e.g., Spanish). You'll need the + gettext library installed. - As of Tux Paint 0.9.17, Tux Paint can determine your system's - default paper size (e.g., A4 or Letter), or can be told to use a - particular paper size, thanks to "libpaper". + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - Tux Paint's "Text" and also "Label" tools support bidirectional - languages, thanks to the "FriBiDi" library. +libpaper (Linux/Unix only) - http://fribidi.org/ + As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper + size (e.g., A4 or Letter), or can be told to use a particular paper size, + thanks to "libpaper". - SVG graphics support + https://github.com/naota/libpaper - As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector - Graphics) images as stamps. Two sets of libraries are supported, - and SVG support can be completely disabled (via "make SVG_LIB:=") - librsvg-2 & libCairo2 (newer libraries) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * These also depend on the following: - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Older SVG libraries - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * These also depend on the following: - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Animated GIF Export feature + Tux Paint's "Text" and also "Label" tools support bidirectional languages, + thanks to the "FriBiDi" library. - To support export of animated GIFs (slideshows), the - "libimagequant" library (from the "pngquant2" project) is - required. + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - NetPBM Tools (optional) No longer used, by default - 📜 Under Linux and Unix, earlier versions of Tux Paint used the - NetPBM tools to assist with printing. (A PNG is generated by Tux - Paint, and converted into a PostScript using the 'pngtopnm' and - 'pnmtops' NetPBM command-line tools.) +SVG graphics support - http://netpbm.sourceforge.net/ + As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics) + images as stamps. Two sets of libraries are supported, and SVG support can + be completely disabled (via "make SVG_LIB:=") - Compiling and Installation + librsvg-2 & libCairo2 (newer libraries) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o These also depend on the following: + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint is released under the GNU General Public License (GPL) (see - "COPYING.txt" for details), and therefore the 'source code' to the program - is available freely. - ------------------------------------------------------------------ + Older SVG libraries + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o These also depend on the following: + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Animated GIF Export feature + + To support export of animated GIFs (slideshows), the "libimagequant" + library (from the "pngquant2" project) is required. + + https://github.com/ImageOptim/libimagequant + + + +NetPBM Tools (optional) No longer used, by default + + 📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools + to assist with printing. (A PNG is generated by Tux Paint, and converted + into a PostScript using the 'pngtopnm' and 'pnmtops' NetPBM command-line + tools.) + + http://netpbm.sourceforge.net/ + + + + +Compiling and Installation + +Tux Paint is released under the GNU General Public License (GPL) (see +"COPYING.txt" for details), and therefore the 'source code' to the program is +available freely. + + ----------------------------------------------------------------------- Windows - júlí 10, 2022 Shin-ichi TOYAMA +júlí 10, 2022 Shin-ichi TOYAMA - Compiling Set-Up +Compiling Set-Up - As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" - includes support for building on a Windows system using MinGW/MSYS - (https://sourceforge.net/projects/msys2/). +As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes +support for building on a Windows system using MinGW/MSYS (https:// +sourceforge.net/projects/msys2/). - Many tools and libraries are required to build Tux Paint. The package - management system "pacman" helps you install them automatically solving - complicated dependencies. +Many tools and libraries are required to build Tux Paint. The package +management system "pacman" helps you install them automatically solving +complicated dependencies. - MYSYS2 +MYSYS2 - Download the latest MSYS2 environment from https://www.msys2.org/ and - install it where you'd like (the default is "C:\msys64") +Download the latest MSYS2 environment from https://www.msys2.org/ and install +it where you'd like (the default is "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Within the MSYS2 shell, run the following command to install basic - development tools: +Within the MSYS2 shell, run the following command to install basic development +tools: - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to - the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build - environment. +Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to the " +MinGW 32bit (i686) toolchains" section if you need only a 32bit build +environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Within the MSYS2 shell, run the following command to install 64bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 64bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to - the "ImageMagick" section if you need only a 64bit build environment. +Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to the " +ImageMagick" section if you need only a 64bit build environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Within the MSYS2 shell, run the following command to install 32bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 32bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick is a compilation of command line tools to create, edit, - compose, or convert bitmap images supporting quite a large number of image - formats. Tux Paint uses two functions ("convert" and "composite") in it to - generate thumbnails for startar images and templates during the build - process. +ImageMagick is a compilation of command line tools to create, edit, compose, or +convert bitmap images supporting quite a large number of image formats. Tux +Paint uses two functions ("convert" and "composite") in it to generate +thumbnails for startar images and templates during the build process. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - Do not forget to enable "Install legacy utilities (e.g. convert)" while - installing it, because Tux Paint's build process uses them. +Do not forget to enable "Install legacy utilities (e.g. convert)" while +installing it, because Tux Paint's build process uses them. - Add the path to the directory in which ImageMagick is installed at the top - of your "PATH" environment variable. For example: +Add the path to the directory in which ImageMagick is installed at the top of +your "PATH" environment variable. For example: - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - You can make this permanent by adding the above to your the BASH shell - configuration file, "~/.bash_profile". +You can make this permanent by adding the above to your the BASH shell +configuration file, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - All the files needed for starting Tux Paint (and Tux Paint Config.) are - collected in the directory for binary distribution "bdist" directory under - "win32". You can start them by double-clicking their executable (.exe) - files in the "bdist" directory. +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup is used to build executable installer for Tux Paint. Therefore - you have to install it in the first place. +All the files needed for starting Tux Paint (and Tux Paint Config.) are +collected in the directory for binary distribution "bdist" directory under +"win32". You can start them by double-clicking their executable (.exe) files in +the "bdist" directory. - Inno Setup officially supports translations for only about 20 languages. - However, one of the great points of Tux Paint is it supports so many - languages. Therefore, the set up script "tuxpaint.iss" to build the - installer is written to use much more translations including unofficial - one which are available on "Inno Setup Translations". You have to download - translation files (.isl) required and put them in "Languages" directory - under the directory in which Inno Setup is installed. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup is used to build executable installer for Tux Paint. Therefore you +have to install it in the first place. - Then, you can easily build an executable installer by right-clicking on - the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" - on the list. It will run for a while, and eventually you will find a - "tuxpaint-X.Y.Z-windows--installer.exe" file in the same directory. +Inno Setup officially supports translations for only about 20 languages. +However, one of the great points of Tux Paint is it supports so many languages. +Therefore, the set up script "tuxpaint.iss" to build the installer is written +to use much more translations including unofficial one which are available on " +Inno Setup Translations". You have to download translation files (.isl) +required and put them in "Languages" directory under the directory in which +Inno Setup is installed. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Double-click the Tux Paint installer executable (.EXE file) and follow the - instructions. +Then, you can easily build an executable installer by right-clicking on the +"tuxpaint.iss" icon in the "win32" directory and selecting "Compile" on the +list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z +-windows--installer.exe" file in the same directory. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - You will then be asked whether you want to install shortcuts to Tux Paint - in your Windows Start Menu and on your Windows Desktop. (Both options are - set by default.) +Double-click the Tux Paint installer executable (.EXE file) and follow the +instructions. - Then you will be asked where you wish to install Tux Paint. The default - should be suitable, as long as there is space available. Otherwise, pick a - different location. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - At this point, you can click 'Install' to install Tux Paint! +You will then be asked whether you want to install shortcuts to Tux Paint in +your Windows Start Menu and on your Windows Desktop. (Both options are set by +default.) - Changing the Settings Using the Shortcut +Then you will be asked where you wish to install Tux Paint. The default should +be suitable, as long as there is space available. Otherwise, pick a different +location. - To change program settings, right-click on the TuxPaint shortcut and - select 'Properties' (at the bottom). +At this point, you can click 'Install' to install Tux Paint! - Make sure the 'Shortcut' tab is selected in the window that appears, and - examine the 'Target:' field. You should see something like this: +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +To change program settings, right-click on the TuxPaint shortcut and select +'Properties' (at the bottom). - You can now add command-line options which will be enabled when you - double-click the icon. +Make sure the 'Shortcut' tab is selected in the window that appears, and +examine the 'Target:' field. You should see something like this: - For example, to make the game run in fullscreen mode, with simple shapes - (no rotation option) and in French, add the options (after - 'TuxPaint.exe'), like so: + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +You can now add command-line options which will be enabled when you +double-click the icon. - (See the main documentation for a full list of available command-line - options.) +For example, to make the game run in fullscreen mode, with simple shapes (no +rotation option) and in French, add the options (after 'TuxPaint.exe'), like +so: - If you make a mistake or it all disappears use [Control] + [Z] to undo or - just hit the [Esc] key and the box will close with no changes made (unless - you pushed the "Apply" button!). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - When you have finished, click "OK." +(See the main documentation for a full list of available command-line options.) - If Something Goes Wrong +If you make a mistake or it all disappears use [Control] + [Z] to undo or just +hit the [Esc] key and the box will close with no changes made (unless you +pushed the "Apply" button!). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +When you have finished, click "OK." - It will contain a description of what was wrong. Usually it will just be - due to incorrect character-case (capital 'Z' instead of lowercase 'z') or - a missing (or extra) '-' (dash). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +It will contain a description of what was wrong. Usually it will just be due to +incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing +(or extra) '-' (dash). + + ----------------------------------------------------------------------- Linux/Unix - Compiling: +Compiling: - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - To compile the program from source, simply run the following command from - a shell prompt (e.g., "$"): +To compile the program from source, simply run the following command from a +shell prompt (e.g., "$"): - $ make + $ make - Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): +Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): - To disable SVG support (e.g., if your system is not currently supported by - the Cairo library or other SVG-related dependencies), you can run "make" - with "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: +To disable SVG support (e.g., if your system is not currently supported by the +Cairo library or other SVG-related dependencies), you can run "make" with +"SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - If you don't have a sound card, or would prefer to build the program with - no sound support (and therefore without a the SDL_mixer dependency), you - can run "make" with "SDL_MIXER_LIB=" added: +If you don't have a sound card, or would prefer to build the program with no +sound support (and therefore without a the SDL_mixer dependency), you can run +"make" with "SDL_MIXER_LIB=" added: - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Various other options (e.g., installation paths) may be overridden; see - them in "Makefile" for further details. +Various other options (e.g., installation paths) may be overridden; see them in +"Makefile" for further details. - If you get errors +If you get errors - If you receive any errors during compile-time, make sure you have the - appropriate libraries installed (see above). If using packaged versions of - the libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to - get the corresponding "-dev" or "-devel" packages as well, otherwise you - won't be able to compile Tux Paint (and other programs) from source! +If you receive any errors during compile-time, make sure you have the +appropriate libraries installed (see above). If using packaged versions of the +libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the +corresponding "-dev" or "-devel" packages as well, otherwise you won't be able +to compile Tux Paint (and other programs) from source! - Installng +Installng - Assuming no fatal errors occured, you can now install the program so that - it can be run by users on the system. By default, this must be done by the - "root" user ('superuser'). Switch to "root" by typing the command: +Assuming no fatal errors occured, you can now install the program so that it +can be run by users on the system. By default, this must be done by the "root" +user ('superuser'). Switch to "root" by typing the command: - $ su + $ su - Enter "root"'s password at the prompt. You should now be "root" (with a - prompt like "#"). To install the program and its data files, type: +Enter "root"'s password at the prompt. You should now be "root" (with a prompt +like "#"). To install the program and its data files, type: - # make install + # make install - Finally, you can switch back to your regular user by exiting superuser - mode: +Finally, you can switch back to your regular user by exiting superuser mode: - # exit + # exit - Alternatively, you may be able to simply use the "sudo" command (e.g., on - Ubuntu Linux): +Alternatively, you may be able to simply use the "sudo" command (e.g., on +Ubuntu Linux): - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Changing Where Things Go +Changing Where Things Go - You can change where things will go by setting "Makefile"variables on the - command line. "DESTDIR" is used to place output in a staging area for - package creation. "PREFIX" is the basis of where all other files go, and - is, by default, set to "/usr/local". +You can change where things will go by setting "Makefile"variables on the +command line. "DESTDIR" is used to place output in a staging area for package +creation. "PREFIX" is the basis of where all other files go, and is, by +default, set to "/usr/local". - Other variables are: +Other variables are: - BIN_PREFIX - Where the "tuxpaint" binary will be installed. (Set to - "$(PREFIX)/bin" by default - e.g., "/usr/local/bin") +BIN_PREFIX + Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by + default - e.g., "/usr/local/bin") - DATA_PREFIX - Where the data files (sound, graphics, brushes, stamps, fonts) - will go, and where Tux Paint will look for them when it's run. - (Set to "$(PREFIX)/share/tuxpaint") +DATA_PREFIX + Where the data files (sound, graphics, brushes, stamps, fonts) will go, and + where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/ + tuxpaint") - DOC_PREFIX - Where the documentation text files (the "docs" directory) will go. - (Set to "$(PREFIX)/share/doc/tuxpaint") +DOC_PREFIX + Where the documentation text files (the "docs" directory) will go. (Set to + "$(PREFIX)/share/doc/tuxpaint") - MAN_PREFIX - Where the manual page for Tux Paint will go. (Set to - "$(PREFIX)/share/man") +MAN_PREFIX + Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man") - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Where the icons and launchers (for GNOME and KDE) will go. - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Where the translation files for Tux Paint will go, and where Tux Paint will + look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a + translation file will be under the locale's directory (e.g., "es" for + Spanish), within the "LC_MESSAGES" subdirectory.) - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Where the icons and launchers (for GNOME and KDE) will go. +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Where the translation files for Tux Paint will go, and where Tux - Paint will look for them. (Set to "$(PREFIX)/share/locale/") - (Final location of a translation file will be under the locale's - directory (e.g., "es" for Spanish), within the "LC_MESSAGES" - subdirectory.) - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - júní 5, 2022 Mark Kim +júní 5, 2022 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prerequisites +Prerequisites - Although Tux Paint is built without the Xcode IDE, Xcode itself is still - required to build Tux Paint. Download it from the App Store, and launch it - once to accept its license agreements. You may also need to install the - Xcode command line tools using the command: +Although Tux Paint is built without the Xcode IDE, Xcode itself is still +required to build Tux Paint. Download it from the App Store, and launch it once +to accept its license agreements. You may also need to install the Xcode +command line tools using the command: - $ xcode-select --install + $ xcode-select --install - Building Tux Paint also requires various libraries. We install them from - MacPorts where possible, source code otherwise. Install MacPorts to the - default /opt/local path according to the instructions found on their - website: https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... but you should install any package that is required by the latest - version of Tux Paint. +Building Tux Paint also requires various libraries. We install them from +MacPorts where possible, source code otherwise. Install MacPorts to the default +/opt/local path according to the instructions found on their website: https:// +www.macports.org/ - ^* Not available from MacPorts as of this writing, see below. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... but you should install any package that is required by the latest version +of Tux Paint. - libimagequant is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. +^* Not available from MacPorts as of this writing, see below. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - WARNING: Having any UNIX-like toolset installed on your Mac besides - MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle - from being portable. Be sure Fink and Brew are not accessible from your - build environment. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - How to Build + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Simply, run: +WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts +and Xcode, such as Fink or Brew, will prevent your app bundle from being +portable. Be sure Fink and Brew are not accessible from your build environment. - % make - % make install +How to Build - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Simply, run: - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Known Issues +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * A macOS binary built on a specific version of macOS only runs on that - version of macOS or later. To ensure Tux Paint can run on the oldest - version of macOS possible, build it on the oldest version of macOS - available. As of this writing we know Tux Paint cannot be built to run - on macOS 10.7 or earlier. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - See "Old Versions of macOS" below for best-effort instructions on how - to obtain, install, and build Tux Paint on an old version of macOS. +Known Issues - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * A macOS binary built on a specific version of macOS only runs on that + version of macOS or later. To ensure Tux Paint can run on the oldest + version of macOS possible, build it on the oldest version of macOS + available. As of this writing we know Tux Paint cannot be built to run on + macOS 10.7 or earlier. - Old Versions of macOS + See "Old Versions of macOS" below for best-effort instructions on how to + obtain, install, and build Tux Paint on an old version of macOS. - Some old versions of macOS can be downloaded from Apple's support page: - https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Old Versions of macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Some old versions of macOS can be downloaded from Apple's support page: https:/ +/support.apple.com/en-us/HT211683 - As of this writing, the oldest version of macOS available on Apple's - support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" - partitioning scheme instead of the older MBR scheme, and "Mac OS Extended - (Journaled)" as the partition type instead of the newer APFS partition - type. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Upon launching the installer, if you get a popup about macOS being too old - or new to be installed, a bootable installer can be created using the - instructions found here: https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Once the old macOS is installed, you may find the Xcode on the App Store - is too new to run on the version of the old macOS. Old versions of Xcode - can be downloaded from Apple's Developer site in an area accessible with - free registration: https://developer.apple.com/download/more/ +As of this writing, the oldest version of macOS available on Apple's support +site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning +scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as +the partition type instead of the newer APFS partition type. - The list of macOS versions and the last version of Xcode compatible with - them are laid out nicely on the Wikipedia page on Xcode: - https://en.wikipedia.org/wiki/Xcode#Version_comparison_table +Upon launching the installer, if you get a popup about macOS being too old or +new to be installed, a bootable installer can be created using the instructions +found here: https://support.apple.com/en-mide/HT201372 - And because Xcode is being installed manually, you can skip the step to - install the Xcode command line tools (do not run "xcode-select --install") - but otherwise build Tux Paint using the same steps described in the - earlier part of this document. +Once the old macOS is installed, you may find the Xcode on the App Store is too +new to run on the version of the old macOS. Old versions of Xcode can be +downloaded from Apple's Developer site in an area accessible with free +registration: https://developer.apple.com/download/more/ - Recompiling MacPorts +The list of macOS versions and the last version of Xcode compatible with them +are laid out nicely on the Wikipedia page on Xcode: https://en.wikipedia.org/ +wiki/Xcode#Version_comparison_table - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +And because Xcode is being installed manually, you can skip the step to install +the Xcode command line tools (do not run "xcode-select --install") but +otherwise build Tux Paint using the same steps described in the earlier part of +this document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - mars 29, 2023 Pere Pujal i Carabantes (Edited by - Bill Kendrick) +mars 29, 2023 Pere Pujal i Carabantes (Edited by Bill +Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prerequisites +Prerequisites - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - maí 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) +maí 7, 2023 Luc Schrijvers (Edited by Bill Kendrick) - Prerequisites +Prerequisites - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Debugging +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file - on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled - by setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines - in "src/debug.h" and (re)compiling Tux Paint. +Debugging - Uninstalling Tux Paint +⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file on +Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled by +setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src +/debug.h" and (re)compiling Tux Paint. + +Uninstalling Tux Paint Windows - Using the Uninstaller +Using the Uninstaller - If you installed the Start Menu shortcuts (the default), then go to the - TuxPaint folder and select "Uninstall". A box will be displayed that will - confirm that you are about to uninstall Tux Paint and, if you are certain - that you want to permanently remove Tux Paint, click on the 'Uninstall' - button. +If you installed the Start Menu shortcuts (the default), then go to the +TuxPaint folder and select "Uninstall". A box will be displayed that will +confirm that you are about to uninstall Tux Paint and, if you are certain that +you want to permanently remove Tux Paint, click on the 'Uninstall' button. - When it has finished, click on the close button. +When it has finished, click on the close button. - Using the Control Panel +Using the Control Panel - It is also possible to use the entry "TuxPaint (remove only)" in the - Control Panel Add/Remove programs section. +It is also possible to use the entry "TuxPaint (remove only)" in the Control +Panel Add/Remove programs section. macOS - Delete "TuxPaint.app" from the "Applications" folder. Data files, - including the configuration files, stamps, and saved pictures, may be - found in "/Library/Application Support/TuxPaint" (all users) and - "/Users/USERNAME/Library/Application Support/TuxPaint" (individual users). +Delete "TuxPaint.app" from the "Applications" folder. Data files, including the +configuration files, stamps, and saved pictures, may be found in "/Library/ +Application Support/TuxPaint" (all users) and "/Users/USERNAME/Library/ +Application Support/TuxPaint" (individual users). Linux - Within the Tux Paint source directory (where you compiled Tux Paint), you - can use the "make uninstall" target to uninstall Tux Paint. By default, - this must be done by the "root" user ('superuser'), but if you installed - Tux Paint somewhere else (e.g., using a "PREFIX=..." setting to "make" and - "make install"), you may not, and will want to provide those same settings - here. (See the installation instructions above for further information.) +Within the Tux Paint source directory (where you compiled Tux Paint), you can +use the "make uninstall" target to uninstall Tux Paint. By default, this must +be done by the "root" user ('superuser'), but if you installed Tux Paint +somewhere else (e.g., using a "PREFIX=..." setting to "make" and "make +install"), you may not, and will want to provide those same settings here. (See +the installation instructions above for further information.) + diff --git a/docs/is_IS.UTF-8/MAGIC-API.txt b/docs/is_IS.UTF-8/MAGIC-API.txt index b5094dbde..f27d58e77 100644 --- a/docs/is_IS.UTF-8/MAGIC-API.txt +++ b/docs/is_IS.UTF-8/MAGIC-API.txt @@ -1,1274 +1,1279 @@ Tux Paint útgáfa 0.9.31 -Magic Tool Plugin API Documentation + Magic Tool Plugin API Documentation - Höfundarréttur © 2007-2023 eftir various contributors; sjá AUTHORS-skrá. + Höfundarréttur © 2007-2023 eftir various contributors; sjá AUTHORS-skrá. https://tuxpaint.org/ - 13. apríl 2023 + 13. apríl 2023 - +----------------------------------------------------+ - |Efnisyfirlit | - |----------------------------------------------------| - | * Forkröfur | - | * Interfaces | - | * 'Magic' tool plugin functions | - | * Common arguments to plugin functions | - | * Required Plugin Functions | - | * Plugin "housekeeping" functions | - | * Plugin event functions | - | * Tux Paint Functions and Data | - | * Pixel Manipulations | - | * Helper Functions | - | * Til upplýsingar | - | * Tux Paint System Calls | - | * Color Conversions | - | * Helper Macros in "tp_magic_api.h" | - | * Constant Definitions in "tp_magic_api.h" | - | * Compiling | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Installing | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Creating plugins with multiple effects | - | * Example Code | - | * Til að fá hjálp | - | * Orðasafn | - +----------------------------------------------------+ ++--------------------------------------------------+ +| Efnisyfirlit | +|--------------------------------------------------| +| * Forkröfur | +| * Interfaces | +| + 'Magic' tool plugin functions | +| o Common arguments to plugin functions | +| o Required Plugin Functions | +| # Plugin "housekeeping" functions | +| # Plugin event functions | +| + Tux Paint Functions and Data | +| o Pixel Manipulations | +| o Helper Functions | +| o Til upplýsingar | +| o Tux Paint System Calls | +| o Color Conversions | +| + Helper Macros in "tp_magic_api.h" | +| + Constant Definitions in "tp_magic_api.h" | +| * Compiling | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Installing | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Creating plugins with multiple effects | +| * Example Code | +| * Til að fá hjálp | +| * Orðasafn | ++--------------------------------------------------+ - Yfirlit +Yfirlit - Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted - from routines that lived within the application itself, to a set of - 'plugins' that are loaded when Tux Paint starts up. +Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted from +routines that lived within the application itself, to a set of 'plugins' that +are loaded when Tux Paint starts up. - This division allows more rapid development of 'Magic' tools, and allows - programmers to create and test new tools without needing to integrate them - within the main Tux Paint source code. (Users of more professional - graphics tools, such as GIMP, should be familiar with this plugin - concept.) +This division allows more rapid development of 'Magic' tools, and allows +programmers to create and test new tools without needing to integrate them +within the main Tux Paint source code. (Users of more professional graphics +tools, such as GIMP, should be familiar with this plugin concept.) - Prerequisites +Prerequisites - Tux Paint is written in the C programming language, and uses the Simple - DirectMedia Layer library ('libSDL', or simply 'SDL'; available from - https://www.libsdl.org/). Therefore, for the moment at least, one must - understand the C language and how to compile C-based programs. Familiarity - with the SDL API is highly recommended, but some basic SDL concepts will - be covered in this document. +Tux Paint is written in the C programming language, and uses the Simple +DirectMedia Layer library ('libSDL', or simply 'SDL'; available from https:// +www.libsdl.org/). Therefore, for the moment at least, one must understand the C +language and how to compile C-based programs. Familiarity with the SDL API is +highly recommended, but some basic SDL concepts will be covered in this +document. - Interfaces +Interfaces - Those who create 'Magic' tool plugins for Tux Paint must provide some - interfaces (C functions) that Tux Paint may invoke. +Those who create 'Magic' tool plugins for Tux Paint must provide some +interfaces (C functions) that Tux Paint may invoke. - Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" - routines to load plugins (shared objects files; e.g., ".so" files on Linux - or ".dll" files on Windows) and find the functions within. +Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" routines +to load plugins (shared objects files; e.g., ".so" files on Linux or ".dll" +files on Windows) and find the functions within. - In turn, Tux Paint provides a number of helper functions that the plugin - may (or sometimes is required to) use. This is exposed as a C structure - (or "struct") which contains pointers to functions and other data inside - Tux Paint. A pointer to this structure gets passed along to the plugin's - functions as an argument when Tux Paint invokes them. +In turn, Tux Paint provides a number of helper functions that the plugin may +(or sometimes is required to) use. This is exposed as a C structure (or +"struct") which contains pointers to functions and other data inside Tux Paint. +A pointer to this structure gets passed along to the plugin's functions as an +argument when Tux Paint invokes them. - Plugins should #include the C header file "tp_magic_api.h", which exposes - the 'Magic' tool plugin API. Also, when you run the C compiler to build a - plugin, you should use the command-line tool "tp-magic-config" to get the - appropriate compiler flags (such as where the compiler can find the Tux - Paint plugin header file, as well as SDL's header files) for building a - plugin. (See "Compiling", below.) +Plugins should #include the C header file "tp_magic_api.h", which exposes the +'Magic' tool plugin API. Also, when you run the C compiler to build a plugin, +you should use the command-line tool "tp-magic-config" to get the appropriate +compiler flags (such as where the compiler can find the Tux Paint plugin header +file, as well as SDL's header files) for building a plugin. (See "Compiling", +below.) - The C header file and command-line tool mentioned above are included with - Tux Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package". +The C header file and command-line tool mentioned above are included with Tux +Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin +Development package". 'Magic' tool plugin functions - 'Magic' tool plugins must contain the functions listed below. Note: To - avoid 'namespace' collisions, each function's name must start with the - shared object's filename (e.g., "blur.so" or "blur.dll" would have - functions whose names begin with "blur_"). This includes private functions - (ones not used by Tux Paint directly), unless you declare those as - 'static'. - - Common arguments to plugin functions - - Here is a description of arguments that many of your plugin's functions - will need to accept. - - magic_api * api - - Pointer to a C structure containing pointers to Tux Paint - functions and other data that the plugin can (and sometimes - should) use. The contents of this struct are described below. - - Note: The magic_api struct is defined in the C header file - "tp_magic_api.h", which you should include at the top of your - plugin's C source file: - - #include "tp_magic_api.h" - - int which - An index the plugin should use to differentiate different 'Magic' - tools, if the plugin provides more than one. (If not, "which" will - always be 0.) See "Creating plugins with multiple effects", below. +'Magic' tool plugins must contain the functions listed below. Note: To avoid +'namespace' collisions, each function's name must start with the shared +object's filename (e.g., "blur.so" or "blur.dll" would have functions whose +names begin with "blur_"). This includes private functions (ones not used by +Tux Paint directly), unless you declare those as 'static'. - SDL_Surface * snapshot - A snapshot of the previous Tux Paint canvas, taken when the the - mouse was first clicked to activate the current magic tool. If you - don't continuously affect the image during one hold of the mouse - button, you should base your effects off the contents of this - canvas. (That is, read from "snapshot" and write to "canvas", - below.) - - SDL_Surface * canvas - The current Tux Paint drawing canvas. Your magical effects should - end up here! - - SDL_Rect * update_rect - A pointer to an SDL 'rectangle' structure that you use to tell Tux - Paint what part of the canvas has been updated. If your effect - affects a 32x32 area centered around the mouse pointer, you would - fill the SDL_Rect as follows: - - update_rect->x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Til upplýsingar + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Til upplýsingar - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Til að fá hjálp +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Til að fá hjálp - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Orðasafn +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Orðasafn + + * alfa: See "RGBA" + * &: See "'og' merki" + * 'og' merki (bendlar): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * 'og' merki (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bitar" + * API: Application Programming Interface. TBD + * viðfang: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * bakslag: See "grave" + * bitar: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "bæti" + * blátt: See "RGBA" + * boole gildið 'eða': A mathematical operation that results in a true value + if either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". + "0 | 0" results in "0".) + * |: See "boole gildið 'eða'" + * .: See "punktur" + * `: See "grave" + * *: See "star" + * bæti: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * svörun: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * rás: TBD + * smellur: The action of pressing a button on a mouse. + * hnit: A set of numbers corresponding to a physical position; for example, + in a two-dimensional (2D) image, "X" and "Y" coordinates specify the + position across (left-to-right) and down the image, respectively. In SDL, + the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * stærðir: The size of an object, in terms of its width (left to right) and + height (top to bottom). + * .dll: See "Shared Object" + * punktur: ".". A symbol in C that references an element within a struct. + * draga: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "fleytitala" + * fleytitala: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * grænt: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * haus: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * litblær: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * línulegt: TBD + * fjölvi: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Viðbót: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * frumgerð: See "C function prototype" + * rautt: See "RGBA" + * sleppa: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "'og' merki" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * óundirritað: In C, a variable that can store a numeric value can be + declared as either "signed" (the default), or "unsigned". In the former + case, one bit of the value is used to denote the sign of the value (either + positive or negative). In the latter case, the value can only be positive, + but benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * gildi: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Stærðir" + * (x,y): See "Hnit" - * alfa: See "RGBA" - * &: See "'og' merki" - * 'og' merki (bendlar): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * 'og' merki (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bitar" - * API: Application Programming Interface. TBD - * viðfang: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * bakslag: See "grave" - * bitar: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "bæti" - * blátt: See "RGBA" - * boole gildið 'eða': A mathematical operation that results in a true - value if either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all - result in "1". "0 | 0" results in "0".) - * |: See "boole gildið 'eða'" - * .: See "punktur" - * `: See "grave" - * *: See "star" - * bæti: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * svörun: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * rás: TBD - * smellur: The action of pressing a button on a mouse. - * hnit: A set of numbers corresponding to a physical position; for - example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * stærðir: The size of an object, in terms of its width (left to right) - and height (top to bottom). - * .dll: See "Shared Object" - * punktur: ".". A symbol in C that references an element within a - struct. - * draga: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "fleytitala" - * fleytitala: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * grænt: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * haus: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * litblær: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * línulegt: TBD - * fjölvi: A C construct that looks similar to a C function, but is - simply a #define that is expanded 'inline'. For example, if you - declared the macro "#define ADD(A,B) ((A)+(B))", and then used it with - "c = ADD(1,2);", that line of code would literally expand to "c = ((1) - + (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Viðbót: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * frumgerð: See "C function prototype" - * rautt: See "RGBA" - * sleppa: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "'og' merki" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * óundirritað: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * gildi: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Stærðir" - * (x,y): See "Hnit" diff --git a/docs/is_IS.UTF-8/OPTIONS.txt b/docs/is_IS.UTF-8/OPTIONS.txt index d6b2d3603..cc3c027d4 100644 --- a/docs/is_IS.UTF-8/OPTIONS.txt +++ b/docs/is_IS.UTF-8/OPTIONS.txt @@ -1,2011 +1,2183 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Options Documentation + Options Documentation Copyright © 2002-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ júlí 13, 2023 - +---------------------------------------------+ - |Table of Contents | - |---------------------------------------------| - | * Tux Paint Config. | - | * Configuration File | - | * Available Options | - | * Video/Sound | - | * Mouse/Keyboard | - | * Simplification | - | * Languages | - | * Printing | - | * Saving | - | * Data | - | * Accessibility | - | * Joystick | - | * Overriding System Config. Options | - | * Command-Line Options | - | * Command-Line Informational Options | - | * Choosing a Different Language | - | * Available Languages | - | * Setting Your Environment's Locale | - | * Special Fonts | - +---------------------------------------------+ ++--------------------------------------------+ +| Table of Contents | +|--------------------------------------------| +| * Tux Paint Config. | +| * Configuration File | +| * Available Options | +| + Video/Sound | +| + Mouse/Keyboard | +| + Simplification | +| + Languages | +| + Printing | +| + Saving | +| + Data | +| + Accessibility | +| + Joystick | +| * Overriding System Config. Options | +| * Command-Line Options | +| + Command-Line Informational Options | +| * Choosing a Different Language | +| + Available Languages | +| + Setting Your Environment's Locale | +| + Special Fonts | ++--------------------------------------------+ - Tux Paint Config. +Tux Paint Config. - A graphical tool is available that allows you to change Tux Paint's - behavior. However, if you'd rather not install and use this tool, or want - a better understanding of the available options, please continue reading. +A graphical tool is available that allows you to change Tux Paint's behavior. +However, if you'd rather not install and use this tool, or want a better +understanding of the available options, please continue reading. - Configuration File +Configuration File - You can create a simple configuration file for Tux Paint, which it will - read each time you start it up. +You can create a simple configuration file for Tux Paint, which it will read +each time you start it up. - The file is simply a plain text file containing the options you want - enabled: +The file is simply a plain text file containing the options you want enabled: Linux and Unix Users - The file you should create is called ".tuxpaintrc" and it should be placed - in your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") +The file you should create is called ".tuxpaintrc" and it should be placed in +your home directory. (a.k.a. "~/.tuxpaintrc" or "$HOME/.tuxpaintrc") - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf macOS Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in your home folder, under the sub-folder: Library/Application - Support/TuxPaint +The file you should create is called "tuxpaint.cfg" and it should be placed in +your home folder, under the sub-folder: Library/Application Support/TuxPaint - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Windows Users - The file you should create is called "tuxpaint.cfg" and it should be - placed in in your personal AppData folder: - C:\Users\username\AppData\Roaming\TuxPaint\ +The file you should create is called "tuxpaint.cfg" and it should be placed in +in your personal AppData folder: C:\Users\username\AppData\Roaming\TuxPaint\ - You can use NotePad or WordPad to create this file. Be sure to save it as - Plain Text, and make sure the filename doesn't have ".txt" at the end... +You can use NotePad or WordPad to create this file. Be sure to save it as Plain +Text, and make sure the filename doesn't have ".txt" at the end... - System-Wide Configuration File +System-Wide Configuration File - Before this file is read, a system-wide configuration file is read. (By - default, this configuration has no settings enabled.) It is normally - located at: +Before this file is read, a system-wide configuration file is read. (By +default, this configuration has no settings enabled.) It is normally located +at: - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ You can disable reading of this file altogether, leaving the settings as - defaults (which can then be overridden by your personal config. file - and/or command-line arguments) by using the command-line option - "--nosysconfig". +⚙ You can disable reading of this file altogether, leaving the settings as +defaults (which can then be overridden by your personal config. file and/or +command-line arguments) by using the command-line option "--nosysconfig". - Available Options +Available Options - The following settings can be set in the configuration file. (Command-line - settings will override these. See the "Command-Line Options" section, - below.) +The following settings can be set in the configuration file. (Command-line +settings will override these. See the "Command-Line Options" section, below.) Video/Sound - Video +Video - fullscreen=yes +fullscreen=yes - Run the program in full screen mode, rather than in a window. + Run the program in full screen mode, rather than in a window. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "fullscreen=no". - In both cases, may be overridden by the command-line option - "--windowed". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "fullscreen=no". In both cases, may be + overridden by the command-line option "--windowed". - fullscreen=native - Run the program in full screen mode. Additionally, assume the - screen's current resolution (set by the operating system). - windowsize=SIZE +fullscreen=native - Run the program at a different size (in windowed mode) or at a - different screen resolution (in fullscreen mode), rather than the - default (usually 800x600). + Run the program in full screen mode. Additionally, assume the screen's + current resolution (set by the operating system). - The SIZE value should be presented in pixels, in 'width-by-height' - format, with an "x" (lowercase X) between the values. The size can - be anything that's at least 640 wide, and at least 480 tall. - Some examples: - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=SIZE - 💡 If only one display is available, and Tux Paint is being run in - windowed (not fullscreen) mode, and the chosen window size exceeds - the capabilities of the display, Tux Paint will fall back to the - display's dimensions. + Run the program at a different size (in windowed mode) or at a different + screen resolution (in fullscreen mode), rather than the default (usually + 800x600). - orient=portrait + The SIZE value should be presented in pixels, in 'width-by-height' format, + with an "x" (lowercase X) between the values. The size can be anything + that's at least 640 wide, and at least 480 tall. - Swaps the width/height options given to Tux Paint, useful for - rotating the window on portait displays, such as a tablet PC - that's in tablet orientation. + Some examples: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "orient=landscape". In both cases, may be overridden by the - command-line option "--orient=landscape". + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 If only one display is available, and Tux Paint is being run in windowed + (not fullscreen) mode, and the chosen window size exceeds the capabilities + of the display, Tux Paint will fall back to the display's dimensions. - When running Tux Paint in fullscreen mode, this assumes the - screen's current resolution (overriding any "windowsize" option), - as set by the operating system. - allowscreensaver=yes - By default, Tux Paint prevents your system's screensaver from - starting up. You can override this by using the "allowscreensaver" - option. Note: This requires version 1.2.12 or higher of the SDL - library. (You can also do this by setting the - "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your system - to "1".) +orient=portrait - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "allowscreensaver=no" or "disablescreensaver=yes". In both cases, - may be overridden by the command-line option - "--disablescreensaver". + Swaps the width/height options given to Tux Paint, useful for rotating the + window on portait displays, such as a tablet PC that's in tablet + orientation. - Sound + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "orient=landscape". In both cases, may + be overridden by the command-line option "--orient=landscape". - nosound=yes - Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used - to reenable sounds if they were disabled using this option.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosound=no" or - "sound=yes". In both cases, may be overridden by the command-line - option "--sound". +native=yes - nostereo=yes + When running Tux Paint in fullscreen mode, this assumes the screen's + current resolution (overriding any "windowsize" option), as set by the + operating system. - Disable stereo panning support. (Useful for users with hearing - impairment in one ear, or places where a single speaker or - headphone is being used.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostereo=no" or - "stereo=yes". In both cases, may be overridden by the command-line - option "--stereo". - Interface Size +allowscreensaver=yes - buttonsize=SIZE + By default, Tux Paint prevents your system's screensaver from starting up. + You can override this by using the "allowscreensaver" option. Note: This + requires version 1.2.12 or higher of the SDL library. (You can also do this + by setting the "SDL_VIDEO_ALLOW_SCREENSAVER" environment variable on your + system to "1".) - Set the pixel size of buttons in Tux Paint's user interface - (overriding the default of "48"). Useful when using very - high-density displays or coarse input devices, such as eye gaze - trackers. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "allowscreensaver=no" or + "disablescreensaver=yes". In both cases, may be overridden by the + command-line option "--disablescreensaver". - The SIZE value should be presented in pixels, and can be anything - between 24 and 192, inclusive. Most buttons are square, and this - will affect their width and height. - A value of "auto" may be provided, and Tux Paint will choose a - suitable button size based on the size of Tux Paint's window (or - fullscreen display). (For the default screen size of 800x600, it - will be the default button size: "48".) - 💡 Note: If the chosen button size would cause the buttons to be - too large for all required UI elements to appear under Tux Paint's - chosen window size, the largest possible button size will be used. - (A note will appear in stderr.) - colorsrows=ROWS +Sound + +nosound=yes + + Disable sound effects. (Note: Pressing [Alt] + [S] cannot be used to + reenable sounds if they were disabled using this option.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nosound=no" or "sound=yes". In both + cases, may be overridden by the command-line option "--sound". + + + +nostereo=yes + + Disable stereo panning support. (Useful for users with hearing impairment + in one ear, or places where a single speaker or headphone is being used.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostereo=no" or "stereo=yes". In both + cases, may be overridden by the command-line option "--stereo". + + + + +Interface Size + +buttonsize=SIZE + + Set the pixel size of buttons in Tux Paint's user interface (overriding the + default of "48"). Useful when using very high-density displays or coarse + input devices, such as eye gaze trackers. + + The SIZE value should be presented in pixels, and can be anything between + 24 and 192, inclusive. Most buttons are square, and this will affect their + width and height. + + A value of "auto" may be provided, and Tux Paint will choose a suitable + button size based on the size of Tux Paint's window (or fullscreen + display). (For the default screen size of 800x600, it will be the default + button size: "48".) + + 💡 Note: If the chosen button size would cause the buttons to be too large + for all required UI elements to appear under Tux Paint's chosen window + size, the largest possible button size will be used. (A note will appear in + stderr.) + + + +colorsrows=ROWS + + How many rows of color palette buttons to show; useful when using a large + color palette (see "colorfile", above), and/or for use with coarse input + devices (like eyegaze trackers). "ROWS" may be between "1" (the default) + and "3". + + - How many rows of color palette buttons to show; useful when using - a large color palette (see "colorfile", above), and/or for use - with coarse input devices (like eyegaze trackers). "ROWS" may be - between "1" (the default) and "3". Mouse/Keyboard - Cursor +Cursor - nofancycursors=yes +nofancycursors=yes - This disables the fancy mouse pointer shapes in Tux Paint, and - uses your environment's normal mouse pointer. + This disables the fancy mouse pointer shapes in Tux Paint, and uses your + environment's normal mouse pointer. - In some enviornments, the fancy cursors cause problems. Use this - option to avoid them. + In some enviornments, the fancy cursors cause problems. Use this option to + avoid them. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nofancycursors=no" or "fancycursors=yes". In both cases, may be - overridden by the command-line option "--fancycursors". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nofancycursors=no" or "fancycursors= + yes". In both cases, may be overridden by the command-line option + "--fancycursors". - hidecursor=yes - This completely hides the mouse pointer shapes in Tux Paint. - This is useful for touchscreen devices, such as tablet PCs. +hidecursor=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "hidecursor=no" - or "showcursor=yes". In both cases, may be overridden by the - command-line option "--showcursor". + This completely hides the mouse pointer shapes in Tux Paint. - Keyboard + This is useful for touchscreen devices, such as tablet PCs. - noshortcuts=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "hidecursor=no" or "showcursor=yes". In + both cases, may be overridden by the command-line option "--showcursor". - This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, - [Ctrl]-[N] for a new image, etc.) - This is useful to prevent unwanted commands from being activated - by children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noshortcuts=no" - or "shortcuts=yes". In both cases, may be overridden by the - command-line option "--shortcuts". - Mouse +Keyboard - grab=yes +noshortcuts=yes - Tux Paint will attempt to 'grab' the mouse and keyboard, so that - the mouse is confined to Tux Paint's window, and nearly all - keyboard input is passed directly to it. + This disable keyboard shortcuts (e.g., [Ctrl]-[S] for save, [Ctrl]-[N] for + a new image, etc.) - This is useful to disable operating system actions that could get - the user out of Tux Paint [Alt]-[Tab] window cycling, - [Ctrl]-[Escape], etc. This is especially useful in fullscreen - mode. + This is useful to prevent unwanted commands from being activated by + children who aren't experienced with keyboards. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "grab=no" or - "dontgrab=yes". In both cases, may be overridden by the - command-line option "--dontgrab". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshortcuts=no" or "shortcuts=yes". In + both cases, may be overridden by the command-line option "--shortcuts". - nowheelmouse=yes - This disables support for the wheel on mice that have it. - (Normally, the wheel will scroll the selector menu on the right.) - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nowheelmouse=no" or "wheelmouse=yes". In both cases, may be - overridden by the command-line option "--wheelmouse". - nobuttondistinction=yes +Mouse + +grab=yes + + Tux Paint will attempt to 'grab' the mouse and keyboard, so that the mouse + is confined to Tux Paint's window, and nearly all keyboard input is passed + directly to it. + + This is useful to disable operating system actions that could get the user + out of Tux Paint [Alt]-[Tab] window cycling, [Ctrl]-[Escape], etc. This is + especially useful in fullscreen mode. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "grab=no" or "dontgrab=yes". In both + cases, may be overridden by the command-line option "--dontgrab". + + + +nowheelmouse=yes + + This disables support for the wheel on mice that have it. (Normally, the + wheel will scroll the selector menu on the right.) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nowheelmouse=no" or "wheelmouse=yes". + In both cases, may be overridden by the command-line option "--wheelmouse". + + + +nobuttondistinction=yes + + Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse could + also be used for clicking. In version 0.9.15, it was changed so that only + the left mouse button worked, so as to not train children to use the wrong + button. + + However, for children who have trouble with the mouse, this distinction + between the two or three buttons on a mouse can be disabled (returning Tux + Paint to its old behavior) by using this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobuttondistinction=no" or + "buttondistinction=yes". In both cases, may be overridden by the + command-line option "--buttondistinction". - Prior to Tux Paint 0.9.15, the middle and right buttons on a mouse - could also be used for clicking. In version 0.9.15, it was changed - so that only the left mouse button worked, so as to not train - children to use the wrong button. - However, for children who have trouble with the mouse, this - distinction between the two or three buttons on a mouse can be - disabled (returning Tux Paint to its old behavior) by using this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobuttondistinction=no" or "buttondistinction=yes". In both - cases, may be overridden by the command-line option - "--buttondistinction". Simplification - Interface Simplification +Interface Simplification - simpleshapes=yes +simpleshapes=yes - Disable the rotation step of the 'Shape' tool. Click, drag and - release is all that will be needed to draw a shape. + Disable the rotation step of the 'Shape' tool. Click, drag and release is + all that will be needed to draw a shape. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "simpleshapes=no" or "complexshapes=yes". In both cases, may be - overridden by the command-line option "--complexshapes". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "simpleshapes=no" or "complexshapes= + yes". In both cases, may be overridden by the command-line option + "--complexshapes". - nooutlines=yes - In this mode, much simpler outlines and 'rubber-band' lines are - displayed when using the Lines, Shapes, Stamps and Eraser tools. - This can help when Tux Paint is run on very slow computers, or - displayed on a remote X-Window display. +nooutlines=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nooutlines=no" - or "outlines=yes". In both cases, may be overridden by the - command-line option "--outlines". + In this mode, much simpler outlines and 'rubber-band' lines are displayed + when using the Lines, Shapes, Stamps and Eraser tools. - uppercase=yes + This can help when Tux Paint is run on very slow computers, or displayed on + a remote X-Window display. - All text will be rendered only in uppercase (e.g., "Brush" will be - "BRUSH"). Useful for children who can read, but who have only - learned uppercase letters so far. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nooutlines=no" or "outlines=yes". In + both cases, may be overridden by the command-line option "--outlines". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "uppercase=no" - or "mixedcase=yes". In both cases, may be overridden by the - command-line option "--mixedcase". - Initial Stamp Size - stampsize=SIZE +uppercase=yes - Use this option to force Tux Paint to set the starting size of all - stamps. The SIZE value should be between 0 (smallest) and 10 - (largest). The size is relative to the available sizes of the - stamp, which depends on the stamp itself, and Tux Paint's current - canvas size. + All text will be rendered only in uppercase (e.g., "Brush" will be + "BRUSH"). Useful for children who can read, but who have only learned + uppercase letters so far. - Specify "default" to let Tux Paint decide (its standard behavior). + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "uppercase=no" or "mixedcase=yes". In + both cases, may be overridden by the command-line option "--mixedcase". - Control Simplification - noquit=yes - Disable the on-screen "Quit" button and prevent the [Escape] key - from quitting Tux Paint. - Using the [Alt] + [F4] keyboard combination or clicking the - window's close button (assuming you're not in fullscreen mode) - still works to quit Tux Paint. +Initial Stamp Size - You can also use the following keyboard combination to quit: - [Shift] + [Control] + [Escape]. +stampsize=SIZE - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noquit=no" or - "quit=yes". In both cases, may be overridden by the command-line - option "--quit". + Use this option to force Tux Paint to set the starting size of all stamps. + The SIZE value should be between 0 (smallest) and 10 (largest). The size is + relative to the available sizes of the stamp, which depends on the stamp + itself, and Tux Paint's current canvas size. - nostamps=yes + Specify "default" to let Tux Paint decide (its standard behavior). - This option tells Tux Paint to not load any rubber stamp images, - which in turn ends up disabling the Stamps tool. - This can speed up Tux Paint when it first loads up, and reduce - memory usage while it's running. Of course, no stamps will be - available at all. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nostamps=no" or - "stamps=yes". In both cases, may be overridden by the command-line - option "--stamps". - nostampcontrols=yes +Control Simplification - Some images in the Stamps tool can be mirrored, flipped, and/or - have their size changed. This option disables the controls, and - only provides the basic stamps. +noquit=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostampcontrols=no" or "stampcontrols=yes". In both cases, may be - overridden by the command-line option "--stampcontrols". + Disable the on-screen "Quit" button and prevent the [Escape] key from + quitting Tux Paint. - nostamprotation=yes + Using the [Alt] + [F4] keyboard combination or clicking the window's close + button (assuming you're not in fullscreen mode) still works to quit Tux + Paint. - This disables the rotation step of the Stamps tool, immediately - placing the stamp in its regular orientation (with any flipping or - mirroring applied) on the first click. + You can also use the following keyboard combination to quit: [Shift] + + [Control] + [Escape]. - 📜 Note: The stamp rotation feature was added to Tux Paint in - version 0.9.29. + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noquit=no" or "quit=yes". In both + cases, may be overridden by the command-line option "--quit". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nostamprotation=no" or "stamprotation=yes". In both cases, may be - overridden by the command-line option "--stamprotation". - nomagiccontrols=yes - Some Magic tools have the option of acting like a paintbrush, or - affecting the entire canvas at once. This option disables the - controls, and only provides the default functionality (usually - paint-mode). +nostamps=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagiccontrols=no" or "magiccontrols=yes". In both cases, may be - overridden by the command-line option "--magiccontrols". + This option tells Tux Paint to not load any rubber stamp images, which in + turn ends up disabling the Stamps tool. - nomagicsizes=yes + This can speed up Tux Paint when it first loads up, and reduce memory usage + while it's running. Of course, no stamps will be available at all. - Some Magic tools offer various size settings. This option disables - the sizing control, and only provides the tools' default sizes. - (Some plugins may offer additional variations of a Magic tool, to - make a few sizes possible, e.g. "Bricks" and "Googly Eyes".) + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamps=no" or "stamps=yes". In both + cases, may be overridden by the command-line option "--stamps". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nomagicsizes=no" or "magicsizes=yes". In both cases, may be - overridden by the command-line option "--magicsizes". - noshapecontrols=yes - Disable the control buttons shown when using the Shapes tool that - allow changing how shapes are drawn — centered around the initial - mouse click, or with a corner at the initial mouse click. +nostampcontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "noshapecontrols=no" or "shapecontrols=yes". In both cases, may be - overridden by the command-line option "--shapecontrols". + Some images in the Stamps tool can be mirrored, flipped, and/or have their + size changed. This option disables the controls, and only provides the + basic stamps. - nolabel=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostampcontrols=no" or "stampcontrols= + yes". In both cases, may be overridden by the command-line option + "--stampcontrols". - Disables the Label tool: the tool that allows text entry which can - be edited later. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nolabel=no" or - "label=yes". In both cases, may be overridden by the command-line - option "--label". - nobrushspacing=yes +nostamprotation=yes - Disables the brush spacing option of the Paint and Lines tools. - The brushes' default spacings will be used. + This disables the rotation step of the Stamps tool, immediately placing the + stamp in its regular orientation (with any flipping or mirroring applied) + on the first click. - 📜 Note: The brush spacing option was added to Tux Paint's user - interface in version 0.9.28. For more information on brush - spacing, see EXTENDING.html + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nobrushspacing=no" or "brushspacing=yes". In both cases, may be - overridden by the command-line option "--brushspacing". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nostamprotation=no" or "stamprotation= + yes". In both cases, may be overridden by the command-line option + "--stamprotation". - notemplateexport=yes - Disables the ability to create a new Template image (based on a - saved drawing) from within the Open dialog. - 📜 Note: The Template creation feature was added to Tux Paint in - version 0.9.31. +nomagiccontrols=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "notemplateexport=no" or "templateexport=yes". In both cases, may - be overridden by the command-line option "--templateexport". + Some Magic tools have the option of acting like a paintbrush, or affecting + the entire canvas at once. This option disables the controls, and only + provides the default functionality (usually paint-mode). - noerase=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagiccontrols=no" or "magiccontrols= + yes". In both cases, may be overridden by the command-line option + "--magiccontrols". + + + +nomagicsizes=yes + + Some Magic tools offer various size settings. This option disables the + sizing control, and only provides the tools' default sizes. (Some plugins + may offer additional variations of a Magic tool, to make a few sizes + possible, e.g. "Bricks" and "Googly Eyes".) + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nomagicsizes=no" or "magicsizes=yes". + In both cases, may be overridden by the command-line option "--magicsizes". + + + +noshapecontrols=yes + + Disable the control buttons shown when using the Shapes tool that allow + changing how shapes are drawn — centered around the initial mouse click, or + with a corner at the initial mouse click. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noshapecontrols=no" or "shapecontrols= + yes". In both cases, may be overridden by the command-line option + "--shapecontrols". + + + +nolabel=yes + + Disables the Label tool: the tool that allows text entry which can be + edited later. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nolabel=no" or "label=yes". In both + cases, may be overridden by the command-line option "--label". + + + +nobrushspacing=yes + + Disables the brush spacing option of the Paint and Lines tools. The + brushes' default spacings will be used. + + 📜 Note: The brush spacing option was added to Tux Paint's user interface in + version 0.9.28. For more information on brush spacing, see EXTENDING.html + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "nobrushspacing=no" or "brushspacing= + yes". In both cases, may be overridden by the command-line option + "--brushspacing". + + + +notemplateexport=yes + + Disables the ability to create a new Template image (based on a saved + drawing) from within the Open dialog. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "notemplateexport=no" or + "templateexport=yes". In both cases, may be overridden by the command-line + option "--templateexport". + + + +noerase=yes + + Disables the ability to erase saved drawings via the "Erase" button on the + Open dialog, or exported Template images (based on a saved drawing) via the + "Erase" button on the New dialog. Useful to prevent users from erasing + work, especially combined with the --saveovernew option. + + 📜 Note: This option was added to Tux Paint in version 0.9.31. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "noerase=no" or "erase=yes". In both + cases, may be overridden by the command-line option "--erase". - Disables the ability to erase saved drawings via the "Erase" - button on the Open dialog, or exported Template images (based on a - saved drawing) via the "Erase" button on the New dialog. Useful to - prevent users from erasing work, especially combined with the - --saveovernew option. - 📜 Note: This option was added to Tux Paint in version 0.9.31. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "noerase=no" or - "erase=yes". In both cases, may be overridden by the command-line - option "--erase". Languages - Language +Language - lang=LANGUAGE +lang=LANGUAGE - Run Tux Paint in one of the supported languages. Possible choices - for LANGUAGE currently include: + Run Tux Paint in one of the supported languages. Possible choices for + LANGUAGE currently include: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale LOCALE - Run Tux Paint in one of the support languages. See the "Choosing a - Different Language" section below for the locale strings (e.g., - "de_DE" for German) to use. - (If your locale is already set, e.g. with the "$LANG" environment - variable, this option is not necessary, since Tux Paint honors - your environment's setting, if possible.) +--locale LOCALE - mirrorstamps=yes + Run Tux Paint in one of the support languages. See the "Choosing a + Different Language" section below for the locale strings (e.g., "de_DE" for + German) to use. - For stamps that can be mirrored, this option sets them to their - mirrored shape by default. + (If your locale is already set, e.g. with the "$LANG" environment variable, + this option is not necessary, since Tux Paint honors your environment's + setting, if possible.) - This can be useful for people who prefer things right-to-left, - rather than left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "mirrorstamps=no" or "dontmirrorstamps=yes". In both cases, may be - overridden by the command-line option "--dontmirrorstamps". - Fonts +mirrorstamps=yes - sysfonts=yes + For stamps that can be mirrored, this option sets them to their mirrored + shape by default. - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. + This can be useful for people who prefer things right-to-left, rather than + left-to-right. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "sysfonts=no" or - "nosysfonts=yes". In both cases, may be overridden by the - command-line option "--nosysfonts". + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "mirrorstamps=no" or "dontmirrorstamps= + yes". In both cases, may be overridden by the command-line option + "--dontmirrorstamps". - alllocalefonts=yes - Prior to version 0.9.21, Tux Paint loaded all fonts in its own - fonts directory, including locale-specific ones (e.g., the one for - Tibetan, which had no latin characters). As of 0.9.21, the only - font loaded from the locale-specific subdirectory, if any, is one - matching the locale Tux Paint is running on. - To load all locale-specific fonts (the old behavior), set this - option. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "alllocalefonts=no" or "currentlocalefont=yes". In both cases, may - be overridden by the command-line option "--currentlocalefont". +Fonts + +sysfonts=yes + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "sysfonts=no" or "nosysfonts=yes". In + both cases, may be overridden by the command-line option "--nosysfonts". + + + +alllocalefonts=yes + + Prior to version 0.9.21, Tux Paint loaded all fonts in its own fonts + directory, including locale-specific ones (e.g., the one for Tibetan, which + had no latin characters). As of 0.9.21, the only font loaded from the + locale-specific subdirectory, if any, is one matching the locale Tux Paint + is running on. + + To load all locale-specific fonts (the old behavior), set this option. + + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "alllocalefonts=no" or + "currentlocalefont=yes". In both cases, may be overridden by the + command-line option "--currentlocalefont". + + + +uifont=FONT NAME + + This option causes Tux Paint to attempt to load fonts (for use in the Text + tool) from your operating system. Normally, Tux Paint will only load the + ones that came bundled with Tux Paint. + + Specify "default" to let Tux Paint use its default font, "DejaVu Sans" (its + standard behavior). - uifont=FONT NAME - This option causes Tux Paint to attempt to load fonts (for use in - the Text tool) from your operating system. Normally, Tux Paint - will only load the ones that came bundled with Tux Paint. - Specify "default" to let Tux Paint use its default font, "DejaVu - Sans" (its standard behavior). Printing - Print Permissions +Print Permissions - noprint=yes +noprint=yes - Disable the printing feature. + Disable the printing feature. - printdelay=SECONDS - Restrict printing so that printing can occur only once every - SECONDS seconds. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printdelay=0". - In both cases, may be overridden by the command-line option - "--printdelay=0". +printdelay=SECONDS - Show Printer Dialog + Restrict printing so that printing can occur only once every SECONDS + seconds. - altprint=always + ⚙ Note: If used in a system-wide configuration file, may be overridden by + the user's configuration file using "printdelay=0". In both cases, may be + overridden by the command-line option "--printdelay=0". - This causes Tux Paint to always show the printer dialog (or, on - Linux/Unix, run the "altprintcommand") when the 'Print' button is - clicked. In other words, it's like clicking 'Print' while holding - [Alt], except you don't need to hold [Alt] every time. - altprint=never - This prevents Tux Paint from ever showing the printer dialog (or, - on Linux/Unix, run the "altprintcommand") when the 'Print' button - is clicked. In other words, it makes the [Alt] key have no effect - when clicking the 'Print' button. - altprint=mod +Show Printer Dialog - This is the normal, default behavior. Tux Paint shows a printer - dialog (or, on Linux/Unix, runs the "altprintcommand"), when the - [Alt] key is pressed while the 'Print' button is clicked. Clicking - 'Print' without holding [Alt] prints without showing a dialog. +altprint=always - Save Printer Configuration + This causes Tux Paint to always show the printer dialog (or, on Linux/Unix, + run the "altprintcommand") when the 'Print' button is clicked. In other + words, it's like clicking 'Print' while holding [Alt], except you don't + need to hold [Alt] every time. - printcfg=yes - (Windows and macOS only) - Tux Paint will use a printer configuration file when printing. - Push the [Alt] key while clicking the 'Print' button in Tux - Paint to cause a Windows print dialog window to appear. +altprint=never - Any configuration changes made in this dialog will be saved to - the file "userdata/print.cfg" , and used again, as long as the - "printcfg" option is set. + This prevents Tux Paint from ever showing the printer dialog (or, on Linux/ + Unix, run the "altprintcommand") when the 'Print' button is clicked. In + other words, it makes the [Alt] key have no effect when clicking the + 'Print' button. - 💡 Note: This only works when not running Tux Paint in fullscreen - mode. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "printcfg=no" - or "noprintcfg=yes". In both cases, may be overridden by the - command-line option "--noprintcfg". - Print Commands +altprint=mod - printcommand=COMMAND + This is the normal, default behavior. Tux Paint shows a printer dialog (or, + on Linux/Unix, runs the "altprintcommand"), when the [Alt] key is pressed + while the 'Print' button is clicked. Clicking 'Print' without holding [Alt] + prints without showing a dialog. - (Linux and Unix only) - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked. If this option is not - specifically not set, the default command is: - lpr - 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format - data to the print command (which defaulted to "pngtopnm | - pnmtops | lpr"). +Save Printer Configuration - If you set an alternative printcommand in the configuration file - prior to version 0.9.15, you will need to change it. + printcfg=yes - altprintcommand=COMMAND + (Windows and macOS only) - (Linux and Unix only) + Tux Paint will use a printer configuration file when printing. Push the + [Alt] key while clicking the 'Print' button in Tux Paint to cause a + Windows print dialog window to appear. - Use the command COMMAND to print a PostScript format file when - the 'Print' button is clicked while the [Alt] modifier key is - being held. (This is typically used for providing a print - dialog, similar to when pressing [Alt]+'Print' in Windows and - macOS.) + Any configuration changes made in this dialog will be saved to the file + "userdata/print.cfg" , and used again, as long as the "printcfg" option + is set. - If this option is not specifically not set, the default command - is KDE's graphical print dialog: + 💡 Note: This only works when not running Tux Paint in fullscreen mode. - kprinter + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "printcfg=no" or "noprintcfg= + yes". In both cases, may be overridden by the command-line option + "--noprintcfg". - Paper Size - papersize=PAPERSIZE - (Platforms that use Tux Paint's internal PostScript generator — - not Windows, macOS, BeOS, or Haiku.) - Tell Tux Paint what size PostScript to generate. If none is - specified, Tux Paint first checks your $PAPER environment - variable, then the file /etc/papersize, then uses the the - 'libpaper' library's default paper size. + Print Commands - Valid paper sizes include: letter, legal, tabloid, executive, - note, statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, - b0, b1, b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, - halfnote, folio, quarto, ledger, archA, archB, archC, archD, - archE, flsa, flse, csheet, dsheet, esheet. + printcommand=COMMAND -Saving + (Linux and Unix only) - Save Over Earlier Work + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked. If this option is not specifically not set, + the default command is: - saveover=yes + lpr - This disables the "Save over the old version...?" prompt when - saving an existing file. With this option, the older version - will always be replaced by the new version, automatically. + 📜 Note: Versions of Tux Paint prior to 0.9.15 sent PNG format data to + the print command (which defaulted to "pngtopnm | pnmtops | lpr"). - saveover=new + If you set an alternative printcommand in the configuration file prior + to version 0.9.15, you will need to change it. - This also disables the "Save over the old version...?" prompt - when saving an existing file. This option, however, will always - save a new file, rather than overwrite the older version. - saveover=ask - (This option is redundant, since this is the default.) When - saving an existing drawing, you will be first asked whether to - save over the older version or not. + altprintcommand=COMMAND - Starting Out + (Linux and Unix only) - startblank=yes + Use the command COMMAND to print a PostScript format file when the + 'Print' button is clicked while the [Alt] modifier key is being held. + (This is typically used for providing a print dialog, similar to when + pressing [Alt]+'Print' in Windows and macOS.) - This causes Tux Paint to display a blank canvas when it first - starts up, rather than loading the last image that was being - edited. + If this option is not specifically not set, the default command is + KDE's graphical print dialog: - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "startblank=no" or "startlast=yes". In both cases, may be - overridden by the command-line option "--startlast". + kprinter - newcolorslast=yes - Places the blank color options in the New dialog at the end, so - that any Starters and/or Templates are shown first. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "newcolorslast=no" or "newcolorsfirst=yes". In both cases, may - be overridden by the command-line option "--newcolorsfirst". - Save and Export Directories + Paper Size - savedir=DIRECTORY + papersize=PAPERSIZE - Use this option to change where Tux Paint's "saved" - directory/folder is located, which is where Tux Paint saves and - opens pictures. + (Platforms that use Tux Paint's internal PostScript generator — not + Windows, macOS, BeOS, or Haiku.) - If you do not override it, the default location is: + Tell Tux Paint what size PostScript to generate. If none is specified, + Tux Paint first checks your $PAPER environment variable, then the file + /etc/papersize, then uses the the 'libpaper' library's default paper + size. - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/saved/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/saved/ + Valid paper sizes include: letter, legal, tabloid, executive, note, + statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, + b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, + ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, + esheet. - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. - 📜 Note: Prior to version 0.9.18, Tux Paint would also use the - setting or default for "savedir" as the place to search for - personal data files (brushes, stamps, starters and fonts). As of - version 0.9.18, they may be specified separately (see the - "datadir" option, below). - Example: savedir=Z:\tuxpaint\ - exportdir=DIRECTORY + Saving - Use this option to change where Tux Paint exports files — single - images, or animated GIF slideshows — for external use. + Save Over Earlier Work - If you do not override it, the default location is: + saveover=yes - * Linux & Unix — If available, wherever your desktop - environment is configured for pictures to be stored, based - on your XDG (X Desktop Group) configuration. (Try running - the command-line "xdg-user-dir PICTURES" to find out.) - Typically (in an English locale), this will be a "Pictures" - subdirectory in your home directory (i.e., "$HOME/Pictures" - aka "~/Pictures"). - Tux Paint will fall back to using that typical directory, - of no XDG configuration can be read, or nothing is set for - "XDG_PICTURES_DIR". - * Windows - "My Pictures" directory for each user (normaly - "c:\Users\USERNAME\Pictures"). - You can directly open the folder as follows: - * Press "[Windows]+[R]" key to open "Run ..." dialogue. - * Enter "Shell:My Pictures" in the text box and push - [OK]. - * macOS — TBD! + This disables the "Save over the old version...?" prompt when saving an + existing file. With this option, the older version will always be + replaced by the new version, automatically. - 💡 Note: When the defaults are used, a new "TuxPaint" - subdirectory will be created and used. (e.g., - "~/Pictures/TuxPaint") When the "--exportdir" option is used, - the exact path specified will be used (no "TuxPaint" - subdirectory is created). - The directory itself (e.g., "~/Pictures/TuxPaint") will be - created, if it doesn't exist. - If the parent directory (e.g., "~/Pictures/TuxPaint") also does - not exist, Tux Paint will attempt to create it as well (but not - any directories higher than that). + saveover=new - Example: exportdir=/home/penguin/TuxPaintExports + This also disables the "Save over the old version...?" prompt when + saving an existing file. This option, however, will always save a new + file, rather than overwrite the older version. - More Saving Options - nosave=yes - This disables Tux Paint's ability to save files (and therefore - disables the on-screen "Save" button). It can be used in - situations where the program is only being used for fun, or in a - test environment. + saveover=ask - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "nosave=no" or - "save=yes". In both cases, may be overridden by the command-line - option "--save". + (This option is redundant, since this is the default.) When saving an + existing drawing, you will be first asked whether to save over the + older version or not. - autosave=yes - This prevents Tux Paint from asking whether you want to save the - current picture when quitting, and assumes you do. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "autosave=no" - or "noautosave=yes". In both cases, may be overridden by the - command-line option "--noautosave". - reversesort=yes + Starting Out - This reverses the sorting of the Open and Slideshow dialogs, - placing the newest images at the top of the list. + startblank=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "reversesort=no" or "noreversesort=yes". In both cases, may be - overridden by the command-line option "--noreversesort". + This causes Tux Paint to display a blank canvas when it first starts + up, rather than loading the last image that was being edited. -Data + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "startblank=no" or "startlast= + yes". In both cases, may be overridden by the command-line option + "--startlast". - Lockfile - nolockfile=yes - By default, Tux Paint uses what's known as a 'lockfile' to - prevent it from being launched more than once in 30 seconds. - (This is to avoid accidentally running multiple copies; for - example, by double-clicking a single-click launcher, or simply - impatiently clicking the icon multiple times.) + newcolorslast=yes - To make Tux Paint ignore the lockfile, allowing it to run again, - even if it was just launched less than 30 seconds ago, enable - this setting in the configuration file, or run Tux Paint with - the --nolockfile option on the command-line. + Places the blank color options in the New dialog at the end, so that + any Starters and/or Templates are shown first. - By default, the lockfile is stored in "~/.tuxpaint/" under Linux - and Unix, and "userdata\" under Windows. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "newcolorslast=no" or + "newcolorsfirst=yes". In both cases, may be overridden by the + command-line option "--newcolorsfirst". - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "nolockfile=no" or "lockfile=yes". In both cases, may be - overridden by the command-line option "--lockfile". - Data Directory - datadir=DIRECTORY - Use this option to change where Tux Paint looks for personal - data files (brushes, stamps, starters, templates, and fonts - specific to the current user). - - Tux Paint will search for subdirectories/subfolders named - "brushes", "stamps", "starters", "templates", and "fonts" under - the specified data directory. - - If you do not override it, the default location is: - - * Linux & Unix — Under a hidden directory named ".tuxpaint" - in your home directory (aka "~" or "$HOME") - Example: /home/username/.tuxpaint/brushes/ - * Windows — Inside a folder named "TuxPaint" in your - "Application Data" folder. - Example: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS — Inside a folder named "TuxPaint" in your - "Application Support" folder. - Example: /Users/Username/Library/Application - Support/TuxPaint/brushes/ + Save and Export Directories - 📜 Note: Prior to version 0.9.18, Tux Paint would use the same - setting or default as for "savedir" to search for data files. As - of version 0.9.18, they may be specified separately. + savedir=DIRECTORY - 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must - also specify a subdirectory. + Use this option to change where Tux Paint's "saved" directory/folder is + located, which is where Tux Paint saves and opens pictures. - Example: datadir=/home/johnny/tuxpaint-data/ + If you do not override it, the default location is: - Color Palette File + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/saved/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\saved\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/saved + / - colorfile=FILENAME + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - You may override Tux Paint's default color palette by creating a - plain ASCII text file that describes the colors you want, and - pointing to that file using the "colorfile" option. + 📜 Note: Prior to version 0.9.18, Tux Paint would also use the setting + or default for "savedir" as the place to search for personal data files + (brushes, stamps, starters and fonts). As of version 0.9.18, they may + be specified separately (see the "datadir" option, below). - The file should list one color per line. Colors are defined in - terms of their Red, Green and Blue values, each from 0 (off) to - 255 (brightest). (For more information, try Wikipedia's "RGB - color model" article.) + Example: savedir=Z:\tuxpaint\ - Colors may be listed using three decimal numbers (e.g., "255 68 - 136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., - "#ff4488" or "#F48"). - After the color definition (on the same line) you may enter text - to describe the color. Tux will display this text when the color - is clicked. (For example, "#FFF White as snow.") - As an example, you can see the default colors currently used in - Tux Paint in: "default_colors.txt". + exportdir=DIRECTORY - NOTES: You must separate decimal values with spaces, and begin - hexadecimal values with a pound/number-sign character ("#"). In - 3-digit hexadecimal, each digit is used for both the high and - low halves of the byte, so "#FFF" is the same as "#FFFFFF", not - "#F0F0F0". + Use this option to change where Tux Paint exports files — single + images, or animated GIF slideshows — for external use. -Accessibility + If you do not override it, the default location is: - Mouse + o Linux & Unix — If available, wherever your desktop environment is + configured for pictures to be stored, based on your XDG (X Desktop + Group) configuration. (Try running the command-line "xdg-user-dir + PICTURES" to find out.) + Typically (in an English locale), this will be a "Pictures" + subdirectory in your home directory (i.e., "$HOME/Pictures" aka "~/ + Pictures"). + Tux Paint will fall back to using that typical directory, of no XDG + configuration can be read, or nothing is set for + "XDG_PICTURES_DIR". + o Windows - "My Pictures" directory for each user (normaly "c:\Users\ + USERNAME\Pictures"). + You can directly open the folder as follows: + # Press "[Windows]+[R]" key to open "Run ..." dialogue. + # Enter "Shell:My Pictures" in the text box and push [OK]. + o macOS — TBD! - mouse-accessibility=yes + 💡 Note: When the defaults are used, a new "TuxPaint" subdirectory will + be created and used. (e.g., "~/Pictures/TuxPaint") When the + "--exportdir" option is used, the exact path specified will be used (no + "TuxPaint" subdirectory is created). - In this mode, instead of clicking, dragging and releasing (e.g., - to draw), you click, move, and click again to end the motion. + The directory itself (e.g., "~/Pictures/TuxPaint") will be created, if + it doesn't exist. - Keyboard + If the parent directory (e.g., "~/Pictures/TuxPaint") also does not + exist, Tux Paint will attempt to create it as well (but not any + directories higher than that). - keyboard=yes + Example: exportdir=/home/penguin/TuxPaintExports - This allows the keyboard arrow keys to be used to control the - mouse pointer. (e.g., for mouseless environments, or - handicapped/accessibility purposes) - Features: - * Fine movement within canvas, or coarse movement if Shift is - held. - * Coarse movement within tool button areas. - * Key controls: - * [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move - mouse - * [Space]/[5]: Click mouse (except when using "Text" or - "Label" tools) - * [Insert]/[F5]: Click mouse (always) - * [F4] jump mouse between "Tools", "Colors" and canvas - areas - * If mouse is within "Tools" section on the left, or - "Colors" section at the bottom: - * [F7], [F8]: Move down/up between buttons, - respectively (Tools section, only) - * [F11], [F12]: Move to previous/next button, - respectively - * To click-and-drag, hold one of the 'click' keys (e.g., - [Insert]), and use the movement keys (e.g., [Left]). - 💡 Note: The "mouse accessibility" feature works with the - keyboard mouse controls. With both options enabled, - painting tools can be used to draw by pressing a 'click' - key to start clicking, movement keys to move around (which - will draw), and another 'click' key to end the click (stop - drawing). + More Saving Options - * A regular mouse and/or joystick may still be used (so you - can, e.g., move with the mouse, and click with the - keyboard, or vice-versa) + nosave=yes - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using "keyboard=no" - or "mouse=yes". In both cases, may be overridden by the - command-line option "--mouse". + This disables Tux Paint's ability to save files (and therefore disables + the on-screen "Save" button). It can be used in situations where the + program is only being used for fun, or in a test environment. - Onscreen Keyboard + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nosave=no" or "save=yes". In + both cases, may be overridden by the command-line option "--save". - onscreen-keyboard=yes - Presents a clickable on-screen keyboard when using the Text and - Label tools. - onscreen-keyboard-layout=LAYOUTNAME + autosave=yes - Selects the initial layout for the on-screen keyboard when using - the Text and Label tools. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. + This prevents Tux Paint from asking whether you want to save the + current picture when quitting, and assumes you do. - onscreen-keyboard-disable-change=yes + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "autosave=no" or "noautosave= + yes". In both cases, may be overridden by the command-line option + "--noautosave". - Disables the possibility for changing the layout of the - on-screen keyboard when using the Text and Label tools, useful - for simplifying things for the small children. - Note: Using this option implies automatically - onscreen-keyboard=yes, so setting both is redundant. - ⚙ Note: If used in a system-wide configuration file, may be - overridden by the user's configuration file using - "onscreen-keyboard-disable-change=no". In both cases, may be - overridden by the command-line option - "--onscreen-keyboard-disable-change=no". -Joystick + reversesort=yes - Main Device + This reverses the sorting of the Open and Slideshow dialogs, placing + the newest images at the top of the list. - joystick-dev=N + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "reversesort=no" or + "noreversesort=yes". In both cases, may be overridden by the + command-line option "--noreversesort". - Specify which joystick device should be used by Tux Paint. - Default value is 0 (the first joystick). - joystick-slowness=SPEED - Sets a delay at each axis motion, allowing to slow the joystick. - Allowed values are from 0 to 500. Default value is 15. - joystick-threshold=THRESHOLD + Data - Sets the minimum level of axis motion to start moving the - pointer. Allowed values are from 0 to 32766. Default value is - 3200. + Lockfile - joystick-maxsteps=STEPS + nolockfile=yes - Sets the maximum pixels the pointer will move at once. Allowed - values are from 1 to 7. Default value is 7. + By default, Tux Paint uses what's known as a 'lockfile' to prevent it + from being launched more than once in 30 seconds. (This is to avoid + accidentally running multiple copies; for example, by double-clicking a + single-click launcher, or simply impatiently clicking the icon multiple + times.) - Hat + To make Tux Paint ignore the lockfile, allowing it to run again, even + if it was just launched less than 30 seconds ago, enable this setting + in the configuration file, or run Tux Paint with the --nolockfile + option on the command-line. - joystick-hat-slowness=SPEED + By default, the lockfile is stored in "~/.tuxpaint/" under Linux and + Unix, and "userdata\" under Windows. - Sets a delay at each automatic motion, allowing to slow the - speed of the hat. Allowed values are from 0 to 500. Default - value is 15. + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "nolockfile=no" or "lockfile= + yes". In both cases, may be overridden by the command-line option + "--lockfile". - joystick-hat-timeout=MILLISECONDS - Sets the delay after wich the pointer will start moving - automatically if the hat is keeped pushed. Allowed values are - from 0 to 3000. Default value is 1000. - Buttons to Disable - joystick-buttons-ignore=BUTTON1,BUTTON2,... + Data Directory - A set of joystick button numbers, as seen by SDL, that should be - ignored. Otherwise, unless they are used by one of the - "joystick-btn-" options above, buttons will be seen as a mouse - left-click. + datadir=DIRECTORY - Button Shortcuts + Use this option to change where Tux Paint looks for personal data files + (brushes, stamps, starters, templates, and fonts specific to the + current user). - joystick-btn-escape=BUTTON NUMBER + Tux Paint will search for subdirectories/subfolders named "brushes", + "stamps", "starters", "templates", and "fonts" under the specified data + directory. - Selects the joystick button number, as seen by SDL, that will be - used to generate a escape event. Useful to dismiss dialogs and - quit. + If you do not override it, the default location is: - joystick-btn-brush=BUTTON NUMBER + o Linux & Unix — Under a hidden directory named ".tuxpaint" in your + home directory (aka "~" or "$HOME") + Example: /home/username/.tuxpaint/brushes/ + o Windows — Inside a folder named "TuxPaint" in your "Application + Data" folder. + Example: C:\Documents and Settings\Username\Application Data\ + TuxPaint\brushes\ + o macOS — Inside a folder named "TuxPaint" in your "Application + Support" folder. + Example: /Users/Username/Library/Application Support/TuxPaint/ + brushes/ - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the brush tool. + 📜 Note: Prior to version 0.9.18, Tux Paint would use the same setting + or default as for "savedir" to search for data files. As of version + 0.9.18, they may be specified separately. - joystick-btn-stamp=BUTTON NUMBER + 💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also + specify a subdirectory. - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the stamp tool. + Example: datadir=/home/johnny/tuxpaint-data/ - joystick-btn-lines=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the lines tool. - joystick-btn-shapes=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the shapes tool. + Color Palette File - joystick-btn-text=BUTTON NUMBER + colorfile=FILENAME - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the text tool. + You may override Tux Paint's default color palette by creating a plain + ASCII text file that describes the colors you want, and pointing to + that file using the "colorfile" option. - joystick-btn-label=BUTTON NUMBER + The file should list one color per line. Colors are defined in terms of + their Red, Green and Blue values, each from 0 (off) to 255 (brightest). + (For more information, try Wikipedia's "RGB color model" article.) - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the label tool. + Colors may be listed using three decimal numbers (e.g., "255 68 136") + or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "#ff4488" or "# + F48"). - joystick-btn-fill=BUTTON NUMBER + After the color definition (on the same line) you may enter text to + describe the color. Tux will display this text when the color is + clicked. (For example, "#FFF White as snow.") - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the fill tool. + As an example, you can see the default colors currently used in Tux + Paint in: "default_colors.txt". - joystick-btn-magic=BUTTON NUMBER + NOTES: You must separate decimal values with spaces, and begin + hexadecimal values with a pound/number-sign character ("#"). In 3-digit + hexadecimal, each digit is used for both the high and low halves of the + byte, so "#FFF" is the same as "#FFFFFF", not "#F0F0F0". - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select the magic tool. - joystick-btn-undo=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to invoke the undo tool. - joystick-btn-redo=BUTTON NUMBER + Accessibility - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select redo tool. + Mouse - joystick-btn-eraser=BUTTON NUMBER + mouse-accessibility=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to select eraser tool. + In this mode, instead of clicking, dragging and releasing (e.g., to + draw), you click, move, and click again to end the motion. - joystick-btn-new=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for creating a new drawing. - joystick-btn-open=BUTTON NUMBER - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the dialog for opening an existing drawing. + Keyboard - joystick-btn-save=BUTTON NUMBER + keyboard=yes - Selects the joystick button number, as seen by SDL, that will be - a shortcut to save the drawing. + This allows the keyboard arrow keys to be used to control the mouse + pointer. (e.g., for mouseless environments, or handicapped/ + accessibility purposes) - joystick-btn-pgsetup=BUTTON NUMBER + Features: - Selects the joystick button number, as seen by SDL, that will be - a shortcut to launch the page setup dialog for printing. + o Fine movement within canvas, or coarse movement if Shift is held. + o Coarse movement within tool button areas. + o Key controls: + # [Left]/[Right]/[Up]/[Down], numpad [1] thru [9]: Move mouse + # [Space]/[5]: Click mouse (except when using "Text" or "Label" + tools) + # [Insert]/[F5]: Click mouse (always) + # [F4] jump mouse between "Tools", "Colors" and canvas areas + # If mouse is within "Tools" section on the left, or "Colors" + section at the bottom: + @ [F7], [F8]: Move down/up between buttons, respectively + (Tools section, only) + @ [F11], [F12]: Move to previous/next button, respectively + o To click-and-drag, hold one of the 'click' keys (e.g., [Insert]), + and use the movement keys (e.g., [Left]). - joystick-btn-print=BUTTON NUMBER + 💡 Note: The "mouse accessibility" feature works with the keyboard + mouse controls. With both options enabled, painting tools can be + used to draw by pressing a 'click' key to start clicking, movement + keys to move around (which will draw), and another 'click' key to + end the click (stop drawing). - Selects the joystick button number, as seen by SDL, that will be - a shortcut to print. - - Overriding System Config. Options - - (For Linux and Unix users) - - If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", - you can override them in your own "~/.tuxpaintrc" file. - - For true/false options, like "noprint" and "grab", you can simply say - they equal 'no' in your "~/.tuxpaintrc" file: - - noprint=no - uppercase=no - - Or, you can use options similar to the command-line override options - described below. For example: - - print=yes - mixedcase=yes - - Command-Line Options - - Options may also be issued on the command-line when you go to launch Tux - Paint. - - --fullscreen - --WIDTHxHEIGHT - --buttonsize=SIZE - --colorsrows=ROWS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDS - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --printcommand=COMMAND - --altprintcommand=COMMAND - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang LANGUAGE - --colorfile FILE - - These enable or correspond to the configuration file options - described above. - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - These options can be used to override any settings made in the - configuration file. (If the option isn't set in the - configuration file(s), no overriding option is necessary.) - - --nosysconfig - - Under Linux and Unix, this prevents the system-wide - configuration file, "/etc/tuxpaint/tuxpaint.conf", from being - read. - - Only your own configuration file, "~/.tuxpaintrc", if it exists, - will be used. - -Command-Line Informational Options - - The following options display some informative text on the screen. Tux - Paint doesn't actually start up and run afterwards, however. - - --version - --verbose-version - - Display the version number and date of the copy of Tux Paint you - are running. The "--verbose-version" also lists what - compile-time options were set. (See INSTALL and FAQ). - - --copying - - Show brief license information about copying Tux Paint. - - --usage - - Display the list of available command-line options. - - --help - - Display brief help on using Tux Paint. - - --lang help - - Display a list of available languages in Tux Paint. - - --joystick-dev list - - Display list of attached joysticks available to Tux Paint. - - Choosing a Different Language - - Tux Paint has been translated into a number of languages. To access the - translations, you can use the "--lang" option on the command-line to set - the language (e.g. "--lang spanish") or use the "lang=" setting in the - configuration file (e.g., "lang=spanish"). - - Tux Paint also honors your environment's current locale. (You can - override it on the command-line using the "--locale" option; see above.) - - Use the option "--lang help" to list the language options available. - -Available Languages - - +----------------------------------------------------------------------+ - | |Language |Language |Input Method | - |Locale Code |(native name) |(English name) |Cycle Key | - | | | |Combination | - |----------------+-------------------+-----------------+---------------| - |C | |English | | - |----------------+-------------------+-----------------+---------------| - |ach_UG |Acoli |Acholi | | - |----------------+-------------------+-----------------+---------------| - |af_ZA | |Afrikaans | | - |----------------+-------------------+-----------------+---------------| - |ak_GH | |Akan | | - |----------------+-------------------+-----------------+---------------| - |am_ET | |Amharic | | - |----------------+-------------------+-----------------+---------------| - |an_ES | |Aragones | | - |----------------+-------------------+-----------------+---------------| - |ar_SA | |Arabic | | - |----------------+-------------------+-----------------+---------------| - |as_IN | |Assamese | | - |----------------+-------------------+-----------------+---------------| - |ast_ES | |Asturian | | - |----------------+-------------------+-----------------+---------------| - |az_AZ | |Azerbaijani | | - |----------------+-------------------+-----------------+---------------| - |bm_ML | |Bambara | | - |----------------+-------------------+-----------------+---------------| - |bn_IN | |Bengali | | - |----------------+-------------------+-----------------+---------------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+-------------------+-----------------+---------------| - |bg_BG | |Bulgarian | | - |----------------+-------------------+-----------------+---------------| - |bo_CN (*) | |Tibetan | | - |----------------+-------------------+-----------------+---------------| - |br_FR |Brezhoneg |Breton | | - |----------------+-------------------+-----------------+---------------| - |brx_IN | |Bodo | | - |----------------+-------------------+-----------------+---------------| - |bs_BA | |Bosnian | | - |----------------+-------------------+-----------------+---------------| - |ca_ES |Català |Catalan | | - |----------------+-------------------+-----------------+---------------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+-------------------+-----------------+---------------| - |cgg_UG |Chiga |Kiga | | - |----------------+-------------------+-----------------+---------------| - |cs_CZ |Cesky |Czech | | - |----------------+-------------------+-----------------+---------------| - |cy_GB |Cymraeg |Welsh | | - |----------------+-------------------+-----------------+---------------| - |da_DK |Dansk |Danish | | - |----------------+-------------------+-----------------+---------------| - |de_DE |Deutsch |German | | - |----------------+-------------------+-----------------+---------------| - |doi_IN | |Dogri | | - |----------------+-------------------+-----------------+---------------| - |et_EE | |Estonian | | - |----------------+-------------------+-----------------+---------------| - |el_GR (*) | |Greek | | - |----------------+-------------------+-----------------+---------------| - |en_AU | |Australian | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |en_CA | |Canadian English | | - |----------------+-------------------+-----------------+---------------| - |en_GB | |British English | | - |----------------+-------------------+-----------------+---------------| - |en_ZA | |South African | | - | | |English | | - |----------------+-------------------+-----------------+---------------| - |eo | |Esperanto | | - |----------------+-------------------+-----------------+---------------| - |es_ES |Español |Spanish | | - |----------------+-------------------+-----------------+---------------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+-------------------+-----------------+---------------| - |eu_ES |Euskara |Basque | | - |----------------+-------------------+-----------------+---------------| - |fa_IR | |Persian | | - |----------------+-------------------+-----------------+---------------| - |ff_SN |Fulah |Fula | | - |----------------+-------------------+-----------------+---------------| - |fi_FI |Suomi |Finnish | | - |----------------+-------------------+-----------------+---------------| - |fo_FO | |Faroese | | - |----------------+-------------------+-----------------+---------------| - |fr_FR |Français |French | | - |----------------+-------------------+-----------------+---------------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+-------------------+-----------------+---------------| - |gl_ES |Galego |Galician | | - |----------------+-------------------+-----------------+---------------| - |gos_NL |Zudelk |Gronings | | - | |Veenkelonioals | | | - |----------------+-------------------+-----------------+---------------| - |gu_IN | |Gujarati | | - |----------------+-------------------+-----------------+---------------| - |he_IL (*) | |Hebrew | | - |----------------+-------------------+-----------------+---------------| - |hi_IN (*) | |Hindi | | - |----------------+-------------------+-----------------+---------------| - |hr_HR |Hrvatski |Croatian | | - |----------------+-------------------+-----------------+---------------| - |hu_HU |Magyar |Hungarian | | - |----------------+-------------------+-----------------+---------------| - |hy_AM |Hayeren |Armenian | | - |----------------+-------------------+-----------------+---------------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+-------------------+-----------------+---------------| - |is_IS |Íslenska |Icelandic | | - |----------------+-------------------+-----------------+---------------| - |it_IT |Italiano |Italian | | - |----------------+-------------------+-----------------+---------------| - |iu_CA | |Inuktitut | | - |----------------+-------------------+-----------------+---------------| - |ja_JP (*) | |Japanese |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |ka_GE | |Georgian | | - |----------------+-------------------+-----------------+---------------| - |kab | |Kabyle | | - |----------------+-------------------+-----------------+---------------| - |km_KH | |Khmer | | - |----------------+-------------------+-----------------+---------------| - |kn_IN | |Kannada | | - |----------------+-------------------+-----------------+---------------| - |ko_KR (*) | |Korean |right [Alt] or | - | | | |left [Alt] | - |----------------+-------------------+-----------------+---------------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |kok@roman | |Konkani (Roman) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+-------------------+-----------------+---------------| - |ku_TR | |Kurdish | | - |----------------+-------------------+-----------------+---------------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+-------------------+-----------------+---------------| - |lg_UG | |Luganda | | - |----------------+-------------------+-----------------+---------------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+-------------------+-----------------+---------------| - |lv_LV | |Latvian | | - |----------------+-------------------+-----------------+---------------| - |mk_MK | |Macedonian | | - |----------------+-------------------+-----------------+---------------| - |mai_IN | |Maithili | | - |----------------+-------------------+-----------------+---------------| - |ml_IN | |Malayalam | | - |----------------+-------------------+-----------------+---------------| - |mn_MN | |Mongolian | | - |----------------+-------------------+-----------------+---------------| - |mni_IN | |Manipuri | | - | | |(Bengali) | | - |----------------+-------------------+-----------------+---------------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+-------------------+-----------------+---------------| - |mr_IN | |Marathi | | - |----------------+-------------------+-----------------+---------------| - |ms_MY | |Malay | | - |----------------+-------------------+-----------------+---------------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+-------------------+-----------------+---------------| - |ne_NP |Nepali | | | - |----------------+-------------------+-----------------+---------------| - |nl_NL | |Dutch | | - |----------------+-------------------+-----------------+---------------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk| | - |----------------+-------------------+-----------------+---------------| - |nr_ZA | |Ndebele | | - |----------------+-------------------+-----------------+---------------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+-------------------+-----------------+---------------| - |oc_FR | |Occitan | | - |----------------+-------------------+-----------------+---------------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+-------------------+-----------------+---------------| - |pa_IN | |Punjabi | | - |----------------+-------------------+-----------------+---------------| - |or_IN |Odia |Oriya | | - |----------------+-------------------+-----------------+---------------| - |pl_PL |Polski |Polish | | - |----------------+-------------------+-----------------+---------------| - |pt_BR |Portugês Brazileiro|Brazilian | | - | | |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |pt_PT |Portugês |Portuguese | | - |----------------+-------------------+-----------------+---------------| - |ro_RO | |Romanian | | - |----------------+-------------------+-----------------+---------------| - |ru_RU |Russkiy |Russian | | - |----------------+-------------------+-----------------+---------------| - |rw_RW | |Kinyarwanda | | - |----------------+-------------------+-----------------+---------------| - |sa_IN | |Sanskrit | | - |----------------+-------------------+-----------------+---------------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sat@olchiki | |Santali | | - | | |(Ol-Chikii) | | - |----------------+-------------------+-----------------+---------------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+-------------------+-----------------+---------------| - |si_LK | |Sinhala | | - |----------------+-------------------+-----------------+---------------| - |sd_IN@devanagari| |Sindhi | | - | | |(Devanagari) | | - |----------------+-------------------+-----------------+---------------| - |sd_IN | |Sindhi | | - |----------------+-------------------+-----------------+---------------| - |sk_SK | |Slovak | | - |----------------+-------------------+-----------------+---------------| - |sl_SI | |Slovenian | | - |----------------+-------------------+-----------------+---------------| - |son | |Songhay | | - |----------------+-------------------+-----------------+---------------| - |sq_AL | |Albanian | | - |----------------+-------------------+-----------------+---------------| - |sr_YU | |Serbian | | - | | |(cyrillic) | | - |----------------+-------------------+-----------------+---------------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+-------------------+-----------------+---------------| - |su_ID | |Sundanese | | - |----------------+-------------------+-----------------+---------------| - |sv_SE |Svenska |Swedish | | - |----------------+-------------------+-----------------+---------------| - |sw_TZ | |Swahili | | - |----------------+-------------------+-----------------+---------------| - |ta_IN (*) | |Tamil | | - |----------------+-------------------+-----------------+---------------| - |te_IN (*) | |Telugu | | - |----------------+-------------------+-----------------+---------------| - |th_TH (*) | |Thai | | - |----------------+-------------------+-----------------+---------------| - |tl_PH (*) | |Tagalog | | - |----------------+-------------------+-----------------+---------------| - |tlh |tlhIngan |Klingon | | - |----------------+-------------------+-----------------+---------------| - |tr_TR | |Turkish | | - |----------------+-------------------+-----------------+---------------| - |tw_GH | |Twi | | - |----------------+-------------------+-----------------+---------------| - |uk_UA | |Ukrainian | | - |----------------+-------------------+-----------------+---------------| - |ur_IN | |Urdu | | - |----------------+-------------------+-----------------+---------------| - |ve_ZA | |Venda | | - |----------------+-------------------+-----------------+---------------| - |vec |Venèto |Venetian | | - |----------------+-------------------+-----------------+---------------| - |vi_VN | |Vietnamese | | - |----------------+-------------------+-----------------+---------------| - |wa_BE | |Walloon | | - |----------------+-------------------+-----------------+---------------| - |wo_SN | |Wolof | | - |----------------+-------------------+-----------------+---------------| - |xh_ZA | |Xhosa | | - |----------------+-------------------+-----------------+---------------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+-------------------+-----------------+---------------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+-------------------+-----------------+---------------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+-------------------+-----------------+---------------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - These languages require their own fonts, since they are not - represented using a Latin character set, like the others. See the - "Special Fonts" section, below. - - 💡 Note: Tux Paint provides an alternative input method for entering - characters with the Text tool in some locales. The key comibation(s) - listed can be used to cycle through the supported input methods while - the Text tool is active. - -Setting Your Environment's Locale - - Changing your locale will affect much of your environment. - - As stated above, along with letting you choose the language at runtime - using command-line options ("--lang" and "--locale"), Tux Paint honors - the global locale setting in your environment. - - If you haven't already set your environment's locale, the following will - briefly explain how: - - Linux/Unix Users - - First, be sure the locale you want to use is enabled by editing the file - "/etc/locale.gen" on your system and then running the program - "locale-gen" as root. - - 💡 Note: Debian users may be able to simply run the command - "dpkg-reconfigure locales" as root to bring up a configuration dialog. - Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the - "localeconf" package may need to be installed first), or you may need to - edit the file "/var/lib/locales/supported.d/local" first, and add - locales they want, from the list found in "/usr/share/i18n/SUPPORTED". - - Then, before running Tux Paint, set your "$LANG" environment variable to - one of the locales listed above. (If you want all programs that can be - translated to be, you may wish to place the following in your login - script; e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) - - For example, in a Bourne Shell (like BASH): - - export LANG=es_ES ; \ - tuxpaint - - And in a C Shell (like TCSH): - - setenv LANG es_ES ; \ - tuxpaint - - Windows Users - - Tux Paint will recognize the current locale and use the appropriate - files by default. So this section is only for people trying different - languages. - - The simplest thing to do is to use the "--lang" switch in the shortcut - (see "INSTALL"). However, by using an MSDOS Prompt window, it is also - possible to issue a command like this: - - set LANG=es_ES - - ...which will set the language for the lifetime of that DOS window. - - For something more permanent, you can set an 'environment variable' - using the "System properties" dialogue as follows: - - * Press the "[Windows]+[R]" key combination to open the "Run ..." - dialogue. - * Enter "sysdm.cpl" in the text box and click the "[OK]" button to - open the "System properties" dialogue. - * Select the "Advanced" tab. - * Click the "Environment Variables..." button. - * Edit the value of the parameter "LANG" (create it, if it doesn't - exists). - -Special Fonts - - Some languages require special fonts be installed. These font files - (which are in TrueType format (TTF)), are much too large to include with - the Tux Paint download, and are available separately. (See the table - above, under the "Choosing a Different Language" section.) - - 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, - which utilizes the "Pango" library to render text in the user interface, - rather than using "SDL_ttf" directly. Unless your copy of Tux Paint was - built without Pango support, special fonts should no longer be - necessary. + o A regular mouse and/or joystick may still be used (so you can, + e.g., move with the mouse, and click with the keyboard, or + vice-versa) - When running Tux Paint in a language that requires its own font, Tux - Paint will try to load the font file from its system-wide "fonts" - directory (under a "locale" subdirectory). The name of the file - corresponds to the first two letters in the 'locale' code of the - language (e.g., "ko" for Korean, "ja" for Japanese, "zh_tw" for - Traditional Chinese). + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using "keyboard=no" or "mouse=yes". In + both cases, may be overridden by the command-line option "--mouse". - For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., - with the option "--lang korean"), Tux Paint will attempt to load the - following font file: - /usr/share/tuxpaint/fonts/locale/ko.ttf - You can download fonts for supported languages from Tux Paint's website, - https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') - Under Unix and Linux, you can use the Makefile that comes with the font - to install the font in the appropriate location. + Onscreen Keyboard + + onscreen-keyboard=yes + + Presents a clickable on-screen keyboard when using the Text and Label + tools. + + + + onscreen-keyboard-layout=LAYOUTNAME + + Selects the initial layout for the on-screen keyboard when using the + Text and Label tools. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + + + onscreen-keyboard-disable-change=yes + + Disables the possibility for changing the layout of the on-screen + keyboard when using the Text and Label tools, useful for simplifying + things for the small children. + Note: Using this option implies automatically onscreen-keyboard=yes, so + setting both is redundant. + + ⚙ Note: If used in a system-wide configuration file, may be overridden + by the user's configuration file using + "onscreen-keyboard-disable-change=no". In both cases, may be overridden + by the command-line option "--onscreen-keyboard-disable-change=no". + + + + + Joystick + + Main Device + + joystick-dev=N + + Specify which joystick device should be used by Tux Paint. Default + value is 0 (the first joystick). + + + + joystick-slowness=SPEED + + Sets a delay at each axis motion, allowing to slow the joystick. + Allowed values are from 0 to 500. Default value is 15. + + + + joystick-threshold=THRESHOLD + + Sets the minimum level of axis motion to start moving the pointer. + Allowed values are from 0 to 32766. Default value is 3200. + + + + joystick-maxsteps=STEPS + + Sets the maximum pixels the pointer will move at once. Allowed values + are from 1 to 7. Default value is 7. + + + + + Hat + + joystick-hat-slowness=SPEED + + Sets a delay at each automatic motion, allowing to slow the speed of + the hat. Allowed values are from 0 to 500. Default value is 15. + + + + joystick-hat-timeout=MILLISECONDS + + Sets the delay after wich the pointer will start moving automatically + if the hat is keeped pushed. Allowed values are from 0 to 3000. Default + value is 1000. + + + + + Buttons to Disable + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + A set of joystick button numbers, as seen by SDL, that should be + ignored. Otherwise, unless they are used by one of the "joystick-btn-" + options above, buttons will be seen as a mouse left-click. + + + + +Button Shortcuts + + joystick-btn-escape=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be used + to generate a escape event. Useful to dismiss dialogs and quit. + + + + joystick-btn-brush=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the brush tool. + + + + joystick-btn-stamp=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the stamp tool. + + + + joystick-btn-lines=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the lines tool. + + + + joystick-btn-shapes=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the shapes tool. + + + + joystick-btn-text=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the text tool. + + + + joystick-btn-label=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the label tool. + + + + joystick-btn-fill=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the fill tool. + + + + joystick-btn-magic=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select the magic tool. + + + + joystick-btn-undo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to invoke the undo tool. + + + + joystick-btn-redo=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select redo tool. + + + + joystick-btn-eraser=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to select eraser tool. + + + + joystick-btn-new=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for creating a new drawing. + + + + joystick-btn-open=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the dialog for opening an existing drawing. + + + + joystick-btn-save=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to save the drawing. + + + + joystick-btn-pgsetup=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to launch the page setup dialog for printing. + + + + joystick-btn-print=BUTTON NUMBER + + Selects the joystick button number, as seen by SDL, that will be a + shortcut to print. + + + + + Overriding System Config. Options + + (For Linux and Unix users) + + If any of the above options are set in "/etc/tuxpaint/tuxpaint.config", you + can override them in your own "~/.tuxpaintrc" file. + + For true/false options, like "noprint" and "grab", you can simply say they + equal 'no' in your "~/.tuxpaintrc" file: + + noprint=no + uppercase=no + + Or, you can use options similar to the command-line override options + described below. For example: + + print=yes + mixedcase=yes + + Command-Line Options + + Options may also be issued on the command-line when you go to launch Tux + Paint. + + --fullscreen + --WIDTHxHEIGHT + --buttonsize=SIZE + --colorsrows=ROWS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDS + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --printcommand=COMMAND + --altprintcommand=COMMAND + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang LANGUAGE + --colorfile FILE + + These enable or correspond to the configuration file options described + above. + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + These options can be used to override any settings made in the + configuration file. (If the option isn't set in the configuration file + (s), no overriding option is necessary.) + + + + --nosysconfig + + Under Linux and Unix, this prevents the system-wide configuration file, + "/etc/tuxpaint/tuxpaint.conf", from being read. + + Only your own configuration file, "~/.tuxpaintrc", if it exists, will + be used. + + + + + Command-Line Informational Options + + The following options display some informative text on the screen. Tux + Paint doesn't actually start up and run afterwards, however. + + --version + --verbose-version + + Display the version number and date of the copy of Tux Paint you are + running. The "--verbose-version" also lists what compile-time options + were set. (See INSTALL and FAQ). + + + + --copying + + Show brief license information about copying Tux Paint. + + + + --usage + + Display the list of available command-line options. + + + + --help + + Display brief help on using Tux Paint. + + + + --lang help + + Display a list of available languages in Tux Paint. + + + + --joystick-dev list + + Display list of attached joysticks available to Tux Paint. + + + + + Choosing a Different Language + + Tux Paint has been translated into a number of languages. To access the + translations, you can use the "--lang" option on the command-line to set + the language (e.g. "--lang spanish") or use the "lang=" setting in the + configuration file (e.g., "lang=spanish"). + + Tux Paint also honors your environment's current locale. (You can override + it on the command-line using the "--locale" option; see above.) + + Use the option "--lang help" to list the language options available. + + Available Languages + + +-------------------------------------------------------------------------+ + | | Language | Language | Input Method | + | Locale Code | (native name) | (English name) | Cycle Key | + | | | | Combination | + |------------------+------------------+----------------+------------------| + | C | | English | | + |------------------+------------------+----------------+------------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+----------------+------------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+----------------+------------------| + | ak_GH | | Akan | | + |------------------+------------------+----------------+------------------| + | am_ET | | Amharic | | + |------------------+------------------+----------------+------------------| + | an_ES | | Aragones | | + |------------------+------------------+----------------+------------------| + | ar_SA | | Arabic | | + |------------------+------------------+----------------+------------------| + | as_IN | | Assamese | | + |------------------+------------------+----------------+------------------| + | ast_ES | | Asturian | | + |------------------+------------------+----------------+------------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+----------------+------------------| + | bm_ML | | Bambara | | + |------------------+------------------+----------------+------------------| + | bn_IN | | Bengali | | + |------------------+------------------+----------------+------------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+----------------+------------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+----------------+------------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+----------------+------------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+----------------+------------------| + | brx_IN | | Bodo | | + |------------------+------------------+----------------+------------------| + | bs_BA | | Bosnian | | + |------------------+------------------+----------------+------------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+----------------+------------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+----------------+------------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+----------------+------------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+----------------+------------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+----------------+------------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+----------------+------------------| + | de_DE | Deutsch | German | | + |------------------+------------------+----------------+------------------| + | doi_IN | | Dogri | | + |------------------+------------------+----------------+------------------| + | et_EE | | Estonian | | + |------------------+------------------+----------------+------------------| + | el_GR (*) | | Greek | | + |------------------+------------------+----------------+------------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_GB | | British | | + | | | English | | + |------------------+------------------+----------------+------------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+----------------+------------------| + | eo | | Esperanto | | + |------------------+------------------+----------------+------------------| + | es_ES | Español | Spanish | | + |------------------+------------------+----------------+------------------| + | es_MX | Español-Mejicano | Mexican | | + | | | Spanish | | + |------------------+------------------+----------------+------------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+----------------+------------------| + | fa_IR | | Persian | | + |------------------+------------------+----------------+------------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+----------------+------------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+----------------+------------------| + | fo_FO | | Faroese | | + |------------------+------------------+----------------+------------------| + | fr_FR | Français | French | | + |------------------+------------------+----------------+------------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+----------------+------------------| + | gd_GB | Ghaidhlig | Scottish | | + | | | Gaelic | | + |------------------+------------------+----------------+------------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+----------------+------------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+----------------+------------------| + | gu_IN | | Gujarati | | + |------------------+------------------+----------------+------------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+----------------+------------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+----------------+------------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+----------------+------------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+----------------+------------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+----------------+------------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+----------------+------------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+----------------+------------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+----------------+------------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+----------------+------------------| + | ja_JP (*) | | Japanese | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | ka_GE | | Georgian | | + |------------------+------------------+----------------+------------------| + | kab | | Kabyle | | + |------------------+------------------+----------------+------------------| + | km_KH | | Khmer | | + |------------------+------------------+----------------+------------------| + | kn_IN | | Kannada | | + |------------------+------------------+----------------+------------------| + | ko_KR (*) | | Korean | right [Alt] or | + | | | | left [Alt] | + |------------------+------------------+----------------+------------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | kok@roman | | Konkani | | + | | | (Roman) | | + |------------------+------------------+----------------+------------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+----------------+------------------| + | ku_TR | | Kurdish | | + |------------------+------------------+----------------+------------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+----------------+------------------| + | lg_UG | | Luganda | | + |------------------+------------------+----------------+------------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+----------------+------------------| + | lv_LV | | Latvian | | + |------------------+------------------+----------------+------------------| + | mk_MK | | Macedonian | | + |------------------+------------------+----------------+------------------| + | mai_IN | | Maithili | | + |------------------+------------------+----------------+------------------| + | ml_IN | | Malayalam | | + |------------------+------------------+----------------+------------------| + | mn_MN | | Mongolian | | + |------------------+------------------+----------------+------------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+----------------+------------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+----------------+------------------| + | mr_IN | | Marathi | | + |------------------+------------------+----------------+------------------| + | ms_MY | | Malay | | + |------------------+------------------+----------------+------------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+----------------+------------------| + | ne_NP | Nepali | | | + |------------------+------------------+----------------+------------------| + | nl_NL | | Dutch | | + |------------------+------------------+----------------+------------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+----------------+------------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+----------------+------------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+----------------+------------------| + | oc_FR | | Occitan | | + |------------------+------------------+----------------+------------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+----------------+------------------| + | pa_IN | | Punjabi | | + |------------------+------------------+----------------+------------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+----------------+------------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+----------------+------------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+----------------+------------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+----------------+------------------| + | ro_RO | | Romanian | | + |------------------+------------------+----------------+------------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+----------------+------------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+----------------+------------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+----------------+------------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+----------------+------------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+----------------+------------------| + | si_LK | | Sinhala | | + |------------------+------------------+----------------+------------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+----------------+------------------| + | sd_IN | | Sindhi | | + |------------------+------------------+----------------+------------------| + | sk_SK | | Slovak | | + |------------------+------------------+----------------+------------------| + | sl_SI | | Slovenian | | + |------------------+------------------+----------------+------------------| + | son | | Songhay | | + |------------------+------------------+----------------+------------------| + | sq_AL | | Albanian | | + |------------------+------------------+----------------+------------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+----------------+------------------| + | sr_RS@latin | | Serbian | | + | | | (latin) | | + |------------------+------------------+----------------+------------------| + | su_ID | | Sundanese | | + |------------------+------------------+----------------+------------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+----------------+------------------| + | sw_TZ | | Swahili | | + |------------------+------------------+----------------+------------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+----------------+------------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+----------------+------------------| + | th_TH (*) | | Thai | | + |------------------+------------------+----------------+------------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+----------------+------------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+----------------+------------------| + | tr_TR | | Turkish | | + |------------------+------------------+----------------+------------------| + | tw_GH | | Twi | | + |------------------+------------------+----------------+------------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+----------------+------------------| + | ur_IN | | Urdu | | + |------------------+------------------+----------------+------------------| + | ve_ZA | | Venda | | + |------------------+------------------+----------------+------------------| + | vec | Venèto | Venetian | | + |------------------+------------------+----------------+------------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+----------------+------------------| + | wa_BE | | Walloon | | + |------------------+------------------+----------------+------------------| + | wo_SN | | Wolof | | + |------------------+------------------+----------------+------------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+----------------+------------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+----------------+------------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+----------------+------------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+----------------+------------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - These languages require their own fonts, since they are not + represented using a Latin character set, like the others. See the "Special + Fonts" section, below. + + 💡 Note: Tux Paint provides an alternative input method for entering + characters with the Text tool in some locales. The key comibation(s) listed + can be used to cycle through the supported input methods while the Text + tool is active. + + Setting Your Environment's Locale + + Changing your locale will affect much of your environment. + + As stated above, along with letting you choose the language at runtime + using command-line options ("--lang" and "--locale"), Tux Paint honors the + global locale setting in your environment. + + If you haven't already set your environment's locale, the following will + briefly explain how: + + Linux/Unix Users + + First, be sure the locale you want to use is enabled by editing the file "/ + etc/locale.gen" on your system and then running the program "locale-gen" as + root. + + 💡 Note: Debian users may be able to simply run the command + "dpkg-reconfigure locales" as root to bring up a configuration dialog. + Ubuntu users may be able to run "sudo dpkg-reconfigure localeconf" (the + "localeconf" package may need to be installed first), or you may need to + edit the file "/var/lib/locales/supported.d/local" first, and add locales + they want, from the list found in "/usr/share/i18n/SUPPORTED". + + Then, before running Tux Paint, set your "$LANG" environment variable to + one of the locales listed above. (If you want all programs that can be + translated to be, you may wish to place the following in your login script; + e.g. "~/.profile", "~/.bashrc", "~/.cshrc", etc.) + + For example, in a Bourne Shell (like BASH): + + export LANG=es_ES ; \ + tuxpaint + + And in a C Shell (like TCSH): + + setenv LANG es_ES ; \ + tuxpaint + + Windows Users + + Tux Paint will recognize the current locale and use the appropriate files + by default. So this section is only for people trying different languages. + + The simplest thing to do is to use the "--lang" switch in the shortcut (see + "INSTALL"). However, by using an MSDOS Prompt window, it is also possible + to issue a command like this: + + set LANG=es_ES + + ...which will set the language for the lifetime of that DOS window. + + For something more permanent, you can set an 'environment variable' using + the "System properties" dialogue as follows: + + + Press the "[Windows]+[R]" key combination to open the "Run ..." + dialogue. + + Enter "sysdm.cpl" in the text box and click the "[OK]" button to open + the "System properties" dialogue. + + Select the "Advanced" tab. + + Click the "Environment Variables..." button. + + Edit the value of the parameter "LANG" (create it, if it doesn't + exists). + + Special Fonts + + Some languages require special fonts be installed. These font files (which + are in TrueType format (TTF)), are much too large to include with the Tux + Paint download, and are available separately. (See the table above, under + the "Choosing a Different Language" section.) + + 📜 Note: As of version 0.9.18, Tux Paint uses the "SDL_Pango" library, which + utilizes the "Pango" library to render text in the user interface, rather + than using "SDL_ttf" directly. Unless your copy of Tux Paint was built + without Pango support, special fonts should no longer be necessary. + + When running Tux Paint in a language that requires its own font, Tux Paint + will try to load the font file from its system-wide "fonts" directory + (under a "locale" subdirectory). The name of the file corresponds to the + first two letters in the 'locale' code of the language (e.g., "ko" for + Korean, "ja" for Japanese, "zh_tw" for Traditional Chinese). + + For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., + with the option "--lang korean"), Tux Paint will attempt to load the + following font file: + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + You can download fonts for supported languages from Tux Paint's website, + https://tuxpaint.org/. (Look in the 'Fonts' section under 'Download.') + + Under Unix and Linux, you can use the Makefile that comes with the font to + install the font in the appropriate location. + diff --git a/docs/is_IS.UTF-8/PNG.txt b/docs/is_IS.UTF-8/PNG.txt index e6f68f6da..2f97f4494 100644 --- a/docs/is_IS.UTF-8/PNG.txt +++ b/docs/is_IS.UTF-8/PNG.txt @@ -1,88 +1,92 @@ Tux Paint - version 0.9.31 + version 0.9.31 PNG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - júní 4, 2022 + júní 4, 2022 - About PNGs +About PNGs - 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 - not "lossy" like JPEGs - lossiness allows files to be much smaller, but - introduces 'mistakes' in the image when saved), and supports 24-bit color - (16.7 million colors) as well as a full "alpha channel" - that is, each - pixel can have a varying degree of transparency. +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 not +"lossy" like JPEGs - lossiness allows files to be much smaller, but introduces +'mistakes' in the image when saved), and supports 24-bit color (16.7 million +colors) as well as a full "alpha channel" - that is, each pixel can have a +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) - make it the best choice for Tux Paint. (Tux Paint's support for the PNG - format comes from the Open Source SDL_Image library, which in turn gets it - from the libPNG library.) +These features (openness, losslessness, compression, transparency/alpha) make +it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes +from the Open Source SDL_Image library, which in turn gets it from the libPNG +library.) - Support for many colors allows photo-quality "rubber stamp" images to be - used in Tux Paint, and alpha transparency allows for high-quality brushes. +Support for many colors allows photo-quality "rubber stamp" images to be used +in Tux Paint, and alpha transparency allows for high-quality brushes. How To Make PNGs - The following is a very brief list of ways to create PNGs or convert - existing images into PNGs. +The following is a very brief list of ways to create PNGs or convert existing +images into PNGs. - GIMP & Krita +GIMP & Krita - Excellent tools with which to create PNG images for use in Tux - Paint are GIMP and Krita, both high-quality Open Source - interactive drawing and photo editing programs. + Excellent tools with which to create PNG images for use in Tux Paint are + GIMP and Krita, both high-quality Open Source interactive drawing and photo + 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 - NetPBM - The Portable Bitmap tools (collectively known as - "NetPBM") is a collection of Open Source command-line - tools which convert to and from various formats, - including GIF, TIFF, BMP, PNG, and many more. +Command-line Tools - 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/. + NetPBM - cjpeg/djpeg + The Portable Bitmap tools (collectively known as "NetPBM") is a + collection of Open Source command-line tools which convert to and from + various formats, 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/. + + + + cjpeg/djpeg + + The "cjpeg" and "djpeg" command-line programs convert between the + NetPBM Portable Any Map (PNM) format and JPEGs. 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 https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Macintosh Users + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - The "cjpeg" and "djpeg" command-line programs convert - between the NetPBM Portable Any Map (PNM) format and - JPEGs. 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 - https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Macintosh Users - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/is_IS.UTF-8/README.txt b/docs/is_IS.UTF-8/README.txt index f1ecdd608..857da8241 100644 --- a/docs/is_IS.UTF-8/README.txt +++ b/docs/is_IS.UTF-8/README.txt @@ -1,5 +1,5 @@ Tux Paint - version 0.9.31 + version 0.9.31 A simple drawing program for children @@ -8,1343 +8,1332 @@ júlí 13, 2023 - +------------------------------------------------------+ - |Table of Contents | - |------------------------------------------------------| - |I. About Tux Paint | - |II. Using Tux Paint | - | A. Launching Tux Paint | - | B. Title Screen | - | C. Main Screen | - | D. Available Tools | - | 1. Drawing Tools | - | a. "Paint" Tool (Brush) | - | b. "Stamp" Tool (Rubber Stamps) | - | c. "Lines" Tool | - | d. "Shapes" Tool | - | e. "Text" and "Label" Tools | - | f. "Fill" Tool | - | g. "Magic" Tool (Special Effects) | - | h. "Eraser" Tool | - | 2. Other Controls | - | a. "Undo" and "Redo" Commands | - | b. "New" Command | - | c. "Open" Command | - | d. "Save" Command | - | e. "Print" Command | - | f. "Slides" Command (under "Open") | - | g. "Quit" Command | - | h. Sound Muting | - | E. Controlling Tux Paint | - |III. Loading Other Pictures into Tux Paint | - |IV. Further Reading | - |V. How to Get Help | - |VI. How to Participate | - +------------------------------------------------------+ ++-------------------------------------------------+ +| Table of Contents | +|-------------------------------------------------| +| I. About Tux Paint | +| II. Using Tux Paint | +| A. Launching Tux Paint | +| B. Title Screen | +| C. Main Screen | +| D. Available Tools | +| 1. Drawing Tools | +| a. "Paint" Tool (Brush) | +| b. "Stamp" Tool (Rubber Stamps) | +| c. "Lines" Tool | +| d. "Shapes" Tool | +| e. "Text" and "Label" Tools | +| f. "Fill" Tool | +| g. "Magic" Tool (Special Effects) | +| h. "Eraser" Tool | +| 2. Other Controls | +| a. "Undo" and "Redo" Commands | +| b. "New" Command | +| c. "Open" Command | +| d. "Save" Command | +| e. "Print" Command | +| f. "Slides" Command (under "Open") | +| g. "Quit" Command | +| h. Sound Muting | +| E. Controlling Tux Paint | +| III. Loading Other Pictures into Tux Paint | +| IV. Further Reading | +| V. How to Get Help | +| VI. How to Participate | ++-------------------------------------------------+ - I. About Tux Paint +I. About Tux Paint A. What Is "Tux Paint"? - Tux Paint is a free drawing program designed for young children (kids ages - 3 and up). It has a simple, easy-to-use interface, fun sound effects, and - an encouraging cartoon mascot who helps guide children as they use the - program. It provides a blank canvas and a variety of drawing tools to help - your child be creative. +Tux Paint is a free drawing program designed for young children (kids ages 3 +and up). It has a simple, easy-to-use interface, fun sound effects, and an +encouraging cartoon mascot who helps guide children as they use the program. It +provides a blank canvas and a variety of drawing tools to help your child be +creative. B. Objectives - Easy and Fun - Tux Paint is meant to be a simple drawing program for young - children. It is not meant as a general-purpose drawing tool. It is - meant to be fun and easy to use. Sound effects and a cartoon - character help let the user know what's going on, and keeps them - entertained. There are also extra-large cartoon-style mouse - pointer shapes. +Easy and Fun + Tux Paint is meant to be a simple drawing program for young children. It is + not meant as a general-purpose drawing tool. It is meant to be fun and easy + to use. Sound effects and a cartoon character help let the user know what's + going on, and keeps them entertained. There are also extra-large + cartoon-style mouse pointer shapes. - Extensibility - Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be - dropped in and pulled out. For example, a teacher can drop in a - collection of animal shapes and ask their students to draw an - ecosystem. Each shape can have a sound which is played, and - textual facts which are displayed, when the child selects the - shape. +Extensibility + Tux Paint is extensible. Brushes and 'rubber stamp' shapes can be dropped + in and pulled out. For example, a teacher can drop in a collection of + animal shapes and ask their students to draw an ecosystem. Each shape can + have a sound which is played, and textual facts which are displayed, when + the child selects the shape. - Portability - Tux Paint is portable among various computer platforms: Windows, - Macintosh, Linux, etc. The interface looks the same among them - all. Tux Paint runs suitably well on older systems, and can be - built to run better on slow systems. +Portability + Tux Paint is portable among various computer platforms: Windows, Macintosh, + Linux, etc. The interface looks the same among them all. Tux Paint runs + suitably well on older systems, and can be built to run better on slow + systems. - Simplicity - There is no direct access to the computer's underlying - intricacies. The current image is kept when the program quits, and - reappears when it is restarted. Saving images requires no need to - create filenames or use the keyboard. Opening an image is done by - selecting it from a collection of thumbnails. Access to other - files on the computer is restricted. +Simplicity + There is no direct access to the computer's underlying intricacies. The + current image is kept when the program quits, and reappears when it is + restarted. Saving images requires no need to create filenames or use the + keyboard. Opening an image is done by selecting it from a collection of + thumbnails. Access to other files on the computer is restricted. + +Accessibility + Tux Paint offers a number of accessibility options, including increasing + the size of control buttons, changing the UI font, options to control the + cursor (mouse pointer) using the keyboard or other input devices (joystick, + gamepad, etc.), an on-screen keyboard, and "stick" mouse clicks. - Accessibility - Tux Paint offers a number of accessibility options, including - increasing the size of control buttons, changing the UI font, - options to control the cursor (mouse pointer) using the keyboard - or other input devices (joystick, gamepad, etc.), an on-screen - keyboard, and "stick" mouse clicks. C. License - Tux Paint is an Open Source project, Free Software released under the GNU - General Public License (GPL). It is free, and the 'source code' behind the - program is available. (This allows others to add features, fix bugs, and - use parts of the program in their own GPL'd software.) +Tux Paint is an Open Source project, Free Software released under the GNU +General Public License (GPL). It is free, and the 'source code' behind the +program is available. (This allows others to add features, fix bugs, and use +parts of the program in their own GPL'd software.) - See COPYING.txt for the full text of the GPL license. +See COPYING.txt for the full text of the GPL license. D. What's New in Tux Paint version 0.9.31? - Fuzzy Erasers - Fuzzy-edged round erasers have been added to the Eraser tool +Fuzzy Erasers + Fuzzy-edged round erasers have been added to the Eraser tool - New Magic tools - Loops, Ribbon, Smooth, and Squiggles +New Magic tools + Loops, Ribbon, Smooth, and Squiggles - Create templates from Open dialog - Saved drawings can be turned into templates (used to make new - drawings) via a new option in the Open dialog. (This feature may - be deactivated using the "notemplateexport" simplification - option.) +Create templates from Open dialog + Saved drawings can be turned into templates (used to make new drawings) via + a new option in the Open dialog. (This feature may be deactivated using the + "notemplateexport" simplification option.) - User interface font may be overridden - The font used for the user interface (button labels, dialog - pop-ups, and instructions) can be overridden from its default - ("DejaVu Sans"). (See the "uifont" configuration option. Use - "--listfonts" to see a list of available fonts.) +User interface font may be overridden + The font used for the user interface (button labels, dialog pop-ups, and + instructions) can be overridden from its default ("DejaVu Sans"). (See the + "uifont" configuration option. Use "--listfonts" to see a list of available + fonts.) - File Erase may be disabled - Controls to erase saved work — saved drawings (via the Open - dialog) and exported templates (via the New dialog) — can be - disabled. (See the "noerase" configuration option.) +File Erase may be disabled - "Controlling Tux Paint" documentation - A brief overview of how Tux Paint can be controlled — mouse, - tablet, touchscreen, joystick, and keyboard — has been added to - the README documentation. + Controls to erase saved work — saved drawings (via the Open dialog) and + exported templates (via the New dialog) — can be disabled. (See the + "noerase" configuration option.) - See CHANGES.txt for the complete list of changes. +"Controlling Tux Paint" documentation - II. Using Tux Paint + A brief overview of how Tux Paint can be controlled — mouse, tablet, + touchscreen, joystick, and keyboard — has been added to the README + documentation. + + +See CHANGES.txt for the complete list of changes. + +II. Using Tux Paint A. Launching Tux Paint - 1. Linux/Unix Users +1. Linux/Unix Users - Tux Paint should have placed a launcher icon in your KDE and/or GNOME - menus, under 'Graphics.' +Tux Paint should have placed a launcher icon in your KDE and/or GNOME menus, +under 'Graphics.' - Alternatively, you can run the following command at a shell prompt (e.g., - "$"): +Alternatively, you can run the following command at a shell prompt (e.g., "$"): - $ tuxpaint + $ tuxpaint - If any errors occur, they will be displayed on the terminal (to STDERR). +If any errors occur, they will be displayed on the terminal (to STDERR). - 2. Windows Users +2. Windows Users - [Tux Paint Icon] - Tux Paint +[Tux Paint Icon] + Tux Paint - If you installed Tux Paint on your computer using the 'Tux Paint - Installer,' it will have asked you whether you wanted a 'Start' menu - short-cut, and/or a desktop shortcut. If you agreed, you can simply run - Tux Paint from the 'Tux Paint' section of your 'Start' menu (e.g., under - 'All Programs'), or by double-clicking the 'Tux Paint' icon on your - desktop, if you had the installer place one there. +If you installed Tux Paint on your computer using the 'Tux Paint Installer,' it +will have asked you whether you wanted a 'Start' menu short-cut, and/or a +desktop shortcut. If you agreed, you can simply run Tux Paint from the 'Tux +Paint' section of your 'Start' menu (e.g., under 'All Programs'), or by +double-clicking the 'Tux Paint' icon on your desktop, if you had the installer +place one there. - If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you - used the 'Tux Paint Installer,' but chose not to have shortcuts installed, - you'll need to double-click the "tuxpaint.exe" icon in the "Tux Paint" - folder on your computer. +If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you used +the 'Tux Paint Installer,' but chose not to have shortcuts installed, you'll +need to double-click the "tuxpaint.exe" icon in the "Tux Paint" folder on your +computer. - By default, the 'Tux Paint Installer' will put Tux Paint's folder in - "C:\Program Files\", though you may have changed this when you ran the - installer. +By default, the 'Tux Paint Installer' will put Tux Paint's folder in "C:\ +Program Files\", though you may have changed this when you ran the installer. - If you used the 'ZIP-file' download, Tux Paint's folder will be wherever - you extracted the contents of the ZIP file. +If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you +extracted the contents of the ZIP file. - 3. macOS Users +3. macOS Users - Simply double-click the "Tux Paint" icon. +Simply double-click the "Tux Paint" icon. - [Title screen] +[Title screen] B. Title Screen - When Tux Paint first loads, a title/credits screen will appear. +When Tux Paint first loads, a title/credits screen will appear. - Once loading is complete, press a key or click or tap in the Tux Paint - window to continue. (Or, after about 5 seconds, the title screen will go - away automatically.) +Once loading is complete, press a key or click or tap in the Tux Paint window +to continue. (Or, after about 5 seconds, the title screen will go away +automatically.) C. Main Screen - The main screen is divided into the following sections: +The main screen is divided into the following sections: - [Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, - Eraser, New, Open, Save, Print, Quit] +[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, + New, Open, Save, Print, Quit] +Left Side: Toolbar - Left Side: Toolbar + The toolbar contains the drawing and editing controls. - The toolbar contains the drawing and editing controls. - [Canvas] - Middle: Drawing Canvas + [Canvas] +Middle: Drawing Canvas - The largest part of the screen, in the center, is the drawing - canvas. This is, obviously, where you draw! + The largest part of the screen, in the center, is the drawing canvas. This + is, obviously, where you draw! - 💡 Note: The size of the drawing canvas depends on the size of Tux - Paint. You can change the size of Tux Paint using the Tux Paint - Config. configuration tool, or by other means. See the Options - documentation for more details. + 💡 Note: The size of the drawing canvas depends on the size of Tux Paint. + You can change the size of Tux Paint using the Tux Paint Config. + configuration tool, or by other means. See the Options documentation for + more details. - [Selectors - Brushes, Letters, Shapes, Stamps] - Right Side: Selector - Depending on the current tool, the selector shows different - things. e.g., when the Paint Brush or Line tool is selected, it - shows the various brushes available. When the Rubber Stamp tool is - selected, it shows the different shapes you can use. When the Text - or Label tool is selected, it shows various fonts. + [Selectors - Brushes, Letters, Shapes, Stamps] +Right Side: Selector - [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, - Blue, Purple, Brown, Grey] + Depending on the current tool, the selector shows different things. e.g., + when the Paint Brush or Line tool is selected, it shows the various brushes + available. When the Rubber Stamp tool is selected, it shows the different + shapes you can use. When the Text or Label tool is selected, it shows + various fonts. - Lower: Colors - When the active tool supports colors, a palette of colors choices - will be shown near the bottom of the screen. Click one to choose a - color, and it will be used by the active tool. (For example, the - "Paint" tool will use it as the color to draw with the chosen - brush, and the "Fill" tool will use it as the color to use when - flood-filling an area of the picture.) - On the far right are three special color options: - * Color Picker - The "color picker" (which has an outline of an eye-dropper) - allows you to pick a color found within your drawing. - (A shortcut key is available to access this feature quickly; - see below.) - * Rainbow Palette - The rainbow palette allows you to pick any color by choosing - the hue, saturation, and value of the color you want. A box - on the left displays hundreds of hues — from red at the top - through to violet at the bottom — at hundreds of - saturation/intensity levels — from pale & washed-out on the - left through to pure on the right. A grey vertical bar - provides access to hundreds of value levels — from lighest at - the top through to darkest at the bottom. - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. - You may also set this tool's color to that of other color - choices: - * Whichever built-in color is selected, if any - * The Color Picker's current color - * The Color Mixer's current color - * Color Mixer - The "color mixer" (which has silhouette of a paint palette) - allows you to create colors by blending primary additive - colors — red, yellow, and blue — along with white (to - "tint"), grey (to "tone"), and black (to "shade"). - You may click any button multiple times (for example, red + - red + yellow results in a red-orange color). The ratios of - colors added are shown at the bottom. - You can start over (reset to no colors in your picture) by - clicking the "Clear" button. You can also undo or redo - multiple steps of mixing, in case you made a mistake (without - having to start over). - Click the green checkbox button to select the color, or the - "Back" button to dismiss the pop-up without picking a new - color. + [Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, + Purple, Brown, Grey] +Lower: Colors - ⌨ When the active tool supports colors, a shortcut may be used for - quick access to the "color picker" option. Hold the [Control] key - while clicking, and the color under the mouse cursor will be shown - at the bottom. You may drag around to canvas to find the color you - want. When you release the mouse button, the color under the - cursor will be selected. If you release the mouse outside of the - canvas (e.g., over the "Tools" area), the color selection will be - left unchanged. (This is similar to clicking the "Back" button - that's available when bringing up the "color picker" option via - its button the color palette.) + When the active tool supports colors, a palette of colors choices will be + shown near the bottom of the screen. Click one to choose a color, and it + will be used by the active tool. (For example, the "Paint" tool will use it + as the color to draw with the chosen brush, and the "Fill" tool will use it + as the color to use when flood-filling an area of the picture.) - ⚙ Note: You can define your own colors for Tux Paint. See the - "Options" documentation. + On the far right are three special color options: + + Color Picker + The "color picker" (which has an outline of an eye-dropper) allows you + to pick a color found within your drawing. + (A shortcut key is available to access this feature quickly; see + below.) + + Rainbow Palette + The rainbow palette allows you to pick any color by choosing the hue, + saturation, and value of the color you want. A box on the left displays + hundreds of hues — from red at the top through to violet at the bottom + — at hundreds of saturation/intensity levels — from pale & washed-out + on the left through to pure on the right. A grey vertical bar provides + access to hundreds of value levels — from lighest at the top through to + darkest at the bottom. + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + You may also set this tool's color to that of other color choices: + o Whichever built-in color is selected, if any + o The Color Picker's current color + o The Color Mixer's current color + + Color Mixer + The "color mixer" (which has silhouette of a paint palette) allows you + to create colors by blending primary additive colors — red, yellow, and + blue — along with white (to "tint"), grey (to "tone"), and black (to + "shade"). + You may click any button multiple times (for example, red + red + + yellow results in a red-orange color). The ratios of colors added are + shown at the bottom. + You can start over (reset to no colors in your picture) by clicking the + "Clear" button. You can also undo or redo multiple steps of mixing, in + case you made a mistake (without having to start over). + Click the green checkbox button to select the color, or the "Back" + button to dismiss the pop-up without picking a new color. + + ⌨ When the active tool supports colors, a shortcut may be used for quick + access to the "color picker" option. Hold the [Control] key while clicking, + and the color under the mouse cursor will be shown at the bottom. You may + drag around to canvas to find the color you want. When you release the + mouse button, the color under the cursor will be selected. If you release + the mouse outside of the canvas (e.g., over the "Tools" area), the color + selection will be left unchanged. (This is similar to clicking the "Back" + button that's available when bringing up the "color picker" option via its + button the color palette.) + + ⚙ Note: You can define your own colors for Tux Paint. See the "Options" + documentation. + + + + (Example tip: 'Pick a shape. Click to pick the center, drag, then let go + when it is the size you want. Move around to rotate it, and click to draw + it.') +Bottom: Help Area + + At the very bottom of the screen, Tux, the Linux Penguin, provides tips and + other information while you use Tux Paint. - (Example tip: 'Pick a shape. Click to pick the center, drag, then - let go when it is the size you want. Move around to rotate it, and - click to draw it.') - Bottom: Help Area - At the very bottom of the screen, Tux, the Linux Penguin, provides - tips and other information while you use Tux Paint. D. Available Tools - 1. Drawing Tools - - a. "Paint" Tool (Brush) - - The Paint Brush tool lets you draw freehand, using various brushes - (chosen in the Selector on the right) and colors (chosen in the - Color palette towards the bottom). - - If you hold the mouse button down, and move the mouse, it will - draw as you move. - - Some brushes are animated — they change their shape as you draw - them. A good example of this is the vines brush that ships with - Tux Paint. These brushes will have a small "filmstrip" icon drawn - on their Selector buttons. - - Other brushes are directional — they will draw a different shape - depending on what direction you are painting with them. An example - of this is the arrow brush that ships with Tux Paint. These - brushes have a small 8-way arrow icon drawn on their Selector - buttons. - - Finally, some brushes can be both direction and animated. Examples - of this are the cat and squirrel brushes that ship with Tux Paint. - These brushes will have both the "filmstrip" and 8-way arrow - icons. - - As you draw, a sound is played. The bigger the brush, the lower - the pitch. - - Brush Spacing - - The space between each position where a brush is applied to the - canvas can vary. Some brushes (such as the footprints and - flower) are spaced, by default, far enough apart that they don't - overlap. Other brushes (such as the basic circular ones) are - spaced closely, so they make a continuous stroke. - - The default spacing of brushes may be overridden using by - clicking within the triangular-shaped series of bars at the - bottom right; the larger the bar, the wider the spacing. Brush - spacing affects both tools that use the brushes: the "Paint" - tool and the "Lines" tool. - - ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't - display the brush spacing controls. See the "Options" - documentation. - - b."Stamp" Tool (Rubber Stamps) - - The Stamp tool is like a set of rubber stamps or stickers. It lets - you paste pre-drawn or photographic images (like a picture of a - horse, or a tree, or the moon) in your picture. - - As you move the mouse around the canvas, an outline follows the - mouse, showing where the stamp will be placed, and how big it will - be. Click on the canvas where you wish to place the stamp. - - Stamp Categories - There can be numerous categories of stamps (e.g., - animals, plants, outer space, vehicles, people, - etc.). Use the Left and Right arrows near the bottom - of the Selector to cycle through the collections. - - Stamp Rotation - - Using the rotation toggle button near the bottom - right, you can enable a rotation step when placing - stamps. Once you've placed the stamp, choose the - angle to rotate it by moving the mouse around the - canvas. Click the mouse button again and the stamp - will be added to the drawing. - - ⚙ Note: If "stamp rotation" option is disabled, the - stamp will be drawn on the canvas when you let go of - the mouse button. (There's no rotation step.) See the - "Options" documentation to learn about the "stamp - rotation" ("stamprotation") option. - - 📜 Note: The stamp rotation feature was added to Tux - Paint in version 0.9.29. +1. Drawing Tools - Stamp Controls - - Prior to 'stamping' an image onto your drawing, - various effects can sometimes be applied (depending - on the stamp): - - * Some stamps can be colored or tinted. If the - color palette below the canvas is activated, you - can click the colors to change the tint or color - of the stamp before placing it in the picture. - * Stamps can be shrunk and expanded, by clicking - within the triangular-shaped series of bars at - the bottom right; the larger the bar, the larger - the stamp will appear in your picture. - * Many stamps may be flipped vertically, or - displayed as a mirror-image, using the control - buttons at the bottom right. +a. "Paint" Tool (Brush) - ⚙ Note: If the "nostampcontrols" option is set, Tux - Paint won't display the Rotation, Mirror, Flip, or - sizing controls for stamps. See the "Options" - documentation. - - Stamp Sounds - - Different stamps can have different sound effects - and/or descriptive (spoken) sounds. Buttons in the - Help Area at the lower left (near Tux, the Linux - penguin) allow you to re-play the sound effects and - descriptive sounds for the currently-selected stamp. - - c."Lines" Tool - - This tool lets you draw straight lines using the various brushes - and colors you normally use with the Paint Brush. - - Click the mouse and hold it to choose the starting point of the - line. As you move the mouse around, a thin 'rubber-band' line will - show where the line will be drawn. At the bottom, you'll see the - angle of your line, in degrees. A line going straight to the right - is 0°, a line going straight up is 90°, a line going straight left - is 180°, a line going straight down is 270°, and so on. - - Let go of the mouse to complete the line. A "sproing!" sound will - play. - - Some brushes are animated, and will show a pattern of shapes along - the line. Others are directional, and will show a different shape - depending on the angle of the brush. And finally some are both - animated and directional. See "Paint", above, to learn more. - - Different brushes have different spacing, leaving either a series - of individual shapes, or a continuous stroke of the brush shape. - Brush spacing may be adjusted. See the brush spacing section of - the "Paint" tool, above, to learn more. - - d."Shapes" Tool - - This tool lets you draw some simple filled, and un-filled shapes. - - Select a shape from the selector on the right (circle, square, - oval, etc.). - - Use the options at the bottom right to choose the shape tool's - behavior: - - Shapes from center - The shape will expand from where you initially - clicked, and will be centered around that position. - - 📜 This was Tux Paint's only behavior through version - 0.9.24.) - - Shapes from corner - The shape will extend with one corner starting from - where you initially clicked. This is the default - method of most other traditional drawing software. - - 📜 This option was added starting with Tux Paint - version 0.9.25. - - ⚙ Note: If shape controls are disabled (e.g., with the - "noshapecontrols" option), the controls will not be presented, and - the "shapes from center" method will be used. - - In the canvas, click the mouse and hold it to stretch the shape - out from where you clicked. Some shapes can change proportion - (e.g., rectangle and oval may be wider than tall, or taller than - wide), others cannot (e.g., square and circle). - - For shapes that can change proportion, the aspect ratio of the - shape will be shown at the bottom. For example: "1:1" will be - shown if it is "square" (as tall as it is wide); "2:1" if it is - either twice as wide as it is tall, or twice as tall as it is - wide; and so on. - - Let go of the mouse when you're done stretching. - - Normal Shapes Mode - - Now you can move the mouse around the canvas to - rotate the shape. The angle your shape is rotated - will be shown at the bottom, in degrees (similar to - the "Lines" tool, described above). - - Click the mouse button again and the shape will be - drawn in the current color. - - Simple Shapes Mode - If the "simple shapes" option is enabled, the shape - will be drawn on the canvas when you let go of the - mouse button. (There's no rotation step.) - - ⚙ See the "Options" documentation to learn about the - "simple shapes" ("simpleshapes") option. - - e."Text" and "Label" Tools - - Choose a font (from the 'Letters' available on the right) and a - color (from the color palette near the bottom). You may also apply - a bold, and/or an italic styling effect to the text. Click on the - screen and a cursor will appear. Type text and it will show up on - the screen. (You can change the font, color, and styling while - entering the text, before it is applied to the canvas.) - - Press [Enter] or [Return] and the text will be drawn onto the - picture and the cursor will move down one line. - - Alternatively, press [Tab] and the text will be drawn onto the - picture, but the cursor will move to the right of the text, rather - than down a line, and to the left. (This can be useful to create a - line of text with mixed colors, fonts, styles and sizes.) - - Clicking elsewhere in the picture while the text entry is still - active causes the current line of text to move to that location - (where you can continue editing it). - - "Text" versus "Label" - - The Text tool is the original text-entry tool in Tux - Paint. Text entered using this tool can't be modified - or moved later, since it becomes part of the drawing. - However, because the text becomes part of the - picture, it can be drawn over or modified using Magic - tool effects (e.g., smudged, tinted, embossed, etc.) - - When using the Label tool (which was added to Tux - Paint in version 0.9.22), the text 'floats' over the - image, and the details of the label (the text, the - position of the label, the font choice and the color) - get stored separately. This allows the label to be - repositioned or edited later. - - To edit a label, click the label selection button. - All labels in the drawing will appear highlighted. - Click one — or use the [Tab] key to cycle through all - the labels, and the [Enter] or [Return] key to select - one — and you may then edit the label. (Use they - [Backspace] key to erase characters, and other keys - to add text to the label; click in the canvas to - reposition the label; click in the palette to change - the color of the text in the label; etc.) - - You may "apply" a label to the canvas, painting the - text into the picture as if it had been added using - the Text tool, by clicking the label application - button. (This feature was added in Tux Paint version - 0.9.28.) All labels in the drawing will appear - highlighted, and you select one just as you do when - selecting a label to edit. The chosen label will be - removed, and the text will be added directly to the - canvas. - - ⚙ The Label tool can be disabled (e.g., by selecting - "Disable 'Label' Tool" in Tux Paint Config. or - running Tux Paint with the "nolabel" option). - - International Character Input - - Tux Paint allows inputting characters in different - languages. Most Latin characters (A-Z, ñ, è, etc.) - can by entered directly. Some languages require that - Tux Paint be switched into an alternate input mode - before entering, and some characters must be composed - using numerous keypresses. - - When Tux Paint's locale is set to one of the - languages that provide alternate input modes, a key - is used to cycle through normal (Latin character) and - locale-specific mode or modes. - - Currently supported locales, the input methods - available, and the key to toggle or cycle modes, are - listed below. - - * Japanese — Romanized Hiragana and Romanized - Katakana — right [Alt] key or left [Alt] key - * Korean — Hangul 2-Bul — right [Alt] key or left - [Alt] key - * Traditional Chinese — right [Alt] key or left - [Alt] key - * Thai — right [Alt] key - - 💡 Note: Many fonts do not include all characters for - all languages, so sometimes you'll need to change - fonts to see the characters you're trying to type. - - On-screen Keyboard - - An optional on-screen keyboard is available for the - Text and Label tools, which can provide a variety of - layouts and character composition (e.g., composing - "a" and "e" into "æ"). - - ⚙ See the "Options" and "Extending Tux Paint" - documentation for more information. - - f."Fill" Tool - - The 'Fill' tool 'flood-fills' a contiguous area of your drawing - with a color of your choice. Three fill options are offered: - * Solid — click once to fill an area with a solid color. - * Brush — click and drag to fill an area with a solid color - using freehand painting. - * Linear — click and then drag to fill the area with color that - fades away (a gradient) towards where you drag the mouse. - * Radial — click once to fill an area with a color that fades - away (a gradient) radially, centered on where you clicked. - * Shaped — click once to fill an area with a color that fades - away (a gradient), following the contours of the shape you're - filling. - - 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see - below). Prior to Tux Paint 0.9.26, the "Fill" tool only offered - the 'Solid' method of filling. 'Shaped' fill was introduced in Tux - Paint 0.9.29. - - g."Magic" Tool (Special Effects) - - The Magic tool is actually a set of special tools. Select one of - the 'magic' effects from the selector on the right. Then, - depending on the tool, you can either click and drag around the - picture, and/or simply click the picture once, to apply the - effect. - - Magic Controls - - If the tool can be used by clicking and dragging, a 'painting' - button will be available on the left, below the list of Magic - tools on the right side of the screen. If the tool can affect - the entire picture at once, an 'entire picture' button will be - available on the right. - - ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't - display the painting or entire picture controls. See the - "Options" documentation. - - 💡 If the magic controls are disabled, the Magic plugin may make - separate tools available, one for painting and one that affects - the entire pictre. - - Magic Sizing - - Some tools offer different sizing options. If so, a slider will - appear at the bottom right side of the screen. This may affect - the radius of a special effect (e.g., Darken) or painted object - (e.g., Patterns), or other attributes (e.g., large versus small - Brick shapes). - - ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't - display the sizing controls. See the "Options" documentation. - - 💡 If the sizing option is disabled, the Magic plugin may simply - offer a default size (e.g., Patterns), or it may make separate - tools available with different pre-set sizes (e.g., Bricks and - Googly Eyes). - - 📜 This option was added starting with Tux Paint version 0.9.30. - - See the instructions for each Magic tool (in the 'magic-docs' - folder). - - h."Eraser" Tool - - This tool is similar to the Paint Brush. Wherever you click (or - click and drag), the picture will be erased. (This may be white, - some other color, or to a background picture, depending on the - picture.) - - A number of eraser sizes are available, with both square and round - shapes. Fuzzy-edged round shapes are also available. - - As you move the mouse around, a square outline follows the - pointer, showing what part of the picture will be erased to white. - - As you erase, a 'squeaky clean' eraser wiping sound is played. - - ⌨ Hold the [X] key while clicking for quick access to a small - sharp round eraser (not available when the Text or Label tools are - selected, when you're in the process of rotating a stamp or shape, - or when using an interactive magic tool). Release the mouse to - return to your currently-selected tool. - - 2. Other Controls - - a."Undo" and "Redo" Commands - - Clicking the "Undo" button will undo (revert) the last drawing - action. You can even undo more than once! - - ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to - Undo. - - Clicking the "Redo" button will redo the drawing action you just - un-did via the "Undo" command. - - As long as you don't draw again, you can redo as many times as you - had undone! - - ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to - Redo. - - b."New" Command - - Clicking the 'New' button will start a new drawing. A dialog will - appear where you may choose to start a new picture using a solid - background color, or using a 'Starter' or 'Template' image (see - below). You will first be asked whether you really want to do - this. - - ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to - start a new drawing. - - Special Solid Background Color Choices - Along with the preset solid colors, you can also - choose colors using a rainbow palette or a "color - mixer". These operate identically to the options - found in the color palette shown below the canvas - when drawing a picture. See Main Screen > Lower: - Colors > Special color options for details. - - 'Starter' & Template Images - * 'Starters' can behave like a page from a - coloring book — a black-and-white outline of a - picture, which you can then color in, and the - black outline remains intact — or like a 3D - photograph, where you draw in between a - foreground and background layer. - * 'Templates' are similar, but simply provide a - background drawing to work off of. Unlike - 'Starters', there is no layer that remains in - the foreground of anything you draw in the - picture. + The Paint Brush tool lets you draw freehand, using various brushes (chosen + in the Selector on the right) and colors (chosen in the Color palette + towards the bottom). - When using the 'Eraser' tool, the original image from - the 'Starter' or 'Template' will reappear. The 'Flip' - and 'Mirror' Magic tools affect the orientation of - the 'Starter' or 'Template', as well. + If you hold the mouse button down, and move the mouse, it will draw as you + move. - When you load a 'Starter' or 'Template', draw on it, - and then click 'Save,' it creates a new picture file - — it doesn't overwrite the original, so you can use - it again later (by accessing it from the 'New' - dialog). + Some brushes are animated — they change their shape as you draw them. A + good example of this is the vines brush that ships with Tux Paint. These + brushes will have a small "filmstrip" icon drawn on their Selector buttons. - ⚙ You can create your own 'Starter' and Template - images. See the Extending Tux Paint documentation's - sections on 'Starters' and Templates. + Other brushes are directional — they will draw a different shape depending + on what direction you are painting with them. An example of this is the + arrow brush that ships with Tux Paint. These brushes have a small 8-way + arrow icon drawn on their Selector buttons. - 💡 You can also convert your saved drawings into - Templates directly within Tux Paint, from the 'Open' - dialog. See "Open", below. + Finally, some brushes can be both direction and animated. Examples of this + are the cat and squirrel brushes that ship with Tux Paint. These brushes + will have both the "filmstrip" and 8-way arrow icons. - Erasing Exported Template Images + As you draw, a sound is played. The bigger the brush, the lower the pitch. - If you've selected a Template in your personal - templates folder, and it was created from within Tux - Paint (using the "Template" button in the "Open" - dialog), you may remove it from within Tux Paint, - too. An 'Erase' (trash can) button will appear at the - lower right of the list. Click it to erase the - selected template. (You will be asked to confirm.) + Brush Spacing - 💡 Note: On Linux, Windows, and macOS, the picture - will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you - change your mind). - ⚙ Note: The 'Erase' button may be disabled, via the - "noerase" option. + The space between each position where a brush is applied to the canvas + can vary. Some brushes (such as the footprints and flower) are spaced, + by default, far enough apart that they don't overlap. Other brushes + (such as the basic circular ones) are spaced closely, so they make a + continuous stroke. - ⚙ Note: The solid colors can be placed at the end of the 'New' - dialog (below the Starters and Templates), via the "newcolorslast" - option. + The default spacing of brushes may be overridden using by clicking + within the triangular-shaped series of bars at the bottom right; the + larger the bar, the wider the spacing. Brush spacing affects both tools + that use the brushes: the "Paint" tool and the "Lines" tool. - c."Open" Command + ⚙ Note: If the "nobrushspacing" option is set, Tux Paint won't display + the brush spacing controls. See the "Options" documentation. - This shows you a list of all of the pictures you've saved. If - there are more than can fit on the screen, use the up and down - arrows at the top and bottom of the list to scroll through the - list of pictures. - Click a picture to select it, and then... - * Click the green 'Open' button at the lower left of the list - to load the selected picture. You will then be able to edit - it. - (Alternatively, you can double-click a picture's icon to load - it.) +b."Stamp" Tool (Rubber Stamps) - 💡 If choose to open a picture, and your current drawing - hasn't been saved, you will be prompted as to whether you - want to save it or not. (See "Save," below.) + The Stamp tool is like a set of rubber stamps or stickers. It lets you + paste pre-drawn or photographic images (like a picture of a horse, or a + tree, or the moon) in your picture. - * Click the brown 'Erase' (trash can) button at the lower right - of the list to erase the selected picture. (You will be asked - to confirm.) + As you move the mouse around the canvas, an outline follows the mouse, + showing where the stamp will be placed, and how big it will be. Click on + the canvas where you wish to place the stamp. - 📜 Note: On Linux (as of version 0.9.22), Windows (as of - version 0.9.27), and macOS (as of version 0.9.29), the - picture will be placed in your desktop's trash can / recycle - bin (where you may recover and restore it, if you change your - mind). + Stamp Categories + There can be numerous categories of stamps (e.g., animals, plants, + outer space, vehicles, people, etc.). Use the Left and Right arrows + near the bottom of the Selector to cycle through the collections. - ⚙ Note: The 'Erase' button may be disabled, via the "noerase" - option. + Stamp Rotation - * Click the 'Export' button near the lower right to export the - selected picture to your export folder. (e.g., - "~/Pictures/TuxPaint/") + Using the rotation toggle button near the bottom right, you can enable + a rotation step when placing stamps. Once you've placed the stamp, + choose the angle to rotate it by moving the mouse around the canvas. + Click the mouse button again and the stamp will be added to the + drawing. - From the "Open" screen you can also: - * Click the blue 'Slides' (slide projector) button at the lower - left to go to slideshow mode. See "Slides", below, for - details. + ⚙ Note: If "stamp rotation" option is disabled, the stamp will be drawn + on the canvas when you let go of the mouse button. (There's no rotation + step.) See the "Options" documentation to learn about the "stamp + rotation" ("stamprotation") option. - * Click the blue 'Template' button at the lower left to go to - convert the selected picture into a new template, which can - be used as the basis for new drawings. + 📜 Note: The stamp rotation feature was added to Tux Paint in version + 0.9.29. - 📜 Note: The Template creation feature was added to Tux Paint - in version 0.9.31. To learn how to create Templates outside - of Tux Paint, see Extending Tux Paint - ⚙ The Template creation feature can be disabled (e.g., by - selecting "Disable 'Make Template'" in Tux Paint Config. or - running Tux Paint with the "notemplateexport" option). - * Click the red 'Back' arrow button at the lower right of the - list to cancel and return to the picture you were drawing. + Stamp Controls - ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to - bring up the 'Open' dialog. + Prior to 'stamping' an image onto your drawing, various effects can + sometimes be applied (depending on the stamp): - d."Save" Command + o Some stamps can be colored or tinted. If the color palette below + the canvas is activated, you can click the colors to change the + tint or color of the stamp before placing it in the picture. + o Stamps can be shrunk and expanded, by clicking within the + triangular-shaped series of bars at the bottom right; the larger + the bar, the larger the stamp will appear in your picture. + o Many stamps may be flipped vertically, or displayed as a + mirror-image, using the control buttons at the bottom right. - This saves your current picture. + ⚙ Note: If the "nostampcontrols" option is set, Tux Paint won't display + the Rotation, Mirror, Flip, or sizing controls for stamps. See the " + Options" documentation. - If you haven't saved it before, it will create a new entry in the - list of saved images. (i.e., it will create a new file) - 💡 Note: It won't ask you anything (e.g., for a filename). It will - simply save the picture, and play a "camera shutter" sound effect. - If you have saved the picture before, or this is a picture you - just loaded using the "Open" command, you will first be asked - whether you want to save over the old version, or create a new - entry (a new file). + Stamp Sounds - ⚙ Note: If either the "saveover" or "saveovernew" options are set, - it won't ask before saving over. See the "Options" documentation. + Different stamps can have different sound effects and/or descriptive + (spoken) sounds. Buttons in the Help Area at the lower left (near Tux, + the Linux penguin) allow you to re-play the sound effects and + descriptive sounds for the currently-selected stamp. - ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to - save. - e."Print" Command - Click this button and your picture will be printed! - On most platforms, you can also hold the [Alt] key (called - [Option] on Macs) while clicking the 'Print' button to get a - printer dialog. Note that this may not work if you're running Tux - Paint in fullscreen mode. See below. - Disabling Printing - The "noprint" option can be set, which will disable - Tux Paint's 'Print' button. +c."Lines" Tool - ⚙ See the "Options" documentation. + This tool lets you draw straight lines using the various brushes and colors + you normally use with the Paint Brush. - Restricting Printing + Click the mouse and hold it to choose the starting point of the line. As + you move the mouse around, a thin 'rubber-band' line will show where the + line will be drawn. At the bottom, you'll see the angle of your line, in + degrees. A line going straight to the right is 0°, a line going straight up + is 90°, a line going straight left is 180°, a line going straight down is + 270°, and so on. - The "printdelay" option can be set, which will only - allow occasional printing — once every so many - seconds, as configured by you. + Let go of the mouse to complete the line. A "sproing!" sound will play. - For example, with "printdelay=60" in Tux Paint's - configuration file, printing can only occur once per - minute (60 seconds). + Some brushes are animated, and will show a pattern of shapes along the + line. Others are directional, and will show a different shape depending on + the angle of the brush. And finally some are both animated and directional. + See "Paint", above, to learn more. - ⚙ See the "Options" documentation. + Different brushes have different spacing, leaving either a series of + individual shapes, or a continuous stroke of the brush shape. Brush spacing + may be adjusted. See the brush spacing section of the "Paint" tool, above, + to learn more. - Printing Commands - (Linux and Unix only) - Tux Paint prints by generating a PostScript - representation of the drawing and sending it to an - external program. By default, the program is: +d."Shapes" Tool - lpr + This tool lets you draw some simple filled, and un-filled shapes. - This command can be changed by setting a - "printcommand" option in Tux Paint's configuration - file. + Select a shape from the selector on the right (circle, square, oval, etc.). - An alternative print command can be invoked by - holding the "[Alt]" key on the keyboard while - clicking clicking the 'Print' button, as long as - you're not in fullscreen mode, an alternative program - is run. By default, the program is KDE's graphical - print dialog: + Use the options at the bottom right to choose the shape tool's behavior: - kprinter + Shapes from center + The shape will expand from where you initially clicked, and will be + centered around that position. - This command can be changed by setting a - "altprintcommand" option in Tux Paint's configuration - file. + 📜 This was Tux Paint's only behavior through version 0.9.24.) - ⚙ See the "Options" documentation. - Printer Settings - (Windows and macOS) + Shapes from corner + The shape will extend with one corner starting from where you initially + clicked. This is the default method of most other traditional drawing + software. - By default, Tux Paint simply prints to the default - printer with default settings when the 'Print' button - is pushed. + 📜 This option was added starting with Tux Paint version 0.9.25. - However, if you hold the [Alt] (or [Option]) key on - the keyboard while clicking the 'Print' button, as - long as you're not in fullscreen mode, your operating - system's printer dialog will appear, where you can - change the settings. - You can have the printer configuration changes stored - between Tux Paint sessions by setting the "printcfg" - option. - If the "printcfg" option is used, printer settings - will be loaded from the file "printcfg.cfg" in your - personal folder (see below). Any changes will be - saved there as well. - ⚙ See the "Options" documentation. + ⚙ Note: If shape controls are disabled (e.g., with the "noshapecontrols" + option), the controls will not be presented, and the "shapes from center" + method will be used. - Printer Dialog Options + In the canvas, click the mouse and hold it to stretch the shape out from + where you clicked. Some shapes can change proportion (e.g., rectangle and + oval may be wider than tall, or taller than wide), others cannot (e.g., + square and circle). - By default, Tux Paint only shows the printer dialog - (or, on Linux/Unix, runs the "altprintcommand"; e.g., - "kprinter" instead of "lpr") if the [Alt] (or - [Option]) key is held while clicking the 'Print' - button. + For shapes that can change proportion, the aspect ratio of the shape will + be shown at the bottom. For example: "1:1" will be shown if it is "square" + (as tall as it is wide); "2:1" if it is either twice as wide as it is tall, + or twice as tall as it is wide; and so on. - However, this behavior can be changed. You can have - the printer dialog always appear by using - "--altprintalways" on the command-line, or - "altprint=always" in Tux Paint's configuration file. - Conversely, you can prevent the [Alt]/[Option] key - from having any effect by using "--altprintnever", or - "altprint=never". + Let go of the mouse when you're done stretching. - ⚙ See the "Options" documentation. + Normal Shapes Mode - f."Slides" Command (under "Open") + Now you can move the mouse around the canvas to rotate the shape. The + angle your shape is rotated will be shown at the bottom, in degrees + (similar to the "Lines" tool, described above). - The 'Slides' button is available in the 'Open' dialog. It can be - used to play a simple animation within Tux Paint, or a slideshow - of pictures. It can also export an animated GIF based on the - chosen images. + Click the mouse button again and the shape will be drawn in the current + color. - Chosing pictures - When you enter the 'Slides' section of Tux Paint, it - displays a list of your saved files, just like the - 'Open' dialog. - Click each of the images you wish to display in a - slideshow-style presentation, one by one. A digit - will appear over each image, letting you know in - which order they will be displayed. + Simple Shapes Mode + If the "simple shapes" option is enabled, the shape will be drawn on + the canvas when you let go of the mouse button. (There's no rotation + step.) - You can click a selected image to unselect it (take - it out of your slideshow). Click it again if you wish - to add it to the end of the list. + ⚙ See the "Options" documentation to learn about the "simple shapes" + ("simpleshapes") option. - Set playback speed - A sliding scale at the lower left of the screen (next - to the 'Play' button) can be used to adjust the speed - of the slideshow or animated GIF, from slowest to - fastest. Choose the leftmost setting to disable - automatic advancement during playback within Tux - Paint — you will need to press a key or click to go - to the next slide (see below). - 💡 Note: The slowest setting does not automatically - advance through the slides. Use it for when you want - to step through them manually. (This does not apply - to an exported animated GIF.) - Playback in Tux Paint - To play a slideshow within Tux Paint, click the - 'Play' button. - 💡 Note: If you hadn't selected any images, then all - of your saved images will be played in the slideshow! +e."Text" and "Label" Tools - During the slideshow, press [Space], [Enter] or - [Return], or the [Right arrow] — or click the 'Next' - button at the lower left — to manually advance to the - next slide. Press [Left arrow] to go back to the - previous slide. + Choose a font (from the 'Letters' available on the right) and a color (from + the color palette near the bottom). You may also apply a bold, and/or an + italic styling effect to the text. Click on the screen and a cursor will + appear. Type text and it will show up on the screen. (You can change the + font, color, and styling while entering the text, before it is applied to + the canvas.) - Press [Escape], or click the 'Back' button at the - lower right, to exit the slideshow and return to the - slideshow image selection screen. + Press [Enter] or [Return] and the text will be drawn onto the picture and + the cursor will move down one line. - Exporting an animated GIF + Alternatively, press [Tab] and the text will be drawn onto the picture, but + the cursor will move to the right of the text, rather than down a line, and + to the left. (This can be useful to create a line of text with mixed + colors, fonts, styles and sizes.) - Click the 'GIF Export' button near the lower right to - have Tux Paint generate an animated GIF file based on - the selected images. + Clicking elsewhere in the picture while the text entry is still active + causes the current line of text to move to that location (where you can + continue editing it). - 💡 Note: At least two images must be selected. (To - export a single image, use the 'Export' option from - the main 'Open' dialog.) If no images are selected, - Tux Paint will not attempt to generate a GIF based on - all saved images. + "Text" versus "Label" - Pressing [Escape] during the export process will - abort the process, and return you to the 'Slideshow' - dialog. + The Text tool is the original text-entry tool in Tux Paint. Text + entered using this tool can't be modified or moved later, since it + becomes part of the drawing. However, because the text becomes part of + the picture, it can be drawn over or modified using Magic tool effects + (e.g., smudged, tinted, embossed, etc.) - Click 'Back' in the slideshow image selection screen to return to - the 'Open' dialog. + When using the Label tool (which was added to Tux Paint in version + 0.9.22), the text 'floats' over the image, and the details of the label + (the text, the position of the label, the font choice and the color) + get stored separately. This allows the label to be repositioned or + edited later. - g."Quit" Command + To edit a label, click the label selection button. All labels in the + drawing will appear highlighted. Click one — or use the [Tab] key to + cycle through all the labels, and the [Enter] or [Return] key to select + one — and you may then edit the label. (Use they [Backspace] key to + erase characters, and other keys to add text to the label; click in the + canvas to reposition the label; click in the palette to change the + color of the text in the label; etc.) - Clicking the 'Quit' button, closing the Tux Paint window, or - pushing the [Escape] key will quit Tux Paint. + You may "apply" a label to the canvas, painting the text into the + picture as if it had been added using the Text tool, by clicking the + label application button. (This feature was added in Tux Paint version + 0.9.28.) All labels in the drawing will appear highlighted, and you + select one just as you do when selecting a label to edit. The chosen + label will be removed, and the text will be added directly to the + canvas. - You will first be prompted as to whether you really want to quit. + ⚙ The Label tool can be disabled (e.g., by selecting "Disable 'Label' + Tool" in Tux Paint Config. or running Tux Paint with the "nolabel" + option). - If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new - image, you will then be asked if you want to save over the old - version, or create a new entry. (See "Save" above.) - ⚙ Note: If the image is saved, it will be reloaded automatically - the next time you run Tux Paint -- unless the "startblank" option - is set. - ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the - [Escape] key, may be disabled, via the "noquit" option. + International Character Input - In that case, the "window close" button on Tux Paint's title bar - (if not in fullscreen mode) or the [Alt] + [F4] key sequence may - be used to quit. + Tux Paint allows inputting characters in different languages. Most + Latin characters (A-Z, ñ, è, etc.) can by entered directly. Some + languages require that Tux Paint be switched into an alternate input + mode before entering, and some characters must be composed using + numerous keypresses. - If neither of those are possible, the key sequence of [Shift] + - [Control / ⌘] + [Escape] may be used to quit. + When Tux Paint's locale is set to one of the languages that provide + alternate input modes, a key is used to cycle through normal (Latin + character) and locale-specific mode or modes. - ⚙ See the "Options" documentation. + Currently supported locales, the input methods available, and the key + to toggle or cycle modes, are listed below. - h.Sound Muting + o Japanese — Romanized Hiragana and Romanized Katakana — right [Alt] + key or left [Alt] key + o Korean — Hangul 2-Bul — right [Alt] key or left [Alt] key + o Traditional Chinese — right [Alt] key or left [Alt] key + o Thai — right [Alt] key + + 💡 Note: Many fonts do not include all characters for all languages, so + sometimes you'll need to change fonts to see the characters you're + trying to type. + + + + On-screen Keyboard + + An optional on-screen keyboard is available for the Text and Label + tools, which can provide a variety of layouts and character composition + (e.g., composing "a" and "e" into "æ"). + + ⚙ See the "Options" and "Extending Tux Paint" documentation for more + information. + + + + + + +f."Fill" Tool + + The 'Fill' tool 'flood-fills' a contiguous area of your drawing with a + color of your choice. Three fill options are offered: + + Solid — click once to fill an area with a solid color. + + Brush — click and drag to fill an area with a solid color using + freehand painting. + + Linear — click and then drag to fill the area with color that fades + away (a gradient) towards where you drag the mouse. + + Radial — click once to fill an area with a color that fades away (a + gradient) radially, centered on where you clicked. + + Shaped — click once to fill an area with a color that fades away (a + gradient), following the contours of the shape you're filling. + + 📜 Note: Prior to Tux Paint 0.9.24, "Fill" was a Magic tool (see below). + Prior to Tux Paint 0.9.26, the "Fill" tool only offered the 'Solid' method + of filling. 'Shaped' fill was introduced in Tux Paint 0.9.29. + + + +g."Magic" Tool (Special Effects) + + The Magic tool is actually a set of special tools. Select one of the + 'magic' effects from the selector on the right. Then, depending on the + tool, you can either click and drag around the picture, and/or simply click + the picture once, to apply the effect. + + Magic Controls + + + If the tool can be used by clicking and dragging, a 'painting' button + will be available on the left, below the list of Magic tools on the + right side of the screen. If the tool can affect the entire picture at + once, an 'entire picture' button will be available on the right. + + ⚙ Note: If the "nomagiccontrols" option is set, Tux Paint won't display + the painting or entire picture controls. See the "Options" + documentation. + + 💡 If the magic controls are disabled, the Magic plugin may make + separate tools available, one for painting and one that affects the + entire pictre. + + Magic Sizing + + + Some tools offer different sizing options. If so, a slider will appear + at the bottom right side of the screen. This may affect the radius of a + special effect (e.g., Darken) or painted object (e.g., Patterns), or + other attributes (e.g., large versus small Brick shapes). + + ⚙ Note: If the "nomagicsizes" option is set, Tux Paint won't display + the sizing controls. See the "Options" documentation. + + 💡 If the sizing option is disabled, the Magic plugin may simply offer a + default size (e.g., Patterns), or it may make separate tools available + with different pre-set sizes (e.g., Bricks and Googly Eyes). + + 📜 This option was added starting with Tux Paint version 0.9.30. + + See the instructions for each Magic tool (in the 'magic-docs' folder). + + + +h."Eraser" Tool + + This tool is similar to the Paint Brush. Wherever you click (or click and + drag), the picture will be erased. (This may be white, some other color, or + to a background picture, depending on the picture.) + + A number of eraser sizes are available, with both square and round shapes. + Fuzzy-edged round shapes are also available. + + As you move the mouse around, a square outline follows the pointer, showing + what part of the picture will be erased to white. + + As you erase, a 'squeaky clean' eraser wiping sound is played. + + ⌨ Hold the [X] key while clicking for quick access to a small sharp round + eraser (not available when the Text or Label tools are selected, when + you're in the process of rotating a stamp or shape, or when using an + interactive magic tool). Release the mouse to return to your + currently-selected tool. + + + + +2. Other Controls + +a."Undo" and "Redo" Commands + + Clicking the "Undo" button will undo (revert) the last drawing action. You + can even undo more than once! + + ⌨ Note: You can also press [Control / ⌘] + [Z] on the keyboard to Undo. + + Clicking the "Redo" button will redo the drawing action you just un-did via + the "Undo" command. + + As long as you don't draw again, you can redo as many times as you had + undone! + + ⌨ Note: You can also press [Control / ⌘] + [R] on the keyboard to Redo. + + + +b."New" Command + + Clicking the 'New' button will start a new drawing. A dialog will appear + where you may choose to start a new picture using a solid background color, + or using a 'Starter' or 'Template' image (see below). You will first be + asked whether you really want to do this. + + ⌨ Note: You can also press [Control / ⌘] + [N] on the keyboard to start a + new drawing. + + Special Solid Background Color Choices + Along with the preset solid colors, you can also choose colors using a + rainbow palette or a "color mixer". These operate identically to the + options found in the color palette shown below the canvas when drawing + a picture. See Main Screen > Lower: Colors > Special color options for + details. + + 'Starter' & Template Images + o 'Starters' can behave like a page from a coloring book — a + black-and-white outline of a picture, which you can then color in, + and the black outline remains intact — or like a 3D photograph, + where you draw in between a foreground and background layer. + o 'Templates' are similar, but simply provide a background drawing to + work off of. Unlike 'Starters', there is no layer that remains in + the foreground of anything you draw in the picture. + + When using the 'Eraser' tool, the original image from the 'Starter' or + 'Template' will reappear. The 'Flip' and 'Mirror' Magic tools affect + the orientation of the 'Starter' or 'Template', as well. + + When you load a 'Starter' or 'Template', draw on it, and then click + 'Save,' it creates a new picture file — it doesn't overwrite the + original, so you can use it again later (by accessing it from the 'New' + dialog). + + ⚙ You can create your own 'Starter' and Template images. See the + Extending Tux Paint documentation's sections on 'Starters' and + Templates. + + 💡 You can also convert your saved drawings into Templates directly + within Tux Paint, from the 'Open' dialog. See "Open", below. + + + + Erasing Exported Template Images + + If you've selected a Template in your personal templates folder, and it + was created from within Tux Paint (using the "Template" button in the + "Open" dialog), you may remove it from within Tux Paint, too. An + 'Erase' (trash can) button will appear at the lower right of the list. + Click it to erase the selected template. (You will be asked to + confirm.) + + 💡 Note: On Linux, Windows, and macOS, the picture will be placed in + your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + + + ⚙ Note: The solid colors can be placed at the end of the 'New' dialog + (below the Starters and Templates), via the "newcolorslast" option. + + + +c."Open" Command + + This shows you a list of all of the pictures you've saved. If there are + more than can fit on the screen, use the up and down arrows at the top and + bottom of the list to scroll through the list of pictures. + + Click a picture to select it, and then... + + Click the green 'Open' button at the lower left of the list to load the + selected picture. You will then be able to edit it. + + (Alternatively, you can double-click a picture's icon to load it.) + + 💡 If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.) + + + Click the brown 'Erase' (trash can) button at the lower right of the + list to erase the selected picture. (You will be asked to confirm.) + + 📜 Note: On Linux (as of version 0.9.22), Windows (as of version + 0.9.27), and macOS (as of version 0.9.29), the picture will be placed + in your desktop's trash can / recycle bin (where you may recover and + restore it, if you change your mind). + + ⚙ Note: The 'Erase' button may be disabled, via the "noerase" option. + + + Click the 'Export' button near the lower right to export the selected + picture to your export folder. (e.g., "~/Pictures/TuxPaint/") + + From the "Open" screen you can also: + + Click the blue 'Slides' (slide projector) button at the lower left to + go to slideshow mode. See "Slides", below, for details. + + + Click the blue 'Template' button at the lower left to go to convert the + selected picture into a new template, which can be used as the basis + for new drawings. + + 📜 Note: The Template creation feature was added to Tux Paint in version + 0.9.31. To learn how to create Templates outside of Tux Paint, see + Extending Tux Paint + + ⚙ The Template creation feature can be disabled (e.g., by selecting + "Disable 'Make Template'" in Tux Paint Config. or running Tux Paint + with the "notemplateexport" option). + + + Click the red 'Back' arrow button at the lower right of the list to + cancel and return to the picture you were drawing. + + ⌨ Note: You can also press [Control / ⌘] + [O] on the keyboard to bring up + the 'Open' dialog. + + + +d."Save" Command + + This saves your current picture. + + If you haven't saved it before, it will create a new entry in the list of + saved images. (i.e., it will create a new file) + + 💡 Note: It won't ask you anything (e.g., for a filename). It will simply + save the picture, and play a "camera shutter" sound effect. + + If you have saved the picture before, or this is a picture you just loaded + using the "Open" command, you will first be asked whether you want to save + over the old version, or create a new entry (a new file). + + ⚙ Note: If either the "saveover" or "saveovernew" options are set, it won't + ask before saving over. See the "Options" documentation. + + ⌨ Note: You can also press [Control / ⌘] + [S] on the keyboard to save. + + + +e."Print" Command + + Click this button and your picture will be printed! + + On most platforms, you can also hold the [Alt] key (called [Option] on + Macs) while clicking the 'Print' button to get a printer dialog. Note that + this may not work if you're running Tux Paint in fullscreen mode. See + below. + + Disabling Printing + + The "noprint" option can be set, which will disable Tux Paint's 'Print' + button. + + ⚙ See the "Options" documentation. + + + + Restricting Printing + + The "printdelay" option can be set, which will only allow occasional + printing — once every so many seconds, as configured by you. + + For example, with "printdelay=60" in Tux Paint's configuration file, + printing can only occur once per minute (60 seconds). + + ⚙ See the "Options" documentation. + + + + Printing Commands + + (Linux and Unix only) + + Tux Paint prints by generating a PostScript representation of the + drawing and sending it to an external program. By default, the program + is: + + lpr + + This command can be changed by setting a "printcommand" option in Tux + Paint's configuration file. + + An alternative print command can be invoked by holding the "[Alt]" key + on the keyboard while clicking clicking the 'Print' button, as long as + you're not in fullscreen mode, an alternative program is run. By + default, the program is KDE's graphical print dialog: + + kprinter + + This command can be changed by setting a "altprintcommand" option in + Tux Paint's configuration file. + + ⚙ See the "Options" documentation. + + + + Printer Settings + + (Windows and macOS) + + By default, Tux Paint simply prints to the default printer with default + settings when the 'Print' button is pushed. + + However, if you hold the [Alt] (or [Option]) key on the keyboard while + clicking the 'Print' button, as long as you're not in fullscreen mode, + your operating system's printer dialog will appear, where you can + change the settings. + + You can have the printer configuration changes stored between Tux Paint + sessions by setting the "printcfg" option. + + If the "printcfg" option is used, printer settings will be loaded from + the file "printcfg.cfg" in your personal folder (see below). Any + changes will be saved there as well. + + ⚙ See the "Options" documentation. + + + + Printer Dialog Options + + By default, Tux Paint only shows the printer dialog (or, on Linux/Unix, + runs the "altprintcommand"; e.g., "kprinter" instead of "lpr") if the + [Alt] (or [Option]) key is held while clicking the 'Print' button. + + However, this behavior can be changed. You can have the printer dialog + always appear by using "--altprintalways" on the command-line, or + "altprint=always" in Tux Paint's configuration file. Conversely, you + can prevent the [Alt]/[Option] key from having any effect by using + "--altprintnever", or "altprint=never". + + ⚙ See the "Options" documentation. + + + + + + +f."Slides" Command (under "Open") + + The 'Slides' button is available in the 'Open' dialog. It can be used to + play a simple animation within Tux Paint, or a slideshow of pictures. It + can also export an animated GIF based on the chosen images. + + Chosing pictures + + When you enter the 'Slides' section of Tux Paint, it displays a list of + your saved files, just like the 'Open' dialog. + + Click each of the images you wish to display in a slideshow-style + presentation, one by one. A digit will appear over each image, letting + you know in which order they will be displayed. + + You can click a selected image to unselect it (take it out of your + slideshow). Click it again if you wish to add it to the end of the + list. + + + + Set playback speed + + A sliding scale at the lower left of the screen (next to the 'Play' + button) can be used to adjust the speed of the slideshow or animated + GIF, from slowest to fastest. Choose the leftmost setting to disable + automatic advancement during playback within Tux Paint — you will need + to press a key or click to go to the next slide (see below). + + 💡 Note: The slowest setting does not automatically advance through the + slides. Use it for when you want to step through them manually. (This + does not apply to an exported animated GIF.) + + + + Playback in Tux Paint + + To play a slideshow within Tux Paint, click the 'Play' button. + + 💡 Note: If you hadn't selected any images, then all of your saved + images will be played in the slideshow! + + During the slideshow, press [Space], [Enter] or [Return], or the [Right + arrow] — or click the 'Next' button at the lower left — to manually + advance to the next slide. Press [Left arrow] to go back to the + previous slide. + + Press [Escape], or click the 'Back' button at the lower right, to exit + the slideshow and return to the slideshow image selection screen. + + + + Exporting an animated GIF + + Click the 'GIF Export' button near the lower right to have Tux Paint + generate an animated GIF file based on the selected images. + + 💡 Note: At least two images must be selected. (To export a single + image, use the 'Export' option from the main 'Open' dialog.) If no + images are selected, Tux Paint will not attempt to generate a GIF based + on all saved images. + + Pressing [Escape] during the export process will abort the process, and + return you to the 'Slideshow' dialog. + + + + + Click 'Back' in the slideshow image selection screen to return to the + 'Open' dialog. + + + +g."Quit" Command + + Clicking the 'Quit' button, closing the Tux Paint window, or pushing the + [Escape] key will quit Tux Paint. + + You will first be prompted as to whether you really want to quit. + + If you choose to quit, and you haven't saved the current picture, you will + first be asked if wish to save it. If it's not a new image, you will then + be asked if you want to save over the old version, or create a new entry. + (See "Save" above.) + + ⚙ Note: If the image is saved, it will be reloaded automatically the next + time you run Tux Paint -- unless the "startblank" option is set. + + ⚙ Note: The 'Quit' button within Tux Paint, and quitting via the [Escape] + key, may be disabled, via the "noquit" option. + + In that case, the "window close" button on Tux Paint's title bar (if not in + fullscreen mode) or the [Alt] + [F4] key sequence may be used to quit. + + If neither of those are possible, the key sequence of [Shift] + [Control / + ⌘] + [Escape] may be used to quit. + + ⚙ See the "Options" documentation. + + + +h.Sound Muting + + There is no on-screen control button at this time, but by using the [Alt] + + [S] keyboard sequence, sound effects can be disabled and re-enabled (muted + and unmuted) while the program is running. + + Note that if sounds are completely disabled via the "nosound" option, the + [Alt] + [S] key combination has no effect. (i.e., it cannot be used to turn + on sounds when the parent/teacher wants them disabled.) + + ⚙ See the "Options" documentation. - There is no on-screen control button at this time, but by using - the [Alt] + [S] keyboard sequence, sound effects can be disabled - and re-enabled (muted and unmuted) while the program is running. - Note that if sounds are completely disabled via the "nosound" - option, the [Alt] + [S] key combination has no effect. (i.e., it - cannot be used to turn on sounds when the parent/teacher wants - them disabled.) - ⚙ See the "Options" documentation. E. Controlling Tux Paint - 1. Using a Mouse or Trackball +1. Using a Mouse or Trackball - Tux Paint's main mode of operation is via any device that appears to your - operating system as a mouse, including standard mice, trackballs, and - trackpads, as well as drawing tablets (usually operated with a stylus) and - touch screens (operated with a finger and/or a stylus) (see "Using a - Tablet or Touchscreen" below for more information). +Tux Paint's main mode of operation is via any device that appears to your +operating system as a mouse, including standard mice, trackballs, and +trackpads, as well as drawing tablets (usually operated with a stylus) and +touch screens (operated with a finger and/or a stylus) (see "Using a Tablet or +Touchscreen" below for more information). - For drawing and controlling Tux Paint, only a single mouse button is used - — typically, on multi-button mice, this will the left mouse button, but - this can usually be configured at the operating system level. By default, - Tux Paint will ignore input from the other button(s). If a user attempts - to use the other button(s), a pop-up dialog will eventually appear - reminding them that only one button is recognized Tux Paint. However, you - may configure Tux Paint to accept any button as input (see the Options - documentation). +For drawing and controlling Tux Paint, only a single mouse button is used — +typically, on multi-button mice, this will the left mouse button, but this can +usually be configured at the operating system level. By default, Tux Paint will +ignore input from the other button(s). If a user attempts to use the other +button(s), a pop-up dialog will eventually appear reminding them that only one +button is recognized Tux Paint. However, you may configure Tux Paint to accept +any button as input (see the Options documentation). - a. Scrolling +a. Scrolling - Many input devices offer a way to quickly scroll within applications — - many mice have a scroll wheel, trackballs have scroll rings, and trackpads - recognize certain "scroll" gestures (e.g., two-finger vertical motion, or - vertical motion on the edge of the trackpad). Tux Paint supports scrolling - input to allow quick scrolling through certain lists (e.g., Stamps, Magic - tools, and the New and Open dialogs). +Many input devices offer a way to quickly scroll within applications — many +mice have a scroll wheel, trackballs have scroll rings, and trackpads recognize +certain "scroll" gestures (e.g., two-finger vertical motion, or vertical motion +on the edge of the trackpad). Tux Paint supports scrolling input to allow quick +scrolling through certain lists (e.g., Stamps, Magic tools, and the New and +Open dialogs). - Tux Paint will also automatically scroll if you click and hold the mouse - down on an scroll button — the "up" and "down" arrow buttons that appear - above and below scrolling lists. +Tux Paint will also automatically scroll if you click and hold the mouse down +on an scroll button — the "up" and "down" arrow buttons that appear above and +below scrolling lists. - b. Mouse Accessibility +b. Mouse Accessibility - Other devices that appear as a mouse can be used to control Tux Paint. For - example: - * Head pointing/tracking devices - * Eye gaze trackers - * Foot mice +Other devices that appear as a mouse can be used to control Tux Paint. For +example: - Tux Paint offers a "sticky mouse click" accessibility setting, where a - single click begins a click-and-drag operation, and a subsequent click - ends it. (See the Options documentation.) + * Head pointing/tracking devices + * Eye gaze trackers + * Foot mice - 2. Using a Tablet or Touchscreen +Tux Paint offers a "sticky mouse click" accessibility setting, where a single +click begins a click-and-drag operation, and a subsequent click ends it. (See +the Options documentation.) - As noted above, Tux Paint recognizes any device that appears as a mouse. - This means drawing tablets and touchscreens may be used. However, these - devices often support other features beyond X/Y motion, button clicks, and - scroll-wheel motion. Currently, those additional features are not - supported by Tux Paint. Some examples: - * Pressure and angle - * Eraser tip - * Multi-touch gestures +2. Using a Tablet or Touchscreen - 3. Using a Joystick-like Device +As noted above, Tux Paint recognizes any device that appears as a mouse. This +means drawing tablets and touchscreens may be used. However, these devices +often support other features beyond X/Y motion, button clicks, and scroll-wheel +motion. Currently, those additional features are not supported by Tux Paint. +Some examples: - Tux Paint may be configured to recognize input from any game controller - that appears to your operating system as a joystick. That even includes - modern game console controllers connected via USB or Bluetooth (e.g., - Nintendo Switch or Microsoft Xbox game pads)! + * Pressure and angle + * Eraser tip + * Multi-touch gestures - Numerous configuration options are available to best suit the device being - used, and the user's needs. Analog input will be used for coarse movement, - and digital "hat" input for fine movement. Buttons on the controller can - be mapped to different Tux Paint controls (e.g., acting as the [Escape] - key, switching to the Paint tool, invoking Undo and Redo operations, - etc.). See the Options documentation for more details. +3. Using a Joystick-like Device - 4. Using the Keyboard +Tux Paint may be configured to recognize input from any game controller that +appears to your operating system as a joystick. That even includes modern game +console controllers connected via USB or Bluetooth (e.g., Nintendo Switch or +Microsoft Xbox game pads)! - Tux Paint offers an option to allow the keyboard to be used to control the - mouse pointer. This includes motion and clicking, as well as shortcuts to - navigate between and within certain parts of the interface. See the - Options documentation for more details. +Numerous configuration options are available to best suit the device being +used, and the user's needs. Analog input will be used for coarse movement, and +digital "hat" input for fine movement. Buttons on the controller can be mapped +to different Tux Paint controls (e.g., acting as the [Escape] key, switching to +the Paint tool, invoking Undo and Redo operations, etc.). See the Options +documentation for more details. - III. Loading Other Pictures into Tux Paint +4. Using the Keyboard + +Tux Paint offers an option to allow the keyboard to be used to control the +mouse pointer. This includes motion and clicking, as well as shortcuts to +navigate between and within certain parts of the interface. See the Options +documentation for more details. + +III. Loading Other Pictures into Tux Paint A. Overview - Tux Paint's 'Open' dialog only displays pictures you created with Tux - Paint. So what do you do if you want to load some other drawinng or even a - photograph into Tux Paint, so you can edit or draw on it? +Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint. So +what do you do if you want to load some other drawinng or even a photograph +into Tux Paint, so you can edit or draw on it? - You can simply convert the picture to the format Tux Paint uses — PNG - (Portable Network Graphic) — and place it in Tux Paint's "saved" - directory/folder. Here is where to find it (by default): +You can simply convert the picture to the format Tux Paint uses — PNG (Portable +Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here +is where to find it (by default): - Windows 10, 8, 7, Vista - Inside the user's "AppData" folder, e.g.: - "C:\Users\username\AppData\Roaming\TuxPaint\saved\". +Windows 10, 8, 7, Vista + Inside the user's "AppData" folder, e.g.: "C:\Users\username\AppData\ + Roaming\TuxPaint\saved\". - Windows 2000, XP - Inside the user's "Application Data" folder, e.g.: "C:\Documents - and Settings\username\Application Data\TuxPaint\saved\". +Windows 2000, XP + Inside the user's "Application Data" folder, e.g.: "C:\Documents and + Settings\username\Application Data\TuxPaint\saved\". - macOS - Inside the user's "Library" folder, e.g.: - "/Users/username/Library/Application Support/Tux Paint/saved/". +macOS + Inside the user's "Library" folder, e.g.: "/Users/username/Library/ + Application Support/Tux Paint/saved/". - Linux/Unix - Inside a hidden ".tuxpaint" directory, in the user's home - directory ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". +Linux/Unix + Inside a hidden ".tuxpaint" directory, in the user's home directory + ("$HOME"), e.g. "/home/username/.tuxpaint/saved/". - 💡 Note: It is also from this folder that you can copy or open pictures - drawn in Tux Paint using other applications, though the 'Export' option - from Tux Paint's 'Open' dialog can be used to copy them to a location - that's easier and safer to access. + +💡 Note: It is also from this folder that you can copy or open pictures drawn in +Tux Paint using other applications, though the 'Export' option from Tux Paint's +'Open' dialog can be used to copy them to a location that's easier and safer to +access. B. Using the import script, "tuxpaint-import" - Linux and Unix users can use the "tuxpaint-import" shell script which gets - installed when you install Tux Paint. It uses some NetPBM tools to convert - the image ("anytopnm"), resize it so that it will fit in Tux Paint's - canvas ("pnmscale"), and convert it to a PNG ("pnmtopng"). +Linux and Unix users can use the "tuxpaint-import" shell script which gets +installed when you install Tux Paint. It uses some NetPBM tools to convert the +image ("anytopnm"), resize it so that it will fit in Tux Paint's canvas +("pnmscale"), and convert it to a PNG ("pnmtopng"). - It also uses the "date" command to get the current time and date, which is - the file-naming convention Tux Paint uses for saved files. (Remember, you - are never asked for a 'filename' when you go to save or open pictures!) +It also uses the "date" command to get the current time and date, which is the +file-naming convention Tux Paint uses for saved files. (Remember, you are never +asked for a 'filename' when you go to save or open pictures!) - To use this script, simply run it from a command-line prompt, and provide - it the name(s) of the file(s) you wish to convert. +To use this script, simply run it from a command-line prompt, and provide it +the name(s) of the file(s) you wish to convert. - They will be converted and placed in your Tux Paint "saved" directory. +They will be converted and placed in your Tux Paint "saved" directory. - 💡 Note: If you're doing this for a different user (e.g., your child) - you'll need to make sure to run the command under their account.) +💡 Note: If you're doing this for a different user (e.g., your child) you'll +need to make sure to run the command under their account.) - Example: +Example: - $ tuxpaint-import grandma.jpg - grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import grandma.jpg + grandma.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - The first line ("tuxpaint-import grandma.jpg") is the command to run. The - following two lines are output from the program while it's working. +The first line ("tuxpaint-import grandma.jpg") is the command to run. The +following two lines are output from the program while it's working. - Now you can load Tux Paint, and a version of that original picture will be - available under the 'Open' dialog. Just double-click its icon! +Now you can load Tux Paint, and a version of that original picture will be +available under the 'Open' dialog. Just double-click its icon! C. Importing Pictures Manually - Windows, macOS, and Haiku users who wish to import arbitrary images into - Tux Paint must do so via a manual process. +Windows, macOS, and Haiku users who wish to import arbitrary images into Tux +Paint must do so via a manual process. - Load a graphics program that is capable of both loading your picture and - saving a PNG format file. (See the documentation file "PNG.html" for a - list of suggested software, and other references.) +Load a graphics program that is capable of both loading your picture and saving +a PNG format file. (See the documentation file "PNG.html" for a list of +suggested software, and other references.) - When Tux Paint loads an image that's not the same size as its drawing - canvas, it scales (and sometimes smears the edges of) the image so that it - fits within the canvas. +When Tux Paint loads an image that's not the same size as its drawing canvas, +it scales (and sometimes smears the edges of) the image so that it fits within +the canvas. - To avoid having the image stretched or smeared, you can resize it to Tux - Paint's canvas size. This size depends on the size of the Tux Paint - window, or resolution at which Tux Paint is run, if in fullscreen. (Note: - The default resolution is 800x600.) See "Calculating Image Dimensions", - below. +To avoid having the image stretched or smeared, you can resize it to Tux +Paint's canvas size. This size depends on the size of the Tux Paint window, or +resolution at which Tux Paint is run, if in fullscreen. (Note: The default +resolution is 800x600.) See "Calculating Image Dimensions", below. - 1. Naming the File +1. Naming the File - Save the picture in PNG format. It is highly recommended that you name the - filename using the current date and time, since that's the convention Tux - Paint uses: +Save the picture in PNG format. It is highly recommended that you name the +filename using the current date and time, since that's the convention Tux Paint +uses: - YYYYMMDDhhmmss.png + YYYYMMDDhhmmss.png - * YYYY = Year - * MM = Month (two digits, "01"-"12") - * DD = Day of month (two digits, "01"-"31") - * HH = Hour (two digits, in 24-hour format, "00"-"23") - * mm = Minute (two digits, "00"-"59") - * ss = Seconds (two digits, "00"-"59") + * YYYY = Year + * MM = Month (two digits, "01"-"12") + * DD = Day of month (two digits, "01"-"31") + * HH = Hour (two digits, in 24-hour format, "00"-"23") + * mm = Minute (two digits, "00"-"59") + * ss = Seconds (two digits, "00"-"59") - Example: "20210731110500.png", for July 31, 2021 at 11:05am. +Example: "20210731110500.png", for July 31, 2021 at 11:05am. - Place this PNG file in your Tux Paint "saved" directory/folder. (See - above.) +Place this PNG file in your Tux Paint "saved" directory/folder. (See above.) - 2. Calculating Image Dimensions +2. Calculating Image Dimensions - This part of the documentation needs to be rewritten, since the new - "buttonsize" option was added. For now, try drawing and saving an image - within Tux Paint, then determine what size (pixel width and height) it - came out to, and try to match that when scaling the picture(s) you're - importing into Tux Paint. +This part of the documentation needs to be rewritten, since the new +"buttonsize" option was added. For now, try drawing and saving an image within +Tux Paint, then determine what size (pixel width and height) it came out to, +and try to match that when scaling the picture(s) you're importing into Tux +Paint. - IV.Further Reading +IV.Further Reading - Other documentation included with Tux Paint (found in the "docs" - folder/directory) includes: +Other documentation included with Tux Paint (found in the "docs" folder/ +directory) includes: - Using Tux Paint: - * OPTIONS.html - Detailed instructions on command-line and configuration-file - options, for those who don't want to use the Tux Paint - Config. tool to manage Tux Paint's configuration. - * 'Magic' Tool Documentation ("magic-docs") - Documentation for each of the currently-installed 'Magic' - tools. +Using Tux Paint: + + OPTIONS.html + Detailed instructions on command-line and configuration-file options, + for those who don't want to use the Tux Paint Config. tool to manage + Tux Paint's configuration. + + 'Magic' Tool Documentation ("magic-docs") + Documentation for each of the currently-installed 'Magic' tools. - How to extend Tux Paint: - * EXTENDING.html - Detailed instructions on extending Tux Paint: creating - brushes, stamps, starters, and templates; adding fonts; and - creating new on-screen keyboard layouts and input methods. - * PNG.html - Notes on creating PNG format bitmapped (raster) images for - use in Tux Paint. - * SVG.html - Notes on creating SVG format vector images for use in Tux - Paint. - Technical information: - * INSTALL.html - Instructions for compiling and installing Tux Paint, when - applicable. - * SIGNALS.html - Information about the POSIX signals that Tux Paint responds - to. - * MAGIC-API.html - Creating new Magic tools using Tux Paint's plugin API. +How to extend Tux Paint: + + EXTENDING.html + Detailed instructions on extending Tux Paint: creating brushes, stamps, + starters, and templates; adding fonts; and creating new on-screen + keyboard layouts and input methods. + + PNG.html + Notes on creating PNG format bitmapped (raster) images for use in Tux + Paint. + + SVG.html + Notes on creating SVG format vector images for use in Tux Paint. - Development history and license: - * AUTHORS.txt - List of authors and contributors. - * CHANGES.txt - Summary of what has changed between releases of Tux Paint. - * COPYING.txt - Tux Paint's software license, the GNU General Public License - (GPL) - V.How to Get Help +Technical information: + + INSTALL.html + Instructions for compiling and installing Tux Paint, when applicable. + + SIGNALS.html + Information about the POSIX signals that Tux Paint responds to. + + MAGIC-API.html + Creating new Magic tools using Tux Paint's plugin API. - If you need help, there are numerous ways to interact with Tux Paint - developers and other users: - * Report bugs or request new features via the project's bug-tracking - system - * Participate in the various project mailing lists - * Contact the developers directly - To learn more, visit the "Contact" page of the official Tux Paint website: - https://tuxpaint.org/contact/ +Development history and license: + + AUTHORS.txt + List of authors and contributors. + + CHANGES.txt + Summary of what has changed between releases of Tux Paint. + + COPYING.txt + Tux Paint's software license, the GNU General Public License (GPL) - VI.How to Participate - Tux Paint is a volunteer-driven project, and we're happy to accept your - help in a variety of ways: - * Translate Tux Paint to another language - * Improve existing translations - * Create artwork (stamps, starters, templates, brushes) - * Add or improve features or magic tools - * Create classroom curriculum - * Promote or help support others using Tux Paint - To learn more, visit the "Help Us" page of the official Tux Paint website: - https://tuxpaint.org/help/ +V.How to Get Help - VII.Follow the Tux Paint project on social media +If you need help, there are numerous ways to interact with Tux Paint developers +and other users: - Tux Paint maintains a presence on a variety of social media networks, - where we post updates and artwork. - * Join the Tux Paint page on Facebook - * Follow @TuxPaintDevs on Instagram - * Follow @tuxpaint@floss.social on Mastodon - * Follow u/TuxPaintDevs on Reddit - * Follow @TuxPaintDevs on Threads - * Follow Tux Paint on Tumblr - * Follow @TuxPaintTweets on Twitter + * Report bugs or request new features via the project's bug-tracking system + * Participate in the various project mailing lists + * Contact the developers directly - VIII. Trademark notices +To learn more, visit the "Contact" page of the official Tux Paint website: +https://tuxpaint.org/contact/ + +VI.How to Participate + +Tux Paint is a volunteer-driven project, and we're happy to accept your help in +a variety of ways: + + * Translate Tux Paint to another language + * Improve existing translations + * Create artwork (stamps, starters, templates, brushes) + * Add or improve features or magic tools + * Create classroom curriculum + * Promote or help support others using Tux Paint + +To learn more, visit the "Help Us" page of the official Tux Paint website: +https://tuxpaint.org/help/ + +VII.Follow the Tux Paint project on social media + +Tux Paint maintains a presence on a variety of social media networks, where we +post updates and artwork. + + * Join the Tux Paint page on Facebook + * Follow @TuxPaintDevs on Instagram + * Follow @tuxpaint@floss.social on Mastodon + * Follow u/TuxPaintDevs on Reddit + * Follow @TuxPaintDevs on Threads + * Follow Tux Paint on Tumblr + * Follow @TuxPaintTweets on Twitter + +VIII. Trademark notices + + * "Linux" is a registered trademark of Linus Torvalds. + * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. + * "Apple" and "macOS" are registered trademarks of Apple Inc. + * "Facebook", "Instagram", and "Threads" are registered trademarks of Meta + Platforms, Inc. + * "Mastodon" is a registered trademark of Mastodon gGmbH. + * "Reddit" is a registered trademark of Reddit, Inc. + * "Tumblr" is a registered trademark of Tumblr, Inc. + * "Twitter" is a registered trademark of X Corp. - * "Linux" is a registered trademark of Linus Torvalds. - * "Microsoft" and "Windows" are registered trademarks of Microsoft Corp. - * "Apple" and "macOS" are registered trademarks of Apple Inc. - * "Facebook", "Instagram", and "Threads" are registered trademarks of - Meta Platforms, Inc. - * "Mastodon" is a registered trademark of Mastodon gGmbH. - * "Reddit" is a registered trademark of Reddit, Inc. - * "Tumblr" is a registered trademark of Tumblr, Inc. - * "Twitter" is a registered trademark of X Corp. diff --git a/docs/is_IS.UTF-8/SIGNALS.txt b/docs/is_IS.UTF-8/SIGNALS.txt index 927c7a1db..92ec699ca 100644 --- a/docs/is_IS.UTF-8/SIGNALS.txt +++ b/docs/is_IS.UTF-8/SIGNALS.txt @@ -1,53 +1,57 @@ Tux Paint - version 0.9.31 + version 0.9.31 Signals Documentation Copyright © 2019-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - júní 4, 2022 + júní 4, 2022 - Tux Paint responds to the following signals (which can be sent to the - program's process via `kill` or `killall`, for example). +Tux Paint responds to the following signals (which can be sent to the program's +process via `kill` or `killall`, for example). - SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) +SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) - Tux Paint responds as if the "Quit" button were pressed, or the - desktop environment was told to close Tux Paint (e.g., by clicking - a window close button, or pressing [Alt] + [F4] on most systems). + Tux Paint responds as if the "Quit" button were pressed, or the desktop + environment was told to close Tux Paint (e.g., by clicking a window close + button, or pressing [Alt] + [F4] on most systems). - From the main interface, Tux Paint will prompt whether or not you - wish to quit, and (unless overridden by the auto-save option, e.g. - "--autosave") if you'd like to save the current drawing (if - unsaved), and if so, and it's a modified version of an existing - drawing (unless overridden by the options to save over old images, - or always save new images; e.g. "--saveover" and "--saveovernew", - respectively), whether or not to overwrite the existing drawing, - or save to a new file. + From the main interface, Tux Paint will prompt whether or not you wish to + quit, and (unless overridden by the auto-save option, e.g. "--autosave") if + you'd like to save the current drawing (if unsaved), and if so, and it's a + modified version of an existing drawing (unless overridden by the options + to save over old images, or always save new images; e.g. "--saveover" and + "--saveovernew", respectively), whether or not to overwrite the existing + drawing, or save to a new file. - Example: killall tuxpaint + Example: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint responds by setting its auto-save option (as if it had - been launched with "--autosave"), as well as either the option to - always save new images (as if launched with "--saveovernew") in - the case of receiving a SIGUSR1 signal, or to always save over the - existing image (as if launched with "--saveover") in the case of - receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, - in an attempt to quit. (See above.) - So, from the main interface, Tux Paint should quit almost - immediately, with no questions asked. +SIGUSR1 & SIGUSR2 + + Tux Paint responds by setting its auto-save option (as if it had been + launched with "--autosave"), as well as either the option to always save + new images (as if launched with "--saveovernew") in the case of receiving a + SIGUSR1 signal, or to always save over the existing image (as if launched + with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends + itself a SIGTERM signal, in an attempt to quit. (See above.) + + So, from the main interface, Tux Paint should quit almost immediately, with + no questions asked. + + Example: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - Example: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/is_IS.UTF-8/SVG.txt b/docs/is_IS.UTF-8/SVG.txt index 520e6d59d..5a9124f41 100644 --- a/docs/is_IS.UTF-8/SVG.txt +++ b/docs/is_IS.UTF-8/SVG.txt @@ -1,36 +1,37 @@ Tux Paint - version 0.9.31 + version 0.9.31 SVG Documentation Copyright © 2007-2022 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - júní 4, 2022 + júní 4, 2022 - About SVGs +About SVGs - SVG (Scalable Vector Graphics) is an open standard used to describe - two-dimensional vector graphics. It is great for diagrams and shapes, - while PNGs are better for photographs. SVG files are a bit like - instructions on how to make an image. This means that they can be resized - without looking pixelated or blocky. +SVG (Scalable Vector Graphics) is an open standard used to describe +two-dimensional vector graphics. It is great for diagrams and shapes, while +PNGs are better for photographs. SVG files are a bit like instructions on how +to make an image. This means that they can be resized without looking pixelated +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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt b/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt index 38aa5264a..305839683 100644 --- a/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt +++ b/docs/is_IS.UTF-8/tuxpaint-quickstart-guide.txt @@ -1,215 +1,210 @@ - Tux Paint 0.9.29 Quickstart Guide +Tux Paint 0.9.29 Quickstart Guide Tools (Drawing) - 🖌Paint +🖌Paint - * Choose a brush on the right. - * Some brushes are animated 🎞, some are directional ✲, some are both. - * Change brush spacing with the bars 📶 at the bottom right. - * Choose a color (see "Colors"). - * Click/tap and drag in the canvas to paint. + * Choose a brush on the right. + * Some brushes are animated 🎞, some are directional ✲, some are both. + * Change brush spacing with the bars 📶 at the bottom right. + * Choose a color (see "Colors"). + * Click/tap and drag in the canvas to paint. - ⌧Stamps +⌧Stamps - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Choose a stamp on the right. - * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near - the bottom right. - * Some stamps allow you to choose their color (see "Colors"). - * Change stamp size with the bars 📶 at the bottom right. - * Rotation ⟳ may be enabled, if desired. - * Click/tap in the canvas to place a stamp. - * If rotation is enabled, drag to rotate it, and click/tap again to - add it to the drawing. - * Some stamps play sound effects; press the speaker 🕪 button to hear it - again. - * Some stamps play descriptive sounds; press the headphones 🎧 button to - hear it again. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Choose a stamp on the right. + * Some stamps may be mirrored 🪞, and/or flipped ↕, using controls near the + bottom right. + * Some stamps allow you to choose their color (see "Colors"). + * Change stamp size with the bars 📶 at the bottom right. + * Rotation ⟳ may be enabled, if desired. + * Click/tap in the canvas to place a stamp. + + If rotation is enabled, drag to rotate it, and click/tap again to add + it to the drawing. + * Some stamps play sound effects; press the speaker 🕪 button to hear it + again. + * Some stamps play descriptive sounds; press the headphones 🎧 button to hear + it again. - ⚟Lines +⚟Lines - * (See Paint) - * Click/tap and drag to draw a line. + * (See Paint) + * Click/tap and drag to draw a line. - ⭓Shapes +⭓Shapes - * Choose a shape on the right. - * Select whether you want to extend the shape from the center ⧈, or a - corner ◰, using controls at the bottom right. - * 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. + * Choose a shape on the right. + * Select whether you want to extend the shape from the center ⧈, or a corner + ◰, using controls at the bottom right. + * Click/tap to position, and drag to set the size of the shape. + * Drag to rotate it, and click/tap again to add it to the drawing. - 🄰Text +🄰Text - * Choose a font on the right. - * Select whether you want the text bold 𝗔 and/or italic 𝘈, using - controls near the bottom right. - * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom - right. - * Choose a color (see "Colors"). - * Click/tap the canvas to position an insertion cursor. - * Enter text via your keyboard or the on-screen keyboard. - * 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 - and begin entering more text one line down. - * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and - continue entering more text immediately to the right. - * Using the on-screen keyboard: - * "Cmp" can be used to compose characters, e.g. Cmp ' a results in - á. - * "AltGr" can be used to quickly access more characters. - * Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. - "ABC") + * Choose a font on the right. + * Select whether you want the text bold 𝗔 and/or italic 𝘈, using controls + near the bottom right. + * Change text size using the up 🡁 and down 🡃 arrow buttons at the bottom + right. + * Choose a color (see "Colors"). + * Click/tap the canvas to position an insertion cursor. + * Enter text via your keyboard or the on-screen keyboard. + * 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 and + begin entering more text one line down. + * Or, press [Tab] or click/tap or ⟷ to add the text to the drawing and + continue entering more text immediately to the right. + * Using the on-screen keyboard: + + "Cmp" can be used to compose characters, e.g. Cmp ' a results in á. + + "AltGr" can be used to quickly access more characters. + + Left/Right arrows switches keyboard layouts (e.g., "QWERTY" vs. "ABC") - 🅰Label +🅰Label - * (See Text) - * Labels float 'above' the drawing; you cannot paint or stamp over them, - apply Magic effects, etc. - * Labels may be edited, repositioned, and styled after they've been - added to the drawing. - * Click/tap the ☝ button near the lower right to choose a label. - Click/tap the label you wish to modify, then click/tap somewhere else - in the canvas to reposition, or change the font/style, change color, - and/or type to edit the text. - * Or, use the 🖑 button near the lower right to "flatten" a label, - applying it to the canvas; it may no longer be edited with the Label - tool. + * (See Text) + * Labels float 'above' the drawing; you cannot paint or stamp over them, + apply Magic effects, etc. + * Labels may be edited, repositioned, and styled after they've been added to + the drawing. + * Click/tap the ☝ button near the lower right to choose a label. Click/tap + the label you wish to modify, then click/tap somewhere else in the canvas + to reposition, or change the font/style, change color, and/or type to edit + the text. + * Or, use the 🖑 button near the lower right to "flatten" a label, applying it + to the canvas; it may no longer be edited with the Label tool. - 🪣Fill +🪣Fill - * Choose a fill mode on the right. - * Choose a color (see "Colors"). - * Click/tap (and drag, with Brush and Linear modes) to fill an area of - the picture with a color. - * Solid - Flood-fills an area with a solid color - * Brush - Paints with a solid color, without drawing outside the - chosen area - * Linear - Fills the area with a linear gradient (drag to choose - angle and gradient) - * Radial - Fills the area with a radial gradient, centered where - you clicked/tapped - * Shaped - Fills the area with a gradient that follows the contours - of the area being filled + * Choose a fill mode on the right. + * Choose a color (see "Colors"). + * Click/tap (and drag, with Brush and Linear modes) to fill an area of the + picture with a color. + + Solid - Flood-fills an area with a solid color + + Brush - Paints with a solid color, without drawing outside the chosen + area + + Linear - Fills the area with a linear gradient (drag to choose angle + and gradient) + + Radial - Fills the area with a radial gradient, centered where you + clicked/tapped + + Shaped - Fills the area with a gradient that follows the contours of + the area being filled - 🪄Magic +🪄Magic - * Choose a magic tool on the right. - * Change categories with the arrow buttons ⇦⇨ near the bottom right. - * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some - affect the entire drawing 🖻🪄, and some offer both options; use the - controls at the bottom right. - * Some magic tools offer various sizes; change it with the bars 📶 at the - bottom right. - * Some magic tools allow you to choose their color. + * Choose a magic tool on the right. + * Change categories with the arrow buttons ⇦⇨ near the bottom right. + * Some magic tools draw or apply effects via click/tap and drag 〰🪄, some + affect the entire drawing 🖻🪄, and some offer both options; use the controls + at the bottom right. + * Some magic tools offer various sizes; change it with the bars 📶 at the + bottom right. + * Some magic tools allow you to choose their color. - 🖓Undo +🖓Undo - * Use to undo the most recent changes (multiple undo available). - * Shortcut: [Ctrl]+[Z] + * Use to undo the most recent changes (multiple undo available). + * Shortcut: [Ctrl]+[Z] - 🖒Redo +🖒Redo - * Use to redo the most recent undone change (multiple redo available). - * Shortcut: [Ctrl]+[R] + * Use to redo the most recent undone change (multiple redo available). + * Shortcut: [Ctrl]+[R] - ◪Eraser +◪Eraser - * Choose the size and shape of the eraser on the right. - * Click/tap and drag to erase parts of the picture (solid color, or - starter or template image). - * Shortcut: [X] and click/tap in the drawing (not always available) + * Choose the size and shape of the eraser on the right. + * Click/tap and drag to erase parts of the picture (solid color, or starter + or template image). + * Shortcut: [X] and click/tap in the drawing (not always available) Tools (Controls) - 🗏New +🗏New - * Choose a solid color, starter, or template image to start with. - * Starters allow drawing "under" a picture (e.g., a coloring book - outline), sometimes with a background layer, too. - * Templates are pictures to start with (background only). - * Eraser tool ◪ reveals the solid color, or starter/template - background. - * Click/tap "🕮⮫Open" to begin a new drawing. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Shortcut: [Ctrl]+[N] + * Choose a solid color, starter, or template image to start with. + + Starters allow drawing "under" a picture (e.g., a coloring book + outline), sometimes with a background layer, too. + + Templates are pictures to start with (background only). + + Eraser tool ◪ reveals the solid color, or starter/template background. + * Click/tap "🕮⮫Open" to begin a new drawing. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Shortcut: [Ctrl]+[N] - 🕮⮫Open +🕮⮫Open - * Choose a previously-saved drawing to open (or export or erase). - * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. - * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" - folder. - * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle - Bin. - * Click/tap "⤺Back" to abort and return to your current drawing. - * Click/tap "📽Slides" to switch to slideshow mode: - * Click/tap two or more of your previously-saved drawings, in the - order you want them shown. Numbers will appear on them. - * Choose the playback speed using the bars 📶 near the lower left. - * Click/tap "⯈Play" to watch the slideshow/animation. - * Or, click/tap "🎞GIF Export" to save an animated GIF of the - animation to your system's "Pictures" folder. - * Click/tap "⤺Back" to return to the Open dialog. - * Shortcut: [Ctrl]+[O] + * Choose a previously-saved drawing to open (or export or erase). + * Click/tap "🕮⮫Open" to open the saved drawing and continue editing it. + * Click/tap "🗏⮫Export" to save the drawing to your system's "Pictures" + folder. + * Click/tap "🗑Erase" to move the drawing to your system's Trash/Recycle Bin. + * Click/tap "⤺Back" to abort and return to your current drawing. + * Click/tap "📽Slides" to switch to slideshow mode: + + Click/tap two or more of your previously-saved drawings, in the order + you want them shown. Numbers will appear on them. + + Choose the playback speed using the bars 📶 near the lower left. + + Click/tap "⯈Play" to watch the slideshow/animation. + + Or, click/tap "🎞GIF Export" to save an animated GIF of the animation to + your system's "Pictures" folder. + + Click/tap "⤺Back" to return to the Open dialog. + * Shortcut: [Ctrl]+[O] - 🕮⮪Save +🕮⮪Save - * Click/tap to save your drawing. - * If you've saved previously, you'll be prompted whether to overwrite - the previously-saved drawing (a la "File→Save") or create a new saved - drawing (a la "File→Save As...") - * Shortcut: [Ctrl]+[S] + * Click/tap to save your drawing. + * If you've saved previously, you'll be prompted whether to overwrite the + previously-saved drawing (a la "File→Save") or create a new saved drawing + (a la "File→Save As...") + * Shortcut: [Ctrl]+[S] - 🖶Print +🖶Print - * Click/tap to print your drawing. - * Hold [Alt] or [Option] while clicking/tapping to bring up printer - dialog, if available. - * Shortcut: [Ctrl]+[P] + * Click/tap to print your drawing. + * Hold [Alt] or [Option] while clicking/tapping to bring up printer dialog, + if available. + * Shortcut: [Ctrl]+[P] - 🗙Quit +🗙Quit - * Click/tap to quit Tux Paint. - * Shortcut: [Esc] + * Click/tap to quit Tux Paint. + * Shortcut: [Esc] Colors - * Click/tap to choose a color to use with the Paint, Lines, and Shapes - tools, and Stamps and Magic tools that support colors. - * Use the pipette / color picker 💉 button to choose a color from a pixel - in your current drawing. - * Shortcut: When colors are available, press [Ctrl] and click/tap - in your drawing, to quickly pick a color from your drawing. - * Click/tap the rainbow 🌈 button to choose a arbitrary color. - * Click/tap in the rainbow square to pick a color (hue and - saturation). - * Click/tap in the grey gradient bar to adjust brightness (value). - * Click/tap the green checkbox ✓ to accept. - * Click/tap "⤺Back" to abort and dismiss the palette. - * You may grab the currently-chosen built-in color (if any), the - color in the pipette / color picker, or the color in the color - mixer, by clicking one of the colored arrow ⇫ buttons. - * Click/tap the paint palette 🎨 button to create a color by mixing - primary colors: red, yellow, and blue, and white (tint), grey (tone), - and black (shade). - * Click/tap the green checkbox ✓ to accept. - * Color mixing offers its own 🖓Undo and 🖒Redo options. - * Click/tap "🗑Clear" to start over with no mixed colors. - * Click/tap "⤺Back" to abort and dismiss the color mixer. + * Click/tap to choose a color to use with the Paint, Lines, and Shapes tools, + and Stamps and Magic tools that support colors. + * Use the pipette / color picker 💉 button to choose a color from a pixel in + your current drawing. + + Shortcut: When colors are available, press [Ctrl] and click/tap in your + drawing, to quickly pick a color from your drawing. + * Click/tap the rainbow 🌈 button to choose a arbitrary color. + + Click/tap in the rainbow square to pick a color (hue and saturation). + + Click/tap in the grey gradient bar to adjust brightness (value). + + Click/tap the green checkbox ✓ to accept. + + Click/tap "⤺Back" to abort and dismiss the palette. + + You may grab the currently-chosen built-in color (if any), the color in + the pipette / color picker, or the color in the color mixer, by + clicking one of the colored arrow ⇫ buttons. + * Click/tap the paint palette 🎨 button to create a color by mixing primary + colors: red, yellow, and blue, and white (tint), grey (tone), and black + (shade). + + Click/tap the green checkbox ✓ to accept. + + Color mixing offers its own 🖓Undo and 🖒Redo options. + + Click/tap "🗑Clear" to start over with no mixed colors. + + Click/tap "⤺Back" to abort and dismiss the color mixer. Shortcuts while drawing: - * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access - * [X]+Click/tap - Quick eraser ◪ access - * [Ctrl]+[Z] - 🖓Undo - * [Ctrl]+[R] - 🖒Redo - * [Ctrl]+[N] - 🗏New - * [Ctrl]+[O] - 🕮⮫Open - * [Ctrl]+[S] - 🕮⮪Save - * [Ctrl]+[P] - 🖶Print - * [Alt]+[S] - Toggle sound effects on/off - * [Esc] - ⤺Back or 🗙Quit + * [Ctrl]+Click/tap - Quick pipette / color picker 💉 access + * [X]+Click/tap - Quick eraser ◪ access + * [Ctrl]+[Z] - 🖓Undo + * [Ctrl]+[R] - 🖒Redo + * [Ctrl]+[N] - 🗏New + * [Ctrl]+[O] - 🕮⮫Open + * [Ctrl]+[S] - 🕮⮪Save + * [Ctrl]+[P] - 🖶Print + * [Alt]+[S] - Toggle sound effects on/off + * [Esc] - ⤺Back or 🗙Quit + +Last updated: maí 9, 2023 - Last updated: maí 9, 2023 diff --git a/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt b/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt index aa6d88227..ff2a05d5d 100644 --- a/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt +++ b/docs/ja_JP.UTF-8/ADVANCED-STAMPS-HOWTO.txt @@ -1,193 +1,285 @@ Tux Paint - バージョン 0.9.31 スタンプ作成の詳細について + バージョン 0.9.31 スタンプ作成の詳細について - Copyright © 2006-2022 by Albert Cahalan ほか; AUTHORS.txt 参照. + Copyright © 2006-2022 by Albert Cahalan ほか; AUTHORS.txt 参照. https://tuxpaint.org/ - 2022年6月 4日 + 2022年6月 4日 - ---------------------------------------------------------------------- - - +-----------------------+ - |目次 | - |-----------------------| - | * この解説について | - | * 使用する画像の選択 | - | * マスクの設定 | - | * 縁取りと不要なピクセルの除去 | - | * Tux Paint 用の画像の保存 | - +-----------------------+ - - ---------------------------------------------------------------------- - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++----------------------------------+ +| 目次 | +|----------------------------------| +| * この解説について | +| * 使用する画像の選択 | +| * マスクの設定 | +| * 縁取りと不要なピクセルの除去 | +| * Tux Paint 用の画像の保存 | ++----------------------------------+ +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- この解説について - この解説では、デジカメ写真などのJPEG画像をもとに、PNG形式で、高いクォリティの Tux Paint - 用スタンプを作成したいという場合を想定しています。クォリティにこだわらなければ、もっと簡単で早い方法もあります。 + この解説では、デジカメ写真などのJPEG画像をもとに、PNG形式で、高いクォリティ + の Tux Paint 用スタンプを作成したいという場合を想定しています。クォリティに + こだわらなければ、もっと簡単で早い方法もあります。 - 扱う対象としては、通常の透明ではないものを前提としており、半透明のもの（火、動く扇風機の羽根、風船）や発光するもの（火、電球、太陽）を扱うには、専用のソフトウェアを使用するのが最適です。背景が完全なベタ塗りの画像も、専用のソフトを使うのが良いですが、以下のようにしても問題はありません。 + 扱う対象としては、通常の透明ではないものを前提としており、半透明のもの（火 + 、動く扇風機の羽根、風船）や発光するもの（火、電球、太陽）を扱うには、専用 + のソフトウェアを使用するのが最適です。背景が完全なベタ塗りの画像も、専用の + ソフトを使うのが良いですが、以下のようにしても問題はありません。 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- 使用する画像の選択 - 著作権 + 著作権 - Tux Paint の開発者に作品を提供して公式プロジェクトへの採用を検討してもらいたい場合や、Tux Paint - に独自の画像を同梱して配布したい場合には、Tux Paint が採用しているライセンスである GNU 一般公衆利用許諾 - と互換性があるライセンスの画像を用いる必要があります。 + Tux Paint の開発者に作品を提供して公式プロジェクトへの採用を検討しても + らいたい場合や、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 > - cropped.jpg + jpegtran -trim -copy none -crop 512x1728+160+128 < src.jpg > + cropped.jpg - 次に、切り抜いた画像を画像エディタで表示させます。トリミングをしていない大きな画像を開く場合は、画像エディタの動作が非常に遅くなるかもしれません。必要に応じて画像を回転させたりトリミングしたりして、画像を保存します。保存の際は、レイヤー、マスク、アルファチャンネルなどが保存されるように、各ソフトウェア専用のフォーマットを選択します。GIMPをお使いの方は「XCF」、Adobe - Photoshopをお使いの方は「PSD」などを選択して下さい。 + 次に、切り抜いた画像を画像エディタで表示させます。トリミングをしていない大 + きな画像を開く場合は、画像エディタの動作が非常に遅くなるかもしれません。必 + 要に応じて画像を回転させたりトリミングしたりして、画像を保存します。保存の + 際は、レイヤー、マスク、アルファチャンネルなどが保存されるように、各ソフト + ウェア専用のフォーマットを選択します。GIMPをお使いの方は「XCF」、Adobe + Photoshopをお使いの方は「PSD」などを選択して下さい。 - 画像編集ソフトで画像を回転させたり切り抜いたりした場合は、マスクやアルファチャンネルのない１層の RGB レイヤーに統合して下さい。 + 画像編集ソフトで画像を回転させたり切り抜いたりした場合は、マスクやアルファ + チャンネルのない１層の RGB レイヤーに統合して下さい。 - レイヤーダイアログボックスを開いて、以下のように、レイヤーを上から順に何度か複製します: + レイヤーダイアログボックスを開いて、以下のように、レイヤーを上から順に何度 + か複製します: - 1. 編集前の画像（可能であればプロテクトする） - 2. 編集を行う画像 － "作業用" レイヤー - 3. グリーン１色のレイヤー（可能であればプロテクトする） - 4. マゼンダ１色のレイヤー（可能であればプロテクトする） - 5. 編集前の画像（可能であればプロテクトする） + 1. 編集前の画像（可能であればプロテクトする） + 2. 編集を行う画像－ "作業用" レイヤー + 3. グリーン１色のレイヤー（可能であればプロテクトする） + 4. マゼンダ１色のレイヤー（可能であればプロテクトする） + 5. 編集前の画像（可能であればプロテクトする） - 作業用レイヤーに、大まかに初期マスクを作成します。選択範囲から始めても良いですし、作業レイヤーのグレースケール値を用いても良いでしょう。また、マスクを反転させることもできます。 + 作業用レイヤーに、大まかに初期マスクを作成します。選択範囲から始めても良い + ですし、作業レイヤーのグレースケール値を用いても良いでしょう。また、マスク + を反転させることもできます。 - 注: マスクを設定した後は、画像の回転や拡大縮小は行えません。これはデータ損失の原因となります。サイズを調整するための特別な方法は後述します。 + 注: マスクを設定した後は、画像の回転や拡大縮小は行えません。これはデータ損 + 失の原因となります。サイズを調整するための特別な方法は後述します。 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- マスクの設定 - レイヤーダイアログのサムネイル画像を [Control] キーを押しながらクリックしたり、[Alt] - キーを押しながらクリックしたりすることに慣れておきましょう。これは、何を見て何を編集しているかを把握するために必要となります。例えば、変更されていない画像を見ながら作業用レイヤーのマスクを編集する場合など、見えていないものを編集することもあります。混乱して間違ってしまわないように注意してください。自分が編集しているものが正しいかどうかを常に確認するようにしましょう。 + レイヤーダイアログのサムネイル画像を [Control] キーを押しながらクリックした + り、[Alt] キーを押しながらクリックしたりすることに慣れておきましょう。これ + は、何を見て何を編集しているかを把握するために必要となります。例えば、変更 + されていない画像を見ながら作業用レイヤーのマスクを編集する場合など、見えて + いないものを編集することもあります。混乱して間違ってしまわないように注意し + てください。自分が編集しているものが正しいかどうかを常に確認するようにしま + しょう。 - 一番上のオリジナル画像のレイヤーを表示しながら、作業用レイヤーに対して編集を加えるするように設定します。編集作業の必要に応じて画像を約400％に拡大してください（画像の各ピクセルを画面上 - 4x4 ピクセルのブロックとして表示し、編集することができます） + 一番上のオリジナル画像のレイヤーを表示しながら、作業用レイヤーに対して編集 + を加えるするように設定します。編集作業の必要に応じて画像を約400％に拡大して + ください（画像の各ピクセルを画面上 4x4 ピクセルのブロックとして表示し、編集 + することができます） - Select parts of the image that need to be 100% opaque or 0% opaque. If - you can select the object or background somewhat accurately by color, do - so. As needed to avoid selecting any pixels that should be partially - opaque (generally at the edge of the object) you should grow, shrink, - and invert the selection. + Select parts of the image that need to be 100% opaque or 0% opaque. If you + can select the object or background somewhat accurately by color, do so. As + needed to avoid selecting any pixels that should be partially opaque + (generally at the edge of the object) you should grow, shrink, and invert + the selection. - Fill the 100% opaque areas with white, and the 0% opaque areas with - black. This is most easily done by drag-and-drop from the - foreground/background color indicator. You should not see anything - happen, because you are viewing the unmodified image layer while editing - the mask of the WIP layer. Large changes might be noticable in the - thumbnail. + Fill the 100% opaque areas with white, and the 0% opaque areas with black. + This is most easily done by drag-and-drop from the foreground/background + color indicator. You should not see anything happen, because you are + viewing the unmodified image layer while editing the mask of the WIP layer. + Large changes might be noticable in the thumbnail. - 次に、画像を拡大します。 + 次に、画像を拡大します。 - 作業内容を確認します。まず、一番上のオリジナルレイヤーを隠します。マスクだけを表示すると、黒の背景に白のオブジェクトが表示されるはずです - (おそらく輪郭の部分には未編集のグレーが表示されます)。次に - 作業用レイヤーを通常通り表示し、マスクがアクティブになるようにします。これで、あなたのオブジェクトが、次の有効レイヤーの上に表示されるはずです。このレイヤーは、コントラストを最大にするために、必要に応じてグリーンまたはマゼンタにする必要があります。緑のレイヤーを繰り返しクリックして有効/無効にすることで、これらの背景を行ったり来たりすることができます。マスクを見ながら編集して、単純なミスを修正します。 + 作業内容を確認します。まず、一番上のオリジナルレイヤーを隠します。マスクだ + けを表示すると、黒の背景に白のオブジェクトが表示されるはずです (おそらく輪 + 郭の部分には未編集のグレーが表示されます)。次に作業用レイヤーを通常通り表示 + し、マスクがアクティブになるようにします。これで、あなたのオブジェクトが、 + 次の有効レイヤーの上に表示されるはずです。このレイヤーは、コントラストを最 + 大にするために、必要に応じてグリーンまたはマゼンタにする必要があります。緑 + のレイヤーを繰り返しクリックして有効/無効にすることで、これらの背景を行った + り来たりすることができます。マスクを見ながら編集して、単純なミスを修正しま + す。 - 作業用レイヤーのマスクを編集しながら、一番上のオリジナルレイヤーの表示に戻ります。描画ツールを「ブラシ」に設定します。ブラシには、円形の小さなぼかし筆を選びます。5x5 - サイズがほとんどの場合に適しています。 + 作業用レイヤーのマスクを編集しながら、一番上のオリジナルレイヤーの表示に戻 + ります。描画ツールを「ブラシ」に設定します。ブラシには、円形の小さなぼかし + 筆を選びます。5x5 サイズがほとんどの場合に適しています。 - ゆっくりとぶれないように画像の輪郭をトレースします。外側には黒色、内側には白色を使います。色を変更しないまま複数のパスにならないように注意して下さい。 + ゆっくりとぶれないように画像の輪郭をトレースします。外側には黒色、内側には + 白色を使います。色を変更しないまま複数のパスにならないように注意して下さい + 。 - 表示をちらっと反転させ、マスクがうまく機能していることを確認します。作業用レイヤーをグリーンまたはマゼンタの上に合成すると、元の背景が、境界周りのほんのわずかなギザギザした縁取りのように見えるはずです。この縁取りが見えない場合、オブジェクトマスクを小さくしすぎたことになります。この縁取りを構成するピクセルは、完全にオブジェクト内でもオブジェクト外でもありません。そのため、マスクは100%でも0%でもありません。この縁取りはこの後に取り除かれます。 + 表示をちらっと反転させ、マスクがうまく機能していることを確認します。作業用 + レイヤーをグリーンまたはマゼンタの上に合成すると、元の背景が、境界周りのほ + んのわずかなギザギザした縁取りのように見えるはずです。この縁取りが見えない + 場合、オブジェクトマスクを小さくしすぎたことになります。この縁取りを構成す + るピクセルは、完全にオブジェクト内でもオブジェクト外でもありません。そのた + め、マスクは100%でも0%でもありません。この縁取りはこの後に取り除かれます。 - マスクを表示して編集します。黒か白の色で領域を選択します。ほとんどの場合、選択されていない色の斑点が残っていると思います。選択範囲を反転させ、鉛筆ツールを使ってこれらの点を取り除きます。この作業を白と黒の両方で行います。 + マスクを表示して編集します。黒か白の色で領域を選択します。ほとんどの場合、 + 選択されていない色の斑点が残っていると思います。選択範囲を反転させ、鉛筆ツ + ールを使ってこれらの点を取り除きます。この作業を白と黒の両方で行います。 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- 縁取りと不要なピクセルの除去 - マスクをを表示しながら、黒で領域を選択した後、選択範囲を数ピクセル縮小します。ただし、マスクの端から縮小しないように注意してください（縮小することで、ミスを防いだりやり直したりすることができます） + マスクをを表示しながら、黒で領域を選択した後、選択範囲を数ピクセル縮小しま + す。ただし、マスクの端から縮小しないように注意してください（縮小することで + 、ミスを防いだりやり直したりすることができます） - ここでマスクを無効にします。マスクされていない作業用レイヤーを表示して編集します。色選択ツールを使って、対象の平均的な色を選択します。この色を選択範囲にドラッグ＆ドロップすると、オブジェクト以外のピクセルのほとんどが削除されます。 + ここでマスクを無効にします。マスクされていない作業用レイヤーを表示して編集 + します。色選択ツールを使って、対象の平均的な色を選択します。この色を選択範 + 囲にドラッグ＆ドロップすると、オブジェクト以外のピクセルのほとんどが削除さ + れます。 - この単色の領域は、Tux - Paintが画像を縮小する際に生じる縁取りを抑制するのに役立ちます。オブジェクトの輪郭に大きく異なる複数の色がある場合は、選択範囲を分割して、近くの背景が似たような色になるようにします。 + この単色の領域は、Tux Paintが画像を縮小する際に生じる縁取りを抑制するのに役 + 立ちます。オブジェクトの輪郭に大きく異なる複数の色がある場合は、選択範囲を + 分割して、近くの背景が似たような色になるようにします。 - ここで、輪郭周りの縁取りを消去します。作業用レイヤーの画像を編集、表示していることを確認してください。以下の全てのレイヤーを頻繁に切り替えて表示することで、自分が何をしているのかを確認することができます: + ここで、輪郭周りの縁取りを消去します。作業用レイヤーの画像を編集、表示して + いることを確認してください。以下の全てのレイヤーを頻繁に切り替えて表示する + ことで、自分が何をしているのかを確認することができます: - * グリーン との合成（マスク有効） - * マゼンタ との合成（マスク有効） - * オリジナル（一番上、または一番下のレイヤー） - * オリジナル との合成（マスク有効） - * 作業用レイヤー（マスク無効） + + グリーンとの合成（マスク有効） + + マゼンタとの合成（マスク有効） + + オリジナル（一番上、または一番下のレイヤー） + + オリジナルとの合成（マスク有効） + + 作業用レイヤー（マスク無効） - 失敗を減らすために、マスクの中の灰色ではないピクセルだけを選択するとよいでしょう。（「マスクから色で領域選択、黒を選択、色加算モード、白を選択、反転」あるいは「すべてを選択、マスクから色で領域選択、色減算モード、黒を選択、白を選択」）この作業を行う際、選択範囲を少し広げて、選択領域を示す線を隠したくなるかもしれません。 + 失敗を減らすために、マスクの中の灰色ではないピクセルだけを選択するとよいで + しょう。（「マスクから色で領域選択、黒を選択、色加算モード、白を選択、反転 + 」あるいは「すべてを選択、マスクから色で領域選択、色減算モード、黒を選択、 + 白を選択」）この作業を行う際、選択範囲を少し広げて、選択領域を示す線を隠し + たくなるかもしれません。 - 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 - generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy - brushes with about 70% opacity.) Unusual drawing modes can be helpful - with semi-transparent objects. + 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 + generally nice to pair up fuzzy brushes with 100% opacity and non-fuzzy + brushes with about 70% opacity.) Unusual drawing modes can be helpful with + semi-transparent objects. - 最終目標は、オブジェクトの内側と外側の両方の縁取りを除去することです。内側の縁取りは、マゼンタやグリーンの上にオブジェクトを合成したときに見えるもので、明らかに除去が必要です。外側のフリンジは、画像を縮小したときに見えるようになるため、こちらも除去する必要があります。例として、鋭角なオブジェクトの輪郭にある2x2のピクセルの領域を考えてみましょう。左半分は黒で、不透明度は0％。右半分は白で、100％不透明です。つまり、黒い背景に白い物体がある状態です。Tux - Paintがこれを50％（1x1ピクセルの領域）にスケーリングすると、結果はグレーの50％不透明ピクセルになりますが、正しい結果は、白の50％不透明ピクセルです。この結果を得るためには、黒いピクセルを塗り潰します。不透明度が0％であるにもかかわらず、黒いピクセルは重要です。 + 最終目標は、オブジェクトの内側と外側の両方の縁取りを除去することです。内側 + の縁取りは、マゼンタやグリーンの上にオブジェクトを合成したときに見えるもの + で、明らかに除去が必要です。外側のフリンジは、画像を縮小したときに見えるよ + うになるため、こちらも除去する必要があります。例として、鋭角なオブジェクト + の輪郭にある2x2のピクセルの領域を考えてみましょう。左半分は黒で、不透明度は + 0％。右半分は白で、100％不透明です。つまり、黒い背景に白い物体がある状態で + す。Tux Paintがこれを50％（1x1ピクセルの領域）にスケーリングすると、結果は + グレーの50％不透明ピクセルになりますが、正しい結果は、白の50％不透明ピクセ + ルです。この結果を得るためには、黒いピクセルを塗り潰します。不透明度が0％で + あるにもかかわらず、黒いピクセルは重要です。 - Tux Paint - では、画像を非常に大きく縮小することができるため、オブジェクトの輪郭を外側に大きく広げることが重要です。オブジェクトの輪郭の部分では、非常に正確に処理する必要がありますが、輪郭から離れるにつれて、少々手を抜いても大丈夫です。十数ピクセル以上外側まで描くとちょうど良くなります。これを太くすればするだけ、Tux - Paintは汚い色の縁どりを発生させずにスケールダウンすることができます。オブジェクトの端から数ピクセル以上離れた部分については、鉛筆ツール（またはドラッグ＆ドロップで適当に色を選択）を使用して、結果がきれいに縮小されるようにしてください。 + Tux Paint では、画像を非常に大きく縮小することができるため、オブジェクトの + 輪郭を外側に大きく広げることが重要です。オブジェクトの輪郭の部分では、非常 + に正確に処理する必要がありますが、輪郭から離れるにつれて、少々手を抜いても + 大丈夫です。十数ピクセル以上外側まで描くとちょうど良くなります。これを太く + すればするだけ、Tux Paintは汚い色の縁どりを発生させずにスケールダウンするこ + とができます。オブジェクトの端から数ピクセル以上離れた部分については、鉛筆 + ツール（またはドラッグ＆ドロップで適当に色を選択）を使用して、結果がきれい + に縮小されるようにしてください。 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- Tux Paint 用の画像の保存 - It is very easy to ruin your hard work. Image editors can silently - destroy pixels in 0% opaque areas. The conditions under which this - happens may vary from version to version. If you are very trusting, you - can try saving your image directly as a PNG. Be sure to read it back in - again to verify that the 0% opaque areas didn't turn black or white, - which would create fringes when Tux Paint scales the image down. If you - need to scale your image to save space (and hide your mistakes), you are - almost certain to destroy all the 0% opaque areas. So here is a better - way... + It is very easy to ruin your hard work. Image editors can silently destroy + pixels in 0% opaque areas. The conditions under which this happens may vary + from version to version. If you are very trusting, you can try saving your + image directly as a PNG. Be sure to read it back in again to verify that + the 0% opaque areas didn't turn black or white, which would create fringes + when Tux Paint scales the image down. If you need to scale your image to + save space (and hide your mistakes), you are almost certain to destroy all + the 0% opaque areas. So here is a better way... - より安全な保存方法 + より安全な保存方法 - マスクをレイヤーダイアログからツールバーの未使用部分（最後の描画ツールの直後）にドラッグします。これで、マスクデータを含む1つのレイヤーからなる新しい画像が作成されます。これを、使用する設定に応じた希望のサイズまで縮小します。多くの場合、700～1500ピクセル程度の画像から始めて、最終的には300～400ピクセル程度の画像を作成します。 + マスクをレイヤーダイアログからツールバーの未使用部分（最後の描画ツール + の直後）にドラッグします。これで、マスクデータを含む1つのレイヤーからな + る新しい画像が作成されます。これを、使用する設定に応じた希望のサイズま + で縮小します。多くの場合、700～1500ピクセル程度の画像から始めて、最終的 + には300～400ピクセル程度の画像を作成します。 - マスク画像を NetPBM の Portable Greymap (".pgm") ファイルとして保存します。(古いバージョンの - GIMPを使用している場合は、保存する前に画像をグレースケールに変換する必要があるかもしれません)。よりコンパクトな「RAW - PGM」フォーマットを選択して保存します。(ファイルの2文字目はASCII数字の「5」、16進数のバイト0x35である必要があります) + マスク画像を NetPBM の Portable Greymap (".pgm") ファイルとして保存しま + す。(古いバージョンの GIMPを使用している場合は、保存する前に画像をグレ + ースケールに変換する必要があるかもしれません)。よりコンパクトな「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 コマンドで、２つのファイルを１つに合成します: + 最後に、以下のように pnmtopng コマンドで、２つのファイルを１つに合成し + ます: + + pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > + final-stamp.png - pnmtopng -force -compression 9 -alpha mask.pgm fg.ppm > - final-stamp.png diff --git a/docs/ja_JP.UTF-8/ENVVARS.txt b/docs/ja_JP.UTF-8/ENVVARS.txt index 72afb78ea..cddbe78d4 100644 --- a/docs/ja_JP.UTF-8/ENVVARS.txt +++ b/docs/ja_JP.UTF-8/ENVVARS.txt @@ -1,97 +1,103 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 Environment Variables Documentation - Copyright © 2021-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2021-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年5月 5日 + 2023年5月 5日 - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- - Tux Paint understands a number of environment variables, either directly, - or indirectly by the libraries that it utilizes. +Tux Paint understands a number of environment variables, either directly, or +indirectly by the libraries that it utilizes. Storage-related environment variables - HOME +HOME - Specifies the user's "home directory", which is used to locate - numerous other files or directories. In some cases, it is utilized - as part of a fall-back location, when other environment variables - (elsewhere in this documentation) are not set. Sometimes, the - location to use can be overridden by options provided on the - command-line or via Tux Paint's configuration file. See the - "OPTIONS" documentation for details. + Specifies the user's "home directory", which is used to locate numerous + other files or directories. In some cases, it is utilized as part of a + fall-back location, when other environment variables (elsewhere in this + documentation) are not set. Sometimes, the location to use can be + overridden by options provided on the command-line or via Tux Paint's + configuration file. See the "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 basis of where Tux Paint saves and loads users' drawings - * The location of a user's private collection of data files — - stamps, brushes, etc. — (versus those available system wide) + + The location of Tux Paint's configuration file + + The basis of where Tux Paint saves and loads users' drawings + + The location of a user's private collection of data files — stamps, + brushes, etc. — (versus those available system wide) - XDG_CONFIG_HOME - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's configuration files. - Specifically, where to find "user-dirs.dirs", where the - "XDG_PICTURES_DIR" might be defined. It is used for exporting - drawings and animated GIFs. Generally it's set to something like - "$HOME/Pictures/". If not specified, Tux Paint checks in the - directory "$HOME/.config/". If the configuration cannot be found, - Tux Paint simply exports drawings and GIFs to "$HOME". +XDG_CONFIG_HOME - XDG_DATA_HOME + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's configuration files. Specifically, where to find + "user-dirs.dirs", where the "XDG_PICTURES_DIR" might be defined. It is used + for exporting drawings and animated GIFs. Generally it's set to something + like "$HOME/Pictures/". If not specified, Tux Paint checks in the directory + "$HOME/.config/". If the configuration cannot be found, Tux Paint simply + exports drawings and GIFs to "$HOME". - On Linux and other platforms where the X Desktop Group standards - are used, the location of the user's data directories. - Specifically, where to find the "Trash" directory. It is used when - deleting images from Tux Paint's "Open" dialog. If not set, the - location "$HOME/.local/share/Trash/" is used, if available. If - not, images are simply deleted, rather than moved anywhere. - TEMP - Specifies the location where temporary files may be created. Only - used by Tux Paint on Microsoft Windows OSes. Uses "userdata" if - not set. +XDG_DATA_HOME + + On Linux and other platforms where the X Desktop Group standards are used, + the location of the user's data directories. Specifically, where to find + the "Trash" directory. It is used when deleting images from Tux Paint's + "Open" dialog. If not set, the location "$HOME/.local/share/Trash/" is + used, if available. If not, images are simply deleted, rather than moved + anywhere. + + + +TEMP + + Specifies the location where temporary files may be created. Only used by + Tux Paint on Microsoft Windows OSes. Uses "userdata" if not set. Language-related environment variables - LANG +LANG +LANGUAGE +LC_ALL +LC_MESSAGES - LANGUAGE + Specify the language Tux Paint should utilize in its user interface. + Overridde by the "--lang" and "--locale" command-line options or their + configuration file counterparts. The "LANGUAGE" environment variable is + used, if set. If not, "LC_ALL" is used as a fallback. Then "LC_MESSAGES", + and finally "LANG". - LC_ALL - LC_MESSAGES - Specify the language Tux Paint should utilize in its user - interface. Overridde by the "--lang" and "--locale" command-line - options or their configuration file counterparts. The "LANGUAGE" - environment variable is used, if set. If not, "LC_ALL" is used as - a fallback. Then "LC_MESSAGES", and finally "LANG". Display-related environment variables - The following are a few of the environment variables supported by Simple - DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying - graphics, playing sounds, and receiving mouse, keyboard, and joystick - input — and which may be useful to users of Tux Paint. +The following are a few of the environment variables supported by Simple +DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics, +playing sounds, and receiving mouse, keyboard, and joystick input — and which +may be useful to users of Tux Paint. + +SDL_VIDEO_ALLOW_SCREENSAVER + + Specifies whether Tux Paint should allow a screensaver to run. Can be set + to '1' (true) by Tux Paint itself by issuing the command-line option + "--allowscreensaver" or its configuration file counterpart. + + + +SDL_VIDEO_WINDOW_POS + + Requests where to position Tux Paint's window, and can be used to specify + what display to place a fullscreen Tux Paint in a multi-monitor + configuration. If not set, or set to "nopref" (meaning "no preference"), + Simple DirectMedia Layer (libSDL) decides. Can be set to an X,Y coordinate + (e.g. 200,100), or "center" (meaning "center"). - SDL_VIDEO_ALLOW_SCREENSAVER - Specifies whether Tux Paint should allow a screensaver to run. Can - be set to '1' (true) by Tux Paint itself by issuing the - command-line option "--allowscreensaver" or its configuration file - counterpart. - SDL_VIDEO_WINDOW_POS - Requests where to position Tux Paint's window, and can be used to - specify what display to place a fullscreen Tux Paint in a - multi-monitor configuration. If not set, or set to "nopref" - (meaning "no preference"), Simple DirectMedia Layer (libSDL) - decides. Can be set to an X,Y coordinate (e.g. 200,100), or - "center" (meaning "center"). diff --git a/docs/ja_JP.UTF-8/EXTENDING.txt b/docs/ja_JP.UTF-8/EXTENDING.txt index 193dbd6d4..04bbb8919 100644 --- a/docs/ja_JP.UTF-8/EXTENDING.txt +++ b/docs/ja_JP.UTF-8/EXTENDING.txt @@ -1,1053 +1,1071 @@ Extending Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 - Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年5月29日 + 2023年5月29日 - +------------------------------------------+ - |目次 | - |------------------------------------------| - | * Where Files Go | - | * Standard Files | - | * Personal Files | - | * Brushes | - | * Brush Options | - | * はんこ | - | * Stamp Images | - | * Stamp Descriptive Text | - | * Stamp Sound Effects | - | * Stamp Descriptive Sound | - | * Stamp Options | - | * Pre-Mirrored and Flipped Stamps | - | * フォント | - | * 'Starters' | - | * Coloring-Book Style Starters | - | * Scene-Style Starters | - | * Starter Options | - | * 'Templates' | - | * Template Options | - | * Translations | - | * Alternative Input Methods | - | * 画面キーボード | - | * Magic Tools | - +------------------------------------------+ ++-----------------------------------------+ +| 目次 | +|-----------------------------------------| +| * Where Files Go | +| + Standard Files | +| + Personal Files | +| * Brushes | +| + Brush Options | +| * はんこ | +| + Stamp Images | +| + Stamp Descriptive Text | +| + Stamp Sound Effects | +| + Stamp Descriptive Sound | +| + Stamp Options | +| + Pre-Mirrored and Flipped Stamps | +| * フォント | +| * 'Starters' | +| + Coloring-Book Style Starters | +| + Scene-Style Starters | +| + Starter Options | +| * 'Templates' | +| + Template Options | +| * Translations | +| * Alternative Input Methods | +| * 画面キーボード | +| * Magic Tools | ++-----------------------------------------+ - If you wish to add or change things like Brushes, Starters, Rubber Stamps, - and other content used by Tux Paint, you can do so fairly easily by simply - adding, changing, or removing files where Tux Paint looks for them. +If you wish to add or change things like Brushes, Starters, Rubber Stamps, and +other content used by Tux Paint, you can do so fairly easily by simply adding, +changing, or removing files where Tux Paint looks for them. - 💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. +💡 Note: You'll need to re-launch Tux Paint for the changes to take effect. - Where Files Go +Where Files Go Standard Files - Tux Paint looks for its various data files in its 'data' directory. +Tux Paint looks for its various data files in its 'data' directory. - Linux and Unix +Linux and Unix - Where this directory goes depends on what value was set for - "DATA_PREFIX" when Tux Paint was built. See 'Install - documentation' for details. + Where this directory goes depends on what value was set for "DATA_PREFIX" + when Tux Paint was built. See 'Install documentation' for details. - By default, though, the directory is: + By default, though, the directory is: - /usr/local/share/tuxpaint/ + /usr/local/share/tuxpaint/ - If you installed from a package, it is more likely to be: + If you installed from a package, it is more likely to be: - /usr/share/tuxpaint/ + /usr/share/tuxpaint/ - Windows - Tux Paint looks for a directory called 'data' in the same - directory as the executable. This is the directory that the - installer used when installing Tux Paint e.g.: - C:\Program Files\TuxPaint\data +Windows - macOS + Tux Paint looks for a directory called 'data' in the same directory as the + executable. This is the directory that the installer used when installing + Tux Paint e.g.: - Tux Paint stores its data files inside the "Tux Paint" application - icon (which is actually a special kind of folder on macOS & Mac OS - X before it). The following steps explain how to get to the - folders within it: + C:\Program Files\TuxPaint\data - 1. Bring up a 'context' menu by holding the [Control] key and - clicking the Tux Paint icon the in Finder. (If you have a - mouse with more than one button, you can simply right-click - the icon.) - 2. Select "Show Contents" from the menu that appears. A new - Finder window will appear with a folder inside called - "Contents". - 3. Open the "Contents" folder and open the "Resources" folder - found inside. - 4. There, you will find various sub-folders, such as "starters", - "stamps", "brushes", etc. Adding new content to these folders - will make the content available to any user that launches - this copy (icon) of Tux Paint. - 💡 Note: If you install a newer version of Tux Paint and replace or - discard the old version, you will lose changes made by following - the instructions above, so keep backups of your new content - (stamps, brushes, etc.). - Tux Paint also looks for files in a "TuxPaint" folder that you can - place in your system's "Application Support" folder (found under - "Library" at the root of your filesystem): +macOS + + Tux Paint stores its data files inside the "Tux Paint" application icon + (which is actually a special kind of folder on macOS & Mac OS X before it). + The following steps explain how to get to the folders within it: + + 1. Bring up a 'context' menu by holding the [Control] key and clicking the + Tux Paint icon the in Finder. (If you have a mouse with more than one + button, you can simply right-click the icon.) + 2. Select "Show Contents" from the menu that appears. A new Finder window + will appear with a folder inside called "Contents". + 3. Open the "Contents" folder and open the "Resources" folder found + inside. + 4. There, you will find various sub-folders, such as "starters", "stamps", + "brushes", etc. Adding new content to these folders will make the + content available to any user that launches this copy (icon) of Tux + Paint. + + 💡 Note: If you install a newer version of Tux Paint and replace or discard + the old version, you will lose changes made by following the instructions + above, so keep backups of your new content (stamps, brushes, etc.). + + Tux Paint also looks for files in a "TuxPaint" folder that you can place in + your system's "Application Support" folder (found under "Library" at the + root of your filesystem): + + /Library/Application Support/TuxPaint/ + + When you upgrade to a newer version of Tux Paint, the contents of this + "TuxPaint" folder will stay the same, and remain accessible by all users of + Tux Paint. + - /Library/Application Support/TuxPaint/ - When you upgrade to a newer version of Tux Paint, the contents of - this "TuxPaint" folder will stay the same, and remain accessible - by all users of Tux Paint. Personal Files - You can also create brushes, stamps, 'starters', templates, and fonts in - your own user account directory (folder) for Tux Paint to find. +You can also create brushes, stamps, 'starters', templates, and fonts in your +own user account directory (folder) for Tux Paint to find. - Windows +Windows - Your personal Tux Paint folder is stored in your personal - "Application Data". For example, on newer Windows: + Your personal Tux Paint folder is stored in your personal "Application + Data". For example, on newer Windows: - C:\Documents and Settings\(username)\Application Data\TuxPaint\ + C:\Documents and Settings\(username)\Application Data\TuxPaint\ - macOS - Your personal Tux Paint folder is stored in your personal - "Application Support" folder: - /Users/(username)/Library/Application Support/TuxPaint/ +macOS - Linux and Unix + Your personal Tux Paint folder is stored in your personal "Application + Support" folder: - Your personal Tux Paint files go into a 'hidden directory' found - in your account's home directory: "$(HOME)/.tuxpaint/" (also known - as "~/.tuxpaint/"). + /Users/(username)/Library/Application Support/TuxPaint/ - That is, if your home directory is "/home/tux", then your personal - Tux Paint files go in "/home/tux/.tuxpaint/". - Don't forget the period (".") before the "tuxpaint"! - To add your own brushes, stamps, 'starters,' templates, and fonts, create - subdirectories under your personal Tux Paint directory named "brushes", - "stamps", "starters", "templates", "fonts", respectively. +Linux and Unix - (For example, if you created a brush named "flower.png", you would put it - in "~/.tuxpaint/brushes/" under Linux or Unix.) + Your personal Tux Paint files go into a 'hidden directory' found in your + account's home directory: "$(HOME)/.tuxpaint/" (also known as "~/.tuxpaint/ + "). - Brushes + That is, if your home directory is "/home/tux", then your personal Tux + Paint files go in "/home/tux/.tuxpaint/". - The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux - Paint are simply PNG image files. + Don't forget the period (".") before the "tuxpaint"! - The alpha (transparency) of the PNG image is used to determine the shape - of the brush, which means that the shape can be 'anti-aliased' and even - partially-transparent! - Greyscale pixels in the brush PNG will be drawn using the - currently-selected color in Tux Paint. Color pixels will be tinted. + + +To add your own brushes, stamps, 'starters,' templates, and fonts, create +subdirectories under your personal Tux Paint directory named "brushes", "stamps +", "starters", "templates", "fonts", respectively. + +(For example, if you created a brush named "flower.png", you would put it in "~ +/.tuxpaint/brushes/" under Linux or Unix.) + +Brushes + +The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux Paint +are simply PNG image files. + +The alpha (transparency) of the PNG image is used to determine the shape of the +brush, which means that the shape can be 'anti-aliased' and even +partially-transparent! + +Greyscale pixels in the brush PNG will be drawn using the currently-selected +color in Tux Paint. Color pixels will be tinted. Brush Options - Aside from a graphical shape, brushes can also be given other attributes. - To do this, you need to create a 'data file' for the brush. +Aside from a graphical shape, brushes can also be given other attributes. To do +this, you need to create a 'data file' for the brush. - A brush's data file is simply a plain ASCII text file containing the - options for the brush. +A brush's data file is simply a plain ASCII text file containing the options +for the brush. - The file has the same name as the PNG image, but a ".dat" extension. - (e.g., "brush.png"'s data file is the text file "brush.dat", found in the - same directory.) +The file has the same name as the PNG image, but a ".dat" extension. (e.g., +"brush.png"'s data file is the text file "brush.dat", found in the same +directory.) - ブラシの描画間隔 +ブラシの描画間隔 - As of Tux Paint version 0.9.16, you can now specify the spacing - for brushes (that is, how often they are drawn). By default, the - spacing will be the brush's height, divided by 4. + As of Tux Paint version 0.9.16, you can now specify the spacing for brushes + (that is, how often they are drawn). By default, the spacing will be the + brush's height, divided by 4. - Add a line containing the line "spacing=N" to the brush's data - file, where "N" is the spacing you want for the brush. (The lower - the number, the more often the brush is drawn.) + Add a line containing the line "spacing=N" to the brush's data file, where + "N" is the spacing you want for the brush. (The lower the number, the more + often the brush is drawn.) - Animated Brushes - As of Tux Paint version 0.9.16, you may now create animated - brushes. As the brush is used, each frame of the animation is - drawn. - Lay each frame out across a wide PNG image. For example, if your - brush is 30x30 and you have 5 frames, the image should be 150x30. +Animated Brushes - Add a line containing the line "frames=N" to the brush's data - file, where "N" is the number of frames in the brush. + As of Tux Paint version 0.9.16, you may now create animated brushes. As the + brush is used, each frame of the animation is drawn. - ⚙ Note: If you'd rather the frames be flipped through randomly, - rather than sequentially, also add a line containing "random" to - the brush's data file. + Lay each frame out across a wide PNG image. For example, if your brush is + 30x30 and you have 5 frames, the image should be 150x30. - Directional Brushes + Add a line containing the line "frames=N" to the brush's data file, where " + N" is the number of frames in the brush. - As of Tux Paint version 0.9.16, you may now create directional - brushes. As the brush is used, different shapes are drawn, - depending on the direction the brush is going. + ⚙ Note: If you'd rather the frames be flipped through randomly, rather than + sequentially, also add a line containing "random" to the brush's data file. - The directional shapes are divided into a 3x3 square in a PNG - image. For example, if your brush is 30x30, the image should be - 90x90, and each of the direction's shapes placed in a 3x3 grid. - The center region is used for no motion. The top right is used for - motion that's both up, and to the right. And so on. - Add a line containing the word "directional" to the brush's data - file. - Rotating Brushes +Directional Brushes - As of Tux Paint version 0.9.27, you may now create rotating - brushes. As the brush is used, it is rotated 360 degrees, - depending on the direction the brush is going. + As of Tux Paint version 0.9.16, you may now create directional brushes. As + the brush is used, different shapes are drawn, depending on the direction + the brush is going. - Add a line containing the word "rotate" to the brush's data file. + The directional shapes are divided into a 3x3 square in a PNG image. For + example, if your brush is 30x30, the image should be 90x90, and each of the + direction's shapes placed in a 3x3 grid. The center region is used for no + motion. The top right is used for motion that's both up, and to the right. + And so on. - Animated Directional or Rotating Brushes + Add a line containing the word "directional" to the brush's data file. - You may mix both animated and either directional or rotating - features into one brush. Use both options desired ("frames=N" and - "directional" or "rotate"), in separate lines in the brush's - ".dat" file. - For directional brushes, lay the brush out so that each 3x3 set of - directional shapes are laid out across a wide PNG image. For - example, if the brush is 30x30 and there are 5 frames, it would be - 450x90. (The leftmost 150x90 pixels of the image represent the 9 - direction shapes for the first frame, for example.) - Place the brush image PNGs (and any data text files) in the "brushes" - directory. +Rotating Brushes - 💡 Note: If your new brushes all come out as solid squares or rectangles, - it's because you forgot to use alpha transparency! See the 'PNG - documentation' in Tux Paint for more information and tips. + As of Tux Paint version 0.9.27, you may now create rotating brushes. As the + brush is used, it is rotated 360 degrees, depending on the direction the + brush is going. - はんこ + Add a line containing the word "rotate" to the brush's data file. - All stamp-related files go in the "stamps" directory. It's useful to - create subdirectories and sub-subdirectories there to organize the stamps. - (For example, you can have a "holidays" folder with "halloween" and - "christmas" sub-folders.) + + +Animated Directional or Rotating Brushes + + You may mix both animated and either directional or rotating features into + one brush. Use both options desired ("frames=N" and "directional" or " + rotate"), in separate lines in the brush's ".dat" file. + + For directional brushes, lay the brush out so that each 3x3 set of + directional shapes are laid out across a wide PNG image. For example, if + the brush is 30x30 and there are 5 frames, it would be 450x90. (The + leftmost 150x90 pixels of the image represent the 9 direction shapes for + the first frame, for example.) + + + + +Place the brush image PNGs (and any data text files) in the "brushes" +directory. + +💡 Note: If your new brushes all come out as solid squares or rectangles, it's +because you forgot to use alpha transparency! See the 'PNG documentation' in +Tux Paint for more information and tips. + +はんこ + +All stamp-related files go in the "stamps" directory. It's useful to create +subdirectories and sub-subdirectories there to organize the stamps. (For +example, you can have a "holidays" folder with "halloween" and "christmas" +sub-folders.) Stamp Images - Rubber Stamps in Tux Paint can be made up of a number of separate files. - The one file that is required is, of course, the picture itself. +Rubber Stamps in Tux Paint can be made up of a number of separate files. The +one file that is required is, of course, the picture itself. - As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or - SVG vector images. They can be full-color or greyscale. The alpha - (transparency) channel of PNGs is used to determine the actual shape of - the picture (otherwise you'll stamp a large rectangle on your drawings). +As of Tux Paint version 0.9.17, Stamps may be either PNG bitmap images or SVG +vector images. They can be full-color or greyscale. The alpha (transparency) +channel of PNGs is used to determine the actual shape of the picture (otherwise +you'll stamp a large rectangle on your drawings). - PNGs can be any size, and Tux Paint (by default) provides a set of sizing - buttons to let the user scale the stamp up (larger) and down (smaller). +PNGs can be any size, and Tux Paint (by default) provides a set of sizing +buttons to let the user scale the stamp up (larger) and down (smaller). - SVGs are vector-based, and will be scaled appropriately for the canvas - size being used in Tux Paint. +SVGs are vector-based, and will be scaled appropriately for the canvas size +being used in Tux Paint. - 💡 Note: If your new PNG-based stamps all come out as solid squares or - rectangles, it's because you forgot to use alpha transparency! See the - 'PNG documentation' in Tux Paint for more information and tips. +💡 Note: If your new PNG-based stamps all come out as solid squares or +rectangles, it's because you forgot to use alpha transparency! See the 'PNG +documentation' in Tux Paint for more information and tips. - 💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure - the SVG 'document' is no larger than the shape(s) within. If they are - being clipped, make sure the 'document' is large enough to contain the - shape(s). See the 'SVG documentation' in Tux Paint for more information - and tips. +💡 Note: If your new SVG stamps seem to have a lot of whitespace, make sure the +SVG 'document' is no larger than the shape(s) within. If they are being +clipped, make sure the 'document' is large enough to contain the shape(s). See +the 'SVG documentation' in Tux Paint for more information and tips. - ⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in - detail, how to make PNG images which will scale perfectly when used as - stamps in Tux Paint. +⚙ Advanced Users: The 'Advanced Stamps How-To' document describes, in detail, +how to make PNG images which will scale perfectly when used as stamps in Tux +Paint. Stamp Descriptive Text - Tux Paint will display descriptive text when a stamp is selected. These - are placed in plain text files with the same name as the PNG or SVG, but - with a ".txt" filename extension. (e.g., "stamp.png"'s description is - stored in "stamp.txt" in the same directory.) +Tux Paint will display descriptive text when a stamp is selected. These are +placed in plain text files with the same name as the PNG or SVG, but with a +".txt" filename extension. (e.g., "stamp.png"'s description is stored in +"stamp.txt" in the same directory.) - The first line of the text file will be used as the US English description - of the stamp's image. It must be encoded in UTF-8. +The first line of the text file will be used as the US English description of +the stamp's image. It must be encoded in UTF-8. - Localization Support +Localization Support - Additional lines can be added to the text file to provide - translations of the description, to be displayed when Tux Paint is - running in a different locale (like French or Spanish). + Additional lines can be added to the text file to provide translations of + the description, to be displayed when Tux Paint is running in a different + locale (like French or Spanish). - The beginning of the line should correspond to the language code - of the language in question (e.g., "fr" for French, and "zh_TW" - for Traditional Chinese), followed by ".utf8=" and the translated - description (Unicode, encoded in UTF-8). + The beginning of the line should correspond to the language code of the + language in question (e.g., "fr" for French, and "zh_TW" for Traditional + Chinese), followed by ".utf8=" and the translated description (Unicode, + encoded in UTF-8). - For Tux Paint developers: There are scripts in the "po" directory - for converting the text files to PO format (and back) for easy - translation to different languages. Therefore you should never add - or change translations in the ".txt" files directly. + For Tux Paint developers: There are scripts in the "po" directory for + converting the text files to PO format (and back) for easy translation to + different languages. Therefore you should never add or change translations + in the ".txt" files directly. + + If no translation is available for the language Tux Paint is currently + running in, the US English text is used. + + + +Windows のユーザー + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. - If no translation is available for the language Tux Paint is - currently running in, the US English text is used. - Windows のユーザー - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. Stamp Sound Effects - Tux Paint can play a sound effect when a stamp is selected. For example, - the sound of a duck quaking when selecting a duck, or a brief piece of - music when a musical instrument is chosen. Files may be in "WAVE (".wav")" - or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG or - SVG image. (e.g., "stamp.svg"'s sound effect is the sound file "stamp.ogg" - in the same directory.) +Tux Paint can play a sound effect when a stamp is selected. For example, the +sound of a duck quaking when selecting a duck, or a brief piece of music when a +musical instrument is chosen. Files may be in "WAVE (".wav")" or "OGG Vorbis +(".ogg")" formats, and are given same name as the PNG or SVG image. (e.g., +"stamp.svg"'s sound effect is the sound file "stamp.ogg" in the same +directory.) - Localization Support +Localization Support - For sounds for different locales (e.g., if the sound is someone - saying a word, and you want translated versions of the word said), - also create WAV or OGG files with the locale's label in the - filename, in the form: "stamp_LOCALE.EXT" + For sounds for different locales (e.g., if the sound is someone saying a + word, and you want translated versions of the word said), also create WAV + or OGG files with the locale's label in the filename, in the form: + "stamp_LOCALE.EXT" - The sound effect that will be played when the stamp corresponding - to the image file "stamp.png" is selected, and when Tux Paint is - using the Spanish locale, would be "stamp_es.wav". Under the - French locale, it would be "stamp_fr.wav". Under the Brazilian - Portuguese locale, "stamp_pt_BR.wav". And so on... + The sound effect that will be played when the stamp corresponding to the + image file "stamp.png" is selected, and when Tux Paint is using the Spanish + locale, would be "stamp_es.wav". Under the French locale, it would be + "stamp_fr.wav". Under the Brazilian Portuguese locale, "stamp_pt_BR.wav". + And so on... - If no localized sound effect can be loaded, Tux Paint will attempt - to load the 'default' sound file. (e.g., "stamp.wav") + If no localized sound effect can be loaded, Tux Paint will attempt to load + the 'default' sound file. (e.g., "stamp.wav") - 💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive - Sound', below. + + + +💡 Note: Also consider using descriptive sounds; see 'Stamp Descriptive Sound', +below. Stamp Descriptive Sound - Tux Paint can also play a descriptive sound when a stamp is selected. For - example, the sound of someone saying the word "duck" when selecting a - duck, or the name of a musical instrument when one is chosen. Files may be - in "WAVE (".wav")" or "OGG Vorbis (".ogg")" formats, and are given same - name as the PNG or SVG image, with "_desc" at the end. (e.g., - "stamp.svg"'s descriptive sound is the sound file "stamp_desc.ogg" in the - same directory.) +Tux Paint can also play a descriptive sound when a stamp is selected. For +example, the sound of someone saying the word "duck" when selecting a duck, or +the name of a musical instrument when one is chosen. Files may be in "WAVE +(".wav")" or "OGG Vorbis (".ogg")" formats, and are given same name as the PNG +or SVG image, with "_desc" at the end. (e.g., "stamp.svg"'s descriptive sound +is the sound file "stamp_desc.ogg" in the same directory.) - Localization Support +Localization Support + + For descriptive sounds for different locales, also create WAV or OGG files + with both "_desc" and the locale's label in the filename, in the form: + "stamp_desc_LOCALE.EXT" + + The descriptive sound that will be played when the stamp corresponding to + the image file "stamp.png" is selected, and when Tux Paint is using the + Spanish locale, would be "stamp_desc_es.wav". Under the French locale, it + would be "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, + "stamp_desc_pt_BR.wav". And so on... + + If no localized descriptive sound can be loaded, Tux Paint will attempt to + load the 'default' sound file. (e.g., "stamp_desc.wav") - For descriptive sounds for different locales, also create WAV or - OGG files with both "_desc" and the locale's label in the - filename, in the form: "stamp_desc_LOCALE.EXT" - The descriptive sound that will be played when the stamp - corresponding to the image file "stamp.png" is selected, and when - Tux Paint is using the Spanish locale, would be - "stamp_desc_es.wav". Under the French locale, it would be - "stamp_desc_fr.wav". Under the Brazilian Portuguese locale, - "stamp_desc_pt_BR.wav". And so on... - If no localized descriptive sound can be loaded, Tux Paint will - attempt to load the 'default' sound file. (e.g., "stamp_desc.wav") Stamp Options - Aside from a graphical shape, a textual description, a sound effect, and a - descriptive sound, stamps can also be given other attributes. To do this, - you need to create a 'data file' for the stamp. +Aside from a graphical shape, a textual description, a sound effect, and a +descriptive sound, stamps can also be given other attributes. To do this, you +need to create a 'data file' for the stamp. - A stamp's data file is simply a plain ASCII text file containing the - options for the stamp. +A stamp's data file is simply a plain ASCII text file containing the options +for the stamp. - The file has the same name as the PNG or SVG image, but a ".dat" - extension. (e.g., "stamp.png"'s data file is the text file "stamp.dat", - found in the same directory.) +The file has the same name as the PNG or SVG image, but a ".dat" extension. +(e.g., "stamp.png"'s data file is the text file "stamp.dat", found in the same +directory.) - Colored Stamps +Colored Stamps - Stamps can be made to be either "colorable" or "tintable." + Stamps can be made to be either "colorable" or "tintable." - Colorable + Colorable - "Colorable" stamps they work much like brushes - you - pick the stamp to get the shape, and then pick the - color you want it to be. (Symbol stamps, like the - mathematical and musical ones, are an example.) + "Colorable" stamps they work much like brushes - you pick the stamp to + get the shape, and then pick the color you want it to be. (Symbol + stamps, like the mathematical and musical ones, are an example.) - Nothing about the original image is used except the - transparency (from "alpha" channel). The color of the - stamp comes out solid. + Nothing about the original image is used except the transparency (from + "alpha" channel). The color of the stamp comes out solid. - Add a line containing the word "colorable" to the - stamp's data file. + Add a line containing the word "colorable" to the stamp's data file. - Tinted - "Tinted" stamps are similar to "colorable" ones, - except the details of the original image are kept. - (To put it technically, the original image is used, - but its hue is changed, based on the - currently-selected color.) - Add a line containing the word "tintable" to the - stamp's data file. + Tinted - Tinting Options: + "Tinted" stamps are similar to "colorable" ones, except the details of + the original image are kept. (To put it technically, the original image + is used, but its hue is changed, based on the currently-selected + color.) - Depending on the contents of your stamp, you might - want to have Tux Paint use one of a number of methods - when tinting it. Add one of the following lines to - the stamp's data file: + Add a line containing the word "tintable" to the stamp's data file. - Normal tinter — "tinter=normal" (the default) - This is the normal tinting mode. First, - the primary hue of the stamp is - determined. (For example, a picture of a - flower with a stem will have the petal - color seen as the primary hue of the - overall image.) Next, the most highly - saturated part of the picture is found. - With "normal tinter", the range of hue - used to do this starts out within ±18° - of the pimary hue found in step 1. (If - none can be found, it widens the range - by 50% and tries again.) Finally, the - image is tinted. Anything falling within - 50% of the range (e.g., ±27°) is altered - to have the hue of the color chosen by - the user. - Narrow tinter — "tinter=narrow" - This like the "normal" option described - above, but starts a narrower hue range - of ±6°. Anything found within 50% of the - range (e.g. ±9°) is tinted. If too much - of your stamp is being tinted, try this - option. - 'Any hue' tinter — "tinter=anyhue" - This remaps all hues in the stamp. It - works similarly to the "anyhue" and - "narrow" options described above, but - the hue range is ±180°. + Tinting Options: - Vector tinter — "tinter=vector" - This maps 'black through white' to - 'black through destination'. + Depending on the contents of your stamp, you might want to have Tux + Paint use one of a number of methods when tinting it. Add one of the + following lines to the stamp's data file: - Unalterable Stamps + Normal tinter — "tinter=normal" (the default) + This is the normal tinting mode. First, the primary hue of the + stamp is determined. (For example, a picture of a flower with a + stem will have the petal color seen as the primary hue of the + overall image.) Next, the most highly saturated part of the picture + is found. With "normal tinter", the range of hue used to do this + starts out within ±18° of the pimary hue found in step 1. (If none + can be found, it widens the range by 50% and tries again.) Finally, + the image is tinted. Anything falling within 50% of the range + (e.g., ±27°) is altered to have the hue of the color chosen by the + user. - By default, a stamp can be flipped upside down, shown as a mirror - image, or both. This is done using the control buttons below the - stamp selector, at the lower right side of the screen in Tux - Paint. + Narrow tinter — "tinter=narrow" + This like the "normal" option described above, but starts a + narrower hue range of ±6°. Anything found within 50% of the range + (e.g. ±9°) is tinted. If too much of your stamp is being tinted, + try this option. - Sometimes, it doesn't make sense for a stamp to be flippable or - mirrored; for example, stamps of letters or numbers. Sometimes - stamps are symmetrical, so letting the user flip or mirror them - isn't useful. + 'Any hue' tinter — "tinter=anyhue" + This remaps all hues in the stamp. It works similarly to the + "anyhue" and "narrow" options described above, but the hue range is + ±180°. - To prevent a stamp from being flipped vertically, add the option - "noflip" to the stamp's data file. + Vector tinter — "tinter=vector" + This maps 'black through white' to 'black through destination'. - To prevent a stamp from being mirrored horizontally, add the - option "nomirror" to the stamp's data file. - スタンプの初期サイズ - By default, Tux Paint assumes that your stamp is sized - appropriately for unscaled display on a 608x472 canvas. This was - the original Tux Paint canvas size, provided by a 640x480 screen. - Tux Paint will then adjust the stamp according to the current - canvas size and, if enabled, the user's stamp size controls. - If your stamp would be too big or too small, you can specify a - scale factor. If your stamp would be 2.5 times as wide (or tall) - as it should be, add one of the following options, which represent - the same adjustment, to the stamp's data file. (An equals sign, - "=", may be included after the word "scale".) - * "scale 40%" - * "scale 5/2" - * "scale 2.5" - * "scale 2:5" - Windows のユーザー - Use NotePad or WordPad to edit/create these files. Be sure to save - them as plain-text, and make sure they have a ".txt" extension at - the end of the filename. +Unalterable Stamps + + By default, a stamp can be flipped upside down, shown as a mirror image, or + both. This is done using the control buttons below the stamp selector, at + the lower right side of the screen in Tux Paint. + + Sometimes, it doesn't make sense for a stamp to be flippable or mirrored; + for example, stamps of letters or numbers. Sometimes stamps are + symmetrical, so letting the user flip or mirror them isn't useful. + + To prevent a stamp from being flipped vertically, add the option "noflip" + to the stamp's data file. + + To prevent a stamp from being mirrored horizontally, add the option " + nomirror" to the stamp's data file. + + + +スタンプの初期サイズ + + By default, Tux Paint assumes that your stamp is sized appropriately for + unscaled display on a 608x472 canvas. This was the original Tux Paint + canvas size, provided by a 640x480 screen. Tux Paint will then adjust the + stamp according to the current canvas size and, if enabled, the user's + stamp size controls. + + If your stamp would be too big or too small, you can specify a scale + factor. If your stamp would be 2.5 times as wide (or tall) as it should be, + add one of the following options, which represent the same adjustment, to + the stamp's data file. (An equals sign, "=", may be included after the word + "scale".) + + + "scale 40%" + + "scale 5/2" + + "scale 2.5" + + "scale 2:5" + + +Windows のユーザー + + Use NotePad or WordPad to edit/create these files. Be sure to save them as + plain-text, and make sure they have a ".txt" extension at the end of the + filename. + + + Pre-Mirrored and Flipped Stamps - In some cases, you may wish to provide a pre-drawn version of a stamp's - mirror-image, flipped image, or even both. For example, imagine a picture - of a fire truck with the words "Fire Department" written across the side. - You probably do not want that text to appear backwards when the image is - flipped! +In some cases, you may wish to provide a pre-drawn version of a stamp's +mirror-image, flipped image, or even both. For example, imagine a picture of a +fire truck with the words "Fire Department" written across the side. You +probably do not want that text to appear backwards when the image is flipped! - To create a mirrored version of a stamp that you want Tux Paint to use, - rather than mirroring one on its own, simply create a second ".png" or - ".svg" graphics file with the same name, except with "_mirror" before the - filename extension. +To create a mirrored version of a stamp that you want Tux Paint to use, rather +than mirroring one on its own, simply create a second ".png" or ".svg" graphics +file with the same name, except with "_mirror" before the filename extension. - For example, for the stamp "stamp.png" you would create another file named - "stamp_mirror.png", which will be used when the stamp is mirrored (rather - than using a backwards version of "stamp.png"). +For example, for the stamp "stamp.png" you would create another file named +"stamp_mirror.png", which will be used when the stamp is mirrored (rather than +using a backwards version of "stamp.png"). - As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with - "_flip" in the name, and/or an image that is both mirrored and flipped, by - naming it "_mirror_flip". +As of Tux Paint 0.9.18, you may similarly provide a pre-flipped image with " +_flip" in the name, and/or an image that is both mirrored and flipped, by +naming it "_mirror_flip". - 💡 Note: If the user flips and mirrors an image, and a pre-drawn - "_mirror_flip" doesn't exist, but either "_flip" or "_mirror" does, it - will be used, and mirrored or flipped, respectively. +💡 Note: If the user flips and mirrors an image, and a pre-drawn "_mirror_flip" +doesn't exist, but either "_flip" or "_mirror" does, it will be used, and +mirrored or flipped, respectively. - フォント +フォント - The fonts used by Tux Paint are TrueType Fonts (TTF). +The fonts used by Tux Paint are TrueType Fonts (TTF). - Simply place them in the "fonts" directory. Tux Paint will load the font - and provide four different sizes in the 'Letters' selector when using the - 'Text' and 'Label' tools. +Simply place them in the "fonts" directory. Tux Paint will load the font and +provide four different sizes in the 'Letters' selector when using the 'Text' +and 'Label' tools. - 'Starters' +'Starters' - 'Starter' images appear in the 'New' dialog, along with solid color - background choices. +'Starter' images appear in the 'New' dialog, along with solid color background +choices. - When you use a 'starter' image, make modifications, and save it, the - original 'starter' image is not overwritten. Additionally, as you edit - your new picture, the contents of the original 'starter' can affect it. +When you use a 'starter' image, make modifications, and save it, the original +'starter' image is not overwritten. Additionally, as you edit your new picture, +the contents of the original 'starter' can affect it. Coloring-Book Style Starters - The most basic kind of 'starter' is similar to a picture in a coloring - book. It's an outline of a shape which you can then color in and add - details to. In Tux Paint, as you draw, type text, or stamp stamps, the - outline remains 'above' what you draw. You can erase the parts of the - drawing you made, but you can't erase the outline. +The most basic kind of 'starter' is similar to a picture in a coloring book. +It's an outline of a shape which you can then color in and add details to. In +Tux Paint, as you draw, type text, or stamp stamps, the outline remains 'above' +what you draw. You can erase the parts of the drawing you made, but you can't +erase the outline. - To create this kind of 'starter' image, simply create an outlined black - and white picture in a paint program, and save it as a raster PNG file, or - vector SVG. If saving as a PNG, you may optionally render the image as - black-and-transparent, rather than black-and-white, but (as of Tux Paint - 0.9.21) this is not required. +To create this kind of 'starter' image, simply create an outlined black and +white picture in a paint program, and save it as a raster PNG file, or vector +SVG. If saving as a PNG, you may optionally render the image as +black-and-transparent, rather than black-and-white, but (as of Tux Paint +0.9.21) this is not required. Scene-Style Starters - Along with the 'coloring-book' style overlay, you can also provide a - separate background image as part of a 'starter' picture. The overlay acts - the same: it can't be drawn over, erased, or affected by 'Magic' tools. - However, the background can be! +Along with the 'coloring-book' style overlay, you can also provide a separate +background image as part of a 'starter' picture. The overlay acts the same: it +can't be drawn over, erased, or affected by 'Magic' tools. However, the +background can be! - When the 'Eraser' tool is used on a picture based on this kind of - 'starter' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'starter' image. +When the 'Eraser' tool is used on a picture based on this kind of 'starter' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'starter' image. - By creating both an overlay and a background, you can create a 'starter' - which simulates depth. Imagine a background that shows the ocean, and an - overlay that's a picture of a reef. You can then draw (or stamp) fish in - the picture. They'll appear in the ocean, but never 'in front of' the - reef. +By creating both an overlay and a background, you can create a 'starter' which +simulates depth. Imagine a background that shows the ocean, and an overlay +that's a picture of a reef. You can then draw (or stamp) fish in the picture. +They'll appear in the ocean, but never 'in front of' the reef. - To create this kind of 'starter' picture, simply create an overlay (with - transparency) and save it as a PNG. Then create another image (without - transparency), and save it with the same filename, but with "-back" (short - for 'background') appended to the name. (e.g., "starter-back.png" would be - the background ocean picture that corresponds to the overlay, or - foreground.) +To create this kind of 'starter' picture, simply create an overlay (with +transparency) and save it as a PNG. Then create another image (without +transparency), and save it with the same filename, but with "-back" (short for +'background') appended to the name. (e.g., "starter-back.png" would be the +background ocean picture that corresponds to the overlay, or foreground.) - For best results, 'starter' images should be at least the same size as Tux - Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" - section of Tux Paint's main documentation (README) for details on sizing.) - If they are not, they will be stretched or scaled. This is done without - affecting the shape ("aspect ratio"); however some smudging may be applied - to the edges. +For best results, 'starter' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. - Place them in the "starters" directory. When the 'New' dialog is accessed - in Tux Paint, the 'starter' images will appear in the screen that appears, - after the various solid color choices. +Place them in the "starters" directory. When the 'New' dialog is accessed in +Tux Paint, the 'starter' images will appear in the screen that appears, after +the various solid color choices. - 💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file - that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'starter' image, it - will always be affected by it.) +💡 Note: 'Starters' are 'attached' to saved pictures, via a small text file that +has the same name as the saved file, but with ".dat" as the extension. This +allows it to continue to affect the drawing even after Tux Paint has been quit, +or another picture is loaded or a new image is created. (In other words, if you +base a drawing on a 'starter' image, it will always be affected by it.) Starter Options - Aside from an image, starters can also be given other attributes. To do - this, you need to create a 'data file' for the starter. (Note: Tux Paint - prior to version 0.9.29 did not support starter options.) +Aside from an image, starters can also be given other attributes. To do this, +you need to create a 'data file' for the starter. (Note: Tux Paint prior to +version 0.9.29 did not support starter options.) - A starter's data file is simply a plain ASCII text file containing the - options for the starter. +A starter's data file is simply a plain ASCII text file containing the options +for the starter. - The file has the same name as the image, but a ".dat" extension. (e.g., - "starter.png"'s data file is the text file "starter.dat", found in the - same directory.) +The file has the same name as the image, but a ".dat" extension. (e.g., +"starter.png"'s data file is the text file "starter.dat", found in the same +directory.) - allowscale +allowscale - When a starter image is a different aspect ratio (width-to-height - proportions) than Tux Paint's canvas, by default it will be scaled - to fit entirely within the canvas, without stretching the starter - (changing its aspect ratio); for example, a square starter on a - portrait-shaped canvas will be placed in the center of the canvas. - By default, Tux Paint will then take the strip of pixels at the - edges of the starter and stretch them to the edges of the canvas, - "smearing" it. + When a starter image is a different aspect ratio (width-to-height + proportions) than Tux Paint's canvas, by default it will be scaled to fit + entirely within the canvas, without stretching the starter (changing its + aspect ratio); for example, a square starter on a portrait-shaped canvas + will be placed in the center of the canvas. By default, Tux Paint will then + take the strip of pixels at the edges of the starter and stretch them to + the edges of the canvas, "smearing" it. - If it's acceptable for the starter image to be cropped in one or - both directions, the "allowscale" may be used to tell Tux Paint - which behavior to allow: + If it's acceptable for the starter image to be cropped in one or both + directions, the "allowscale" may be used to tell Tux Paint which behavior + to allow: - * For starters where it's alright to crop the left and right - edges, but the top and bottom edges must be retained, use - "allowscale=horizontal". - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the height of the - canvas, and the left and right will be cropped. - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the height of the - canvas, and no cropping will occur, and the left and - right edges will be smeared. - * For starters where it's alright to crop the top and bottom - edges, but the left and right edges must be retained, use - "allowscale=vertical". - * If the starter's aspect ratio is taller than that of the - canvas, it will be scaled to fit the width of the - canvas, and the top and bottom will be cropped. - * If the starter's aspect ratio is wider than that of the - canvas, it will be scaled to fit the width of the - canvas, and no cropping will occur, and the top and - bottom edges will be smeared. - * If it's acceptable to crop either the top and bottom or the - left and right, use "allowscale=both". Contents from starter - will always fill the canvas, regardless of how its aspect - ratio compares to that of the canvas. - * The default behavior is to not allow cropping. This may be - specified explicitly with "allowscale=none". + + For starters where it's alright to crop the left and right edges, but + the top and bottom edges must be retained, use "allowscale=horizontal". + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the height of the canvas, and the left and + right will be cropped. + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the height of the canvas, and no cropping + will occur, and the left and right edges will be smeared. - background + + For starters where it's alright to crop the top and bottom edges, but + the left and right edges must be retained, use "allowscale=vertical". + o If the starter's aspect ratio is taller than that of the canvas, it + will be scaled to fit the width of the canvas, and the top and + bottom will be cropped. + o If the starter's aspect ratio is wider than that of the canvas, it + will be scaled to fit the width of the canvas, and no cropping will + occur, and the top and bottom edges will be smeared. - This option allows you to specify how Tux Paint should fill the - rest of the canvas, when the starter does not fit in one or the - other direction. By default, as described above, Tux Paint will - "smear" the pixels from the edges of the starter. (This can be - specified explicitly with "background=smear".) + + If it's acceptable to crop either the top and bottom or the left and + right, use "allowscale=both". Contents from starter will always fill + the canvas, regardless of how its aspect ratio compares to that of the + canvas. + + The default behavior is to not allow cropping. This may be specified + explicitly with "allowscale=none". - You can instead specify a solid background color (e.g., white for - a 'coloring-book' style starter, with "background=#fff"). - 各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 進数の組からなる6桁または3桁の表記（例: - "#ff4488" または "#F48”）で指定します。 +background - See the "Color Palette File" section of "Options documentation" - for further details. + This option allows you to specify how Tux Paint should fill the rest of the + canvas, when the starter does not fit in one or the other direction. By + default, as described above, Tux Paint will "smear" the pixels from the + edges of the starter. (This can be specified explicitly with "background= + smear".) - gravity + You can instead specify a solid background color (e.g., white for a + 'coloring-book' style starter, with "background=#fff"). - This option allows you to specify how Tux Paint should position a - starter, when it is being cropped in one or the other direction. - By default, Tux Paint will place the center of the starter within - the canvas. (This can be specified explicitly with - "gravity=center".) + 各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 進数 + の組からなる6桁または3桁の表記（例: "#ff4488" または "#F48”）で指定します。 - For example, if the top center of the starter contains the most - important content, you can specify "gravity=top". Or, if the - bottom right is important, specify "gravity=bottom-right". + See the "Color Palette File" section of "Options documentation" for further + details. - The available options are: - * center — prefer the center (the default) - * top — prefer the top center - * bottom — prefer the bottom center - * left — prefer the left center - * right — prefer the right center - * top-left — prefer the top left - * top-right — prefer the top right - * bottom-left — prefer the bottom left - * bottom-right — prefer the bottom right - [ Landscape-shaped image of a horizon with the sun in the middle - and a building on the right. ] - Focusing on the center of a starter image stretched to fit the - width of the canvas. +gravity - [ Portrait-shaped image of a horizon with the sun in the middle - and the left side of building on the right. ] + This option allows you to specify how Tux Paint should position a starter, + when it is being cropped in one or the other direction. By default, Tux + Paint will place the center of the starter within the canvas. (This can be + specified explicitly with "gravity=center".) - Focusing on the center of a starter image stretched to fit the - height of the canvas. + For example, if the top center of the starter contains the most important + content, you can specify "gravity=top". Or, if the bottom right is + important, specify "gravity=bottom-right". - [ Landscape-shaped image of the sky with the sun at the bottom and - the top of building on the right. ] + The available options are: + + center — prefer the center (the default) + + top — prefer the top center + + bottom — prefer the bottom center + + left — prefer the left center + + right — prefer the right center + + top-left — prefer the top left + + top-right — prefer the top right + + bottom-left — prefer the bottom left + + bottom-right — prefer the bottom right - Focusing on the top of a starter image stretched to fit the width - of the canvas. + [ Landscape-shaped image of a horizon with the sun in the middle and a + building on the right. ] - [ Landscape-shaped image of the ground with the sun at the top. ] + Focusing on the center of a starter image stretched to fit the width of the + canvas. - Focusing on the bottom of a starter image stretched to fit the - width of the canvas. - [ Portrait-shaped image of a horizon with the sun on the left and - a building in the center. ] + [ Portrait-shaped image of a horizon with the sun in the middle and the + left side of building on the right. ] - Focusing on the right of a starter image stretched to fit the - height of the canvas. + Focusing on the center of a starter image stretched to fit the height of + the canvas. - 💡 Note: Templates (described below) may also have options files, and - currently support all of the same options as starters. - 'Templates' + [ Landscape-shaped image of the sky with the sun at the bottom and the top + of building on the right. ] - 'Template' images also appear in the 'New' dialog, along with solid color - background choices and 'Starters'. (Note: Tux Paint prior to version - 0.9.22 did not have the 'Template' feature.) + Focusing on the top of a starter image stretched to fit the width of the + canvas. - Unlike pictures drawn in Tux Paint by users and then opened later, opening - a 'template' creates a new drawing. When you save, the 'template' image is - not overwritten. Unlike 'starters', there is no immutable 'layer' above - the canvas. You may draw over any part of it. - When the 'Eraser' tool is used on a picture based on this kind of - 'template' image, rather than turning the canvas to a solid color, such as - white, it returns that part of the canvas to the original background - picture from the 'template' image. + [ Landscape-shaped image of the ground with the sun at the top. ] - 'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) - format). No preparation or conversion should be required. + Focusing on the bottom of a starter image stretched to fit the width of the + canvas. - For best results, 'template' images should be at least the same size as - Tux Paint's drawing canvas. (See the "Loading Other Pictures into Tux - Paint" section of Tux Paint's main documentation (README) for details on - sizing.) If they are not, they will be stretched or scaled. This is done - without affecting the shape ("aspect ratio"); however some smudging may be - applied to the edges. - Place them in the "templates" directory. When the 'New' dialog is accessed - in Tux Paint, the 'template' images will appear in the screen that - appears, after the various solid color choices. + [ Portrait-shaped image of a horizon with the sun on the left and a + building in the center. ] + + Focusing on the right of a starter image stretched to fit the height of the + canvas. + + + + + +💡 Note: Templates (described below) may also have options files, and currently +support all of the same options as starters. + + +'Templates' + +'Template' images also appear in the 'New' dialog, along with solid color +background choices and 'Starters'. (Note: Tux Paint prior to version 0.9.22 did +not have the 'Template' feature.) + +Unlike pictures drawn in Tux Paint by users and then opened later, opening a +'template' creates a new drawing. When you save, the 'template' image is not +overwritten. Unlike 'starters', there is no immutable 'layer' above the canvas. +You may draw over any part of it. + +When the 'Eraser' tool is used on a picture based on this kind of 'template' +image, rather than turning the canvas to a solid color, such as white, it +returns that part of the canvas to the original background picture from the +'template' image. + +'Templates' are simply image files (in PNG, JPEG, SVG, or KPX (KidPix) format). +No preparation or conversion should be required. + +For best results, 'template' images should be at least the same size as Tux +Paint's drawing canvas. (See the "Loading Other Pictures into Tux Paint" +section of Tux Paint's main documentation (README) for details on sizing.) If +they are not, they will be stretched or scaled. This is done without affecting +the shape ("aspect ratio"); however some smudging may be applied to the edges. + +Place them in the "templates" directory. When the 'New' dialog is accessed in +Tux Paint, the 'template' images will appear in the screen that appears, after +the various solid color choices. + +💡 Note: 'Templates' are 'attached' to saved pictures, via a small text file +that has the same name as the saved file, but with ".dat" as the extension. +This allows it to continue to affect the drawing even after Tux Paint has been +quit, or another picture is loaded or a new image is created. (In other words, +if you base a drawing on a 'template' image, it will always be affected by it.) - 💡 Note: 'Templates' are 'attached' to saved pictures, via a small text - file that has the same name as the saved file, but with ".dat" as the - extension. This allows it to continue to affect the drawing even after Tux - Paint has been quit, or another picture is loaded or a new image is - created. (In other words, if you base a drawing on a 'template' image, it - will always be affected by it.) Template Options - Like 'Starters', a configuration file may be specified that defines how - Tux Paint should behave when applying 'template' images to the canvas when - they do not have identical proportions (aspect ratio). See "Starter - Options", above. (Note: Tux Paint prior to version 0.9.29 did not support - starter options.) +Like 'Starters', a configuration file may be specified that defines how Tux +Paint should behave when applying 'template' images to the canvas when they do +not have identical proportions (aspect ratio). See "Starter Options", above. +(Note: Tux Paint prior to version 0.9.29 did not support starter options.) - 💡 It's also possible to create basic Templates (with no options) from - existing saved drawings directly within Tux Paint, from the "Open" dialog. - They will be placed in the user's personal templates folder. (Note: Tux - Paint prior to version 0.9.31 did not support Template creation from the - Open dialog.) +💡 It's also possible to create basic Templates (with no options) from existing +saved drawings directly within Tux Paint, from the "Open" dialog. They will be +placed in the user's personal templates folder. (Note: Tux Paint prior to +version 0.9.31 did not support Template creation from the Open dialog.) - Translations +Translations - Tux Paint supports numerous languages, thanks to use of the "gettext" - localization library. (See the "Languages" section of "Options - documentation" for how to change locales in Tux Paint.) +Tux Paint supports numerous languages, thanks to use of the "gettext" +localization library. (See the "Languages" section of "Options documentation" +for how to change locales in Tux Paint.) - To translate Tux Paint to a new language, copy the translation template - file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder - "src/po/"). Rename the copy as a ".po" file, with an appropriate name for - the locale you're translating to (e.g., "es.po" for Spanish; or "pt_BR.po" - for Brazilian Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese - spoken in Portugal.) +To translate Tux Paint to a new language, copy the translation template file, +"tuxpaint.pot" (found in Tux Paint's source code, in the folder "src/po/"). +Rename the copy as a ".po" file, with an appropriate name for the locale you're +translating to (e.g., "es.po" for Spanish; or "pt_BR.po" for Brazilian +Portuguese, versus "pt.po" or "pt_PT.po" for Portuguese spoken in Portugal.) - Open the newly-created ".po" file — you can edit in a plain text edtior, - such as Emacs, Pico or VI on Linux, or NotePad on Windows. The original - English text used in Tux Paint is listed in lines starting with "msgid". - Enter your translations of each of these pieces of text in the empty - "msgstr" lines directly below the corresponding "msgid" lines. (Note: Do - not remove the quotes.) +Open the newly-created ".po" file — you can edit in a plain text edtior, such +as Emacs, Pico or VI on Linux, or NotePad on Windows. The original English text +used in Tux Paint is listed in lines starting with "msgid". Enter your +translations of each of these pieces of text in the empty "msgstr" lines +directly below the corresponding "msgid" lines. (Note: Do not remove the +quotes.) - 例: +例: - msgid "Smudge" - msgstr "Manchar" + msgid "Smudge" + msgstr "Manchar" - msgid "Click and drag to draw large bricks." - msgstr "Haz clic y arrastra para dibujar ladrillos grandes." + msgid "Click and drag to draw large bricks." + msgstr "Haz clic y arrastra para dibujar ladrillos grandes." - Various tools exist to manage gettext translation catalogs, so you don't - have to edit them by hand in a text editor. Here are a few: - * Poedit - * Gtranslator (GNOME Translator) - * Virtraal - * Lokalize +Various tools exist to manage gettext translation catalogs, so you don't have +to edit them by hand in a text editor. Here are a few: - 💡 Note: It is best to always work off of the latest Tux Paint text catalog - template ("tuxpaint.pot"), since new text is added, and old text is - occasionally changed. The text catalog for the upcoming, unreleased - version of Tux Paint can be found in Tux Paint's Git repository (see: - https://tuxpaint.org/download/source/git/), and on the Tux Paint website - at https://tuxpaint.org/help/po/. + * Poedit + * Gtranslator (GNOME Translator) + * Virtraal + * Lokalize - To edit an existing translation, download the latest ".po" file for that - language, and edit it as described above. +💡 Note: It is best to always work off of the latest Tux Paint text catalog +template ("tuxpaint.pot"), since new text is added, and old text is +occasionally changed. The text catalog for the upcoming, unreleased version of +Tux Paint can be found in Tux Paint's Git repository (see: https://tuxpaint.org +/download/source/git/), and on the Tux Paint website at https://tuxpaint.org/ +help/po/. - You may send new or edited translation files to Bill Kendrick, lead - developer of Tux Paint, at: bill@newbreedsoftware.com, or post them to the - "tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). +To edit an existing translation, download the latest ".po" file for that +language, and edit it as described above. - Alternatively, if you have an account with SourceForge.net, you can - request to be added to the "tuxpaint" project and receive write-access to - the Git source code repository so that you may commit your changes - directly. +You may send new or edited translation files to Bill Kendrick, lead developer +of Tux Paint, at: bill@newbreedsoftware.com, or post them to the +"tuxpaint-i18n" mailing list (see: https://tuxpaint.org/lists/). - 💡 Note: Support for new locales requires making additions to Tux Paint's - source code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the - Makefile, to ensure the ".po" files are compiled into ".mo" files, and - available for use at runtime. +Alternatively, if you have an account with SourceForge.net, you can request to +be added to the "tuxpaint" project and receive write-access to the Git source +code repository so that you may commit your changes directly. - Alternative Input Methods +💡 Note: Support for new locales requires making additions to Tux Paint's source +code ("/src/i18n.h" and "/src/i18n.c"), and requires updates to the Makefile, +to ensure the ".po" files are compiled into ".mo" files, and available for use +at runtime. - Tux Paint's 'Text' and 'Label' tools can provide alternative input methods - for some languages. For example, when Tux Paint is running with a Japanese - locale, the right [Alt] key can be pressed to cycle between Latin, - Romanized Hiragana and Romanized Katakana modes. This allows native - characters and words to be entered into the 'Text' and 'Label' tools by - typing one or more keys on a keyboard with Latin characters (e.g., a US - QWERTY keyboard). +Alternative Input Methods - To create an input method for a new locale, create a text file with a name - based on the locale (e.g., "ja" for Japanese), with ".im" as the extension - (e.g., "ja.im"). +Tux Paint's 'Text' and 'Label' tools can provide alternative input methods for +some languages. For example, when Tux Paint is running with a Japanese locale, +the right [Alt] key can be pressed to cycle between Latin, Romanized Hiragana +and Romanized Katakana modes. This allows native characters and words to be +entered into the 'Text' and 'Label' tools by typing one or more keys on a +keyboard with Latin characters (e.g., a US QWERTY keyboard). - The ".im" file can have multiple character mapping sections for different - character mapping modes. For example, on a Japanese typing system, typing - [K] [A] in Hiragana mode generates a different Unicode character ("か") - than typing [K] [A] in Katakana mode ("カ"). +To create an input method for a new locale, create a text file with a name +based on the locale (e.g., "ja" for Japanese), with ".im" as the extension +(e.g., "ja.im"). - List the character mappings in this file, one per line. Each line should - contain (separated by whitespace): +The ".im" file can have multiple character mapping sections for different +character mapping modes. For example, on a Japanese typing system, typing [K] +[A] in Hiragana mode generates a different Unicode character ("か") than typing +[K] [A] in Katakana mode ("カ"). - * the Unicode value of the character, in hexadecimal (more than one - character can be listed, separated by a colon (':'), this allowing - some sequences to map to words) - * the keycode sequence (the ASCII characters that must be entered to - generate the Unicode character) - * a flag (or "-" if none) +List the character mappings in this file, one per line. Each line should +contain (separated by whitespace): - Start additional character mapping sections with a line containign the - word "section". + * the Unicode value of the character, in hexadecimal (more than one character + can be listed, separated by a colon (':'), this allowing some sequences to + map to words) + * the keycode sequence (the ASCII characters that must be entered to generate + the Unicode character) + * a flag (or "-" if none) - 例: +Start additional character mapping sections with a line containign the word +"section". - # Hiragana - 304B ka - - 304C ga - - 304D ki - - 304E gi - - 304D:3083 kya - - 3063:305F tta - +例: - # Katakana - section - 30AB ka - - 30AC ga - - 30AD ki - - 30AE gi - + # Hiragana + 304B ka - + 304C ga - + 304D ki - + 304E gi - + 304D:3083 kya - + 3063:305F tta - - ⚙ Note: Blank lines within the ".im" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. + # Katakana + section + 30AB ka - + 30AC ga - + 30AD ki - + 30AE gi - - 💡 Note: Meanings of the flags are locale-specific, and are processed by - the language-specific source code in "src/im.c". For example, "b" is used - in Korean to handle Batchim, which may carry over to the next character. +⚙ Note: Blank lines within the ".im" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - 💡 Note: Support for new input methods requires making additions to Tux - Paint's source code ("/src/im.c"), and requires updates to the Makefile, - to ensure the ".im" files are available for use at runtime. +💡 Note: Meanings of the flags are locale-specific, and are processed by the +language-specific source code in "src/im.c". For example, "b" is used in Korean +to handle Batchim, which may carry over to the next character. - 画面キーボード +💡 Note: Support for new input methods requires making additions to Tux Paint's +source code ("/src/im.c"), and requires updates to the Makefile, to ensure the +".im" files are available for use at runtime. - As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an - on-screen keyboard that allows the pointer (via a mouse, eye-tracking - systems, etc.) to be used to input characters. Files that describe the - layout and available keys are stored in Tux Paint "osk" directory. Each - keyboard layout is defined by a number of files (some of which may be - shared by different layouts). +画面キーボード - We'll use the QWERTY keyboard as an example: +As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an +on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, +etc.) to be used to input characters. Files that describe the layout and +available keys are stored in Tux Paint "osk" directory. Each keyboard layout is +defined by a number of files (some of which may be shared by different +layouts). + +We'll use the QWERTY keyboard as an example: Layout overview file ("qwerty.layout") - This is a text file that specifies the other files used to describe the - layout and key mappings. +This is a text file that specifies the other files used to describe the layout +and key mappings. - layout qwerty.h_layout - keymap us-intl-altgr-dead-keys.keymap - composemap en_US.UTF-8_Compose - keysymdefs keysymdef.h - keyboardlist qwerty.layout default.layout + layout qwerty.h_layout + keymap us-intl-altgr-dead-keys.keymap + composemap en_US.UTF-8_Compose + keysymdefs keysymdef.h + keyboardlist qwerty.layout default.layout - ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any - text following a "#" (pound/hash) character — it can be used to denote - comments, as seen in the example above. +⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text +following a "#" (pound/hash) character — it can be used to denote comments, as +seen in the example above. - The "keyboardlist" line describes which layouts to switch to, when the - user clicks the left and right buttons on the keyboard. (See below.) +The "keyboardlist" line describes which layouts to switch to, when the user +clicks the left and right buttons on the keyboard. (See below.) Keyboard layout file ("qwerty.h_layout") - This describes how big the keyboard is (as a "width × height" grid), and - lists each key with its numeric keycode (see the "keymap" file, below), - the width it should be drawn at (typically "1.0", to take one space on the - keyboard, but in the example below, notice the "TAB" and "SPACE" keys are - much wider), the character or text to display on the key, depending on - which modifier keys have been pressed (one each for: no modifiers, - [Shift], [AltGr], and [Shift] + [AltGr]), and finally whether or not the - key is affected by the [CapsLock] key (use "1") or [AltGr] (alternate - graphics) key (use "2"), or not at all (use "0"). +This describes how big the keyboard is (as a "width × height" grid), and lists +each key with its numeric keycode (see the "keymap" file, below), the width it +should be drawn at (typically "1.0", to take one space on the keyboard, but in +the example below, notice the "TAB" and "SPACE" keys are much wider), the +character or text to display on the key, depending on which modifier keys have +been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] + +[AltGr]), and finally whether or not the key is affected by the [CapsLock] key +(use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use +"0"). - WIDTH 15 - HEIGHT 5 + WIDTH 15 + HEIGHT 5 - KEY 49 1.0 ` ~ ` ~ 0 - KEY 10 1.0 1 ! ¡ ¹ 0 - KEY 11 1.0 2 @ ² ˝ 0 - KEY 12 1.0 3 # · ³ 0 - KEY 13 1.0 4 $ ¤ £ 0 - KEY 14 1.0 5 % € ¸ 0 - KEY 15 1.0 6 ^ ¼ ^ 0 - ... - KEY 21 1.0 = + × ÷ 0 - KEY 22 2.0 DELETE DELETE DELETE DELETE 0 + KEY 49 1.0 ` ~ ` ~ 0 + KEY 10 1.0 1 ! ¡ ¹ 0 + KEY 11 1.0 2 @ ² ˝ 0 + KEY 12 1.0 3 # · ³ 0 + KEY 13 1.0 4 $ ¤ £ 0 + KEY 14 1.0 5 % € ¸ 0 + KEY 15 1.0 6 ^ ¼ ^ 0 + ... + KEY 21 1.0 = + × ÷ 0 + KEY 22 2.0 DELETE DELETE DELETE DELETE 0 - NEWLINE + NEWLINE - KEY 23 1.5 TAB TAB TAB TAB 0 - KEY 24 1.0 q Q ä Ä 1 - KEY 25 1.0 w W å Å 1 - KEY 26 1.0 e E é É 1 - KEY 27 1.0 r R ® ® 1 - ... + KEY 23 1.5 TAB TAB TAB TAB 0 + KEY 24 1.0 q Q ä Ä 1 + KEY 25 1.0 w W å Å 1 + KEY 26 1.0 e E é É 1 + KEY 27 1.0 r R ® ® 1 + ... - NEWLINE + NEWLINE - # Arrow to left will change to the previous keyboard - KEY 2 1.0 <- <- <- <- 0 + # Arrow to left will change to the previous keyboard + KEY 2 1.0 <- <- <- <- 0 - KEY 133 2.0 Cmp Cmp Cmp Cmp 0 + KEY 133 2.0 Cmp Cmp Cmp Cmp 0 - # The ALT or ALTGR keys are used in im to switch the input mode - KEY 64 2.0 Alt Alt Alt Alt 0 + # The ALT or ALTGR keys are used in im to switch the input mode + KEY 64 2.0 Alt Alt Alt Alt 0 - # Space - KEY 65 7.0 SPACE SPACE SPACE SPACE 0 + # Space + KEY 65 7.0 SPACE SPACE SPACE SPACE 0 - KEY 108 2.0 AltGr AltGr AltGr AltGr 0 + KEY 108 2.0 AltGr AltGr AltGr AltGr 0 - # Arrow to right will change to the next keyboard - KEY 1 1.0 -> -> -> -> 0 + # Arrow to right will change to the next keyboard + KEY 1 1.0 -> -> -> -> 0 - Notice here that alphabetic keys ([Q], [W], etc.) will be affected by - [CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will - not. +Notice here that alphabetic keys ([Q], [W], etc.) will be affected by +[CapsLock], while numeric keys ([1], [2], etc.), [Space], and so on, will not. - Keycodes up to "8" are reserved for internal use. The ones currently used - are described below. +Keycodes up to "8" are reserved for internal use. The ones currently used are +described below. - * 0 — empty button - * 1 — next layout (per the layout file's "keyboardlist" setting) - * 2 — previous layout (per the layout file's "keyboardlist" setting) + * 0 — empty button + * 1 — next layout (per the layout file's "keyboardlist" setting) + * 2 — previous layout (per the layout file's "keyboardlist" setting) Keymap file ("us-intl-altgr-dead-keys.keymap") - This file defines which numeric keycodes (seen in the keyboard layout - files, such as "qwerty.h_layout" described above) should be mapped to - which actual characters that an application such as Tux Paint expects to - receive when keys (e.g., on a real keyboard) are pressed. +This file defines which numeric keycodes (seen in the keyboard layout files, +such as "qwerty.h_layout" described above) should be mapped to which actual +characters that an application such as Tux Paint expects to receive when keys +(e.g., on a real keyboard) are pressed. - If you're using an operating system such as Linux, which runs X-Window and - has the "xmodmap" command-line tool available, you can run it with the - ("print keymap expressions" option, "-pke", to generate a keymap file. +If you're using an operating system such as Linux, which runs X-Window and has +the "xmodmap" command-line tool available, you can run it with the ("print +keymap expressions" option, "-pke", to generate a keymap file. - keycode 9 = Escape NoSymbol Escape Escape - keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol - onesuperior - keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf - twosuperior - keycode 12 = 3 numbersign periodcentered threesuperior dead_macron - periodcentered - ... - keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright - NoSymbol Greek_zeta Greek_ZETA U037D U03FF - keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol - Greek_chi Greek_CHI rightarrow leftarrow - keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi - Greek_PSI copyright - keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 - keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 - keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef - Greek_nu Greek_NU U0374 U0375 - keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU - U03FB U03FA - keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less - guillemotleft - keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period - period greater guillemotright periodcentered - keycode 61 = slash question questiondown dead_hook Arabic_zah - Arabic_question_mark slash question - keycode 62 = Shift_R NoSymbol Shift_R Shift_R - ... + keycode 9 = Escape NoSymbol Escape Escape + keycode 10 = 1 exclam exclamdown onesuperior 1 exclam 1 exclam NoSymbol + onesuperior + keycode 11 = 2 at twosuperior dead_doubleacute 2 at 2 at onehalf + twosuperior + keycode 12 = 3 numbersign periodcentered threesuperior dead_macron + periodcentered + ... + keycode 52 = z Z ae AE Arabic_hamzaonyeh asciitilde guillemotright NoSymbol + Greek_zeta Greek_ZETA U037D U03FF + keycode 53 = x X x X Arabic_hamza Arabic_sukun guillemotleft NoSymbol + Greek_chi Greek_CHI rightarrow leftarrow + keycode 54 = c C copyright cent Arabic_hamzaonwaw braceright Greek_psi + Greek_PSI copyright + keycode 55 = v V v V Arabic_ra braceleft Greek_omega Greek_OMEGA U03D6 + keycode 56 = b B b B UFEFB UFEF5 Greek_beta Greek_BETA U03D0 + keycode 57 = n N ntilde Ntilde Arabic_alefmaksura Arabic_maddaonalef + Greek_nu Greek_NU U0374 U0375 + keycode 58 = m M mu mu Arabic_tehmarbuta apostrophe Greek_mu Greek_MU U03FB + U03FA + keycode 59 = comma less ccedilla Ccedilla Arabic_waw comma comma less + guillemotleft + keycode 60 = period greater dead_abovedot dead_caron Arabic_zain period + period greater guillemotright periodcentered + keycode 61 = slash question questiondown dead_hook Arabic_zah + Arabic_question_mark slash question + keycode 62 = Shift_R NoSymbol Shift_R Shift_R + ... Composemap file ("en_US.UTF-8_Compose") - This file describes single characters that can be composed by multiple - inputs. For example, "[Compose]" followed by "[A]" and "[E]" can be used - to create the "æ" character. +This file describes single characters that can be composed by multiple inputs. +For example, "[Compose]" followed by "[A]" and "[E]" can be used to create the +"æ" character. - The file that comes with Tux Paint is based on the US English UTF-8 - (Unicode) composemap that comes with X.Org's X Window system. The current - version from the Xlib library has a web located page at - https://www.x.org/releases/current/doc/libX11/i18n/compose/en_US.UTF-8.html. +The file that comes with Tux Paint is based on the US English UTF-8 (Unicode) +composemap that comes with X.Org's X Window system. The current version from +the Xlib library has a web located page at https://www.x.org/releases/current/ +doc/libX11/i18n/compose/en_US.UTF-8.html. Keysym definitions file ("keysymdef.h") - This file (which is a C programming language header file) is also from the - X Window System. It defines the Unicode values of each keycap (e.g., - "XK_equal" corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). +This file (which is a C programming language header file) is also from the X +Window System. It defines the Unicode values of each keycap (e.g., "XK_equal" +corresponds to "U+003D", for the character "=" ("EQUALS SIGN"). - 💡 Note: This file is not compiled into Tux Paint, but is read and parsed - at runtime. +💡 Note: This file is not compiled into Tux Paint, but is read and parsed at +runtime. - It is unlikely that any modification will be required of this file. +It is unlikely that any modification will be required of this file. - Magic Tools +Magic Tools - Tux Paint's Magic tools are pieces of software, external to the main Tux - Paint application, that are loaded as "plugins" at runtime, and interact - with the program using a defined Application Programming Interface (API). - The plugins that ship with Tux Paint (as well as Tux Paint itself) are - written in the C programming language. +Tux Paint's Magic tools are pieces of software, external to the main Tux Paint +application, that are loaded as "plugins" at runtime, and interact with the +program using a defined Application Programming Interface (API). The plugins +that ship with Tux Paint (as well as Tux Paint itself) are written in the C +programming language. + +Consult the Magic Tool Plugin API Documentation to learn how to write your own. - Consult the Magic Tool Plugin API Documentation to learn how to write your - own. diff --git a/docs/ja_JP.UTF-8/FAQ.txt b/docs/ja_JP.UTF-8/FAQ.txt index a3d7f0a5e..0d11f572b 100644 --- a/docs/ja_JP.UTF-8/FAQ.txt +++ b/docs/ja_JP.UTF-8/FAQ.txt @@ -1,615 +1,617 @@ Tux Paint - バージョン 0.9.31 Frequently Asked Questions + バージョン 0.9.31 Frequently Asked Questions - Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年7月13日 + 2023年7月13日 - ---------------------------------------------------------------------- - - +------------------------------+ - |目次 | - |------------------------------| - | * Drawing-related | - | * Interface Problems | - | * 印刷 | - | * 保存 | - | * Audio Problems | - | * Fullscreen Mode Problems | - | * Other Problems | - | * Help / Contact | - +------------------------------+ - - ---------------------------------------------------------------------- +------------------------------------------------------------------------------- ++------------------------------+ +| 目次 | +|------------------------------| +| * Drawing-related | +| * Interface Problems | +| * 印刷 | +| * 保存 | +| * Audio Problems | +| * Fullscreen Mode Problems | +| * Other Problems | +| * Help / Contact | ++------------------------------+ +------------------------------------------------------------------------------- Drawing-related - Fonts I added to Tux Paint only show squares - The TrueType Font you're using might have the wrong encoding. If - it's 'custom' encoded, for example, you can try running it through - FontForge (http://fontforge.sourceforge.net/) to convert it to an - ISO-8859 format. (Email us if you need help with special fonts.) +Fonts I added to Tux Paint only show squares + The TrueType Font you're using might have the wrong encoding. If it's + 'custom' encoded, for example, you can try running it through FontForge ( + http://fontforge.sourceforge.net/) to convert it to an ISO-8859 format. + (Email us if you need help with special fonts.) - The Rubber Stamp tool is greyed out! +The Rubber Stamp tool is greyed out! - This means that Tux Paint either couldn't find any stamp images, - or was asked not to load them. + This means that Tux Paint either couldn't find any stamp images, or was + asked not to load them. - If you installed Tux Paint, but did not install the separate, - optional "Stamps" collection, quit Tux Paint and install it now. - It should be available from the same place you got the main Tux - Paint program. (Note: As of version 0.9.14, Tux Paint comes with a - small collection of example stamps.) + If you installed Tux Paint, but did not install the separate, optional + "Stamps" collection, quit Tux Paint and install it now. It should be + available from the same place you got the main Tux Paint program. (Note: As + of version 0.9.14, Tux Paint comes with a small collection of example + stamps.) - If you don't want to install the default collection of stamps, you - can just create your own. See the "Extending Tux Paint" - documentation for more on creating PNG and SVG image files, TXT - text description files, Ogg Vorbis, MP3 or WAV sound files, and - DAT text data files that make up stamps. + If you don't want to install the default collection of stamps, you can just + create your own. See the "Extending Tux Paint" documentation for more on + creating PNG and SVG image files, TXT text description files, Ogg Vorbis, + MP3 or WAV sound files, and DAT text data files that make up stamps. - 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.) + 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. + 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 - Tux Paint was built with low-quality (but faster) stamp outlines. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: +Stamp outlines are always rectangles - #define LOW_QUALITY_STAMP_OUTLINE + Tux Paint was built with low-quality (but faster) stamp outlines. - in the "tuxpaint.c" file in the "src" directory. + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - ---------------------------------------------------------------------- + #define LOW_QUALITY_STAMP_OUTLINE + + in the "tuxpaint.c" file in the "src" directory. + + + + +------------------------------------------------------------------------------- Interface Problems - Stamp thumbnails in the Stamp Selector look bad +Stamp thumbnails in the Stamp Selector look bad - Tux Paint was probably compiled with the faster, lower quality - thumbnail code enabled. Run the command: "tuxpaint - --verbose-version" from a command line. If, amongst the other - output, you see the text: "Low Quality Thumbnails enabled", then - this is what's happening. + Tux Paint was probably compiled with the faster, lower quality thumbnail + code enabled. Run the command: "tuxpaint --verbose-version" from a command + line. If, amongst the other output, you see the text: "Low Quality + Thumbnails enabled", then this is what's happening. - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - #define LOW_QUALITY_THUMBNAILS + #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 - "Low Quality Thumbnails" is probably enabled. See: "Stamp - thumbnails in the Stamp Selector look bad", above. - All of the text is in uppercase! - The "uppercase" option is on. +Pictures in the 'Open' dialog look bad + "Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the + Stamp Selector look bad", above. - Either change/remove the "uppercase" option, or you can override - it with "--mixedcase" on the command line or either "uppercase=no" - or "mixedcase=yes" in a configuration file. +All of the text is in uppercase! - Tux Paint is in a different language - Make sure your locale setting is correct. See "Tux Paint won't - switch to my language", below. + The "uppercase" option is on. - Tux Paint won't switch to my language - * Linux and Unix users: Make sure the locale is available + Either change/remove the "uppercase" option, or you can override it with + "--mixedcase" on the command line or either "uppercase=no" or "mixedcase= + yes" in a configuration file. - Make sure the locale you want is available. Check your - "/etc/locale.gen" file. See the "Options Documentation" for - the locales Tux Paint uses (especially when using the - "--lang" option). +Tux Paint is in a different language + Make sure your locale setting is correct. See "Tux Paint won't switch to my + language", below. - Note: Debian and derivative (e.g., Ubuntu) users can simply - run "dpkg-reconfigure locales" if the locales are managed by - "dpkg". +Tux Paint won't switch to my language + + Linux and Unix users: Make sure the locale is available - * If you're using the "--lang" command-line option + Make sure the locale you want is available. Check your "/etc/ + locale.gen" file. See the "Options Documentation" for the locales Tux + Paint uses (especially when using the "--lang" option). - Try using the "--locale" command-line option, or your - operating system's locale settings (e.g., the "$LANG" - environment variable), and please e-mail us regarding your - trouble. + Note: Debian and derivative (e.g., Ubuntu) users can simply run + "dpkg-reconfigure locales" if the locales are managed by "dpkg". - * If you're using the "--locale" command-line option + + If you're using the "--lang" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + Try using the "--locale" command-line option, or your operating + system's locale settings (e.g., the "$LANG" environment variable), and + please e-mail us regarding your trouble. - * If you're trying to use your Operating System's locale + + If you're using the "--locale" command-line option - If this doesn't work, please e-mail us regarding your - trouble. + If this doesn't work, please e-mail us regarding your trouble. - * Make sure you have the necessary font + + If you're trying to use your Operating System's locale - Some translations require their own font. Chinese and Korean, - for example, need Chinese and Korean TrueType Fonts installed - and placed in the proper location, respectively. + If this doesn't work, please e-mail us regarding your trouble. - The appropriate fonts for such locales can be downloaded from - the Tux Paint website: + + Make sure you have the necessary font - https://tuxpaint.org/download/fonts/ + Some translations require their own font. Chinese and Korean, for + example, need Chinese and Korean TrueType Fonts installed and placed in + the proper location, respectively. - ---------------------------------------------------------------------- + The appropriate fonts for such locales can be downloaded from the Tux + Paint website: + + 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 - and sending it to an external command. By default, this command is - the "lpr" printing tool. + Tux Paint prints by creating a PostScript rendition of the picture and + sending it to an external command. By default, this command is the "lpr" + printing tool. - If that program is not available (for example, you're using CUPS, - the Common Unix Printing System, and do not have "cups-lpr" - installed), you will need to specify an appropriate command using - the "printcommand" option in Tux Paint's configuration file. (See - the "Options Documentation".) + If that program is not available (for example, you're using CUPS, the + Common Unix Printing System, and do not have "cups-lpr" installed), you + will need to specify an appropriate command using the "printcommand" option + in Tux Paint's configuration file. (See the "Options Documentation".) - 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. + 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. + 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 - The "print delay" option is on. You can only print once every X - seconds. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--printdelay=..." option. +I get the message "You can't print yet!" when I go to print - 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 - command-line argument. + The "print delay" option is on. You can only print once every X seconds. - If a "--printdelay=..." option isn't being sent on the command - line, check Tux Paint's configuration file for a line reading: - "printdelay=...". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--printdelay=..." option. - Either remove that line, set the delay value to 0 (no delay), or - decrease the delay to a value you prefer. (See the "Options - Documentation".) + 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 + command-line argument. - Or, you can simply run Tux Paint with the command-line argument: - "--printdelay=0", which will override the configuration file's - setting, and allow unlimited printing. (You won't have to wait - between prints.) + If a "--printdelay=..." option isn't being sent on the command line, check + Tux Paint's configuration file for a line reading: "printdelay=...". - I simply can't print! The button is greyed out! + Either remove that line, set the delay value to 0 (no delay), or decrease + the delay to a value you prefer. (See the "Options Documentation".) - The "no print" option is on. + Or, you can simply run Tux Paint with the command-line argument: + "--printdelay=0", which will override the configuration file's setting, and + allow unlimited printing. (You won't have to wait between prints.) - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noprint" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--noprint" is listed as a - command-line argument. - If a "--noprint" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "noprint=yes". +I simply can't print! The button is greyed out! - Either remove that line, or simply run Tux Paint with the - command-line argument: "--print", which will override the - configuration file's setting. + The "no print" option is on. - Or use Tux Paint Config. and make sure "Allow Printing" (under - "印刷") is checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noprint" option. - ---------------------------------------------------------------------- + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--noprint" is listed as a command-line + argument. + + If a "--noprint" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noprint=yes". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--print", which will override the configuration file's setting. + + Or use Tux Paint Config. and make sure "Allow Printing" (under "印刷") is + 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 - the "savedir" option), Tux Paint saves into a standard location on - your local drive: + Unless you asked Tux Paint to save into a specific location (using the + "savedir" option), Tux Paint saves into a standard location on your local + drive: - Windows Vista, Windows 8, Windows 10, Windows 11 - In the user's "AppData" folder: - e.g., - C:\Users\Username\AppData\Roaming\TuxPaint\saved + Windows Vista, Windows 8, Windows 10, Windows 11 + In the user's "AppData" folder: + e.g., C:\Users\Username\AppData\Roaming\TuxPaint\saved - macOS - In the user's "Application Support" folder: - e.g., /Users/Username/Library/Applicaton - Support/TuxPaint/saved/ + macOS + In the user's "Application Support" folder: + e.g., /Users/Username/Library/Applicaton Support/TuxPaint/saved/ - Linux / Unix - In the user's home directory ("$HOME"), under a - ".tuxpaint" subfolder: - e.g., /home/username/.tuxpaint/saved/ + Linux / Unix + In the user's home directory ("$HOME"), under a ".tuxpaint" subfolder: + e.g., /home/username/.tuxpaint/saved/ - The images are stored as PNG bitmaps, which most modern programs - should be able to load (image editors, word processors, web - browsers, etc.) - Tux Paint always saves over my old picture + The images are stored as PNG bitmaps, which most modern programs should be + able to load (image editors, word processors, web browsers, etc.) - The "save over" option is enabled. (This disables the prompt that - would appear when you click 'Save.') - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveover" option. - If you're running Tux Paint by double-clicking an icon, check the - properties of the icon to see if "--saveover" is listed as a - command-line argument. +Tux Paint always saves over my old picture - If a "--saveover" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=yes". + The "save over" option is enabled. (This disables the prompt that would + appear when you click 'Save.') - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveover" option. - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "保存") is checked. + 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 command-line + argument. - Also, see "Tux Paint always saves a new picture!", below. + If a "--saveover" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=yes". - Tux Paint always saves a new picture! + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. - The "never save over" option is enabled. (This disables the prompt - that would appear when you click 'Save.') + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under "保 + 存") is checked. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--saveovernew" option. + Also, see "Tux Paint always saves a new picture!", below. - 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 - command-line argument. - If a "--saveovernew" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "saveover=new". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--saveoverask", which will override the - configuration file's setting. +Tux Paint always saves a new picture! - Or use Tux Paint Config. and make sure "Ask Before Overwriting" - (under "保存") is checked. + The "never save over" option is enabled. (This disables the prompt that + would appear when you click 'Save.') - Also, see "Tux Paint always saves over my old picture!", above. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--saveovernew" option. - ---------------------------------------------------------------------- + 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 + command-line argument. + + If a "--saveovernew" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "saveover=new". + + Either remove that line, or simply run Tux Paint with the command-line + argument: "--saveoverask", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Ask Before Overwriting" (under "保 + 存") is checked. + + Also, see "Tux Paint always saves over my old picture!", above. + + + + +------------------------------------------------------------------------------- Audio Problems - There's no sound! - * First, check the obvious: - * Are your speakers connected and turned on? - * Is the volume turned up on your speakers? - * Is the volume turned up in your Operating System's - "mixer?" - * Are you certain you're using a computer with a sound - card? - * Are any other programs running that use sound? (They may - be 'blocking' Tux Paint from accessing your sound - device) - * (Unix/Linux) Are you using a sound system, such as aRts, - ESD or GStreamer? If so, try setting the - "SDL_AUDIODRIVER" environment variable before running - Tux Paint (e.g., "export SDL_AUDIODRIVER=arts"). Or, run - 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? +There's no sound! + + First, check the obvious: + o Are your speakers connected and turned on? + o Is the volume turned up on your speakers? + o Is the volume turned up in your Operating System's "mixer?" + o Are you certain you're using a computer with a sound card? + o Are any other programs running that use sound? (They may be + 'blocking' Tux Paint from accessing your sound device) + o (Unix/Linux) Are you using a sound system, such as aRts, ESD or + GStreamer? If so, try setting the "SDL_AUDIODRIVER" environment + variable before running Tux Paint (e.g., "export SDL_AUDIODRIVER= + arts"). Or, run 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 - program is "blocking" the sound device), then Tux Paint may - be running with a "no sound" option. + If sound seems to work otherwise (and you're sure no other program is + "blocking" the sound device), then Tux Paint may be running with a "no + sound" option. - If you're running Tux Paint from a command-line, make sure - you're not giving it a "--nosound" option. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--nosound" option. - If you're running Tux Paint by double-clicking an icon, check - the properties of the icon to see if "--nosound" is listed as - a command-line argument. + If you're running Tux Paint by double-clicking an icon, check the + properties of the icon to see if "--nosound" is listed as a + command-line argument. - If a "--nosound" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "nosound=yes". + If a "--nosound" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "nosound=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--sound", which will override the - configuration file's setting. + Either remove that line, or simply run Tux Paint with the command-line + argument: "--sound", which will override the configuration file's + setting. - Or, you can simply run Tux Paint with the command-line - argument: "Enable Sound Effects", which will override the - configuration file's setting, and allow unlimited printing. - (You won't have to wait between prints.) + Or, you can simply run Tux Paint with the command-line argument: + "Enable Sound Effects", which will override the configuration file's + setting, and allow unlimited printing. (You won't have to wait between + prints.) - * Were sounds temporarily disabled? + + Were sounds temporarily disabled? - Even if sounds are enabled in Tux Paint, it is possible to - disable and re-enable them temporarily using the [Alt] + [S] - key sequence. Try pressing those keys to see if sounds begin - working again. + Even if sounds are enabled in Tux Paint, it is possible to disable and + re-enable them temporarily using the [Alt] + [S] key sequence. Try + pressing those keys to see if sounds begin 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. - To test whether sound support was enabled when Tux Paint was - compiled, run Tux Paint from a command line, like so: + Tux Paint may have been compiled with sound support disabled. To test + whether sound support was enabled when Tux Paint was compiled, run Tux + Paint from a command line, like so: - tuxpaint --verbose-version + tuxpaint --verbose-version - If, amongst the other information, you see "Sound disabled", - then the version of Tux Paint you're running has sound - disabled. Recompile Tux Paint, and be sure NOT to build the - "nosound" target. (i.e., don't run "make nosound") Be sure - the SDL_mixer library and its development headers are - available! + If, amongst the other information, you see "Sound disabled", then the + version of Tux Paint you're running has sound disabled. Recompile Tux + Paint, and be sure NOT to build the "nosound" target. (i.e., don't run + "make nosound") Be sure the SDL_mixer library and its development + headers are available! - Tux Paint makes too much noise! Can I turn them off? - Yes, there are a number of ways to disable sounds in Tux Paint: - * Press [Alt] + [S] while in Tux Paint to temporarily disable - sounds. (Press that key sequence again to re-enable sounds.) - * Run Tux Paint with the "no sound" option: - * Run "tuxpaint --nosound" from the command line or - shortcut or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nosound=yes". - * Or use Tux Paint Config. and make sure "Enable Sound - Effects" (under "Video & Sound") is not checked. - * Alternatively, recompile Tux Paint with sound support - disabled. (See above, and the 'Install' documentation. +Tux Paint makes too much noise! Can I turn them off? - The stereo panning of sound effects is bothersome; can sound effects be - monophonic? + Yes, there are a number of ways to disable sounds in Tux Paint: - Run Tux Paint with the "no stereo" option: + + Press [Alt] + [S] while in Tux Paint to temporarily disable sounds. + (Press that key sequence again to re-enable sounds.) + + Run Tux Paint with the "no sound" option: + o Run "tuxpaint --nosound" from the command line or shortcut or + desktop icon. + o Edit Tux Paint's configuration file (see "Options Documentation" + for details) and add a line containing "nosound=yes". + o Or use Tux Paint Config. and make sure "Enable Sound Effects" + (under "Video & Sound") is not checked. + o Alternatively, recompile Tux Paint with sound support disabled. + (See above, and the 'Install' documentation. - * Run "tuxpaint --nostereo" from the command line or shortcut - or desktop icon. - * Edit Tux Paint's configuration file (see "Options - Documentation" for details) and add a line containing - "nostereo=yes". - * Or use Tux Paint Config. and make sure "Enable Stereo - Effects" (under "Video & Sound") is not checked. - The sound effects sound strange +The stereo panning of sound effects is bothersome; can sound effects be + monophonic? - This could have to do with how SDL and SDL_mixer were initialized. - (The buffer size chosen.) + Run Tux Paint with the "no stereo" option: - Please e-mail us with details about your computer system. - (Operating system and version, sound card, which version of Tux - Paint you're running (run "tuxpaint --version" to verify), and so - on.) + + Run "tuxpaint --nostereo" from the command line or shortcut or desktop + icon. + + Edit Tux Paint's configuration file (see "Options Documentation" for + details) and add a line containing "nostereo=yes". + + Or use Tux Paint Config. and make sure "Enable Stereo Effects" (under + "Video & Sound") is not checked. - ---------------------------------------------------------------------- + +The sound effects sound strange + + This could have to do with how SDL and SDL_mixer were initialized. (The + buffer size chosen.) + + Please e-mail us with details about your computer system. (Operating system + and version, sound card, which version of Tux Paint you're running (run + "tuxpaint --version" to verify), and so on.) + + + + +------------------------------------------------------------------------------- Fullscreen Mode Problems - When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns - black! - This is apparently a bug in the SDL library. Sorry. +When I run Tux Paint full-screen and [Alt] + [Tab] out, the window turns black! + This is apparently a bug in the SDL library. Sorry. - When I run Tux Paint full-screen, it has large borders around it +When I run Tux Paint full-screen, it has large borders around it - Linux users - Your X-Window server is probably not set with the - ability to switch to the desired resolution: 800×600. (or whatever - resolution you have Tux Paint set to run at.) (This is typically - done manually under the X-Window server by pressing [Control] + - [Alt] + [Keypad Plus (+)] and [Control] + [Alt] + [Keypad Minus - (-)].) + Linux users - Your X-Window server is probably not set with the ability to + switch to the desired resolution: 800×600. (or whatever resolution you have + Tux Paint set to run at.) (This is typically done manually under the + X-Window server by pressing [Control] + [Alt] + [Keypad Plus (+)] and + [Control] + [Alt] + [Keypad Minus (-)].) - For this to work, your monitor must support that resolution, and - you need to have it listed in your X server configuration. + For this to work, your monitor must support that resolution, and you need + to have it listed in your X server configuration. - Check the "Display" subsection of the "Screen" section of your - XFree86 or X.org configuration file (typically - "/etc/X11/XF86Config-4" or "/etc/X11/XF86Config", depending on the - version of XFree86 you're using; 3.x or 4.x, respectively, or - "/etc/X11/xorg.conf" for X.org). + Check the "Display" subsection of the "Screen" section of your XFree86 or + X.org configuration file (typically "/etc/X11/XF86Config-4" or "/etc/X11/ + XF86Config", depending on the version of XFree86 you're using; 3.x or 4.x, + respectively, or "/etc/X11/xorg.conf" for X.org). - Add "800x600" (or whatever resolution(s) you want) to the - appropriate "Modes" line. (e.g., in the "Display" subsection that - contains 24-bit color depth ("Depth 24"), which is what Tux Paint - tries to use.) + Add "800x600" (or whatever resolution(s) you want) to the appropriate + "Modes" line. (e.g., in the "Display" subsection that contains 24-bit color + depth ("Depth 24"), which is what Tux Paint tries to use.) - Modes "1280x1024" "1024x768" "800x600" "640x480" + Modes "1280x1024" "1024x768" "800x600" "640x480" - Note that some Linux distributions have tools that can make these - changes for you. Debian users can run the command - "dpkg-reconfigure xserver-xfree86" as root, for example. + Note that some Linux distributions have tools that can make these changes + for you. Debian users can run the command "dpkg-reconfigure + xserver-xfree86" as root, for example. - Tux Paint keeps running in Full Screen mode - I want it windowed! - The "fullscreen" option is set. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--fullscreen" option. +Tux Paint keeps running in Full Screen mode - I want it windowed! - 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 - command-line argument. + The "fullscreen" option is set. - If a "--fullscreen" option isn't being sent on the command line, - check Tux Paint's configuration file for a line reading: - "fullscreen=yes". + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--fullscreen" option. - Either remove that line, or simply run Tux Paint with the - command-line argument: "--windowed", which will override the - configuration file's setting. + 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 command-line + argument. - Or use Tux Paint Config. and make sure "Fullscreen" (under "Video - & Sound") is not checked. + If a "--fullscreen" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "fullscreen=yes". - ---------------------------------------------------------------------- + Either remove that line, or simply run Tux Paint with the command-line + argument: "--windowed", which will override the configuration file's + setting. + + Or use Tux Paint Config. and make sure "Fullscreen" (under "Video & Sound") + is not checked. + + + + +------------------------------------------------------------------------------- Other Problems - Tux Paint won't run +Tux Paint won't run - If Tux Paint aborts with the message: "You're already running a - copy of Tux Paint!", this means it has been launched in the last - 30 seconds. (On Unix/Linux, this message would appear in a - terminal console if you ran Tux Paint from a command-line. On - Windows, this message would appear in a file named "stdout.txt" in - the same folder where TuxPaint.exe resides (e.g., in "C:\Program - Files\TuxPaint"). + If Tux Paint aborts with the message: "You're already running a copy of Tux + Paint!", this means it has been launched in the last 30 seconds. (On Unix/ + Linux, this message would appear in a terminal console if you ran Tux Paint + from a command-line. On Windows, this message would appear in a file named + "stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\ + Program Files\TuxPaint"). - A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, - "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint - isn't run too many times at once (e.g., due to a child impatiently - clicking its icon more than once). + A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\ + lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many + times at once (e.g., due to a child impatiently clicking its icon more than + once). - Even if the lockfile exists, it contains the 'time' Tux Paint was - last run. If it's been more than 30 seconds, Tux Paint should run - fine, and simply update the lockfile with the current time. + Even if the lockfile exists, it contains the 'time' Tux Paint was last run. + If it's been more than 30 seconds, Tux Paint should run fine, and simply + 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. + 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. + To disable the lockfile, add the "--nolockfile" argument to Tux Paint's + command-line, or "nolockfile=yes" to the configuration file. - I can't quit Tux Paint - The "no quit" option is set. This disables the "Quit" button in - Tux Paint's toolbar (greying it out), and prevents Tux Paint from - being exited via the [Escape] key. - If Tux Paint is not in fullscreen mode, simply click the window - close button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper - right.) +I can't 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. + The "no quit" option is set. This disables the "Quit" button in Tux Paint's + toolbar (greying it out), and prevents Tux Paint from being exited via the + [Escape] key. - (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 not in fullscreen mode, simply click the window close + button on Tux Paint's title bar. (i.e., the "ⓧ" at the upper right.) - I don't want "no quit" mode enabled! + If Tux Paint is in fullscreen mode, you will need to use the [Shift] + + [Control] + [Escape] sequence on the keyboard to quit Tux Paint. - If you're running Tux Paint from a command-line, make sure you're - not giving it a "--noquit" option. + (Note: with or without "no quit" set, you can always use the [Alt] + [F4] + combination on your keyboard to quit Tux Paint.) - 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 - command-line argument. - If a "--noquit" option isn't being sent on the command line, check - Tux Paint's configuration file for a line reading: "noquit=yes". - Either remove that line, or simply run Tux Paint with the - command-line argument: "--quit", which will override the - configuration file's setting. +I don't want "no quit" mode enabled! - Or use Tux Paint Config. and make sure "Disable Quit Button and - [Escape] Key" (under "単純化") is not checked. + If you're running Tux Paint from a command-line, make sure you're not + giving it a "--noquit" option. - Tux Paint keeps writing weird messages to the screen / to a text file + 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 command-line + argument. - A few messages are normal, but if Tux Paint is being extremely - verbose (like listing the name of every rubber-stamp image it - finds while loading them), then it was probably compiled with - debugging output turned on. + If a "--noquit" option isn't being sent on the command line, check Tux + Paint's configuration file for a line reading: "noquit=yes". - To change this, you must rebuild Tux Paint from source. Be sure to - remove or comment out any line that says: + Either remove that line, or simply run Tux Paint with the command-line + argument: "--quit", which will override the configuration file's setting. - #define DEBUG + Or use Tux Paint Config. and make sure "Disable Quit Button and [Escape] + Key" (under "単純化") is not checked. - in the "tuxpaint.c" file in the "src" directory. - Tux Paint is using options I didn't specify! - By default, Tux Paint first looks at configuration files for - options. +Tux Paint keeps writing weird messages to the screen / to a text file - * Windows + A few messages are normal, but if Tux Paint is being extremely verbose + (like listing the name of every rubber-stamp image it finds while loading + them), then it was probably compiled with debugging output turned on. - Under Windows, Tux Paint first examines the configuration - file: + To change this, you must rebuild Tux Paint from source. Be sure to remove + or comment out any line that says: - tuxpaint.cfg + #define DEBUG - Finally, any options sent as command-line arguments are used. + in the "tuxpaint.c" file in the "src" directory. - * macOS - * Unix and Linux - Under Unix and Linux, it first examines the system-wide - configuration file, located here: +Tux Paint is using options I didn't specify! - /etc/tuxpaint/tuxpaint.conf + By default, Tux Paint first looks at configuration files for options. - It then examines the user's personal configuration file: + + Windows - ~/.tuxpaintrc + Under Windows, Tux Paint first examines the configuration file: - Finally, any options sent as command-line arguments are used. + tuxpaint.cfg - * Haiku + Finally, any options sent as command-line arguments are used. - This means that if anything is set in a configuration file that - you don't want set, you'll need to either change the config. file - (if you can), or override the option on the command-line. + + macOS - For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" - includes this option to disable sound... + + Unix and Linux - nosound=yes + Under Unix and Linux, it first examines the system-wide configuration + file, located here: - ...then you can reenable sound by either adding this option to - your own ".tuxpaintrc" file: + /etc/tuxpaint/tuxpaint.conf - sound=yes + It then examines the user's personal configuration file: - ...or by using this command-line argument: + ~/.tuxpaintrc - --sound + Finally, any options sent as command-line arguments are used. - Linux and Unix users can also disable the system-wide - configuration file by including the following command-line - argument: + + Haiku - --nosysconfig + This means that if anything is set in a configuration file that you don't + want set, you'll need to either change the config. file (if you can), or + override the option on the command-line. - Tux Paint will then only look at "~/.tuxpaintrc" and command-line - arguments to determine what options should be set. + For example, on Linux and Unix, if "/etc/tuxpaint/tuxpaint.conf" includes + this option to disable sound... - ---------------------------------------------------------------------- + nosound=yes + + ...then you can reenable sound by either adding this option to your own + ".tuxpaintrc" file: + + sound=yes + + ...or by using this command-line argument: + + --sound + + Linux and Unix users can also disable the system-wide configuration file by + including the following command-line argument: + + --nosysconfig + + Tux Paint will then only look at "~/.tuxpaintrc" and command-line arguments + to determine what options should be set. + + + + +------------------------------------------------------------------------------- Help / Contact - Any questions you don't see answered? Please let us know! You can - subscribe and post to our "tuxpaint-users" mailing list: +Any questions you don't see answered? Please let us know! You can subscribe and +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 diff --git a/docs/ja_JP.UTF-8/INSTALL.txt b/docs/ja_JP.UTF-8/INSTALL.txt index 64f9448c4..d46c97efa 100644 --- a/docs/ja_JP.UTF-8/INSTALL.txt +++ b/docs/ja_JP.UTF-8/INSTALL.txt @@ -1,936 +1,935 @@ Tux Paint - バージョン 0.9.31 - Installation Documentation + バージョン 0.9.31 + Installation Documentation - Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年5月13日 + 2023年5月13日 - +----------------------------------------------------+ - |目次 | - |----------------------------------------------------| - | * Requirements | - | * Simple DirectMedia Layer library (libSDL) | - | * Other Libraries | - | * Compiling and Installation | - | * Windows | - | * Linux/Unix | - | * macOS | - | * Android | - | * Haiku | - | * Debugging | - | * Uninstalling Tux Paint | - | * Windows | - | * macOS | - | * Linux | - +----------------------------------------------------+ ++---------------------------------------------------+ +| 目次 | +|---------------------------------------------------| +| * Requirements | +| + Simple DirectMedia Layer library (libSDL) | +| + Other Libraries | +| * Compiling and Installation | +| + Windows | +| + Linux/Unix | +| + macOS | +| + Android | +| + Haiku | +| * Debugging | +| * Uninstalling Tux Paint | +| + Windows | +| + macOS | +| + Linux | ++---------------------------------------------------+ - Requirements +Requirements Simple DirectMedia Layer library (libSDL) - Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open - Source multimedia programming library available under the GNU Lesser - General Public License (LGPL). +Tux Paint requires the Simple DirectMedia Layer Library (libSDL), an Open +Source multimedia programming library available under the GNU Lesser General +Public License (LGPL). - Along with libSDL, Tux Paint depends on a number of other SDL 'helper' - libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical - functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font - support) and, optionally, SDL_Mixer (for sound effects). +Along with libSDL, Tux Paint depends on a number of other SDL 'helper' +libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical +functions, like rotation), SDL_TTF and SDL2_Pango (for True Type Font support) +and, optionally, SDL_Mixer (for sound effects). - The SDL libraries are available as source-code, or as RPM or Debian - packages for various distributions of Linux. They can be downloaded from: +The SDL libraries are available as source-code, or as RPM or Debian packages +for various distributions of Linux. They can be downloaded from: - * libSDL: http://www.libsdl.org/ - * SDL_image: https://github.com/libsdl-org/SDL_image - * SDL_gfx: - https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ - (https://sourceforge.net/projects/sdlgfx/) - * SDL_ttf: https://github.com/libsdl-org/SDL_ttf - * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango - * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) + * libSDL: http://www.libsdl.org/ + * SDL_image: https://github.com/libsdl-org/SDL_image + * SDL_gfx: https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/ ( + https://sourceforge.net/projects/sdlgfx/) + * SDL_ttf: https://github.com/libsdl-org/SDL_ttf + * SDL2_Pango: https://github.com/markuskimius/SDL2_Pango + * SDL_mixer: https://github.com/libsdl-org/SDL_mixer (optional) - They are also typically available along with your Linux distribution (e.g. - on an installation media, or available via package maintainance software - like Debian's "apt"). +They are also typically available along with your Linux distribution (e.g. on +an installation media, or available via package maintainance software like +Debian's "apt"). - 💡 Note: When installing libraries from packages, be sure to ALSO install - the development versions of the packages. (For example, install both - "SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) +💡 Note: When installing libraries from packages, be sure to ALSO install the +development versions of the packages. (For example, install both +"SDL2-2.24.0.rpm" and "SDL2-devel-2.24.0.rpm".) - Other Libraries +Other Libraries - Tux Paint also takes advantage of a number of other free, LGPL'd - libraries. Under Linux, just like SDL, they should either already be - installed, or are readily available for installation as part of your Linux - distribution. +Tux Paint also takes advantage of a number of other free, LGPL'd libraries. +Under Linux, just like SDL, they should either already be installed, or are +readily available for installation as part of your Linux distribution. - libPNG +libPNG - Tux Paint uses PNG (Portable Network Graphics) format for its data - files. SDL_image will require libPNG be installed. + Tux Paint uses PNG (Portable Network Graphics) format for its data files. + SDL_image will require libPNG be installed. - http://www.libpng.org/pub/png/libpng.html + http://www.libpng.org/pub/png/libpng.html - gettext - Tux Paint uses your system's locale settings along with the - "gettext" library to support various languages (e.g., Spanish). - You'll need the gettext library installed. - http://www.gnu.org/software/gettext/ +gettext - libpaper (Linux/Unix only) + Tux Paint uses your system's locale settings along with the "gettext" + library to support various languages (e.g., Spanish). You'll need the + gettext library installed. - As of Tux Paint 0.9.17, Tux Paint can determine your system's - default paper size (e.g., A4 or Letter), or can be told to use a - particular paper size, thanks to "libpaper". + http://www.gnu.org/software/gettext/ - https://github.com/naota/libpaper - FriBiDi - Tux Paint's "Text" and also "Label" tools support bidirectional - languages, thanks to the "FriBiDi" library. +libpaper (Linux/Unix only) - http://fribidi.org/ + As of Tux Paint 0.9.17, Tux Paint can determine your system's default paper + size (e.g., A4 or Letter), or can be told to use a particular paper size, + thanks to "libpaper". - SVG graphics support + https://github.com/naota/libpaper - As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector - Graphics) images as stamps. Two sets of libraries are supported, - and SVG support can be completely disabled (via "make SVG_LIB:=") - librsvg-2 & libCairo2 (newer libraries) - * libRSVG 2: http://librsvg.sourceforge.net/ - * Cairo 2: http://www.cairographics.org/ - * These also depend on the following: - * GdkPixbuf & GLib: http://www.gtk.org/ - * Pango: http://www.pango.org/ - Older SVG libraries - * libcairo1, libsvg1, & libsvg-cairo1: - http://www.cairographics.org/ - * These also depend on the following: - * libxml2: - https://gitlab.gnome.org/GNOME/libxml2 +FriBiDi - Animated GIF Export feature + Tux Paint's "Text" and also "Label" tools support bidirectional languages, + thanks to the "FriBiDi" library. - To support export of animated GIFs (slideshows), the - "libimagequant" library (from the "pngquant2" project) is - required. + http://fribidi.org/ - https://github.com/ImageOptim/libimagequant - NetPBM Tools (optional) No longer used, by default - 📜 Under Linux and Unix, earlier versions of Tux Paint used the - NetPBM tools to assist with printing. (A PNG is generated by Tux - Paint, and converted into a PostScript using the 'pngtopnm' and - 'pnmtops' NetPBM command-line tools.) +SVG graphics support - http://netpbm.sourceforge.net/ + As of Tux Paint 0.9.17, Tux Paint can load SVG (Scalable Vector Graphics) + images as stamps. Two sets of libraries are supported, and SVG support can + be completely disabled (via "make SVG_LIB:=") - Compiling and Installation + librsvg-2 & libCairo2 (newer libraries) + o libRSVG 2: http://librsvg.sourceforge.net/ + o Cairo 2: http://www.cairographics.org/ + o These also depend on the following: + # GdkPixbuf & GLib: http://www.gtk.org/ + # Pango: http://www.pango.org/ - Tux Paint is released under the GNU General Public License (GPL) (see - "COPYING.txt" for details), and therefore the 'source code' to the program - is available freely. - ------------------------------------------------------------------ + Older SVG libraries + o libcairo1, libsvg1, & libsvg-cairo1: http://www.cairographics.org/ + o These also depend on the following: + # libxml2: https://gitlab.gnome.org/GNOME/libxml2 + + + + + +Animated GIF Export feature + + To support export of animated GIFs (slideshows), the "libimagequant" + library (from the "pngquant2" project) is required. + + https://github.com/ImageOptim/libimagequant + + + +NetPBM Tools (optional) No longer used, by default + + 📜 Under Linux and Unix, earlier versions of Tux Paint used the NetPBM tools + to assist with printing. (A PNG is generated by Tux Paint, and converted + into a PostScript using the 'pngtopnm' and 'pnmtops' NetPBM command-line + tools.) + + http://netpbm.sourceforge.net/ + + + + +Compiling and Installation + +Tux Paint is released under the GNU General Public License (GPL) (see +"COPYING.txt" for details), and therefore the 'source code' to the program is +available freely. + + ----------------------------------------------------------------------- Windows - 2022年7月10日 Shin-ichi TOYAMA +2022年7月10日 Shin-ichi TOYAMA - Compiling Set-Up +Compiling Set-Up - As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" - includes support for building on a Windows system using MinGW/MSYS - (https://sourceforge.net/projects/msys2/). +As of February 2005 (starting with Tux Paint 0.9.15), the "Makefile" includes +support for building on a Windows system using MinGW/MSYS (https:// +sourceforge.net/projects/msys2/). - Many tools and libraries are required to build Tux Paint. The package - management system "pacman" helps you install them automatically solving - complicated dependencies. +Many tools and libraries are required to build Tux Paint. The package +management system "pacman" helps you install them automatically solving +complicated dependencies. - MYSYS2 +MYSYS2 - Download the latest MSYS2 environment from https://www.msys2.org/ and - install it where you'd like (the default is "C:\msys64") +Download the latest MSYS2 environment from https://www.msys2.org/ and install +it where you'd like (the default is "C:\msys64") - Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" - and execute following command: +Open the MSYS2 shell from the "Start Menu" → "MSYS2 64bit" → "MSYS2 MSYS" and +execute following command: - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - This will update core system and the window will close automatically. Open - the msys2 shell again and execute following command to finish remaining - updating process. +This will update core system and the window will close automatically. Open the +msys2 shell again and execute following command to finish remaining updating +process. - $ yes "" | pacman -Syu + $ yes "" | pacman -Syu - Within the MSYS2 shell, run the following command to install basic - development tools: +Within the MSYS2 shell, run the following command to install basic development +tools: - $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git - zip patch gperf dos2unix + $ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git zip + patch gperf dos2unix - Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to - the "MinGW 32bit (i686) toolchains" section if you need only a 32bit build - environment. +Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip to the " +MinGW 32bit (i686) toolchains" section if you need only a 32bit build +environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 64bit (x86_64) compiler and tools +MinGW 64bit (x86_64) compiler and tools - Within the MSYS2 shell, run the following command to install 64bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 64bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config +64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-x86_64-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 64bit environment +Install SDL2_Pango and libunibreak on the 64bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "64bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 64-bit" +This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 64-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw64 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw64 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw64 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw64 && make && make install - Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to - the "ImageMagick" section if you need only a 64bit build environment. +Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip to the " +ImageMagick" section if you need only a 64bit build environment. - ------------------------------------------------------- + ----------------------------------------------------------- - MinGW 32bit (i686) compiler and tools +MinGW 32bit (i686) compiler and tools - Within the MSYS2 shell, run the following command to install 32bit - compiler and basic development tools: +Within the MSYS2 shell, run the following command to install 32bit compiler and +basic development tools: - $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} + $ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git} - "ntldd" is a small tool which examine windows executable files to list - Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging - process for binary distribution uses it to find required .dll files. +"ntldd" is a small tool which examine windows executable files to list Dynamic +Link Library (.dll) files they depends on. Tux Paint's packaging process for +binary distribution uses it to find required .dll files. - 32bit (i686) dependency libraries for Tux Paint and Tux Paint Config +32bit (i686) dependency libraries for Tux Paint and Tux Paint Config - You can install tools and libraries required for compiling Tux Paint and - Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and - libunibreak. +You can install tools and libraries required for compiling Tux Paint and Tux +Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and +libunibreak. - FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can - skip installing it if you are only building "Tux Paint". +FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip +installing it if you are only building "Tux Paint". - $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} - $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} + $ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx} + $ pacman -S mingw-w64-i686-{librsvg,fribidi,libimagequant,fltk} - 💡 Note: Close the shell before proceeding to the remaining process. +💡 Note: Close the shell before proceeding to the remaining process. - Install SDL2_Pango and libunibreak on the 32bit environment +Install SDL2_Pango and libunibreak on the 32bit environment - SDL2_Pango and libunibreak should be installed manually. +SDL2_Pango and libunibreak should be installed manually. - This time, use the MinGW "32bit" shell. Open the shell from the "Start - Menu" → "MSYS2 64bit" → "MSYS2 MinGW 32-bit" +This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" → +"MSYS2 64bit" → "MSYS2 MinGW 32-bit" - SDL2_Pango +SDL2_Pango - You can fetch the source code from the Mark K. Kim's git repositry, - compile and install it as follows. +You can fetch the source code from the Mark K. Kim's git repositry, compile and +install it as follows. - $ git clone https://github.com/markuskimius/SDL2_Pango - $ cd SDL2_Pango - $ ./configure --prefix=/mingw32 && make && make install + $ git clone https://github.com/markuskimius/SDL2_Pango + $ cd SDL2_Pango + $ ./configure --prefix=/mingw32 && make && make install - libunibreak +libunibreak - libunibreak is required for compiling Tux Paint Config. You can skip - installing it if you are only building "Tux Paint". +libunibreak is required for compiling Tux Paint Config. You can skip installing +it if you are only building "Tux Paint". - You can fetch the source code from the git repositry and compile it as - follows. +You can fetch the source code from the git repositry and compile it as follows. - $ git clone https://github.com/adah1972/libunibreak libunibreak - $ cd libunibreak - $ ./augogen.sh --prefix=/mingw32 && make && make install + $ git clone https://github.com/adah1972/libunibreak libunibreak + $ cd libunibreak + $ ./augogen.sh --prefix=/mingw32 && make && make install - ImageMagick +ImageMagick - ImageMagick is a compilation of command line tools to create, edit, - compose, or convert bitmap images supporting quite a large number of image - formats. Tux Paint uses two functions ("convert" and "composite") in it to - generate thumbnails for startar images and templates during the build - process. +ImageMagick is a compilation of command line tools to create, edit, compose, or +convert bitmap images supporting quite a large number of image formats. Tux +Paint uses two functions ("convert" and "composite") in it to generate +thumbnails for startar images and templates during the build process. - Using official binary release available from "Windows Binary Release" is - recommended, due to the commands installed with "pacman" on MinGW/MSYS not - working as expected! +Using official binary release available from "Windows Binary Release" is +recommended, due to the commands installed with "pacman" on MinGW/MSYS not +working as expected! - Do not forget to enable "Install legacy utilities (e.g. convert)" while - installing it, because Tux Paint's build process uses them. +Do not forget to enable "Install legacy utilities (e.g. convert)" while +installing it, because Tux Paint's build process uses them. - Add the path to the directory in which ImageMagick is installed at the top - of your "PATH" environment variable. For example: +Add the path to the directory in which ImageMagick is installed at the top of +your "PATH" environment variable. For example: - $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH + $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH - You can make this permanent by adding the above to your the BASH shell - configuration file, "~/.bash_profile". +You can make this permanent by adding the above to your the BASH shell +configuration file, "~/.bash_profile". - Tux Paint & Tux Paint Config. +Tux Paint & Tux Paint Config. - You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit - binaries using "MSYS2 32bit" shell, respectively. +You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit binaries +using "MSYS2 32bit" shell, respectively. - * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to - open the 64bit shell. - * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to - open the 32bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 64-bit" from the "Start Menu" to open + the 64bit shell. + * Select "MSYS2 64bit" → "MSYS2 MinGW 32-bit" from the "Start Menu" to open + the 32bit shell. - Tux Paint Config. +Tux Paint Config. - "Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's - behavior. You have to build this component before compiling Tux Paint if - you want to have it included in your package. +"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's +behavior. You have to build this component before compiling Tux Paint if you +want to have it included in your package. - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - $ tar zxvf tuxpaint-config-A.B.C.tar.gz - $ mv tuxpaint-config-A.B.C tuxpaint-config + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + $ tar zxvf tuxpaint-config-A.B.C.tar.gz + $ mv tuxpaint-config-A.B.C tuxpaint-config - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config - tuxpaint-config + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - Now you can build Tux Paint Config. as follows: + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config + tuxpaint-config - $ cd tuxpaint-config - $ make win32 +Now you can build Tux Paint Config. as follows: - Tux Paint + $ cd tuxpaint-config + $ make win32 - You can use either (a) a stable tar-ball release, or (b) the developing - source tree. - a. Using stable tar-ball release: - * Download a source tar-ball - * Expand the tar-ball and change the directory name so that the - final packaging process can find related files. +Tux Paint - $ tar zxvf tuxpaint-A.B.C.tar.gz - $ mv tuxpaint-A.B.C tuxpaint +You can use either (a) a stable tar-ball release, or (b) the developing source +tree. - b. Using the developing source tree: - * Fetch the developing source tree from git repository: + a. Using stable tar-ball release: + + Download a source tar-ball + + Expand the tar-ball and change the directory name so that the final + packaging process can find related files. - $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint - tuxpaint + $ tar zxvf tuxpaint-A.B.C.tar.gz + $ mv tuxpaint-A.B.C tuxpaint - Now you can build Tux Paint as follows: + b. Using the developing source tree: + + Fetch the developing source tree from git repository: - $ cd tuxpaint - $ make bdist-win32 + $ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint - All the files needed for starting Tux Paint (and Tux Paint Config.) are - collected in the directory for binary distribution "bdist" directory under - "win32". You can start them by double-clicking their executable (.exe) - files in the "bdist" directory. +Now you can build Tux Paint as follows: - Building the Tux Paint Windows Installer + $ cd tuxpaint + $ make bdist-win32 - Inno Setup is used to build executable installer for Tux Paint. Therefore - you have to install it in the first place. +All the files needed for starting Tux Paint (and Tux Paint Config.) are +collected in the directory for binary distribution "bdist" directory under +"win32". You can start them by double-clicking their executable (.exe) files in +the "bdist" directory. - Inno Setup officially supports translations for only about 20 languages. - However, one of the great points of Tux Paint is it supports so many - languages. Therefore, the set up script "tuxpaint.iss" to build the - installer is written to use much more translations including unofficial - one which are available on "Inno Setup Translations". You have to download - translation files (.isl) required and put them in "Languages" directory - under the directory in which Inno Setup is installed. +Building the Tux Paint Windows Installer - Before building an installer, edit the "tuxpaint.iss" file and enable one - of the lines starting with "#define BuildTarget=", depending on the - architecture of the installer you want to create. +Inno Setup is used to build executable installer for Tux Paint. Therefore you +have to install it in the first place. - Then, you can easily build an executable installer by right-clicking on - the "tuxpaint.iss" icon in the "win32" directory and selecting "Compile" - on the list. It will run for a while, and eventually you will find a - "tuxpaint-X.Y.Z-windows--installer.exe" file in the same directory. +Inno Setup officially supports translations for only about 20 languages. +However, one of the great points of Tux Paint is it supports so many languages. +Therefore, the set up script "tuxpaint.iss" to build the installer is written +to use much more translations including unofficial one which are available on " +Inno Setup Translations". You have to download translation files (.isl) +required and put them in "Languages" directory under the directory in which +Inno Setup is installed. - Running the Tux Paint Windows Installer +Before building an installer, edit the "tuxpaint.iss" file and enable one of +the lines starting with "#define BuildTarget=", depending on the architecture +of the installer you want to create. - Double-click the Tux Paint installer executable (.EXE file) and follow the - instructions. +Then, you can easily build an executable installer by right-clicking on the +"tuxpaint.iss" icon in the "win32" directory and selecting "Compile" on the +list. It will run for a while, and eventually you will find a "tuxpaint-X.Y.Z +-windows--installer.exe" file in the same directory. - First, you will be asked to read the license. (It is the GNU General - Public License (GPL), which is also available as "COPYING.txt".) +Running the Tux Paint Windows Installer - You will then be asked whether you want to install shortcuts to Tux Paint - in your Windows Start Menu and on your Windows Desktop. (Both options are - set by default.) +Double-click the Tux Paint installer executable (.EXE file) and follow the +instructions. - Then you will be asked where you wish to install Tux Paint. The default - should be suitable, as long as there is space available. Otherwise, pick a - different location. +First, you will be asked to read the license. (It is the GNU General Public +License (GPL), which is also available as "COPYING.txt".) - At this point, you can click 'Install' to install Tux Paint! +You will then be asked whether you want to install shortcuts to Tux Paint in +your Windows Start Menu and on your Windows Desktop. (Both options are set by +default.) - Changing the Settings Using the Shortcut +Then you will be asked where you wish to install Tux Paint. The default should +be suitable, as long as there is space available. Otherwise, pick a different +location. - To change program settings, right-click on the TuxPaint shortcut and - select 'Properties' (at the bottom). +At this point, you can click 'Install' to install Tux Paint! - Make sure the 'Shortcut' tab is selected in the window that appears, and - examine the 'Target:' field. You should see something like this: +Changing the Settings Using the Shortcut - "C:\Program Files\TuxPaint\TuxPaint.exe" +To change program settings, right-click on the TuxPaint shortcut and select +'Properties' (at the bottom). - You can now add command-line options which will be enabled when you - double-click the icon. +Make sure the 'Shortcut' tab is selected in the window that appears, and +examine the 'Target:' field. You should see something like this: - For example, to make the game run in fullscreen mode, with simple shapes - (no rotation option) and in French, add the options (after - 'TuxPaint.exe'), like so: + "C:\Program Files\TuxPaint\TuxPaint.exe" - "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french +You can now add command-line options which will be enabled when you +double-click the icon. - (See the main documentation for a full list of available command-line - options.) +For example, to make the game run in fullscreen mode, with simple shapes (no +rotation option) and in French, add the options (after 'TuxPaint.exe'), like +so: - If you make a mistake or it all disappears use [Control] + [Z] to undo or - just hit the [Esc] key and the box will close with no changes made (unless - you pushed the "Apply" button!). + "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french - When you have finished, click "OK." +(See the main documentation for a full list of available command-line options.) - If Something Goes Wrong +If you make a mistake or it all disappears use [Control] + [Z] to undo or just +hit the [Esc] key and the box will close with no changes made (unless you +pushed the "Apply" button!). - If, when you double-click on the shortcut to run Tux Paint, nothing - happens, it is probably because some of these command-line options are - wrong. Open an Explorer, and look for a file called "stderr.txt" in your - personal saving folder for TuxPaint which is normaly - "C:\Users\username\AppData\Roaming\TuxPaint". +When you have finished, click "OK." - It will contain a description of what was wrong. Usually it will just be - due to incorrect character-case (capital 'Z' instead of lowercase 'z') or - a missing (or extra) '-' (dash). +If Something Goes Wrong - ------------------------------------------------------------------ +If, when you double-click on the shortcut to run Tux Paint, nothing happens, it +is probably because some of these command-line options are wrong. Open an +Explorer, and look for a file called "stderr.txt" in your personal saving +folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\ +TuxPaint". + +It will contain a description of what was wrong. Usually it will just be due to +incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing +(or extra) '-' (dash). + + ----------------------------------------------------------------------- Linux/Unix - Compiling: +Compiling: - 💡 Note: Tux Paint does not use autoconf/automake, so there is no - "./configure" script to run. Compiling should be straight-forward though, - assuming everything Tux Paint needs is installed. +💡 Note: Tux Paint does not use autoconf/automake, so there is no "./configure" +script to run. Compiling should be straight-forward though, assuming everything +Tux Paint needs is installed. - To compile the program from source, simply run the following command from - a shell prompt (e.g., "$"): +To compile the program from source, simply run the following command from a +shell prompt (e.g., "$"): - $ make + $ make - Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): +Disabling SVG support (and hence Cairo, libSVG, and svg-cairo dependencies): - To disable SVG support (e.g., if your system is not currently supported by - the Cairo library or other SVG-related dependencies), you can run "make" - with "SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: +To disable SVG support (e.g., if your system is not currently supported by the +Cairo library or other SVG-related dependencies), you can run "make" with +"SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG" added: - $ make SVG_LIB= SVG_CFLAGS= + $ make SVG_LIB= SVG_CFLAGS= - Disabling Sound at Compile-time +Disabling Sound at Compile-time - If you don't have a sound card, or would prefer to build the program with - no sound support (and therefore without a the SDL_mixer dependency), you - can run "make" with "SDL_MIXER_LIB=" added: +If you don't have a sound card, or would prefer to build the program with no +sound support (and therefore without a the SDL_mixer dependency), you can run +"make" with "SDL_MIXER_LIB=" added: - $ make SDL_MIXER_LIB= + $ make SDL_MIXER_LIB= - Other options +Other options - Various other options (e.g., installation paths) may be overridden; see - them in "Makefile" for further details. +Various other options (e.g., installation paths) may be overridden; see them in +"Makefile" for further details. - If you get errors +If you get errors - If you receive any errors during compile-time, make sure you have the - appropriate libraries installed (see above). If using packaged versions of - the libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to - get the corresponding "-dev" or "-devel" packages as well, otherwise you - won't be able to compile Tux Paint (and other programs) from source! +If you receive any errors during compile-time, make sure you have the +appropriate libraries installed (see above). If using packaged versions of the +libraries (e.g., RPMs under RedHat or DEBs under Debian), be sure to get the +corresponding "-dev" or "-devel" packages as well, otherwise you won't be able +to compile Tux Paint (and other programs) from source! - Installng +Installng - Assuming no fatal errors occured, you can now install the program so that - it can be run by users on the system. By default, this must be done by the - "root" user ('superuser'). Switch to "root" by typing the command: +Assuming no fatal errors occured, you can now install the program so that it +can be run by users on the system. By default, this must be done by the "root" +user ('superuser'). Switch to "root" by typing the command: - $ su + $ su - Enter "root"'s password at the prompt. You should now be "root" (with a - prompt like "#"). To install the program and its data files, type: +Enter "root"'s password at the prompt. You should now be "root" (with a prompt +like "#"). To install the program and its data files, type: - # make install + # make install - Finally, you can switch back to your regular user by exiting superuser - mode: +Finally, you can switch back to your regular user by exiting superuser mode: - # exit + # exit - Alternatively, you may be able to simply use the "sudo" command (e.g., on - Ubuntu Linux): +Alternatively, you may be able to simply use the "sudo" command (e.g., on +Ubuntu Linux): - $ sudo make install + $ sudo make install - 💡 Note: By default, "tuxpaint", the executable program, is placed in - "/usr/local/bin/". The data files (images, sounds, etc.) are placed in - "/usr/local/share/tuxpaint/". +💡 Note: By default, "tuxpaint", the executable program, is placed in "/usr/ +local/bin/". The data files (images, sounds, etc.) are placed in "/usr/local/ +share/tuxpaint/". - Changing Where Things Go +Changing Where Things Go - You can change where things will go by setting "Makefile"variables on the - command line. "DESTDIR" is used to place output in a staging area for - package creation. "PREFIX" is the basis of where all other files go, and - is, by default, set to "/usr/local". +You can change where things will go by setting "Makefile"variables on the +command line. "DESTDIR" is used to place output in a staging area for package +creation. "PREFIX" is the basis of where all other files go, and is, by +default, set to "/usr/local". - Other variables are: +Other variables are: - BIN_PREFIX - Where the "tuxpaint" binary will be installed. (Set to - "$(PREFIX)/bin" by default - e.g., "/usr/local/bin") +BIN_PREFIX + Where the "tuxpaint" binary will be installed. (Set to "$(PREFIX)/bin" by + default - e.g., "/usr/local/bin") - DATA_PREFIX - Where the data files (sound, graphics, brushes, stamps, fonts) - will go, and where Tux Paint will look for them when it's run. - (Set to "$(PREFIX)/share/tuxpaint") +DATA_PREFIX + Where the data files (sound, graphics, brushes, stamps, fonts) will go, and + where Tux Paint will look for them when it's run. (Set to "$(PREFIX)/share/ + tuxpaint") - DOC_PREFIX - Where the documentation text files (the "docs" directory) will go. - (Set to "$(PREFIX)/share/doc/tuxpaint") +DOC_PREFIX + Where the documentation text files (the "docs" directory) will go. (Set to + "$(PREFIX)/share/doc/tuxpaint") - MAN_PREFIX - Where the manual page for Tux Paint will go. (Set to - "$(PREFIX)/share/man") +MAN_PREFIX + Where the manual page for Tux Paint will go. (Set to "$(PREFIX)/share/man") - ICON_PREFIX — $(PREFIX)/share/pixmaps +ICON_PREFIX — $(PREFIX)/share/pixmaps +X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics +KDE_PREFIX — $(PREFIX)/share/applnk/Graphics + Where the icons and launchers (for GNOME and KDE) will go. - X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps +LOCALE_PREFIX + Where the translation files for Tux Paint will go, and where Tux Paint will + look for them. (Set to "$(PREFIX)/share/locale/") (Final location of a + translation file will be under the locale's directory (e.g., "es" for + Spanish), within the "LC_MESSAGES" subdirectory.) - GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics - KDE_PREFIX — $(PREFIX)/share/applnk/Graphics - Where the icons and launchers (for GNOME and KDE) will go. +💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a +complete list. - LOCALE_PREFIX - Where the translation files for Tux Paint will go, and where Tux - Paint will look for them. (Set to "$(PREFIX)/share/locale/") - (Final location of a translation file will be under the locale's - directory (e.g., "es" for Spanish), within the "LC_MESSAGES" - subdirectory.) - - 💡 Note: This list is out of date. See "Makefile" and "Makefile-i18n" for a - complete list. - - ------------------------------------------------------------------ + ----------------------------------------------------------------------- macOS - 2022年6月 5日 Mark Kim +2022年6月 5日 Mark Kim - Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it - were a Linux application. +Starting with Tux Paint 0.9.23, Tux Paint for macOS is built as though it were +a Linux application. - Prerequisites +Prerequisites - Although Tux Paint is built without the Xcode IDE, Xcode itself is still - required to build Tux Paint. Download it from the App Store, and launch it - once to accept its license agreements. You may also need to install the - Xcode command line tools using the command: +Although Tux Paint is built without the Xcode IDE, Xcode itself is still +required to build Tux Paint. Download it from the App Store, and launch it once +to accept its license agreements. You may also need to install the Xcode +command line tools using the command: - $ xcode-select --install + $ xcode-select --install - Building Tux Paint also requires various libraries. We install them from - MacPorts where possible, source code otherwise. Install MacPorts to the - default /opt/local path according to the instructions found on their - website: https://www.macports.org/ - * ImageMagick - * cairo - * fribidi - * lbzip2 - * libimagequant^* - * libpaper - * libpng - * librsvg - * libsdl2 - * libsdl2_image - * libsdl2_mixer - * libsdl2_pango^* - * libsdl2_ttf - * libsdl2_gfx - * pkgconfig - * zlib - ... but you should install any package that is required by the latest - version of Tux Paint. +Building Tux Paint also requires various libraries. We install them from +MacPorts where possible, source code otherwise. Install MacPorts to the default +/opt/local path according to the instructions found on their website: https:// +www.macports.org/ - ^* Not available from MacPorts as of this writing, see below. + * ImageMagick + * cairo + * fribidi + * lbzip2 + * libimagequant^* + * libpaper + * libpng + * librsvg + * libsdl2 + * libsdl2_image + * libsdl2_mixer + * libsdl2_pango^* + * libsdl2_ttf + * libsdl2_gfx + * pkgconfig + * zlib - libimagequant +... but you should install any package that is required by the latest version +of Tux Paint. - libimagequant is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. +^* Not available from MacPorts as of this writing, see below. - $ sudo port install rust cargo - $ git clone https://github.com/ImageOptim/libimagequant.git - $ cd libimagequant/imagequant-sys - $ cargo build --release # Must use cargo from MacPorts - $ sudo make PREFIX=/opt/local install +libimagequant - sdl2_pango +libimagequant is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - sdl2_pango is not available from MacPorts as of this writing. It can be - installed from the source code as follows. It should be installed to - /opt/local (same as MacPorts) for the library to be included in - TuxPaint.dmg. + $ sudo port install rust cargo + $ git clone https://github.com/ImageOptim/libimagequant.git + $ cd libimagequant/imagequant-sys + $ cargo build --release # Must use cargo from MacPorts + $ sudo make PREFIX=/opt/local install - $ git clone https://github.com/markuskimius/SDL2_Pango.git - $ cd SDL2_Pango - $ ./configure --prefix=/opt/local && make && sudo make install +sdl2_pango - WARNING: Having any UNIX-like toolset installed on your Mac besides - MacPorts and Xcode, such as Fink or Brew, will prevent your app bundle - from being portable. Be sure Fink and Brew are not accessible from your - build environment. +sdl2_pango is not available from MacPorts as of this writing. It can be +installed from the source code as follows. It should be installed to /opt/local +(same as MacPorts) for the library to be included in TuxPaint.dmg. - How to Build + $ git clone https://github.com/markuskimius/SDL2_Pango.git + $ cd SDL2_Pango + $ ./configure --prefix=/opt/local && make && sudo make install - Simply, run: +WARNING: Having any UNIX-like toolset installed on your Mac besides MacPorts +and Xcode, such as Fink or Brew, will prevent your app bundle from being +portable. Be sure Fink and Brew are not accessible from your build environment. - % make - % make install +How to Build - ... to create the TuxPaint.app application bundle that can be run in-place - or copied to /Applications. To create the DMG file for distribution, use - 'make TuxPaint.dmg'. +Simply, run: - Additional steps may be required when building for the Apple Silicon. See - "Building for Apple Silicon" below. + % make + % make install - Known Issues +... to create the TuxPaint.app application bundle that can be run in-place or +copied to /Applications. To create the DMG file for distribution, use 'make +TuxPaint.dmg'. - * A macOS binary built on a specific version of macOS only runs on that - version of macOS or later. To ensure Tux Paint can run on the oldest - version of macOS possible, build it on the oldest version of macOS - available. As of this writing we know Tux Paint cannot be built to run - on macOS 10.7 or earlier. +Additional steps may be required when building for the Apple Silicon. See +"Building for Apple Silicon" below. - See "Old Versions of macOS" below for best-effort instructions on how - to obtain, install, and build Tux Paint on an old version of macOS. +Known Issues - Alternatively, Tux Paint and all of its library dependencies may be - compiled with appropriate options to be runnable on older versions of - macOS. These options are already set on Tux Paint, so only its - dependencies (from MacPorts) need to be recompiled. See "Recompiling - MacPorts" below for the instructions. + * A macOS binary built on a specific version of macOS only runs on that + version of macOS or later. To ensure Tux Paint can run on the oldest + version of macOS possible, build it on the oldest version of macOS + available. As of this writing we know Tux Paint cannot be built to run on + macOS 10.7 or earlier. - Old Versions of macOS + See "Old Versions of macOS" below for best-effort instructions on how to + obtain, install, and build Tux Paint on an old version of macOS. - Some old versions of macOS can be downloaded from Apple's support page: - https://support.apple.com/en-us/HT211683 + Alternatively, Tux Paint and all of its library dependencies may be + compiled with appropriate options to be runnable on older versions of + macOS. These options are already set on Tux Paint, so only its dependencies + (from MacPorts) need to be recompiled. See "Recompiling MacPorts" below for + the instructions. - macOS for Intel CPU does allow dual booting of multiple versions of the - OS, but it's safer and easier to install the old macOS onto a flash drive. - Wherever you're installing it, the target drive's partitioniong scheme and - partition type must match what the old macOS expects, so use the Disk - Utility to partition and format the flash drive accordingly. +Old Versions of macOS - Dual booting multiple versions of macOS for Apple Silicon has been so far - unsuccessful. Instead of installing an older version of macOS for Apple - Silicon to build Tux Paint to run on the old version of macOS for Apple - Silicon, use the instructions found in the "Recompiling MacPorts" section - to build Tux Paint to run on older versions of macOS for Apple Silicon. +Some old versions of macOS can be downloaded from Apple's support page: https:/ +/support.apple.com/en-us/HT211683 - As of this writing, the oldest version of macOS available on Apple's - support site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" - partitioning scheme instead of the older MBR scheme, and "Mac OS Extended - (Journaled)" as the partition type instead of the newer APFS partition - type. +macOS for Intel CPU does allow dual booting of multiple versions of the OS, but +it's safer and easier to install the old macOS onto a flash drive. Wherever +you're installing it, the target drive's partitioniong scheme and partition +type must match what the old macOS expects, so use the Disk Utility to +partition and format the flash drive accordingly. - Upon launching the installer, if you get a popup about macOS being too old - or new to be installed, a bootable installer can be created using the - instructions found here: https://support.apple.com/en-mide/HT201372 +Dual booting multiple versions of macOS for Apple Silicon has been so far +unsuccessful. Instead of installing an older version of macOS for Apple Silicon +to build Tux Paint to run on the old version of macOS for Apple Silicon, use +the instructions found in the "Recompiling MacPorts" section to build Tux Paint +to run on older versions of macOS for Apple Silicon. - Once the old macOS is installed, you may find the Xcode on the App Store - is too new to run on the version of the old macOS. Old versions of Xcode - can be downloaded from Apple's Developer site in an area accessible with - free registration: https://developer.apple.com/download/more/ +As of this writing, the oldest version of macOS available on Apple's support +site is Yosemite 10.10, which expects "GPT (GUID Partition Table)" partitioning +scheme instead of the older MBR scheme, and "Mac OS Extended (Journaled)" as +the partition type instead of the newer APFS partition type. - The list of macOS versions and the last version of Xcode compatible with - them are laid out nicely on the Wikipedia page on Xcode: - https://en.wikipedia.org/wiki/Xcode#Version_comparison_table +Upon launching the installer, if you get a popup about macOS being too old or +new to be installed, a bootable installer can be created using the instructions +found here: https://support.apple.com/en-mide/HT201372 - And because Xcode is being installed manually, you can skip the step to - install the Xcode command line tools (do not run "xcode-select --install") - but otherwise build Tux Paint using the same steps described in the - earlier part of this document. +Once the old macOS is installed, you may find the Xcode on the App Store is too +new to run on the version of the old macOS. Old versions of Xcode can be +downloaded from Apple's Developer site in an area accessible with free +registration: https://developer.apple.com/download/more/ - Recompiling MacPorts +The list of macOS versions and the last version of Xcode compatible with them +are laid out nicely on the Wikipedia page on Xcode: https://en.wikipedia.org/ +wiki/Xcode#Version_comparison_table - To recompile MacPorts to be usable on older versions of macOS, set the - following options in /opt/local/etc/macports/macports.conf: +And because Xcode is being installed manually, you can skip the step to install +the Xcode command line tools (do not run "xcode-select --install") but +otherwise build Tux Paint using the same steps described in the earlier part of +this document. - buildfromsource always - macosx_deployment_target 10.10 +Recompiling MacPorts - Then uninstall all MacPorts packages: +To recompile MacPorts to be usable on older versions of macOS, set the +following options in /opt/local/etc/macports/macports.conf: - $ sudo port -fp uninstall installed + buildfromsource always + macosx_deployment_target 10.10 - Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild - libimagequant using the updated Cargo package from MacPorts. +Then uninstall all MacPorts packages: - As of this writing, all libraries Tux Paint requires from MacPorts can be - recompiled in this manner to run on macOS 10.10 Yosemite and later on - Intel CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. - Unfortunately, although MacPorts has the option to enable the building of - universal libraries, several libraries Tux Paint require cannot be built - as universal libraries so they can only be built to run natively on the - hardware on which they were built. See "Building a Universal Binary" below - for instructions on how to build Tux Paint as a Universal Binary. + $ sudo port -fp uninstall installed - Building for Apple Silicon +Then reinstall all MacPorts packages needed by Tux Paint. Also rebuild +libimagequant using the updated Cargo package from MacPorts. - macOS for Apple Silicon requires all native Apple Silicon applications be - signed, even if it is signed "ad-hoc" (anonymously). Because of this, - compilers that produce native Apple Silicon applications sign all produced - binaries and libraries as a part of the compilation process.^* However, - the Tux Paint compilation process modifies the libraries to be modular - (using install_name_tool) so they can be added into the application - bundle, which has the unfortunate side effect of breaking the signature. - This can be addressed by signing the application bundle ad-hoc (example - below) or using your own Apple Developer Identity if you have one. The DMG - file, if needed, must be created after signing the App Bundle so the DMG - file is created with signed App Bundle: +As of this writing, all libraries Tux Paint requires from MacPorts can be +recompiled in this manner to run on macOS 10.10 Yosemite and later on Intel +CPUs, and macOS 11.0 Big Sur and later on Apple Silicon. Unfortunately, +although MacPorts has the option to enable the building of universal libraries, +several libraries Tux Paint require cannot be built as universal libraries so +they can only be built to run natively on the hardware on which they were +built. See "Building a Universal Binary" below for instructions on how to build +Tux Paint as a Universal Binary. - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building for Apple Silicon - ^* For more information on the code signing requirements on the Apple - Silicon, see - https://developer.apple.com/documentation/macos-release-notes/macos-big-sur-11_0_1-universal-apps-release-notes#:~:text=New%20in%20macOS,pass%20through%20Gatekeeper. +macOS for Apple Silicon requires all native Apple Silicon applications be +signed, even if it is signed "ad-hoc" (anonymously). Because of this, compilers +that produce native Apple Silicon applications sign all produced binaries and +libraries as a part of the compilation process.^* However, the Tux Paint +compilation process modifies the libraries to be modular (using +install_name_tool) so they can be added into the application bundle, which has +the unfortunate side effect of breaking the signature. This can be addressed by +signing the application bundle ad-hoc (example below) or using your own Apple +Developer Identity if you have one. The DMG file, if needed, must be created +after signing the App Bundle so the DMG file is created with signed App Bundle: - If you get an error that the application bundle is already signed, remove - it before signing: + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg - $ codesign --remove-signature TuxPaint.app +^* For more information on the code signing requirements on the Apple Silicon, +see https://developer.apple.com/documentation/macos-release-notes/ +macos-big-sur-11_0_1-universal-apps-release-notes#:~:text= +New%20in%20macOS,pass%20through%20Gatekeeper. - If you plan to combine the Apple Silicon bundle with the Intel CPU bundle - to produce the Universal bundle, the code signing must be done after they - are combined. See "Building a Universal Binary" below. +If you get an error that the application bundle is already signed, remove it +before signing: - Building a Universal Binary + $ codesign --remove-signature TuxPaint.app - To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel - CPU and the Apple Silicon separately first. Then rename the app bundle for - the Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon - to TuxPaint-arm64.app, copy the app bundle from the Intel machine to the - Apple Silicon machine, then use the provided build-universal.sh script to - combine the two application bundles as below. The produced bundle must be - signed (see "Building for Apple Silicon" above for more details). The DMG - file, if required, must be built after the signing: +If you plan to combine the Apple Silicon bundle with the Intel CPU bundle to +produce the Universal bundle, the code signing must be done after they are +combined. See "Building a Universal Binary" below. - $ macos/build-universal.sh - $ codesign -s - TuxPaint.app - $ make TuxPaint.dmg +Building a Universal Binary - ------------------------------------------------------------------ +To build Tux Paint as a Universal Binary, compile Tux Paint for the Intel CPU +and the Apple Silicon separately first. Then rename the app bundle for the +Intel CPU to TuxPaint-x86_64.app, and the bundle for the Apple Silicon to +TuxPaint-arm64.app, copy the app bundle from the Intel machine to the Apple +Silicon machine, then use the provided build-universal.sh script to combine the +two application bundles as below. The produced bundle must be signed (see +"Building for Apple Silicon" above for more details). The DMG file, if +required, must be built after the signing: + + $ macos/build-universal.sh + $ codesign -s - TuxPaint.app + $ make TuxPaint.dmg + + ----------------------------------------------------------------------- Android - 2023年3月29日 Pere Pujal i Carabantes (Edited by Bill - Kendrick) +2023年3月29日 Pere Pujal i Carabantes (Edited by Bill +Kendrick) - As of March 2023, the Android build of Tux Paint is maintained in a - separate code repository at GitHub: - https://github.com/tux4kids/Tuxpaint-Android. Detailed instructions are - there; this acts as an overview. +As of March 2023, the Android build of Tux Paint is maintained in a separate +code repository at GitHub: https://github.com/tux4kids/Tuxpaint-Android. +Detailed instructions are there; this acts as an overview. - Prerequisites +Prerequisites - You will need recent versions of: - * Gradle — build automation tool - * Android Studio (Software Development Kit (SDK)) — to support Android - app development (Java) - * Android Native Development Kit (NDK) — to support native development - in C/C++ +You will need recent versions of: - To compile the latest Tux Paint, one has to sync the main SourceForge - project's tuxpaint Git repository with the GitHub project's - TuxPaint-Android Git repository. (Pere uses a shell script that backs up - the app/src/main/jni/tuxpaint directory in the Tuxpaint-Android GitHub - repo and makes a build of SourceForge's tuxpaint to generate translations - and other things that are not autogenerated in the Android builds, and - then copies the SourceForge tuxpaint back to Tuxpaint-Android.) (FIXME: It - should be checked-in somewhere. For now, see - https://sourceforge.net/p/tuxpaint/feature-requests/224/) + * Gradle — build automation tool + * Android Studio (Software Development Kit (SDK)) — to support Android app + development (Java) + * Android Native Development Kit (NDK) — to support native development in C/ + C++ - For it to run you need the tuxpaint and Tuxpaint-Android sources one next - to one another, and the script in the directory containing both. +To compile the latest Tux Paint, one has to sync the main SourceForge project's +tuxpaint Git repository with the GitHub project's TuxPaint-Android Git +repository. (Pere uses a shell script that backs up the app/src/main/jni/ +tuxpaint directory in the Tuxpaint-Android GitHub repo and makes a build of +SourceForge's tuxpaint to generate translations and other things that are not +autogenerated in the Android builds, and then copies the SourceForge tuxpaint +back to Tuxpaint-Android.) (FIXME: It should be checked-in somewhere. For now, +see https://sourceforge.net/p/tuxpaint/feature-requests/224/) - Fill the app/src/main/assets directory by running cd - app/src/main/jni/tuxpaint && ./mkzip_assets.sh +For it to run you need the tuxpaint and Tuxpaint-Android sources one next to +one another, and the script in the directory containing both. - Building +Fill the app/src/main/assets directory by running cd app/src/main/jni/tuxpaint +&& ./mkzip_assets.sh - The Gradle build generates some variants: PlayStore, debugPlayStore, - offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be - able to install them. (FIXME: Link to info on how to sign.) (Note: - "playStore" ones are intended to be uploaded to Google Play; this is - currently managed by Terrence Sheflin —March 2023. "offPlayStore" is the - flavor that we distribute as APK files on the Tux Paint website and - SourceForge file hosting, and is the variant built by the F-Droid app. - repository.) +Building - To trigger a build from F-droid, it suffices to tag a commit and push it - to GitHub. That doesn't guarantee the build will succeed though, so Pere - usually runs a local F-droid server to test the build and eventually adapt - the F-droid's build receipt before pushing the tag to GitHub. +The Gradle build generates some variants: PlayStore, debugPlayStore, +offPlayStore and debugoffPlayStore. You must sign the non-debug ones to be able +to install them. (FIXME: Link to info on how to sign.) (Note: "playStore" ones +are intended to be uploaded to Google Play; this is currently managed by +Terrence Sheflin —March 2023. "offPlayStore" is the flavor that we distribute +as APK files on the Tux Paint website and SourceForge file hosting, and is the +variant built by the F-Droid app. repository.) - The builds Pere distributes are all made with that local F-droid server. - It has the advantage of packing the sources and logs, and signing the APK. - Most importantly, it uses the same tools F-Droid will use to build Tux - Paint, so you can detect problems beforehand. +To trigger a build from F-droid, it suffices to tag a commit and push it to +GitHub. That doesn't guarantee the build will succeed though, so Pere usually +runs a local F-droid server to test the build and eventually adapt the +F-droid's build receipt before pushing the tag to GitHub. - The receipt Pere uses for F-Droid builds is in the metadata dir of - https://gitlab.com/fdroid/fdroiddata. The F-Droid server code is at - https://gitlab.com/fdroid/fdroidserver. To generate the server you will - need 1GB free on disk. Run the makebuildserver tool they provide, then, - from the root of fdroiddata, run ../fdroidserver/fdroid build --server - org.tuxpaint:NNNN (NNNN = version, e.g. 9288) +The builds Pere distributes are all made with that local F-droid server. It has +the advantage of packing the sources and logs, and signing the APK. Most +importantly, it uses the same tools F-Droid will use to build Tux Paint, so you +can detect problems beforehand. - ------------------------------------------------------------------ +The receipt Pere uses for F-Droid builds is in the metadata dir of https:// +gitlab.com/fdroid/fdroiddata. The F-Droid server code is at https://gitlab.com/ +fdroid/fdroidserver. To generate the server you will need 1GB free on disk. Run +the makebuildserver tool they provide, then, from the root of fdroiddata, run +../fdroidserver/fdroid build --server org.tuxpaint:NNNN (NNNN = version, e.g. +9288) + + ----------------------------------------------------------------------- Haiku - 2023年5月 7日 Luc Schrijvers (Edited by Bill Kendrick) +2023年5月 7日 Luc Schrijvers (Edited by Bill Kendrick) - Prerequisites +Prerequisites - Install the required develop packages in Terminal: +Install the required develop packages in Terminal: - 32-bit: - pkgman install xcairo_x86_devel fribidi_x86_devel - gdk_pixbuf_x86_devel libiconv_x86_devel libimagequant_x86_devel - gettext_x86_libintl libpaper_x86_devel pango_x86_devel - libpng16_x86_devel librsvg_x86_devel libsdl2_x86_devel - sdl2_image_x86_devel sdl2_gfx_x86_devel sdl2_mixer_x86_devel - sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel +32-bit: + pkgman install xcairo_x86_devel fribidi_x86_devel gdk_pixbuf_x86_devel + libiconv_x86_devel libimagequant_x86_devel gettext_x86_libintl + libpaper_x86_devel pango_x86_devel libpng16_x86_devel librsvg_x86_devel + libsdl2_x86_devel sdl2_image_x86_devel sdl2_gfx_x86_devel + sdl2_mixer_x86_devel sdl2_pango_x86_devel sdl2_ttf_x86_devel zlib_x86_devel - 64-bit: - pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel - libiconv_devel libimagequant_devel gettext_libintl libpaper_devel - pango_devel libpng16_devel librsvg_devel libsdl2_devel - sdl2_image_devel sdl2_gfx_devel sdl2_mixer_devel sdl2_pango_devel - sdl2_ttf_devel zlib_devel +64-bit: + pkgman install xcairo_devel fribidi_devel gdk_pixbuf_devel libiconv_devel + libimagequant_devel gettext_libintl libpaper_devel pango_devel + libpng16_devel librsvg_devel libsdl2_devel sdl2_image_devel sdl2_gfx_devel + sdl2_mixer_devel sdl2_pango_devel sdl2_ttf_devel zlib_devel - For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) - with setarch x86 - Building +For 32-bit you need to switch to the new compiler (currently gcc 11.2.0) with +setarch x86 - make PREFIX=/boot/home/config/non-packaged +Building - Tux Paint Stamps +make PREFIX=/boot/home/config/non-packaged - make install-all - DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ +Tux Paint Stamps - Debugging +make install-all DATA_PREFIX=/boot/home/config/non-packaged/share/tuxpaint/ - ⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file - on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled - by setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines - in "src/debug.h" and (re)compiling Tux Paint. +Debugging - Uninstalling Tux Paint +⚙ Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file on +Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be enabled by +setting "DEBUG" (and, if verbose logging is wanted, "VERBOSE") #defines in "src +/debug.h" and (re)compiling Tux Paint. + +Uninstalling Tux Paint Windows - Using the Uninstaller +Using the Uninstaller - If you installed the Start Menu shortcuts (the default), then go to the - TuxPaint folder and select "Uninstall". A box will be displayed that will - confirm that you are about to uninstall Tux Paint and, if you are certain - that you want to permanently remove Tux Paint, click on the 'Uninstall' - button. +If you installed the Start Menu shortcuts (the default), then go to the +TuxPaint folder and select "Uninstall". A box will be displayed that will +confirm that you are about to uninstall Tux Paint and, if you are certain that +you want to permanently remove Tux Paint, click on the 'Uninstall' button. - When it has finished, click on the close button. +When it has finished, click on the close button. - Using the Control Panel +Using the Control Panel - It is also possible to use the entry "TuxPaint (remove only)" in the - Control Panel Add/Remove programs section. +It is also possible to use the entry "TuxPaint (remove only)" in the Control +Panel Add/Remove programs section. macOS - Delete "TuxPaint.app" from the "Applications" folder. Data files, - including the configuration files, stamps, and saved pictures, may be - found in "/Library/Application Support/TuxPaint" (all users) and - "/Users/USERNAME/Library/Application Support/TuxPaint" (individual users). +Delete "TuxPaint.app" from the "Applications" folder. Data files, including the +configuration files, stamps, and saved pictures, may be found in "/Library/ +Application Support/TuxPaint" (all users) and "/Users/USERNAME/Library/ +Application Support/TuxPaint" (individual users). Linux - Within the Tux Paint source directory (where you compiled Tux Paint), you - can use the "make uninstall" target to uninstall Tux Paint. By default, - this must be done by the "root" user ('superuser'), but if you installed - Tux Paint somewhere else (e.g., using a "PREFIX=..." setting to "make" and - "make install"), you may not, and will want to provide those same settings - here. (See the installation instructions above for further information.) +Within the Tux Paint source directory (where you compiled Tux Paint), you can +use the "make uninstall" target to uninstall Tux Paint. By default, this must +be done by the "root" user ('superuser'), but if you installed Tux Paint +somewhere else (e.g., using a "PREFIX=..." setting to "make" and "make +install"), you may not, and will want to provide those same settings here. (See +the installation instructions above for further information.) + diff --git a/docs/ja_JP.UTF-8/MAGIC-API.txt b/docs/ja_JP.UTF-8/MAGIC-API.txt index bb23666b6..3c1f4d23b 100644 --- a/docs/ja_JP.UTF-8/MAGIC-API.txt +++ b/docs/ja_JP.UTF-8/MAGIC-API.txt @@ -1,1273 +1,1279 @@ Tux Paint - version 0.9.31 + version 0.9.31 -Magic Tool Plugin API Documentation + Magic Tool Plugin API Documentation Copyright © 2007-2023 by various contributors; see AUTHORS.txt. https://tuxpaint.org/ - 4月 13, 2023 + 4月 13, 2023 - +----------------------------------------------------+ - |Table of Contents | - |----------------------------------------------------| - | * Prequisites | - | * Interfaces | - | * 'Magic' tool plugin functions | - | * Common arguments to plugin functions | - | * Required Plugin Functions | - | * Plugin "housekeeping" functions | - | * Plugin event functions | - | * Tux Paint Functions and Data | - | * Pixel Manipulations | - | * Helper Functions | - | * Informational | - | * Tux Paint System Calls | - | * Color Conversions | - | * Helper Macros in "tp_magic_api.h" | - | * Constant Definitions in "tp_magic_api.h" | - | * Compiling | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Installing | - | * Linux and other Unix-like Platforms | - | * Windows | - | * macOS | - | * Creating plugins with multiple effects | - | * Example Code | - | * Getting Help | - | * Glossary | - +----------------------------------------------------+ ++--------------------------------------------------+ +| Table of Contents | +|--------------------------------------------------| +| * Prequisites | +| * Interfaces | +| + 'Magic' tool plugin functions | +| o Common arguments to plugin functions | +| o Required Plugin Functions | +| # Plugin "housekeeping" functions | +| # Plugin event functions | +| + Tux Paint Functions and Data | +| o Pixel Manipulations | +| o Helper Functions | +| o Informational | +| o Tux Paint System Calls | +| o Color Conversions | +| + Helper Macros in "tp_magic_api.h" | +| + Constant Definitions in "tp_magic_api.h" | +| * Compiling | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Installing | +| + Linux and other Unix-like Platforms | +| + Windows | +| + macOS | +| * Creating plugins with multiple effects | +| * Example Code | +| * Getting Help | +| * Glossary | ++--------------------------------------------------+ - Overview +Overview - Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted - from routines that lived within the application itself, to a set of - 'plugins' that are loaded when Tux Paint starts up. +Beginning with version 0.9.18, Tux Paint's 'Magic' tools were converted from +routines that lived within the application itself, to a set of 'plugins' that +are loaded when Tux Paint starts up. - This division allows more rapid development of 'Magic' tools, and allows - programmers to create and test new tools without needing to integrate them - within the main Tux Paint source code. (Users of more professional - graphics tools, such as GIMP, should be familiar with this plugin - concept.) +This division allows more rapid development of 'Magic' tools, and allows +programmers to create and test new tools without needing to integrate them +within the main Tux Paint source code. (Users of more professional graphics +tools, such as GIMP, should be familiar with this plugin concept.) - Prerequisites +Prerequisites - Tux Paint is written in the C programming language, and uses the Simple - DirectMedia Layer library ('libSDL', or simply 'SDL'; available from - https://www.libsdl.org/). Therefore, for the moment at least, one must - understand the C language and how to compile C-based programs. Familiarity - with the SDL API is highly recommended, but some basic SDL concepts will - be covered in this document. +Tux Paint is written in the C programming language, and uses the Simple +DirectMedia Layer library ('libSDL', or simply 'SDL'; available from https:// +www.libsdl.org/). Therefore, for the moment at least, one must understand the C +language and how to compile C-based programs. Familiarity with the SDL API is +highly recommended, but some basic SDL concepts will be covered in this +document. - Interfaces +Interfaces - Those who create 'Magic' tool plugins for Tux Paint must provide some - interfaces (C functions) that Tux Paint may invoke. +Those who create 'Magic' tool plugins for Tux Paint must provide some +interfaces (C functions) that Tux Paint may invoke. - Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" - routines to load plugins (shared objects files; e.g., ".so" files on Linux - or ".dll" files on Windows) and find the functions within. +Tux Paint utilizes SDL's "SDL_LoadObject()" and "SDL_LoadFunction()" routines +to load plugins (shared objects files; e.g., ".so" files on Linux or ".dll" +files on Windows) and find the functions within. - In turn, Tux Paint provides a number of helper functions that the plugin - may (or sometimes is required to) use. This is exposed as a C structure - (or "struct") which contains pointers to functions and other data inside - Tux Paint. A pointer to this structure gets passed along to the plugin's - functions as an argument when Tux Paint invokes them. +In turn, Tux Paint provides a number of helper functions that the plugin may +(or sometimes is required to) use. This is exposed as a C structure (or +"struct") which contains pointers to functions and other data inside Tux Paint. +A pointer to this structure gets passed along to the plugin's functions as an +argument when Tux Paint invokes them. - Plugins should #include the C header file "tp_magic_api.h", which exposes - the 'Magic' tool plugin API. Also, when you run the C compiler to build a - plugin, you should use the command-line tool "tp-magic-config" to get the - appropriate compiler flags (such as where the compiler can find the Tux - Paint plugin header file, as well as SDL's header files) for building a - plugin. (See "Compiling", below.) +Plugins should #include the C header file "tp_magic_api.h", which exposes the +'Magic' tool plugin API. Also, when you run the C compiler to build a plugin, +you should use the command-line tool "tp-magic-config" to get the appropriate +compiler flags (such as where the compiler can find the Tux Paint plugin header +file, as well as SDL's header files) for building a plugin. (See "Compiling", +below.) - The C header file and command-line tool mentioned above are included with - Tux Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package". +The C header file and command-line tool mentioned above are included with Tux +Paint — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin +Development package". 'Magic' tool plugin functions - 'Magic' tool plugins must contain the functions listed below. Note: To - avoid 'namespace' collisions, each function's name must start with the - shared object's filename (e.g., "blur.so" or "blur.dll" would have - functions whose names begin with "blur_"). This includes private functions - (ones not used by Tux Paint directly), unless you declare those as - 'static'. - - Common arguments to plugin functions - - Here is a description of arguments that many of your plugin's functions - will need to accept. - - magic_api * api - - Pointer to a C structure containing pointers to Tux Paint - functions and other data that the plugin can (and sometimes - should) use. The contents of this struct are described below. - - Note: The magic_api struct is defined in the C header file - "tp_magic_api.h", which you should include at the top of your - plugin's C source file: - - #include "tp_magic_api.h" - - int which - An index the plugin should use to differentiate different 'Magic' - tools, if the plugin provides more than one. (If not, "which" will - always be 0.) See "Creating plugins with multiple effects", below. +'Magic' tool plugins must contain the functions listed below. Note: To avoid +'namespace' collisions, each function's name must start with the shared +object's filename (e.g., "blur.so" or "blur.dll" would have functions whose +names begin with "blur_"). This includes private functions (ones not used by +Tux Paint directly), unless you declare those as 'static'. - SDL_Surface * snapshot - A snapshot of the previous Tux Paint canvas, taken when the the - mouse was first clicked to activate the current magic tool. If you - don't continuously affect the image during one hold of the mouse - button, you should base your effects off the contents of this - canvas. (That is, read from "snapshot" and write to "canvas", - below.) - - SDL_Surface * canvas - The current Tux Paint drawing canvas. Your magical effects should - end up here! - - SDL_Rect * update_rect - A pointer to an SDL 'rectangle' structure that you use to tell Tux - Paint what part of the canvas has been updated. If your effect - affects a 32x32 area centered around the mouse pointer, you would - fill the SDL_Rect as follows: - - update_rect->x = x - 16; - update_rect->y = y - 16; - update_rect->w = 32; - update_rect->h = 32; - - Or, if your effect changes the entire canvas (e.g., flips it - upside-down), you'd fill it as follows: - - update_rect->x = 0; - update_rect->y = 0; - update_rect->w = canvas->w; - update_rect->h = canvas->h; - - Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than - just an "SDL_Rect") because you need to fill in its contents. - Since it is a pointer, you access its elements via "->" (arrow) - rather than "." (dot). +Common arguments to plugin functions - Required Plugin Functions +Here is a description of arguments that many of your plugin's functions will +need to accept. - Your plugin is required to contain, at the least, all of the following - functions. - - Note: Remember, your plugin's function names must be preceded by your - plugin's filename. That is, if your plugin is called "zoom.so" (on Linux) - or "zoom.dll" (on Windows), then the names of your functions must begin - with "zoom_" (e.g., "zoom_get_name(...)"). - - Plugin "housekeeping" functions - - Uint32 api_version(void) - - The plugin should return an integer value representing the version - of the Tux Paint 'Magic' tool plugin API the plugin was built - against. The safest thing to do is return the value of - TP_MAGIC_API_VERSION, which is defined in "tp_magic_api.h". If Tux - Paint deems your plugin to be compatible, it will go ahead and use - it. - - Note: Called once by Tux Paint, at startup. It is called first. - - int init(magic_api * api, Uint32 disabled_features) - - The plugin should do any initialization here. Return '1' if - initialization was successful, or '0' if not (and Tux Paint will - not present any 'Magic' tools from the plugin). - - Note: Called once by Tux Paint, at startup. It is called after - "api_version()", if Tux Paint believes your plugin to be - compatible. - - The disabled_features value contains bits set for any Tux Paint - features relevant to Magic tools which have been disabled in this - session. Test using the C bitwise 'and' operator, '&'. The - features are defined in tp_magic_api.h: - * MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs - fullscreen) (--nomagiccontrols) - * MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) - Your Magic tool(s) may wish to react differently depending on - whether one or more features have been disabled. (For example, the - "Brick" Magic tool always offered two tool variations: large and - small. With the addition of the size feature, only one tool is - necessary. However, with the size option disabled, the plugin is - able to revert back to providing two separate tools.) - - Note: Changed most recently in Tux Paint 0.9.30; Magic API version - 0x00000008. - - int get_tool_count(magic_api * api) - - This should return the number of Magic tools this plugin provides - to Tux Paint. - - Note: Called once by Tux Paint, at startup. It is called after - your "init()", if it succeeded. - - Note: You may wish to resond differently, based on whether certain - features have been disabled (e.g., 'paint' versus 'entire picture' - controls, or 'Magic sizes' controls). - - int modes(magic_api * api, int which) +magic_api * api - This lets you tell Tux Paint what modes your tool can be used in; - either as a tool the user can paint with, or a tool that affects - the entire drawing at once. - - You must return a value that's some combination of one or more of - available modes: - * MODE_PAINT - freehand paint (click and drag) - * MODE_FULLSCREEN - applies to full image with one click - * MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click - and drag) - * MODE_ONECLICK - applies to an area around the mouse, with one - click - e.g., if your tool is only one that the user can paint with, - return "MODE_PAINT". If the user can do both, return "MODE_PAINT | - MODE_FULLSCREEN" to tell Tux Paint it can do both. + Pointer to a C structure containing pointers to Tux Paint functions and + other data that the plugin can (and sometimes should) use. The contents of + this struct are described below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + Note: The magic_api struct is defined in the C header file + "tp_magic_api.h", which you should include at the top of your plugin's C + source file: - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + #include "tp_magic_api.h" - char * get_name(magic_api * api, int which) - This should return a string containing the name of a magic tool. - This will appear on the button in the 'Magic' selector within Tux - Paint. - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. +int which + An index the plugin should use to differentiate different 'Magic' tools, if + the plugin provides more than one. (If not, "which" will always be 0.) See + "Creating plugins with multiple effects", below. - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). +SDL_Surface * snapshot + A snapshot of the previous Tux Paint canvas, taken when the the mouse was + first clicked to activate the current magic tool. If you don't continuously + affect the image during one hold of the mouse button, you should base your + effects off the contents of this canvas. (That is, read from "snapshot" and + write to "canvas", below.) - int get_group(magic_api * api, int which) +SDL_Surface * canvas + The current Tux Paint drawing canvas. Your magical effects should end up + here! - Use this to group tools together within sections of the 'Magic' - selector. A number of groups are pre-defined within an enum found - in "tp_magic_api.h": - * MAGIC_TYPE_DISTORTS — Tools that distort the shape of the - image, like Blur, Emboss, and Ripples - * MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the - colors of the image without distortion, like Darken, - Negative, and Tint - * MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire - picture, like Shift, Flip, and Waves - * MAGIC_TYPE_PAINTING — Tools that generally paint new content - at the cursor position, like Grass, Bricks, and Rails - * MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple - places at once, like Kaleidoscope and the Symmetry tools - * MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations - to the entire picture, like Blinds and Checkboard - * MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like - Flower, the String tools, and the Rainbow-arc-drawing tools. +SDL_Rect * update_rect + A pointer to an SDL 'rectangle' structure that you use to tell Tux Paint + what part of the canvas has been updated. If your effect affects a 32x32 + area centered around the mouse pointer, you would fill the SDL_Rect as + follows: - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). + update_rect->x = x - 16; + update_rect->y = y - 16; + update_rect->w = 32; + update_rect->h = 32; - Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + Or, if your effect changes the entire canvas (e.g., flips it upside-down), + you'd fill it as follows: - SDL_Surface * get_icon(magic_api * api, int which) - - This should return an SDL_Surface containing the icon representing - the tool. (A greyscale image with alpha, no larger than 40x40.) - This will appear on the button in the 'Magic' selector within Tux - Paint. - - Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - char * get_description(magic_api * api, int which, int mode) - - This should return a string containing the description of how to - use a particular magic tool. This will appear as a help tip, - explained by Tux the Penguin, within Tux Paint. - - Tux Paint will free() the string upon exit, so you should wrap it - in a C strdup() call. + update_rect->x = 0; + update_rect->y = 0; + update_rect->w = canvas->w; + update_rect->h = canvas->h; - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). + Note: "update_rect" is a C pointer (an "SDL_Rect *" rather than just an + "SDL_Rect") because you need to fill in its contents. Since it is a + pointer, you access its elements via "->" (arrow) rather than "." (dot). - In other words, if your plugin contains two tools, one which works - in paint mode only, and the other that works in both paint mode - and full-image mode, your plugin's "get_description()" will be - called three times. - - int requires_colors(magic_api * api, int which) - - Return a '1' if the 'Magic' tool accepts colors (the 'Colors' - palette in Tux Paint will be available), or '0' if not. - - Note: Called once for each Magic tool your plugin claims to - contain (by your "get_tool_count()"). - - Uint8 accepted_sizes(magic_api * api, int which, int mode) - - Return how many size variations the 'Magic' tool accepts, in the - given mode (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' - if the 'Magic' tool should not offer sizing options. Returning '1' - is the same as returning '0'. - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - Uint8 default_size(magic_api * api, int which, int mode) - Return the default size the 'Magic' tool should start out with, in - the given mode. This will be the default setting for the tool the - first time it is used during a Tux Paint session. If Tux Paint is - being invoked with the sizing option disabled, this will be the - only size requested by Tux Paint. Return a number between '1' and - the amount you returned in accepted_sizes(). - - Note: For each Magic tool your plugin claims to contain (reported - by your "get_tool_count()" function), this function will be called - for each mode the tool claims to support (reported by your - "modes()" function). - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void shutdown(magic_api * api) - - The plugin should do any cleanup here. If you allocated any memory - or used SDL_Mixer to load any sounds during init(), for example, - you should free() the allocated memory and Mix_FreeChunk() the - sounds here. - - Note: This function is called once, when Tux Paint exits. - - Plugin event functions - - void switchin(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - void switchout(magic_api * api, int which, int mode, SDL_Surface * - snapshot, SDL_Surface * canvas) - - switchin() is called whenever one of the plugin's Magic tools - becomes active, and switchout() is called whenever one becomes - inactive. This can be because the user just clicked a specific - Magic tool (the current one is switched-out, and a new one is - switched-in). +Required Plugin Functions + +Your plugin is required to contain, at the least, all of the following +functions. + +Note: Remember, your plugin's function names must be preceded by your plugin's +filename. That is, if your plugin is called "zoom.so" (on Linux) or "zoom.dll" +(on Windows), then the names of your functions must begin with "zoom_" (e.g., +"zoom_get_name(...)"). + +Plugin "housekeeping" functions + +Uint32 api_version(void) + + The plugin should return an integer value representing the version of the + Tux Paint 'Magic' tool plugin API the plugin was built against. The safest + thing to do is return the value of TP_MAGIC_API_VERSION, which is defined + in "tp_magic_api.h". If Tux Paint deems your plugin to be compatible, it + will go ahead and use it. + + Note: Called once by Tux Paint, at startup. It is called first. + + + +int init(magic_api * api, Uint32 disabled_features) + + The plugin should do any initialization here. Return '1' if initialization + was successful, or '0' if not (and Tux Paint will not present any 'Magic' + tools from the plugin). + + Note: Called once by Tux Paint, at startup. It is called after "api_version + ()", if Tux Paint believes your plugin to be compatible. + + The disabled_features value contains bits set for any Tux Paint features + relevant to Magic tools which have been disabled in this session. Test + using the C bitwise 'and' operator, '&'. The features are defined in + tp_magic_api.h: + + MAGIC_FEATURE_CONTROL: Magic tool controls (paint vs fullscreen) + (--nomagiccontrols) + + MAGIC_FEATURE_SIZE: Magic tool size (--nomagicsizes) + Your Magic tool(s) may wish to react differently depending on whether one + or more features have been disabled. (For example, the "Brick" Magic tool + always offered two tool variations: large and small. With the addition of + the size feature, only one tool is necessary. However, with the size option + disabled, the plugin is able to revert back to providing two separate + tools.) + + Note: Changed most recently in Tux Paint 0.9.30; Magic API version + 0x00000008. + + + +int get_tool_count(magic_api * api) + + This should return the number of Magic tools this plugin provides to Tux + Paint. + + Note: Called once by Tux Paint, at startup. It is called after your "init() + ", if it succeeded. + + Note: You may wish to resond differently, based on whether certain features + have been disabled (e.g., 'paint' versus 'entire picture' controls, or + 'Magic sizes' controls). + + + +int modes(magic_api * api, int which) + + This lets you tell Tux Paint what modes your tool can be used in; either as + a tool the user can paint with, or a tool that affects the entire drawing + at once. + + You must return a value that's some combination of one or more of available + modes: + + MODE_PAINT - freehand paint (click and drag) + + MODE_FULLSCREEN - applies to full image with one click + + MODE_PAINT_WITH_PREVIEW - freehand paint, with preview (click and drag) + + MODE_ONECLICK - applies to an area around the mouse, with one click + e.g., if your tool is only one that the user can paint with, return + "MODE_PAINT". If the user can do both, return "MODE_PAINT | + MODE_FULLSCREEN" to tell Tux Paint it can do both. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +char * get_name(magic_api * api, int which) + + This should return a string containing the name of a magic tool. This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +int get_group(magic_api * api, int which) + + Use this to group tools together within sections of the 'Magic' selector. A + number of groups are pre-defined within an enum found in "tp_magic_api.h": + + MAGIC_TYPE_DISTORTS — Tools that distort the shape of the image, like + Blur, Emboss, and Ripples + + MAGIC_TYPE_COLOR_FILTERS — Tools that mostly affect the colors of the + image without distortion, like Darken, Negative, and Tint + + MAGIC_TYPE_PICTURE_WARPS — Tools that warp or move the entire picture, + like Shift, Flip, and Waves + + MAGIC_TYPE_PAINTING — Tools that generally paint new content at the + cursor position, like Grass, Bricks, and Rails + + MAGIC_TYPE_PATTERN_PAINTING — Tools that paint in multiple places at + once, like Kaleidoscope and the Symmetry tools + + MAGIC_TYPE_PICTURE_DECORATIONS — Tools that apply decorations to the + entire picture, like Blinds and Checkboard + + MAGIC_TYPE_ARTISTIC — Special-purpose artistic tools, like Flower, the + String tools, and the Rainbow-arc-drawing tools. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + Note: Added to Tux Paint 0.9.27; Magic API version 0x00000005. + + + +SDL_Surface * get_icon(magic_api * api, int which) + + This should return an SDL_Surface containing the icon representing the + tool. (A greyscale image with alpha, no larger than 40x40.) This will + appear on the button in the 'Magic' selector within Tux Paint. + + Tux Paint will free ("SDL_FreeSurface()") the surface upon exit. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +char * get_description(magic_api * api, int which, int mode) + + This should return a string containing the description of how to use a + particular magic tool. This will appear as a help tip, explained by Tux the + Penguin, within Tux Paint. + + Tux Paint will free() the string upon exit, so you should wrap it in a C + strdup() call. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + In other words, if your plugin contains two tools, one which works in paint + mode only, and the other that works in both paint mode and full-image mode, + your plugin's "get_description()" will be called three times. + + + +int requires_colors(magic_api * api, int which) + + Return a '1' if the 'Magic' tool accepts colors (the 'Colors' palette in + Tux Paint will be available), or '0' if not. + + Note: Called once for each Magic tool your plugin claims to contain (by + your "get_tool_count()"). + + + +Uint8 accepted_sizes(magic_api * api, int which, int mode) + + Return how many size variations the 'Magic' tool accepts, in the given mode + (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). Return a '0' if the 'Magic' tool + should not offer sizing options. Returning '1' is the same as returning + '0'. + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +Uint8 default_size(magic_api * api, int which, int mode) + + Return the default size the 'Magic' tool should start out with, in the + given mode. This will be the default setting for the tool the first time it + is used during a Tux Paint session. If Tux Paint is being invoked with the + sizing option disabled, this will be the only size requested by Tux Paint. + Return a number between '1' and the amount you returned in accepted_sizes + (). + + Note: For each Magic tool your plugin claims to contain (reported by your + "get_tool_count()" function), this function will be called for each mode + the tool claims to support (reported by your "modes()" function). + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void shutdown(magic_api * api) + + The plugin should do any cleanup here. If you allocated any memory or used + SDL_Mixer to load any sounds during init(), for example, you should free() + the allocated memory and Mix_FreeChunk() the sounds here. + + Note: This function is called once, when Tux Paint exits. + + + + +Plugin event functions + +void switchin(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas) + void switchout(magic_api * api, int which, int mode, SDL_Surface * + snapshot, SDL_Surface * canvas) + + switchin() is called whenever one of the plugin's Magic tools becomes + active, and switchout() is called whenever one becomes inactive. This can + be because the user just clicked a specific Magic tool (the current one is + switched-out, and a new one is switched-in). + + It can also happen when user leaves/returns from the selection of "Magic" + tools when doing some other activity (i.e., using a different tool, such as + "Text" or "Brush", activating a momentary tool, such as "Undo" and "Redo", + or returning from a dialog — possibly with a new picture when it switches + back — such as "Open", "New" or "Quit"). In this case, the same Magic tool + is first 'switched-out', and then 'switched-back-in', usually moments + later. + + Finally, it can also happen when the user changes the 'mode' of a tool + (i.e., from paint mode to full-image mode). First switchout() is called for + the old mode, then switchin() is called for the new mode. + + These functions allow users to interact in complicated was with Magic tools + (for example, a tool that lets the user draw multiple freehand strokes, and + then uses that as input such as handwriting — normally, the user could + click somewhere in the canvas to tell the Magic tool they are 'finished', + but if they switch to another tool, the Magic tool may want to undo any + temporary changes to the canvas). + + These functions could also be used to streamline certain effects; a + behind-the-scenes copy of the entire canvas could be altered in some way + when the user first switches to the canvas, and then pieces of that copy + could be drawn on the canvas when they draw with the Magic tool. + + Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. + + + +void set_color(magic_api * api, int which, SDL_Surface * canvas, SDL_Surface * + last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the RGB values of + the currently-selected color in Tux Paint's 'Colors' palette. (It will be + called whenever one of the plugin's Magic tools that accept colors becomes + active, and whenever the user picks a new color while such a tool is + currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated color, but it is possible. (For example, the "Zoom" and + "Perspective" tools apply effects which uses the current color choice as a + solid background. The effects may be adjusted with subsequent click/drag + operations, but you may also adjust the background color, without altering + the zoom level or perspective, by simply picking a new color.) + + Note: Changed most recently in Tux Paint 0.9.29; Magic API version + 0x00000007. + + + +void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, + SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) + + Tux Paint will call this function to inform the plugin of the 'Magic' tool + size option chosen. (It will be called whenever one of the plugin's Magic + tools that accept sizes becomes active, and whenever the user picks a new + size while such a tool is currently active.) + + Generally, Magic tools will not alter the canvas in any way when receiving + an updated size, but it is possible. + + Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. + + + +void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, + SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was clicked, and you are told which 'mode' your tool + is in (i.e., 'MODE_PAINT' or 'MODE_FULLSCREEN). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + The contents of the drawing canvas immediately prior to the mouse button + click is stored within the 'snapshot' canvas. + + + +void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (ox,oy) and (x,y) coordinates are the location of the mouse at + the beginning and end of the stroke. + + Typically, plugins that let the user "draw" effects onto the canvas utilize + Tux Paint's "line()" 'Magic' tool plugin helper function to calculate the + points of the line between (ox,oy) and (x,y), and call another function + within the plugin to apply the effect at each point. (See "Tux Paint + Functions and Data," below). + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. + + + +void release(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface * + canvas, int x, int y, SDL_Rect * update_rect) + + The plugin should apply the appropriate 'Magic' tool on the 'canvas' + surface. The (x,y) coordinates are where the mouse was (within the canvas) + when the mouse button was released. + + The plugin should report back what part of the canvas was affected, by + filling in the (x,y) and (w,h) elements of 'update_rect'. + + Note: The contents of the drawing canvas immediately prior to the mouse + button click remains as it was (when the plugin's "click()" function was + called), and is still available in the 'snapshot' canvas. - It can also happen when user leaves/returns from the selection of - "Magic" tools when doing some other activity (i.e., using a - different tool, such as "Text" or "Brush", activating a momentary - tool, such as "Undo" and "Redo", or returning from a dialog — - possibly with a new picture when it switches back — such as - "Open", "New" or "Quit"). In this case, the same Magic tool is - first 'switched-out', and then 'switched-back-in', usually moments - later. - Finally, it can also happen when the user changes the 'mode' of a - tool (i.e., from paint mode to full-image mode). First switchout() - is called for the old mode, then switchin() is called for the new - mode. - These functions allow users to interact in complicated was with - Magic tools (for example, a tool that lets the user draw multiple - freehand strokes, and then uses that as input such as handwriting - — normally, the user could click somewhere in the canvas to tell - the Magic tool they are 'finished', but if they switch to another - tool, the Magic tool may want to undo any temporary changes to the - canvas). - - These functions could also be used to streamline certain effects; - a behind-the-scenes copy of the entire canvas could be altered in - some way when the user first switches to the canvas, and then - pieces of that copy could be drawn on the canvas when they draw - with the Magic tool. - - Note: Added to Tux Paint 0.9.21; Magic API version 0x00000002. - - void set_color(magic_api * api, int which, SDL_Surface * canvas, - SDL_Surface * last, Uint8 r, Uint8 g, Uint8 b, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the RGB - values of the currently-selected color in Tux Paint's 'Colors' - palette. (It will be called whenever one of the plugin's Magic - tools that accept colors becomes active, and whenever the user - picks a new color while such a tool is currently active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated color, but it is possible. (For example, the - "Zoom" and "Perspective" tools apply effects which uses the - current color choice as a solid background. The effects may be - adjusted with subsequent click/drag operations, but you may also - adjust the background color, without altering the zoom level or - perspective, by simply picking a new color.) - - Note: Changed most recently in Tux Paint 0.9.29; Magic API version - 0x00000007. - - void set_size(magic_api * api, int which, int mode, SDL_Surface * canvas, - SDL_Surface * last, Uint8 size, SDL_Rect * update_rect) - - Tux Paint will call this function to inform the plugin of the - 'Magic' tool size option chosen. (It will be called whenever one - of the plugin's Magic tools that accept sizes becomes active, and - whenever the user picks a new size while such a tool is currently - active.) - - Generally, Magic tools will not alter the canvas in any way when - receiving an updated size, but it is possible. - - Note: Added to Tux Paint 0.9.30; Magic API version 0x00000008. - - void click(magic_api * api, int which, int mode, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was clicked, and you are - told which 'mode' your tool is in (i.e., 'MODE_PAINT' or - 'MODE_FULLSCREEN). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - The contents of the drawing canvas immediately prior to the mouse - button click is stored within the 'snapshot' canvas. - - void drag(magic_api * api, int which, SDL_Surface * snapshot, SDL_Surface - * canvas, int ox, int oy, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (ox,oy) and (x,y) coordinates are the - location of the mouse at the beginning and end of the stroke. - - Typically, plugins that let the user "draw" effects onto the - canvas utilize Tux Paint's "line()" 'Magic' tool plugin helper - function to calculate the points of the line between (ox,oy) and - (x,y), and call another function within the plugin to apply the - effect at each point. (See "Tux Paint Functions and Data," below). - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. - - void release(magic_api * api, int which, SDL_Surface * snapshot, - SDL_Surface * canvas, int x, int y, SDL_Rect * update_rect) - - The plugin should apply the appropriate 'Magic' tool on the - 'canvas' surface. The (x,y) coordinates are where the mouse was - (within the canvas) when the mouse button was released. - - The plugin should report back what part of the canvas was - affected, by filling in the (x,y) and (w,h) elements of - 'update_rect'. - - Note: The contents of the drawing canvas immediately prior to the - mouse button click remains as it was (when the plugin's "click()" - function was called), and is still available in the 'snapshot' - canvas. Tux Paint Functions and Data - Tux Paint provides a number of helper functions that plugins may access - via the "magic_api" structure, sent to all of the plugin's functions. (See - "Required Plugin Functions," above.) +Tux Paint provides a number of helper functions that plugins may access via the +"magic_api" structure, sent to all of the plugin's functions. (See "Required +Plugin Functions," above.) - Pixel Manipulations +Pixel Manipulations - Uint32 getpixel(SDL_Surface * surf, int x, int y) - Retreives the pixel value from the (x,y) coordinates of an - SDL_Surface. (You can use SDL's "SDL_GetRGB()" function to convert - the Uint32 'pixel' to a set of Uint8 RGB values.) +Uint32 getpixel(SDL_Surface * surf, int x, int y) + Retreives the pixel value from the (x,y) coordinates of an SDL_Surface. + (You can use SDL's "SDL_GetRGB()" function to convert the Uint32 'pixel' to + a set of Uint8 RGB values.) - void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) - Sets the pixel value at position (x,y) of an SDL_Surface. (You can - use SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB - values to a Uint32 'pixel' value appropriate to the destination - surface.) +void putpixel(SDL_Surface * surf, int x, int y, Uint32 pixel) + Sets the pixel value at position (x,y) of an SDL_Surface. (You can use + SDL's "SDL_MapRGB()" function to convert a set of Uint8 RGB values to a + Uint32 'pixel' value appropriate to the destination surface.) - Uint32 xorpixel(SDL_Surface * surf, int x, int y) - Applies an XOR (exclusive-or) operation to the pixel at - coordinates (x,y) of the SDL_Surface. Applying an XOR again at the - same position will return the pixel to the original value. Useful - for displaying temporary 'rubberband' lines, outlines, and - crosshairs, while utilizing a Magic Tool. +Uint32 xorpixel(SDL_Surface * surf, int x, int y) + Applies an XOR (exclusive-or) operation to the pixel at coordinates (x,y) + of the SDL_Surface. Applying an XOR again at the same position will return + the pixel to the original value. Useful for displaying temporary + 'rubberband' lines, outlines, and crosshairs, while utilizing a Magic Tool. +SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) - SDL_Surface * scale(SDL_Surface * surf, int w, int h, int keep_aspect) + This accepts an existing SDL surface and creates a new one scaled to an + arbitrary size. (The original surface remains untouched.) - This accepts an existing SDL surface and creates a new one scaled - to an arbitrary size. (The original surface remains untouched.) + The "keep_aspect" flag can be set to '1' to force the new surface to stay + the same shape (aspect ratio) as the original, meaning it may not be the + same width and height you requested. (Check the "->w" and "->h" elements of + the output "SDL_Surface *" to determine the actual size.) - The "keep_aspect" flag can be set to '1' to force the new surface - to stay the same shape (aspect ratio) as the original, meaning it - may not be the same width and height you requested. (Check the - "->w" and "->h" elements of the output "SDL_Surface *" to - determine the actual size.) - Helper Functions +Helper Functions - int in_circle(int x, int y, int radius) - Returns '1' if the (x,y) location is within a circle of a - particular radius (centered around the origin: (0,0)). Returns '0' - otherwise. Useful to create 'Magic' tools that affect the canvas - with a circular brush shape. +int in_circle(int x, int y, int radius) + Returns '1' if the (x,y) location is within a circle of a particular radius + (centered around the origin: (0,0)). Returns '0' otherwise. Useful to + create 'Magic' tools that affect the canvas with a circular brush shape. - void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * - snapshot, int x1, int y1, int x2, int y2, int step, FUNC callback) +void line(void * api, int which, SDL_Surface * canvas, SDL_Surface * snapshot, + int x1, int y1, int x2, int y2, int step, FUNC callback) - This function calculates all points on a line between the - coordinates (x1,y1) and (x2,y2). Every 'step' iterations, it calls - the 'callback' function. + This function calculates all points on a line between the coordinates + (x1,y1) and (x2,y2). Every 'step' iterations, it calls the 'callback' + function. - It sends the 'callback' function the (x,y) coordinates on the - line, Tux Paint's "magic_api" struct (as a "void *" pointer which - you need to send to it), a 'which' value, represening which of the - plugin's 'Magic' tool is being used, and the current and snapshot - canvases. + It sends the 'callback' function the (x,y) coordinates on the line, Tux + Paint's "magic_api" struct (as a "void *" pointer which you need to send to + it), a 'which' value, represening which of the plugin's 'Magic' tool is + being used, and the current and snapshot canvases. - Example prototype of a callback function that may be sent to Tux - Paint's "line()" 'Magic' tool plugin helper function: + Example prototype of a callback function that may be sent to Tux Paint's + "line()" 'Magic' tool plugin helper function: - void exampleCallBack(void * ptr_to_api, int which_tool, - SDL_Surface * canvas, SDL_Surface * snapshot, int x, int y); + void exampleCallBack(void * ptr_to_api, int which_tool, SDL_Surface * + canvas, SDL_Surface * snapshot, int x, int y); - Example use of the "line()" helper (e.g., within a plugin's draw() - function): + Example use of the "line()" helper (e.g., within a plugin's draw() + function): - api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, - 1, exampleCallBack); + api->line((void *) api, which, canvas, snapshot, ox, oy, x, y, 1, + exampleCallBack); - Uint8 touched(int x, int y) - This function allows you to avoid re-processing the same pixels - multiple times when the user drags the mouse across an area of the - canvas, thus increasing Tux Paint's response time, especially with - math-heavy effects. - If your effect's "click()", "drag()" and/or "release()" functions - take the contents of the source surface ("snapshot") and always - create the same results in the desintation surface ("canvas"), you - should wrap the effect in a call to "api->touched()". +Uint8 touched(int x, int y) - This function simply returns whether or not it had already been - called for the same (x,y) coordinates, since the user first - clicked the mouse. In other words, the first time you call it for - a particular (x,y) coordinate, it returns '0'. Future calls will - return '1' until the user releases the mouse button. + This function allows you to avoid re-processing the same pixels multiple + times when the user drags the mouse across an area of the canvas, thus + increasing Tux Paint's response time, especially with math-heavy effects. - Note: Magic effects that continuously affect the destination - surface ("canvas") (ignoring the "snapshot surface) have no reason - to use this function. The "Blur" and "Smudge" tools that ship with - Tux Paint are examples of such effects. + If your effect's "click()", "drag()" and/or "release()" functions take the + contents of the source surface ("snapshot") and always create the same + results in the desintation surface ("canvas"), you should wrap the effect + in a call to "api->touched()". - Informational + This function simply returns whether or not it had already been called for + the same (x,y) coordinates, since the user first clicked the mouse. In + other words, the first time you call it for a particular (x,y) coordinate, + it returns '0'. Future calls will return '1' until the user releases the + mouse button. - char * tp_version - A string containing the version of Tux Paint that's running (e.g., - "0.9.31"). + Note: Magic effects that continuously affect the destination surface + ("canvas") (ignoring the "snapshot surface) have no reason to use this + function. The "Blur" and "Smudge" tools that ship with Tux Paint are + examples of such effects. - int canvas_w - int canvas_h - Returns the width (canvas_w) and height (canvas_h) of the drawing - canvas (in pixels). - int button_down(void) - A '1' is returned if the mouse button is down; '0' otherwise. - char * data_directory - This string contains the directory where Tux Paint's data files - are stored. For example, on Linux, this may be - "/usr/share/tuxpaint/". +Informational - Magic tools should include an icon (see "get_icon()", above) and - are encouraged to include sound effects, it's useful for plugins - to know where such things are located. +char * tp_version + A string containing the version of Tux Paint that's running (e.g., + "0.9.31"). - When compiling and installing a plugin, the "tp-magic-config" - command-line tool should be used to determine where such data - should be placed for the installed version of Tux Paint to find - them. (See "Installing," below.) +int canvas_w + int canvas_h + Returns the width (canvas_w) and height (canvas_h) of the drawing canvas + (in pixels). - Note: If your plugin is installed locally (e.g., in your - "~/.tuxpaint/plugins/" directory), rather than globally - (system-wide), the "data_directory" value will be different. - (e.g., "/home/username/.tuxpaint/plugins/data/"). +int button_down(void) + A '1' is returned if the mouse button is down; '0' otherwise. - Tux Paint System Calls +char * data_directory - void update_progress_bar(void) - Asks Tux Paint to animate and draw one frame of its progress bar - (at the bottom of the screen). Useful for routines that may take a - long time, to provide feedback to the user that Tux Paint has not - crashed or frozen. + This string contains the directory where Tux Paint's data files are stored. + For example, on Linux, this may be "/usr/share/tuxpaint/". - void playsound(Mix_Chunk * snd, int pan, int dist) + Magic tools should include an icon (see "get_icon()", above) and are + encouraged to include sound effects, it's useful for plugins to know where + such things are located. - This function plays a sound (one loaded by the SDL helper library - "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the - volume of the sound on the left and right speakers, based on the - 'pan' and 'dist' values sent to it. + When compiling and installing a plugin, the "tp-magic-config" command-line + tool should be used to determine where such data should be placed for the + installed version of Tux Paint to find them. (See "Installing," below.) - A 'pan' of 128 causes the sound to be played at equal volume on - the left and right speakers. A 'pan' of 0 causes it to be played - completely on the left, and 255 completely on the right. + Note: If your plugin is installed locally (e.g., in your "~/.tuxpaint/ + plugins/" directory), rather than globally (system-wide), the + "data_directory" value will be different. (e.g., "/home/username/.tuxpaint/ + plugins/data/"). - The 'dist' value affects overall volume. 255 is loudest, and 0 is - silent. - The 'pan' and 'dist' values can be used to simulate location and - distance of the 'Magic' tool effect. - void stopsound(void) - This function stops playing a sound played by playsound(). It is - useful to silence effects when the user stops using the tool (in - your 'release' function). - void special_notify(int flag) - This function notifies Tux Paint of special events. Various values - defined in "tp_magic_api.h" can be 'or'ed together (using C's - boolean 'or': "|") and sent to this function. +Tux Paint System Calls - SPECIAL_FLIP +void update_progress_bar(void) + Asks Tux Paint to animate and draw one frame of its progress bar (at the + bottom of the screen). Useful for routines that may take a long time, to + provide feedback to the user that Tux Paint has not crashed or frozen. - The contents of the canvas has been flipped - vertically. +void playsound(Mix_Chunk * snd, int pan, int dist) - If a 'Starter' image was used as the basis of this - image, it should be flipped too, and a record of the - flip should be stored as part of Tux Paint's undo - buffer stack. Additionally, the fact that the starter - has been flipped (or unflipped) should be recorded on - disk when the current drawing is saved. + This function plays a sound (one loaded by the SDL helper library + "SDL_mixer"). It uses SDL_mixer's "Mix_SetPanning()" to set the volume of + the sound on the left and right speakers, based on the 'pan' and 'dist' + values sent to it. - SPECIAL_MIRROR - Similar to SPECIAL_FLIP, but for magic tools that - mirror the contents of the canvas horizontally. + A 'pan' of 128 causes the sound to be played at equal volume on the left + and right speakers. A 'pan' of 0 causes it to be played completely on the + left, and 255 completely on the right. - Color Conversions + The 'dist' value affects overall volume. 255 is loudest, and 0 is silent. - float sRGB_to_linear(Uint8 srbg) - Converts an 8-bit sRGB value (one between 0 and 255) to a linear - floating point value (between 0.0 and 1.0). + The 'pan' and 'dist' values can be used to simulate location and distance + of the 'Magic' tool effect. - uint8 linear_to_sRGB(float linear) - Converts a linear floating point value (one between 0.0 and 1.0) - to an 8-bit sRGB value (between 0 and 255). - void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) - Converts 8-bit sRGB values (between 0 and 255) to floating-point - HSV (Hue, Saturation and Value) values (Hue between 0.0 and 360.0, - and Saturation and Value between 0.0 and 1.0). - void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) - Converts floating-point HSV (Hue, Saturation and Value) values - (Hue between 0.0 and 360.0, and Saturation and Value between 0.0 - and 1.0) to 8-bit sRGB values (between 0 and 255). +void stopsound(void) + This function stops playing a sound played by playsound(). It is useful to + silence effects when the user stops using the tool (in your 'release' + function). - For more information, refer to the sRGB article at Wikipedia and the HSV - Color Space article at Wikipedia. +void special_notify(int flag) + This function notifies Tux Paint of special events. Various values defined + in "tp_magic_api.h" can be 'or'ed together (using C's boolean 'or': "|") + and sent to this function. + + SPECIAL_FLIP + + The contents of the canvas has been flipped vertically. + + If a 'Starter' image was used as the basis of this image, it should be + flipped too, and a record of the flip should be stored as part of Tux + Paint's undo buffer stack. Additionally, the fact that the starter has + been flipped (or unflipped) should be recorded on disk when the current + drawing is saved. + + + + SPECIAL_MIRROR + Similar to SPECIAL_FLIP, but for magic tools that mirror the contents + of the canvas horizontally. + + + + + +Color Conversions + +float sRGB_to_linear(Uint8 srbg) + Converts an 8-bit sRGB value (one between 0 and 255) to a linear floating + point value (between 0.0 and 1.0). + +uint8 linear_to_sRGB(float linear) + Converts a linear floating point value (one between 0.0 and 1.0) to an + 8-bit sRGB value (between 0 and 255). + +void rgbtohsv(Uint8 r, Uint8 g, Uint8 b, float * h, float * s, float * v) + Converts 8-bit sRGB values (between 0 and 255) to floating-point HSV (Hue, + Saturation and Value) values (Hue between 0.0 and 360.0, and Saturation and + Value between 0.0 and 1.0). + +void hsvtorgb(float h, float s, float v, Uint8 * r, Uint8 * g, Uint8 * b) + Converts floating-point HSV (Hue, Saturation and Value) values (Hue between + 0.0 and 360.0, and Saturation and Value between 0.0 and 1.0) to 8-bit sRGB + values (between 0 and 255). + + +For more information, refer to the sRGB article at Wikipedia and the HSV Color +Space article at Wikipedia. Helper Macros in "tp_magic_api.h" - Along with the "magic_api" C structure containing functions and data - described above, the tp_magic_api.h C header file also contains some - helper macros that you may use. +Along with the "magic_api" C structure containing functions and data described +above, the tp_magic_api.h C header file also contains some helper macros that +you may use. - min(x, y) - max(x, y) - The minimum (min) or maxinum (max) of 'x' and 'y'. For example, - min() will return the value of 'x' if it is less than or equal to - 'y', otherwise it will return 'y'. +min(x, y) + max(x, y) + The minimum (min) or maxinum (max) of 'x' and 'y'. For example, min() will + return the value of 'x' if it is less than or equal to 'y', otherwise it + will return 'y'. - clamp(lo, value, hi) +clamp(lo, value, hi) + + A value, clamped to be no smaller than 'lo', and no higher than 'hi'. (That + is, if 'value' is less than 'lo', then 'lo' will be used; if 'value' is + greater than 'hi', then 'hi' will be used; otherwise, 'value' will be + used.) + + Example: red = clamp(0, n, 255); will set the variable 'red' to be the + value of the variable 'n', but without allowing it to become less than 0 or + greater than 255. + + Note: This macro is simply a #define of: "(min(max(value,lo),hi))". - A value, clamped to be no smaller than 'lo', and no higher than - 'hi'. (That is, if 'value' is less than 'lo', then 'lo' will be - used; if 'value' is greater than 'hi', then 'hi' will be used; - otherwise, 'value' will be used.) - Example: red = clamp(0, n, 255); will set the variable 'red' to be - the value of the variable 'n', but without allowing it to become - less than 0 or greater than 255. - Note: This macro is simply a #define of: - "(min(max(value,lo),hi))". Constant Defintions in "tp_magic_api.h" - The following is a summary of constant values that are set (via "#define") - within the 'Magic' tool API header file. +The following is a summary of constant values that are set (via "#define") +within the 'Magic' tool API header file. - TP_MAGIC_API_VERSION +TP_MAGIC_API_VERSION - This integer value represents which version of the Tux Paint - 'Magic' tool API the header corresponds to. + This integer value represents which version of the Tux Paint 'Magic' tool + API the header corresponds to. - It should be referenced by your magic tool's "api_version()" - function, to inform the running copy of Tux Paint whether or not - your plugin is compatible. + It should be referenced by your magic tool's "api_version()" function, to + inform the running copy of Tux Paint whether or not your plugin is + compatible. - Note: This version number does not correspond to Tux Paint's own - release number (e.g., "0.9.31"). The API will not change every - time a new version of Tux Paint is released, which means plugins - compiled for earlier versions of Tux Paint will often run under - newer versions. + Note: This version number does not correspond to Tux Paint's own release + number (e.g., "0.9.31"). The API will not change every time a new version + of Tux Paint is released, which means plugins compiled for earlier versions + of Tux Paint will often run under newer versions. - SPECIAL_MIRROR - SPECIAL_FLIP - These are flags for Tux Paint's "special_notify()" helper - function. They are described above. - Compiling + +SPECIAL_MIRROR + SPECIAL_FLIP + These are flags for Tux Paint's "special_notify()" helper function. They + are described above. + + +Compiling Linux and other Unix-like Platforms - Use the C compiler's "-shared" command-line option to generate a shared - object file (".so") based on your 'Magic' tool plugin's C source code. +Use the C compiler's "-shared" command-line option to generate a shared object +file (".so") based on your 'Magic' tool plugin's C source code. - Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to provide additional command-line flags to your C - compiler that will help it build your plugin. +Use the "tp-magic-config --cflags" command, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to provide additional command-line flags to your C compiler that will help it +build your plugin. - Command-Line Example +Command-Line Example - As a stand-alone command, using the GNU C Compiler and BASH shell, for - example: +As a stand-alone command, using the GNU C Compiler and BASH shell, for example: - $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o - my_plugin.so - Note: The characters around the "tp-magic-config" command are a - grave/backtick/backquote ("`"), and not an apostrophe/single-quote ("'"). - They tell the shell to execute the command within (in this case, - "tp-magic-config ..."), and use its output as an argument to the command - being executed (in this case, "gcc ..."). + $ gcc -shared -fpic `tp-magic-config --cflags` my_plugin.c -o my_plugin.so - Makefile Example +Note: The characters around the "tp-magic-config" command are a grave/backtick/ +backquote ("`"), and not an apostrophe/single-quote ("'"). They tell the shell +to execute the command within (in this case, "tp-magic-config ..."), and use +its output as an argument to the command being executed (in this case, "gcc +..."). - A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might - look like this: +Makefile Example - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +A snippet from a Makefile to compile a Tux Paint "Magic" tool plugin might look +like this: - my_plugin.so: my_plugin.c - gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - The first line sets up Makefile variable ("CFLAGS") that contains flags - for the compiler. "-Wall" asks for all compiler warnings to be shown. - "-O2" asks for level 2 optimization. "($shell tp-magic-config --cflags)" - runs "tp-magic-config" to retrieve additional compiler flags that "Magic" - tool plugins require. (The "$(shell ...)" directive is similar to the ` - ("grave") character in the BASH shell examples, above.) + my_plugin.so: my_plugin.c + gcc -shared $(CFLAGS) -o my_plugin.so my_plugin.c - The next line defines a Makefile target, "my_plugin.so", and states that - it depends on the C source file "my_plugin.c". (Any time the C file - changes, "make" will know to recompile it and produce an updated ".so" - file. If the C file hadn't changed, it won't bother recompiling.) +The first line sets up Makefile variable ("CFLAGS") that contains flags for the +compiler. "-Wall" asks for all compiler warnings to be shown. "-O2" asks for +level 2 optimization. "($shell tp-magic-config --cflags)" runs +"tp-magic-config" to retrieve additional compiler flags that "Magic" tool +plugins require. (The "$(shell ...)" directive is similar to the ` ("grave") +character in the BASH shell examples, above.) - The last line defines the command "make" should run when it determines - that it needs to (re)compile the ".so" file. Here, we're using "gcc", with - "-shared and "$(CFLAGS)" command-line arguments, like above. "-o - my_plugin.so" tells the C compiler that the output file should be - "my_plugin.so". The last argument is the C file to compile, in this case - "my_plugin.c". +The next line defines a Makefile target, "my_plugin.so", and states that it +depends on the C source file "my_plugin.c". (Any time the C file changes, +"make" will know to recompile it and produce an updated ".so" file. If the C +file hadn't changed, it won't bother recompiling.) - Note: Commands listed below a Makefile target should be intented using a - single tab character. +The last line defines the command "make" should run when it determines that it +needs to (re)compile the ".so" file. Here, we're using "gcc", with "-shared and +"$(CFLAGS)" command-line arguments, like above. "-o my_plugin.so" tells the C +compiler that the output file should be "my_plugin.so". The last argument is +the C file to compile, in this case "my_plugin.c". - Advanced Makefile +Note: Commands listed below a Makefile target should be intented using a single +tab character. - An even more generalized Makefile might look like this: +Advanced Makefile - CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) +An even more generalized Makefile might look like this: - my_plugin_1.so: my_plugin_1.c - $(CC) -shared $(CFLAGS) -o $@ $< + CFLAGS=-Wall -O2 $(shell tp-magic-config --cflags) - my_plugin_2.so: my_plugin_2.c - $(CC) -shared $(CFLAGS) -o $@ $< + my_plugin_1.so: my_plugin_1.c + $(CC) -shared $(CFLAGS) -o $@ $< - As before, there are lines that define the command "make" should run when - it determines that it needs to (re)compile the ".so" file(s). However, - more general terms are used... + my_plugin_2.so: my_plugin_2.c + $(CC) -shared $(CFLAGS) -o $@ $< - "$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" - and "$(CFLAGS)" are command-line arguments to the compiler, like above. - "-o $@" tells the C compiler what the output file should be; "make" - replaces "$@" with the name of the target, in this case "my_plugin_1.so" - or "my_plugin_2.so". And finally, the last argument is the C file to - compile; "make" replaces "$<" with the target's dependency, in this case - "my_plugin_1.c" or "my_plugin_2.c". +As before, there are lines that define the command "make" should run when it +determines that it needs to (re)compile the ".so" file(s). However, more +general terms are used... + +"$(CC)" gets expanded to your default C compiler (e.g., "gcc"). "-shared" and +"$(CFLAGS)" are command-line arguments to the compiler, like above. "-o $@" +tells the C compiler what the output file should be; "make" replaces "$@" with +the name of the target, in this case "my_plugin_1.so" or "my_plugin_2.so". And +finally, the last argument is the C file to compile; "make" replaces "$<" with +the target's dependency, in this case "my_plugin_1.c" or "my_plugin_2.c". Windows - TBD +TBD macOS - TBD +TBD - Installing +Installing Linux and other Unix-like Platforms - Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint - — or in some cases, as part of a "Tux Paint 'Magic' Tool Plugin - Development package" — to determine where your plugins' files should go. +Use the "tp-magic-config" command-line tool, supplied as part of Tux Paint — or +in some cases, as part of a "Tux Paint 'Magic' Tool Plugin Development package" +— to determine where your plugins' files should go. - Shared Object +Shared Object - Use "tp-magic-config --pluginprefix" to determine where the plugin shared - object (".so") files should be installed. The value returned by this - command will be the global location where the installed copy of Tux Paint - looks for plugins (e.g., "/usr/lib/tuxpaint/plugins"). +Use "tp-magic-config --pluginprefix" to determine where the plugin shared +object (".so") files should be installed. The value returned by this command +will be the global location where the installed copy of Tux Paint looks for +plugins (e.g., "/usr/lib/tuxpaint/plugins"). - Alternatively, you may use "tp-magic-config --localpluginprefix" to find - out where Tux Paint expects to find local plugins for the current user - (e.g., "/home/username/.tuxpaint/plugins"). +Alternatively, you may use "tp-magic-config --localpluginprefix" to find out +where Tux Paint expects to find local plugins for the current user (e.g., "/ +home/username/.tuxpaint/plugins"). - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.so `tp-magic-config --pluginprefix` - # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so + # cp my_plugin.so `tp-magic-config --pluginprefix` + # chmod 644 `tp-magic-config --pluginprefix`/my_plugin.so - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Documentation +Documentation - Use the "tp-magic-config --plugindocprefix" command to determine where - documentation for your "Magic" tools should go. The value returned by this - command will be the location where the documentation to the installed copy - of Tux Paint is stored. The main documentation includes a link to a folder - where "Magic" tools' documentation is expected to be installed +Use the "tp-magic-config --plugindocprefix" command to determine where +documentation for your "Magic" tools should go. The value returned by this +command will be the location where the documentation to the installed copy of +Tux Paint is stored. The main documentation includes a link to a folder where +"Magic" tools' documentation is expected to be installed - (e.g., "/usr/share/doc/tuxpaint/magic-docs"). +(e.g., "/usr/share/doc/tuxpaint/magic-docs"). - Note: It's best to include both HTML and plain-text versions of your - documentation. An "html" subdirectory exists within the "magic-docs" - directory, and is where the HTML versions should go. +Note: It's best to include both HTML and plain-text versions of your +documentation. An "html" subdirectory exists within the "magic-docs" directory, +and is where the HTML versions should go. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin.html `tp-magic-config --plugindocprefix`/html - # cp my_plugin.txt `tp-magic-config --plugindocprefix` + # cp my_plugin.html `tp-magic-config --plugindocprefix`/html + # cp my_plugin.txt `tp-magic-config --plugindocprefix` - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Note: Currently, there is no "--localplugindocprefix" option. +Note: Currently, there is no "--localplugindocprefix" option. - Icons, Sounds and other Data Files +Icons, Sounds and other Data Files - Use the "tp-magic-config --dataprefix" command, supplied as part of Tux - Paint, to determine where data files (PNG icon, Ogg Vorbis sound effects, - etc.) should be installed. The value returned by this command will be the - same as the value of the "data_directory" string stored within the - "magic_api" structure that your plugin's functions receive (e.g., - "/usr/share/tuxpaint/"). +Use the "tp-magic-config --dataprefix" command, supplied as part of Tux Paint, +to determine where data files (PNG icon, Ogg Vorbis sound effects, etc.) should +be installed. The value returned by this command will be the same as the value +of the "data_directory" string stored within the "magic_api" structure that +your plugin's functions receive (e.g., "/usr/share/tuxpaint/"). - For locally-installed plugins (for the current user only), use - "tp-magic-config --localdataprefix". It will return the value of - "data_directory" string that locally-installed plugins will see within - their "magic_api" structure (e.g., - "/home/username/.tuxpaint/plugins/data/"). +For locally-installed plugins (for the current user only), use "tp-magic-config +--localdataprefix". It will return the value of "data_directory" string that +locally-installed plugins will see within their "magic_api" structure (e.g., "/ +home/username/.tuxpaint/plugins/data/"). - Note: Tux Paint's default Magic tool plugins install their data within - "magic" subdirectories of Tux Paint's "images" and "sounds" data - directories (e.g., "/usr/share/tuxpaint/images/magic/"). You are - encouraged to do the same. +Note: Tux Paint's default Magic tool plugins install their data within "magic" +subdirectories of Tux Paint's "images" and "sounds" data directories (e.g., "/ +usr/share/tuxpaint/images/magic/"). You are encouraged to do the same. - As stand-alone commands, using the BASH shell, for example: +As stand-alone commands, using the BASH shell, for example: - # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ - # chmod 644 `tp-magic-config - --dataprefix`/images/magic/my_plugin_icon.png + # cp my_plugin_icon.png `tp-magic-config --dataprefix`/images/magic/ + # chmod 644 `tp-magic-config --dataprefix`/images/magic/my_plugin_icon.png - Note: See the note above regarding the "`" (grave) character. +Note: See the note above regarding the "`" (grave) character. - Putting it Together in a Makefile +Putting it Together in a Makefile - A snippet from a more generalized Makefile might look like this: +A snippet from a more generalized Makefile might look like this: - PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) - PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) - DATAPREFIX=$(shell tp-magic-config --dataprefix) + PLUGINPREFIX=$(shell tp-magic-config --pluginprefix) + PLUGINDOCPREFIX=$(shell tp-magic-config --plugindocprefix) + DATAPREFIX=$(shell tp-magic-config --dataprefix) - install: - # - # Install plugin - mkdir -p $(PLUGINPREFIX) - cp *.so $(PLUGINPREFIX)/ - chmod 644 $(PLUGINPREFIX)/*.so - # - # Install icons - mkdir -p $(DATAPREFIX)/images/magic - cp icons/*.png $(DATAPREFIX)/images/magic/ - chmod 644 $(DATAPREFIX)/images/magic/*.png - # - # Install sound effects - mkdir -p $(DATAPREFIX)/sounds/magic - cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ - chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg - # - # Install docs - mkdir -p $(PLUGINDOCPREFIX)/html - cp docs/*.html $(PLUGINDOCPREFIX)/html/ - cp docs/*.txt $(PLUGINDOCPREFIX)/ - chmod 644 $(PLUGINDOCPREFIX)/html/*.html - chmod 644 $(PLUGINDOCPREFIX)/*.txt + install: + # + # Install plugin + mkdir -p $(PLUGINPREFIX) + cp *.so $(PLUGINPREFIX)/ + chmod 644 $(PLUGINPREFIX)/*.so + # + # Install icons + mkdir -p $(DATAPREFIX)/images/magic + cp icons/*.png $(DATAPREFIX)/images/magic/ + chmod 644 $(DATAPREFIX)/images/magic/*.png + # + # Install sound effects + mkdir -p $(DATAPREFIX)/sounds/magic + cp sounds/*.ogg $(DATAPREFIX)/sounds/magic/ + chmod 644 $(DATAPREFIX)/sounds/magic/*.ogg + # + # Install docs + mkdir -p $(PLUGINDOCPREFIX)/html + cp docs/*.html $(PLUGINDOCPREFIX)/html/ + cp docs/*.txt $(PLUGINDOCPREFIX)/ + chmod 644 $(PLUGINDOCPREFIX)/html/*.html + chmod 644 $(PLUGINDOCPREFIX)/*.txt - The first three lines set up Makefile variables that contain the paths - returned by the "tp-magic-config" command-line tool. (The "$(shell ...)" - directive is similar to the ` ("grave") character in the BASH shell - examples, above.) +The first three lines set up Makefile variables that contain the paths returned +by the "tp-magic-config" command-line tool. (The "$(shell ...)" directive is +similar to the ` ("grave") character in the BASH shell examples, above.) - Below that is an "install" target in the Makefile. (Invoked by, for - example, "$ sudo make install" or "# make install".) +Below that is an "install" target in the Makefile. (Invoked by, for example, "$ +sudo make install" or "# make install".) - The "install" target uses "mkdir -p" to make sure that the plugin - directory exists, then uses "cp" to copy all plugin (".so") files into it, - and invokes "chmod" to make sure they are readable. +The "install" target uses "mkdir -p" to make sure that the plugin directory +exists, then uses "cp" to copy all plugin (".so") files into it, and invokes +"chmod" to make sure they are readable. - It then does a similar series of commands to install icon files (".png" - images) and sound effects (".ogg" files) into subdirectories within Tux - Paint's data directory, and to install documentation (".html" and ".txt" - files) within Tux Paint's documentation directory. +It then does a similar series of commands to install icon files (".png" images) +and sound effects (".ogg" files) into subdirectories within Tux Paint's data +directory, and to install documentation (".html" and ".txt" files) within Tux +Paint's documentation directory. - Note: The above Makefile example assumes the user will have priveleges to - install Tux Paint plugins system-wide. +Note: The above Makefile example assumes the user will have priveleges to +install Tux Paint plugins system-wide. Windows - TBD +TBD macOS - TBD +TBD - Creating plugins with multiple effects +Creating plugins with multiple effects - Plugins for Tux Paint may contain more than one effect. If you have - multiple effects that are similar, it may make sense to place them in one - plugin file, to reduce overhead and share code. +Plugins for Tux Paint may contain more than one effect. If you have multiple +effects that are similar, it may make sense to place them in one plugin file, +to reduce overhead and share code. - These following suggestions can help you create plugins that contain - multiple effects: - * Use a C "enum" to enumerate the effects, and count them. +These following suggestions can help you create plugins that contain multiple +effects: - enum { - ONE_TOOL, - ANOTHER_TOOL, - AND_YET_ANOTHER_TOOL, - NUM_TOOLS }; + * Use a C "enum" to enumerate the effects, and count them. - * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and - compare "which" values sent to other functions with the other - enumerated values. - * Create arrays of "NUM_TOOLS" length to contain effect-specific data. + enum { + ONE_TOOL, + ANOTHER_TOOL, + AND_YET_ANOTHER_TOOL, + NUM_TOOLS }; - char * my_plugin_snd_filenames[NUM_TOOLS] = { - "one.ogg", "another.ogg", "yet_another.ogg" }; - Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; + * Return the value of "NUM_TOOLS" when "get_tool_count()" is called, and + compare "which" values sent to other functions with the other enumerated + values. + * Create arrays of "NUM_TOOLS" length to contain effect-specific data. - * Use a C "for"-loop to load or create the effect-specific data (such as - loading sound effects during your "init()"). + char * my_plugin_snd_filenames[NUM_TOOLS] = { + "one.ogg", "another.ogg", "yet_another.ogg" }; + Mix_Chunk * my_plugin_snds[NUM_TOOLS]") ?>; - int i; - char fname[1024]; + * Use a C "for"-loop to load or create the effect-specific data (such as + loading sound effects during your "init()"). - for (i = 0; i < NUM_TOOLS; i++) - { - /* Becomes, for example, - "/usr/share/tuxpaint/sounds/magic/one.ogg" */ + int i; + char fname[1024]; - snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", - api->data_prefix, my_plugin_snd_filenames[i]); + for (i = 0; i < NUM_TOOLS; i++) + { + /* Becomes, for example, "/usr/share/tuxpaint/sounds/magic/one.ogg" + */ - my_plugin_snds[i] = Mix_LoadWAV(fname); - } + snprintf(fname, sizeof(fname), "%s/sounds/magic/%s", + api->data_prefix, my_plugin_snd_filenames[i]); - * Similarly, do the same to free them later (such as freeing sound - effects during your "shutdown()"). + my_plugin_snds[i] = Mix_LoadWAV(fname); + } - int i; + * Similarly, do the same to free them later (such as freeing sound effects + during your "shutdown()"). - for (i = 0; i < NUM_TOOLS; i++) - Mix_FreeChunk(my_plugin_snds[i]); + int i; - * Use "which" values sent to your functions as an index into those - arrays (e.g., for playing the appropriate sound effect for a tool). + for (i = 0; i < NUM_TOOLS; i++) + Mix_FreeChunk(my_plugin_snds[i]); - Note: Even if your plugin currently contains only one effect, it may be - useful to follow the steps above so that you can add a new variation of an - effect with little effort. ("NUM_TOOLS" will simply be '1', your arrays - will be of length '1', etc.) + * Use "which" values sent to your functions as an index into those arrays + (e.g., for playing the appropriate sound effect for a tool). - Example Code +Note: Even if your plugin currently contains only one effect, it may be useful +to follow the steps above so that you can add a new variation of an effect with +little effort. ("NUM_TOOLS" will simply be '1', your arrays will be of length +'1', etc.) - The C source file "tp_magic_example.c" contains a complete example of a - plugin with multiple simple effects. +Example Code - Getting Help +The C source file "tp_magic_example.c" contains a complete example of a plugin +with multiple simple effects. - For more information, check the Tux Paint website: https://tuxpaint.org/, - and the Simple DirectMedia Layer library website: http://www.libsdl.org/. +Getting Help - Additionally, other Tux Paint developers and users can be found on the - "tuxpaint-devel" and "tuxpaint-users" mailing lists: - https://tuxpaint.org/lists/. +For more information, check the Tux Paint website: https://tuxpaint.org/, and +the Simple DirectMedia Layer library website: http://www.libsdl.org/. - Glossary +Additionally, other Tux Paint developers and users can be found on the +"tuxpaint-devel" and "tuxpaint-users" mailing lists: https://tuxpaint.org/lists +/. + +Glossary + + * alpha: See "RGBA" + * &: See "ampersand" + * ampersand (pointers): "&". A symbol in C that allows you to refer to the + memory address of a variable; that is, a pointer. (For example, consider + "int i;". Later, "&i" refers to the memory where "i" is stored, not the + value of "i" itself; it is a 'pointer to "i"'.) See also: "star" + * ampersand (bitwise operator): "&". A symbol in C that acts as a bitwise + "and" operator. Only bits set in both values will be returned. For example, + "11 & 6" compares the binary values '1011' to '0110'. Only the bit in the + 2's place is set, so the result is 2 ('0010'). See also: "bit" + * API: Application Programming Interface. TBD + * argument: A value sent to a function. + * arrow: "->". A symbol in C that references an element within a pointer to a + struct. + * backquote: See "grave" + * backtick: See "grave" + * bit: "Binary digit." Bits are the basic storage unit in a computer's + memory, disk, networking, etc. They represent either 0 or 1. (Compared to a + decimal digit, which can be anything between 0 and 9.) Just as a series of + decimal digits can represent a larger number (e.g., "1" and "5" is fifteen + (15)), so can bits (e.g., "1" and "0", is two). In decimal, we go from + right to left: ones place, tens place, hundreds place, thousands place, + etc. In binary, it is: ones place, twos place, fours place, eights place, + etc. See also: "byte" + * blue: See "RGBA" + * boolean 'or': A mathematical operation that results in a true value if + either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in "1". "0 + | 0" results in "0".) + * |: See "boolean 'or'" + * .: See "dot" + * `: See "grave" + * *: See "star" + * byte: A unit of memory made up of 8 bits. As a signed value, it can + represent -128 through 127. As an unsigned value, it can represent 0 + through 255. As a series of bits, for example, the byte "00001100" + represents the decimal value 12. + * callback: TBD + * C enumeration: A construct in C that allows you to label numeric values + (usually starting at 0 and incrementing by one). (e.g., "enum { ONE, TWO, + THREE };" + * C function: TBD + * C function prototype: TBD + * C header file: TBD + * channel: TBD + * click: The action of pressing a button on a mouse. + * coordinates: A set of numbers corresponding to a physical position; for + example, in a two-dimensional (2D) image, "X" and "Y" coordinates specify + the position across (left-to-right) and down the image, respectively. In + SDL, the coordinates (0,0) is the top-leftmost pixel of a surface. + * C pointer: A variable that contains the location of a piece of memory; + usually used to 'point' to another variable. Since C functions can only + return one value as a result, pointers are often sent to functions to allow + the function to change the values of multiple variables. (For example, Tux + Paint's "rgbtohsv()" and "hsvtorgb()".) + * C structure: A construct in C that allows you to declare a new variable + 'type' which may contain other types within. For example, SDL's "SDL_Rect" + contains four integer values, the coordinates of the rectangle (X,Y), and + its dimensions (width and height). + * #define: A C statement that defines a substitution that can occur later in + the code. Generally used for constant values (e.g., "#define RADIUS 16"; + all instances of "RADIUS" will be replaced with "16"), but can also be used + to create macros. Typically placed within C header files. + * dimensions: The size of an object, in terms of its width (left to right) + and height (top to bottom). + * .dll: See "Shared Object" + * dot: ".". A symbol in C that references an element within a struct. + * drag: The action of moving a mouse while the button remains held. + * element: A variable stored within a C structure. (Example: "w" and "h" + elements of SDL_Surface store the surface's width and height, + respectively.) + * enum: See "C enumeration" + * float: See "floating point" + * floating point: TBD + * format: An SDL_Surface element (a pointer to an SDL_PixelFormat structure) + that contains information about a surface; for example, the number of bits + used to represent each pixel). See also the "SDL_PixelFormat(3)" man page) + * free(): A C function that frees (deallocates) memory allocated by other C + functions (such as "strdup()"). + * function: See "C function" + * gcc: The GNU C compiler, a portable Open Source compiler. See also the "gcc + (1)" man page) + * GIMP: An Open Source image manipulation and paint program. + * GNU C Compiler: See "gcc" + * grave: The "`" character; used by the BASH shell to use the output of a + command as the command-line arguments to another. + * green: See "RGBA" + * ->: See "arrow" + * .h: See "C header file" + * header: See "C header file" + * header file: See "C header file" + * HSV: Hue, Saturation and Value. TBD + * hue: See "HSV" + * IMG_Load(): An SDL_image function that loads an image file (e.g., a PNG) + and returns it as an "SDL_Surface *". + * #include: A C statement that asks the compiler to read the contents of + another file (usually a header file). + * int: See "integer" + * integer: TBD + * libSDL: See "Simple DirectMedia Layer" + * linear: TBD + * macro: A C construct that looks similar to a C function, but is simply a # + define that is expanded 'inline'. For example, if you declared the macro "# + define ADD(A,B) ((A)+(B))", and then used it with "c = ADD(1,2);", that + line of code would literally expand to "c = ((1) + (2));", or more simply, + "c = 1 + 2;". + * magic_api: A C structure that is passed along to a plugin's functions that + exposes data and functions within the running copy of Tux Paint. + * make: A utility that automatically determines which pieces of a larger + program need to be recompiled, and issues the commands to recompile them. + See also: "Makefile" + * Makefile: A text file used by the "make" utility; it describes the + relationships among files in your program, and the commands for updating + each file. (For example, to compile a human-readable source-code file into + a computer-readable executable program file.) + * Magic tool: One of a number of effects or drawing tools in Tux Paint, made + available via the "Magic" tool button. + * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that + contains a sound. + * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory + allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). + * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg + Vorbis, etc.) and returns it as a "Mix_Chunk *". + * namespace: TBD + * .ogg: See "Ogg Vorbis" + * Ogg Vorbis: See also: "WAV" + * Plugin: TBD + * .png: Portable Network Graphics. An extensible file format for the + lossless, portable, well-compressed storage of raster images. It's the file + format Tux Paint uses to save images, and for its brushes and stamps. It's + an easy way to store 32bpp RGBA images (24bpp true color with full 8bpp + alpha transparency), excellent for use in graphics programs like Tux Paint. + See also the "png(5)" man page) + * pointer: See "C pointer" + * prototype: See "C function prototype" + * red: See "RGBA" + * release: The action of releasing a button on a mouse. + * RGBA: "Red, Green, Blue, Alpha." TBD + * RGB: See "RGBA" + * saturation: See "HSV" + * SDL: See "Simple DirectMedia Layer" + * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory + allocated for an SDL surface ("SDL_Surface *"). See also the + "SDL_FreeSurface(3)" man page) + * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value (e.g., one + returned from the Tux Paint's Magic tool API helper function "getpixel()"), + the format of the surface the pixel was taken from, and pointers to three + Uint8 variables, will place the Red, Green and Blue (RGB) values of the + pixel into the three Uint8 variables. (Example: "SDL_GetRGB(getpixel(surf, + x, y), surf->format, &r, &g, &b);".) See also the "SDL_GetRGB(3)" man page) + * SDL_MapRGB(): A libSDL function that, given the format of a surface and + Uint8 values representing Red, Green and Blue values for a pixel, returns a + Uint32 pixel value that can be placed in the surface (e.g., using Tux + Paint's Magic tool API helper function "putpixel()"). (Example: "putpixel + (surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) See also the + "SDL_MapRGB(3)" man page) + * SDL_image: A library on top of libSDL that can load various kinds of image + files (e.g., PNG) and return them as an "SDL_Surface *". + * SDL_mixer: A library on top of libSDL that can load various kinds of sound + files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at once (mix + them). + * SDL_Rect: A C structure defined by libSDL that represents a rectangular + area. It contains elements representing the coordinates of the top left + corner of the rectange (x,y) and the dimensions of the rectangle (w,h). See + also the "SDL_Rect(3)" man page) + * SDL_Surface *: (A pointer to) a C structure defined by libSDL that contains + a drawing surface. See also the "SDL_Surface(3)" man page) + * Shared Object: A piece of code that's compiled separately from the main + application, and loaded dynamically, at runtime. + * Simple DirectMedia Layer: A programming library that allows programs + portable low level access to a video framebuffer, audio output, mouse, and + keyboard. (See also: http://www.libsdl.org/) + * snprintf(): A C function, related to "printf()", which takes a 'format' + string and one or more additional arguments, and puts them together. + "snprintf()" takes the resulting output and stores it into a string, making + sure not to go beyond the string's buffer size (which must also be + supplied). For example, assume a string "char str[20];" has been declared; + "snprintf(str, 20, "Name: %s, Age: %d", "Bill", "32");" will store "Name: + Bill, Age: 32" into 'str'. See also the "snprintf(3)" man page) + * .so: See "Shared Object" + * sRBG: See "RGBA" + * star: "*". A symbol in C that, when used in the declaration of variables + (e.g., arguments to a function), denotes that the variable is a pointer. + (For example, "int * p;" means that "p" is a pointer to an integer.) When + used next to a pointer, it 'dereferences' the variable. (For example, later + "*p = 50;" assigns the value of 50 to the memory that "p" points to; it + does not change the value of "p", which is still a pointer to an integer. + In essence, it changed the integer that's being pointed to.) See also: + "ampersand" + * strdup(): A C function that allocates enough memory to store a copy of a + string, copies the string to it, and returns a "char *" pointer to the new + copy. See also the "strdup(3)" man page) + * struct: See "C structure" + * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. + Plugins must '#include' it. + * tp-magic-config: A command-line program that provides information about the + installed version of Tux Paint to plugin developers (such as what C + compiler flags they should compile with, and where plugin shared objects + and data files should be installed). See also the "tp-magic-config(3)" man + page) + * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other words, + four bytes that can represent 0 through 4294967295. (Typically used to hold + enough information to store three or four bytes representing a pixel's + color; i.e., RBGA value). + * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, a + byte that can represent 0 through 255. + * unsigned: In C, a variable that can store a numeric value can be declared + as either "signed" (the default), or "unsigned". In the former case, one + bit of the value is used to denote the sign of the value (either positive + or negative). In the latter case, the value can only be positive, but + benefits from one extra bit of storage for the number. A signed byte (8 + bits), for example, can represent any number between -128 and 127. An + unsigned byte can go up to 255, but it cannot go below 0. For the purposes + of graphics in SDL, unsigned values should be used for RGB values, since + each channel (red, green and blue) may be between 0 (off) and 255 + (brightest). + * value: See "HSV" + * variable: A construct in computer programming that contains a value which + can be referenced again later by referring to the variable's name, and + typically changed later. For example, a variable to hold someone's age + could be declared as an integer: "int a;". It can be examined later: "if (a + >= 18) { /* they are an adult */ } else { /* they are not an adult */ }". + * .wav: See also: "Ogg Vorbis" + * (w,h): See "Dimensions" + * (x,y): See "Coordinates" - * alpha: See "RGBA" - * &: See "ampersand" - * ampersand (pointers): "&". A symbol in C that allows you to refer to - the memory address of a variable; that is, a pointer. (For example, - consider "int i;". Later, "&i" refers to the memory where "i" is - stored, not the value of "i" itself; it is a 'pointer to "i"'.) See - also: "star" - * ampersand (bitwise operator): "&". A symbol in C that acts as a - bitwise "and" operator. Only bits set in both values will be returned. - For example, "11 & 6" compares the binary values '1011' to '0110'. - Only the bit in the 2's place is set, so the result is 2 ('0010'). See - also: "bit" - * API: Application Programming Interface. TBD - * argument: A value sent to a function. - * arrow: "->". A symbol in C that references an element within a pointer - to a struct. - * backquote: See "grave" - * backtick: See "grave" - * bit: "Binary digit." Bits are the basic storage unit in a computer's - memory, disk, networking, etc. They represent either 0 or 1. (Compared - to a decimal digit, which can be anything between 0 and 9.) Just as a - series of decimal digits can represent a larger number (e.g., "1" and - "5" is fifteen (15)), so can bits (e.g., "1" and "0", is two). In - decimal, we go from right to left: ones place, tens place, hundreds - place, thousands place, etc. In binary, it is: ones place, twos place, - fours place, eights place, etc. See also: "byte" - * blue: See "RGBA" - * boolean 'or': A mathematical operation that results in a true value if - either operand is true. ("1 | 0", "0 | 1" and "1 | 1" all result in - "1". "0 | 0" results in "0".) - * |: See "boolean 'or'" - * .: See "dot" - * `: See "grave" - * *: See "star" - * byte: A unit of memory made up of 8 bits. As a signed value, it can - represent -128 through 127. As an unsigned value, it can represent 0 - through 255. As a series of bits, for example, the byte "00001100" - represents the decimal value 12. - * callback: TBD - * C enumeration: A construct in C that allows you to label numeric - values (usually starting at 0 and incrementing by one). (e.g., "enum { - ONE, TWO, THREE };" - * C function: TBD - * C function prototype: TBD - * C header file: TBD - * channel: TBD - * click: The action of pressing a button on a mouse. - * coordinates: A set of numbers corresponding to a physical position; - for example, in a two-dimensional (2D) image, "X" and "Y" coordinates - specify the position across (left-to-right) and down the image, - respectively. In SDL, the coordinates (0,0) is the top-leftmost pixel - of a surface. - * C pointer: A variable that contains the location of a piece of memory; - usually used to 'point' to another variable. Since C functions can - only return one value as a result, pointers are often sent to - functions to allow the function to change the values of multiple - variables. (For example, Tux Paint's "rgbtohsv()" and "hsvtorgb()".) - * C structure: A construct in C that allows you to declare a new - variable 'type' which may contain other types within. For example, - SDL's "SDL_Rect" contains four integer values, the coordinates of the - rectangle (X,Y), and its dimensions (width and height). - * #define: A C statement that defines a substitution that can occur - later in the code. Generally used for constant values (e.g., "#define - RADIUS 16"; all instances of "RADIUS" will be replaced with "16"), but - can also be used to create macros. Typically placed within C header - files. - * dimensions: The size of an object, in terms of its width (left to - right) and height (top to bottom). - * .dll: See "Shared Object" - * dot: ".". A symbol in C that references an element within a struct. - * drag: The action of moving a mouse while the button remains held. - * element: A variable stored within a C structure. (Example: "w" and "h" - elements of SDL_Surface store the surface's width and height, - respectively.) - * enum: See "C enumeration" - * float: See "floating point" - * floating point: TBD - * format: An SDL_Surface element (a pointer to an SDL_PixelFormat - structure) that contains information about a surface; for example, the - number of bits used to represent each pixel). See also the - "SDL_PixelFormat(3)" man page) - * free(): A C function that frees (deallocates) memory allocated by - other C functions (such as "strdup()"). - * function: See "C function" - * gcc: The GNU C compiler, a portable Open Source compiler. See also the - "gcc(1)" man page) - * GIMP: An Open Source image manipulation and paint program. - * GNU C Compiler: See "gcc" - * grave: The "`" character; used by the BASH shell to use the output of - a command as the command-line arguments to another. - * green: See "RGBA" - * ->: See "arrow" - * .h: See "C header file" - * header: See "C header file" - * header file: See "C header file" - * HSV: Hue, Saturation and Value. TBD - * hue: See "HSV" - * IMG_Load(): An SDL_image function that loads an image file (e.g., a - PNG) and returns it as an "SDL_Surface *". - * #include: A C statement that asks the compiler to read the contents of - another file (usually a header file). - * int: See "integer" - * integer: TBD - * libSDL: See "Simple DirectMedia Layer" - * linear: TBD - * macro: A C construct that looks similar to a C function, but is simply - a #define that is expanded 'inline'. For example, if you declared the - macro "#define ADD(A,B) ((A)+(B))", and then used it with "c = - ADD(1,2);", that line of code would literally expand to "c = ((1) + - (2));", or more simply, "c = 1 + 2;". - * magic_api: A C structure that is passed along to a plugin's functions - that exposes data and functions within the running copy of Tux Paint. - * make: A utility that automatically determines which pieces of a larger - program need to be recompiled, and issues the commands to recompile - them. See also: "Makefile" - * Makefile: A text file used by the "make" utility; it describes the - relationships among files in your program, and the commands for - updating each file. (For example, to compile a human-readable - source-code file into a computer-readable executable program file.) - * Magic tool: One of a number of effects or drawing tools in Tux Paint, - made available via the "Magic" tool button. - * Mix_Chunk *: (A pointer to) a C structure defined by SDL_mixer that - contains a sound. - * Mix_FreeChunk(): An SDL_mixer function that frees (deallocates) memory - allocated for an SDL_mixer sound 'chunk' ("Mix_Chunk *"). - * Mix_LoadWAV(): An SDL_mixer function that loads a sound file (WAV, Ogg - Vorbis, etc.) and returns it as a "Mix_Chunk *". - * namespace: TBD - * .ogg: See "Ogg Vorbis" - * Ogg Vorbis: See also: "WAV" - * Plugin: TBD - * .png: Portable Network Graphics. An extensible file format for the - lossless, portable, well-compressed storage of raster images. It's the - file format Tux Paint uses to save images, and for its brushes and - stamps. It's an easy way to store 32bpp RGBA images (24bpp true color - with full 8bpp alpha transparency), excellent for use in graphics - programs like Tux Paint. See also the "png(5)" man page) - * pointer: See "C pointer" - * prototype: See "C function prototype" - * red: See "RGBA" - * release: The action of releasing a button on a mouse. - * RGBA: "Red, Green, Blue, Alpha." TBD - * RGB: See "RGBA" - * saturation: See "HSV" - * SDL: See "Simple DirectMedia Layer" - * SDL_FreeSurface(): An libSDL function that frees (deallocates) memory - allocated for an SDL surface ("SDL_Surface *"). See also the - "SDL_FreeSurface(3)" man page) - * SDL_GetRGB(): A libSDL function that, given a Uint32 pixel value - (e.g., one returned from the Tux Paint's Magic tool API helper - function "getpixel()"), the format of the surface the pixel was taken - from, and pointers to three Uint8 variables, will place the Red, Green - and Blue (RGB) values of the pixel into the three Uint8 variables. - (Example: "SDL_GetRGB(getpixel(surf, x, y), surf->format, &r, &g, - &b);".) See also the "SDL_GetRGB(3)" man page) - * SDL_MapRGB(): A libSDL function that, given the format of a surface - and Uint8 values representing Red, Green and Blue values for a pixel, - returns a Uint32 pixel value that can be placed in the surface (e.g., - using Tux Paint's Magic tool API helper function "putpixel()"). - (Example: "putpixel(surf, x, y, SDL_MapRGB(surf->format, r, g, b));".) - See also the "SDL_MapRGB(3)" man page) - * SDL_image: A library on top of libSDL that can load various kinds of - image files (e.g., PNG) and return them as an "SDL_Surface *". - * SDL_mixer: A library on top of libSDL that can load various kinds of - sound files (WAV, Ogg Vorbis, etc.) and play back multiple sounds at - once (mix them). - * SDL_Rect: A C structure defined by libSDL that represents a - rectangular area. It contains elements representing the coordinates of - the top left corner of the rectange (x,y) and the dimensions of the - rectangle (w,h). See also the "SDL_Rect(3)" man page) - * SDL_Surface *: (A pointer to) a C structure defined by libSDL that - contains a drawing surface. See also the "SDL_Surface(3)" man page) - * Shared Object: A piece of code that's compiled separately from the - main application, and loaded dynamically, at runtime. - * Simple DirectMedia Layer: A programming library that allows programs - portable low level access to a video framebuffer, audio output, mouse, - and keyboard. (See also: http://www.libsdl.org/) - * snprintf(): A C function, related to "printf()", which takes a - 'format' string and one or more additional arguments, and puts them - together. "snprintf()" takes the resulting output and stores it into a - string, making sure not to go beyond the string's buffer size (which - must also be supplied). For example, assume a string "char str[20];" - has been declared; "snprintf(str, 20, "Name: %s, Age: %d", "Bill", - "32");" will store "Name: Bill, Age: 32" into 'str'. See also the - "snprintf(3)" man page) - * .so: See "Shared Object" - * sRBG: See "RGBA" - * star: "*". A symbol in C that, when used in the declaration of - variables (e.g., arguments to a function), denotes that the variable - is a pointer. (For example, "int * p;" means that "p" is a pointer to - an integer.) When used next to a pointer, it 'dereferences' the - variable. (For example, later "*p = 50;" assigns the value of 50 to - the memory that "p" points to; it does not change the value of "p", - which is still a pointer to an integer. In essence, it changed the - integer that's being pointed to.) See also: "ampersand" - * strdup(): A C function that allocates enough memory to store a copy of - a string, copies the string to it, and returns a "char *" pointer to - the new copy. See also the "strdup(3)" man page) - * struct: See "C structure" - * tp_magic_api.h: A header file that defines Tux Paint's Magic tool API. - Plugins must '#include' it. - * tp-magic-config: A command-line program that provides information - about the installed version of Tux Paint to plugin developers (such as - what C compiler flags they should compile with, and where plugin - shared objects and data files should be installed). See also the - "tp-magic-config(3)" man page) - * Uint32: A 32-bit, unsigned integer (defined by libSDL). In other - words, four bytes that can represent 0 through 4294967295. (Typically - used to hold enough information to store three or four bytes - representing a pixel's color; i.e., RBGA value). - * Uint8: An 8-bit, unsigned integer (defined by libSDL). In other words, - a byte that can represent 0 through 255. - * unsigned: In C, a variable that can store a numeric value can be - declared as either "signed" (the default), or "unsigned". In the - former case, one bit of the value is used to denote the sign of the - value (either positive or negative). In the latter case, the value can - only be positive, but benefits from one extra bit of storage for the - number. A signed byte (8 bits), for example, can represent any number - between -128 and 127. An unsigned byte can go up to 255, but it cannot - go below 0. For the purposes of graphics in SDL, unsigned values - should be used for RGB values, since each channel (red, green and - blue) may be between 0 (off) and 255 (brightest). - * value: See "HSV" - * variable: A construct in computer programming that contains a value - which can be referenced again later by referring to the variable's - name, and typically changed later. For example, a variable to hold - someone's age could be declared as an integer: "int a;". It can be - examined later: "if (a >= 18) { /* they are an adult */ } else { /* - they are not an adult */ }". - * .wav: See also: "Ogg Vorbis" - * (w,h): See "Dimensions" - * (x,y): See "Coordinates" diff --git a/docs/ja_JP.UTF-8/OPTIONS.txt b/docs/ja_JP.UTF-8/OPTIONS.txt index 8fbd2fcd1..d99f3f616 100644 --- a/docs/ja_JP.UTF-8/OPTIONS.txt +++ b/docs/ja_JP.UTF-8/OPTIONS.txt @@ -1,1746 +1,2169 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 -各種設定について + 各種設定について - Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年7月13日 + 2023年7月13日 - +---------------------------------+ - |目次 | - |---------------------------------| - | * Tux Paint 設定ツール | - | * 設定ファイルについて | - | * 利用可能なオプション | - | * 画面・音声 | - | * マウス・キーボード | - | * 単純化 | - | * 言語関連 | - | * 印刷 | - | * 保存 | - | * データ | - | * 操作方法 | - | * ジョイスティック | - | * システム全体の設定を上書きする | - | * コマンドラインオプション | - | * 情報を表示するためのコマンドラインオプション | - | * 使用する言語の選択 | - | * 利用可能な言語 | - | * 環境で使用する言語の設定 | - | * 言語固有のフォント | - +---------------------------------+ ++------------------------------------------------------+ +| 目次 | +|------------------------------------------------------| +| * Tux Paint 設定ツール | +| * 設定ファイルについて | +| * 利用可能なオプション | +| + 画面・音声 | +| + マウス・キーボード | +| + 単純化 | +| + 言語関連 | +| + 印刷 | +| + 保存 | +| + データ | +| + 操作方法 | +| + ジョイスティック | +| * システム全体の設定を上書きする | +| * コマンドラインオプション | +| + 情報を表示するためのコマンドラインオプション | +| * 使用する言語の選択 | +| + 利用可能な言語 | +| + 環境で使用する言語の設定 | +| + 言語固有のフォント | ++------------------------------------------------------+ - Tux Paint 設定ツール +Tux Paint 設定ツール - Tux Paint - の動作をカスタマイズするには、グラフィカルな操作で設定が変更できるツールがご利用いただけます。しかしながら、このツールをインストールしたくない場合や、利用可能なオプションについて、さらに詳細を知りたいという方は、以下の説明を参照して下さい。 +Tux Paint の動作をカスタマイズするには、グラフィカルな操作で設定が変更できるツ +ールがご利用いただけます。しかしながら、このツールをインストールしたくない場合 +や、利用可能なオプションについて、さらに詳細を知りたいという方は、以下の説明を +参照して下さい。 - 設定ファイルについて +設定ファイルについて - 簡単な設定ファイルを作成して、Tux Paint の起動時に読み込ませることができます。 +簡単な設定ファイルを作成して、Tux Paint の起動時に読み込ませることができます。 - 設定ファイルは、有効にしたいオプションを記述した、シンプルなテキストファイルです。 +設定ファイルは、有効にしたいオプションを記述した、シンプルなテキストファイルで +す。 Linux 及び Unix のユーザー - ユーザー毎の設定ファイルは、ホームディレクトリに ".tuxpaintrc" というファイル名で作成します。（"~/.tuxpaintrc" - あるいは "$HOME/.tuxpaintrc"） +ユーザー毎の設定ファイルは、ホームディレクトリに ".tuxpaintrc" というファイル名 +で作成します。（"~/.tuxpaintrc" あるいは "$HOME/.tuxpaintrc"） - システム全体の設定ファイル +システム全体の設定ファイル - ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユーザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にされています） +ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー +ザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にさ +れています） - /etc/tuxpaint/tuxpaint.conf + /etc/tuxpaint/tuxpaint.conf macOS のユーザー - ユーザー毎の設定ファイルは、ホームフォルダ以下のサブフォルダ Library/Application Support/TuxPaint 内に - "tuxpaint.cfg" というファイル名で作成します。 +ユーザー毎の設定ファイルは、ホームフォルダ以下のサブフォルダ Library/ +Application Support/TuxPaint 内に "tuxpaint.cfg" というファイル名で作成します。 - システム全体の設定ファイル +システム全体の設定ファイル - ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユーザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にされています） +ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー +ザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にさ +れています） - /Library/Application Support/TuxPaint/tuxpaint.cfg + /Library/Application Support/TuxPaint/tuxpaint.cfg Windows のユーザー - ユーザー毎の設定ファイルは、個人用データのフォルダ C:\Users\username\AppData\Roaming\TuxPaint\ 内に - "tuxpaint.cfg" というファイル名で作成します。 +ユーザー毎の設定ファイルは、個人用データのフォルダ C:\Users\username\AppData\ +Roaming\TuxPaint\ 内に "tuxpaint.cfg" というファイル名で作成します。 - 設定ファイルはメモ帳やワードパッドで作成できますが、必ずテキストファイルとして保存するよう注意して下さい。また、ファイル名に ".txt" - という拡張子をつけないようにします。 +設定ファイルはメモ帳やワードパッドで作成できますが、必ずテキストファイルとして +保存するよう注意して下さい。また、ファイル名に ".txt" という拡張子をつけないよ +うにします。 - システム全体の設定ファイル +システム全体の設定ファイル - ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユーザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にされています） +ユーザー毎の設定ファイルが読み込まれる前に、以下の場所にある、システムの全ユー +ザーに適用される設定ファイルが読み込まれます。（標準では、全ての変更が無効にさ +れています） - C:\Program Files\Tuxpaint + C:\Program Files\Tuxpaint - ⚙ コマンドラインオプション "--nosysconfig" - 用いると、システム全体の設定ファイルは無視され、ユーザー毎の設定ファイルやコマンドラインオプションによる変更のみが反映されます。 +⚙ コマンドラインオプション "--nosysconfig" 用いると、システム全体の設定ファイル +は無視され、ユーザー毎の設定ファイルやコマンドラインオプションによる変更のみが +反映されます。 - 利用可能なオプション +利用可能なオプション - 設定ファイルでは、以下のオプションを設定することができます。（コマンドラインオプションによる設定が優先されます。以下のコマンドラインオプション"の項をごらん下さい） +設定ファイルでは、以下のオプションを設定することができます。（コマンドラインオ +プションによる設定が優先されます。以下のコマンドラインオプション"の項をごらん下 +さい） 画面・音声 - 画面 +画面 - fullscreen=yes +fullscreen=yes - プログラムを、ウィンドウ内ではなく、フルスクリーンモードで起動します。 + プログラムを、ウィンドウ内ではなく、フルスクリーンモードで起動します。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "fullscreen=no" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--windowed" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "fullscreen=no" を設定すると上書きされることがあります。また、どちら + の設定も、コマンドラインオプションの "--windowed" で変更できます。 - fullscreen=native - プログラムをフルスクリーンモードで起動します。その際、画面の解像度をオペレーティングシステムの設定から推定します。 - windowsize=SIZE +fullscreen=native - ウィンドウモードの場合、"SIZE" で指定するウィンドウサイズで、フルスクリーンモードの場合、"SIZE" - で指定する解像度でプログラムを起動します。（標準では "800x600" です） + プログラムをフルスクリーンモードで起動します。その際、画面の解像度をオペレ + ーティングシステムの設定から推定します。 - SIZE の値は、数値の間に半角小文字の "x" を用いて、’幅x高さ' のように、ピクセル単位で記述します。幅は最低で 640 - ピクセル、高さは最低で 480 ピクセルです。 - 例: - * 640x480 - * 1024x768 - * 768x1024 - * 1600x1200 +windowsize=SIZE - 💡 利用可能なディスプレイが１つのみで Tux Paint - が（フルスクリーンではなく）ウィンドウモードで実行されており、ウィンドウサイズの設定がディスプレイサイズより大きい場合、ウィンドウサイズは強制的にディスプレイサイズに合わせられます。 + ウィンドウモードの場合、"SIZE" で指定するウィンドウサイズで、フルスクリーン + モードの場合、"SIZE" で指定する解像度でプログラムを起動します。（標準では + "800x600" です） - orient=portrait + SIZE の値は、数値の間に半角小文字の "x" を用いて、’幅x高さ' のように、ピク + セル単位で記述します。幅は最低で 640 ピクセル、高さは最低で 480 ピクセルで + す。 - ウィンドウの幅と高さの設定を入れ替えます。これは、タブレットパソコンのような縦型のディスプレイでウィンドウを回転させる際に便利なオプションです。 + 例: - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "orient=landscape" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--orient=landscape" - で変更できます。 + + 640x480 + + 1024x768 + + 768x1024 + + 1600x1200 - native=yes + 💡 利用可能なディスプレイが１つのみで Tux Paint が（フルスクリーンではなく） + ウィンドウモードで実行されており、ウィンドウサイズの設定がディスプレイサイ + ズより大きい場合、ウィンドウサイズは強制的にディスプレイサイズに合わせられ + ます。 - Tux Paint をフルスクリーンモードで起動する際、"windowsize" - オプションの設定を無視して、オペレーティングシステムが設定する画面解像度に従います。 - allowscreensaver=yes - 標準では、Tux Paint の起動中は スクリーンセーバーが起動しない設定になっていますが、"allowscreensaver" - オプションを指定すると、スクリーンセーバーが有効になります。これはSDLライブラリのバージョンが 1.2.12 - 以降の場合に有効なオプションであることに注意して下さい。（環境変数 "SDL_VIDEO_ALLOW_SCREENSAVER" - の値を "1" に設定しても、同様のことができます） +orient=portrait - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "allowscreensaver=no" - または "disablescreensaver=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--disablescreensaver" で変更できます。 + ウィンドウの幅と高さの設定を入れ替えます。これは、タブレットパソコンのよう + な縦型のディスプレイでウィンドウを回転させる際に便利なオプションです。 - 音声 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "orient=landscape" を設定すると上書きされることがあります。また、ど + ちらの設定も、コマンドラインオプションの "--orient=landscape" で変更できま + す。 - nosound=yes - 効果音を無効にします。（注: このオプションを設定すると、[Alt] + [S] を押しても、効果音を有効化することはできません - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nosound=no" または - "sound=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--sound" - で変更できます。 +native=yes - nostereo=yes + Tux Paint をフルスクリーンモードで起動する際、"windowsize" オプションの設定 + を無視して、オペレーティングシステムが設定する画面解像度に従います。 - ステレオの効果音を無効にする。（片耳イヤホンや１台のスピーカーで使用する場合に役に立ちます） - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nostereo=no" または - "stereo=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--stereo" で変更できます。 - インターフェースサイズ +allowscreensaver=yes - buttonsize=SIZE + 標準では、Tux Paint の起動中はスクリーンセーバーが起動しない設定になってい + ますが、"allowscreensaver" オプションを指定すると、スクリーンセーバーが有効 + になります。これはSDLライブラリのバージョンが 1.2.12 以降の場合に有効なオプ + ションであることに注意して下さい。（環境変数 "SDL_VIDEO_ALLOW_SCREENSAVER" + の値を "1" に設定しても、同様のことができます） - Tux Paint のユーザーインターフェースの各種ボタンのサイズを標準の "48" - から変更します。非常に高解像度のディスプレイや、視線入力といった分解能の低い操作デバイスを使用する場合に有効です。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "allowscreensaver=no" または "disablescreensaver=yes" を設定すると上 + 書きされることがあります。また、どちらの設定も、コマンドラインオプションの + "--disablescreensaver" で変更できます。 - SIZE - の値は24から192までのピクセル値で指定します。ほとんどのボタンは正方形となっており、この設定はボタンの幅と高さの両方に影響します。 - SIZEの値として "auto" を指定すると、Tux Paint - のウィンドウ（またはフルスクリーンディスプレイ）のサイズに基づいて、適切なボタンサイズが選択されます。(デフォルトの画面サイズ - 800x600 の場合、ボタンサイズはデフォルトの "48" になります。) - 💡 注: - 選択されたボタンのサイズが大きすぎて画面内に必要なすべてのインターフェースが表示しきれない場合は、できる限り大きなボタンサイズが使用されます。(その旨がstderrに出力されます) - colorsrows=ROWS +音声 + +nosound=yes + + 効果音を無効にします。（注: このオプションを設定すると、[Alt] + [S] を押し + ても、効果音を有効化することはできません + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nosound=no" または "sound=yes" を設定すると上書きされることがありま + す。また、どちらの設定も、コマンドラインオプションの "--sound" で変更できま + す。 + + + +nostereo=yes + + ステレオの効果音を無効にする。（片耳イヤホンや１台のスピーカーで使用する場 + 合に役に立ちます） + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nostereo=no" または "stereo=yes" を設定すると上書きされることがあり + ます。また、どちらの設定も、コマンドラインオプションの "--stereo" で変更で + きます。 + + + + +インターフェースサイズ + +buttonsize=SIZE + + Tux Paint のユーザーインターフェースの各種ボタンのサイズを標準の "48" から + 変更します。非常に高解像度のディスプレイや、視線入力といった分解能の低い操 + 作デバイスを使用する場合に有効です。 + + SIZE の値は24から192までのピクセル値で指定します。ほとんどのボタンは正方形 + となっており、この設定はボタンの幅と高さの両方に影響します。 + + SIZEの値として "auto" を指定すると、Tux Paint のウィンドウ（またはフルスク + リーンディスプレイ）のサイズに基づいて、適切なボタンサイズが選択されます。 + (デフォルトの画面サイズ 800x600 の場合、ボタンサイズはデフォルトの "48" に + なります。) + + 💡 注: 選択されたボタンのサイズが大きすぎて画面内に必要なすべてのインターフ + ェースが表示しきれない場合は、できる限り大きなボタンサイズが使用されます。 + (その旨がstderrに出力されます) + + + +colorsrows=ROWS + + カラーパレットのボタンを何列表示するかを指定します。色数の多いカラーパレッ + ト（上記の "colorfile" を参照）を使う場合や、視線入力などの分解能の低い操作 + デバイスを使用する場合に便利です。"ROWS "には、"1"（デフォルト）から "3" ま + での値を指定します。 + + - カラーパレットのボタンを何列表示するかを指定します。色数の多いカラーパレット（上記の "colorfile" - を参照）を使う場合や、視線入力などの分解能の低い操作デバイスを使用する場合に便利です。"ROWS "には、"1"（デフォルト）から - "3" までの値を指定します。 マウス・キーボード - マウスカーソル +マウスカーソル - nofancycursors=yes +nofancycursors=yes - Tux Paint 独自のマウスポインタを無効にし、システム標準のマウスポインタを使用するようにします。 + Tux Paint 独自のマウスポインタを無効にし、システム標準のマウスポインタを使 + 用するようにします。 - 環境によっては Tux Paint - のマウスカーソルが原因で不具合が起こることがあります。そういった場合にこのオプションを有効にして下さい。 + 環境によっては Tux Paint のマウスカーソルが原因で不具合が起こることがありま + す。そういった場合にこのオプションを有効にして下さい。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nofancycursors=no" または - "fancycursors=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--fancycursors" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nofancycursors=no" または "fancycursors=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--fancycursors" で変更できます。 - hidecursor=yes - マウスカーソルを表示しないようにします。 - タブレットＰＣなどのタッチスクリーンを用いるデバイスのためのオプションです。 +hidecursor=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "hidecursor=no" または - "showcursor=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--showcursor" で変更できます。 + マウスカーソルを表示しないようにします。 - キーボード + タブレットＰＣなどのタッチスクリーンを用いるデバイスのためのオプションです + 。 - noshortcuts=yes + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "hidecursor=no" または "showcursor=yes" を設定すると上書きされること + があります。また、どちらの設定も、コマンドラインオプションの "--showcursor" + で変更できます。 - キーボードショートカット（保存: [Ctrl]-[S]、新規作成: [Ctrl]-[N] など）を無効にします。 - これは、キーボードの操作に慣れていない子供が不用意にコマンドを実行してしまうことを防ぐために有効です。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "noshortcuts=no" または - "shortcuts=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--shortcuts" で変更できます。 - マウス +キーボード - grab=yes +noshortcuts=yes - Tux Paint がマウスとキーボードを「独占」します。マウスカーソルが Tux Paint - のウィンドウ内に限定され、ほとんどすべてのキーボード入力が直接 Tux Paint に渡されます。 + キーボードショートカット（保存: [Ctrl]-[S]、新規作成: [Ctrl]-[N] など）を無 + 効にします。 - これは、ユーザーが Tux Paint から抜け出すことができないようにするのに便利です。 [Alt]-[Tab] - によるウィンドウの切り替えや、[Ctrl]-[Escape] - キーによる操作が無効になります。このオプションは、特にフルスクリーンモード時に有効です。 + これは、キーボードの操作に慣れていない子供が不用意にコマンドを実行してしま + うことを防ぐために有効です。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "grab=no" または - "dontgrab=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--dontgrab" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "noshortcuts=no" または "shortcuts=yes" を設定すると上書きされること + があります。また、どちらの設定も、コマンドラインオプションの "--shortcuts" + で変更できます。 - nowheelmouse=yes - マウスでのホイールによる操作が無効になります。(通常、ホイールは右のセレクターメニューをスクロールします)。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nowheelmouse=no" または - "wheelmouse=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--wheelmouse" で変更できます。 - nobuttondistinction=yes +マウス + +grab=yes + + Tux Paint がマウスとキーボードを「独占」します。マウスカーソルが Tux Paint + のウィンドウ内に限定され、ほとんどすべてのキーボード入力が直接 Tux Paint に + 渡されます。 + + これは、ユーザーが Tux Paint から抜け出すことができないようにするのに便利で + す。 [Alt]-[Tab] によるウィンドウの切り替えや、[Ctrl]-[Escape] キーによる操 + 作が無効になります。このオプションは、特にフルスクリーンモード時に有効です + 。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "grab=no" または "dontgrab=yes" を設定すると上書きされることがありま + す。また、どちらの設定も、コマンドラインオプションの "--dontgrab" で変更で + きます。 + + + +nowheelmouse=yes + + マウスでのホイールによる操作が無効になります。(通常、ホイールは右のセレクタ + ーメニューをスクロールします)。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nowheelmouse=no" または "wheelmouse=yes" を設定すると上書きされるこ + とがあります。また、どちらの設定も、コマンドラインオプションの + "--wheelmouse" で変更できます。 + + + +nobuttondistinction=yes + + Tux Paint 0.9.15 以前では、マウスの中ボタンと右ボタンでもクリックが可能でし + たが、バージョン0.9.15からは、子供たちが間違ったボタン押さないように、マウ + スの左ボタンだけが使えるように変更しました。 + + マウス操作が苦手なお子さんの場合、このオプションを使用することで、マウスの2 + つまたは3つのボタンの区別を無効にすることができます。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nobuttondistinction=no" または "buttondistinction=yes" を設定すると + 上書きされることがあります。また、どちらの設定も、コマンドラインオプション + の "--buttondistinction" で変更できます。 - Tux Paint 0.9.15 - 以前では、マウスの中ボタンと右ボタンでもクリックが可能でしたが、バージョン0.9.15からは、子供たちが間違ったボタン押さないように、マウスの左ボタンだけが使えるように変更しました。 - マウス操作が苦手なお子さんの場合、このオプションを使用することで、マウスの2つまたは3つのボタンの区別を無効にすることができます。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで - "nobuttondistinction=no" または "buttondistinction=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--buttondistinction" - で変更できます。 単純化 - 操作の単純化 +操作の単純化 - simpleshapes=yes +simpleshapes=yes - 「ずけい」ツールで、形を決めたあとに回転させるステップを省略します。クリックして、ドラッグして、ボタンを離すだけで、図形を描くことができます。 + 「ずけい」ツールで、形を決めたあとに回転させるステップを省略します。クリッ + クして、ドラッグして、ボタンを離すだけで、図形を描くことができます。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "simpleshapes=no" または - "complexshapes=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--complexshapes" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "simpleshapes=no" または "complexshapes=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--complexshapes" で変更できます。 - nooutlines=yes - このモードでは、「せん」ツール、「かたち」ツール、「はんこ」ツールそしてけしゴムを使うときに、アウトラインをシンプルな線で表示します。 - Tux Paint を非常に遅いパソコンで使いたい場合や、リモートの X-Window ディスプレイで使う場合に、速度を改善します。 +nooutlines=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nooutlines=no" または - "outlines=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--outlines" で変更できます。 + このモードでは、「せん」ツール、「かたち」ツール、「はんこ」ツールそしてけ + しゴムを使うときに、アウトラインをシンプルな線で表示します。 - uppercase=yes + Tux Paint を非常に遅いパソコンで使いたい場合や、リモートの X-Window ディス + プレイで使う場合に、速度を改善します。 - すべてのテキストが大文字で表記されます（例: - 「Brush」は「BRUSH」）。まだ大文字しか習っていない子供たちにとって役に立つオプションです。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nooutlines=no" または "outlines=yes" を設定すると上書きされることが + あります。また、どちらの設定も、コマンドラインオプションの "--outlines" で + 変更できます。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "uppercase=no" または - "mixedcase=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--mixedcase" で変更できます。 - スタンプの初期サイズ - stampsize=SIZE +uppercase=yes - すべてのスタンプの初期の大きさを 0（最小）から 10（最大）の間で設定します。SIZE の値はスタンプ自体の大きさと Tux - Paint のキャンバスサイズによって決まる大きさに対する相対的な指定になります。 + すべてのテキストが大文字で表記されます（例: 「Brush」は「BRUSH」）。まだ大 + 文字しか習っていない子供たちにとって役に立つオプションです。 - SIZE の値に default を指定すると、Tux Paint がスタンプの大きさを自動的に決定します。（これが標準の動作です） + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "uppercase=no" または "mixedcase=yes" を設定すると上書きされることが + あります。また、どちらの設定も、コマンドラインオプションの "--mixedcase" で + 変更できます。 - 機能制限 - noquit=yes - 画面の "やめる" ボタンや [Escape] キーによるプログラム終了を無効にする。 - なお、この場合でも [Alt] + [F4] - の組み合わせや、フルスクリーンモードでない場合は、閉じるボタンを押せば、プログラムを終了することができます。 +スタンプの初期サイズ - また、[Shift] + [Control] + [Escape]. というキーの組み合わせでもプログラムを終了することができます。 +stampsize=SIZE - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "noquit=no" または - "quit=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--quit" - で変更できます。 + すべてのスタンプの初期の大きさを 0（最小）から 10（最大）の間で設定します。 + SIZE の値はスタンプ自体の大きさと Tux Paint のキャンバスサイズによって決ま + る大きさに対する相対的な指定になります。 - nostamps=yes + SIZE の値に default を指定すると、Tux Paint がスタンプの大きさを自動的に決 + 定します。（これが標準の動作です） - 「はんこ」の画像を読み込まず、「はんこ」ツールを無効にします。 - これによって、初回起動時のプログラムの読み込みが高速になります。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nostamps=no" または - "stamps=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--stamps" で変更できます。 - nostampcontrols=yes +機能制限 - 「はんこ」ツールの画像には、上下または左右に反転できたり、大きさを変更したりできるものがあります。このオプションを設定すると、このような操作を無効にします。 +noquit=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nostampcontrols=no" - または "stampcontrols=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--stampcontrols" - で変更できます。 + 画面の "やめる" ボタンや [Escape] キーによるプログラム終了を無効にする。 - nostamprotation=yes + なお、この場合でも [Alt] + [F4] の組み合わせや、フルスクリーンモードでない + 場合は、閉じるボタンを押せば、プログラムを終了することができます。 - はんこを回転させるステップを省略し、１回のクリックで通常の向きにはんこを配置します。 + また、[Shift] + [Control] + [Escape]. というキーの組み合わせでもプログラム + を終了することができます。 - 📜 注: はんこの回転機能は Tux Paint バージョン 0.9.29 で追加されました。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "noquit=no" または "quit=yes" を設定すると上書きされることがあります + 。また、どちらの設定も、コマンドラインオプションの "--quit" で変更できます + 。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nostamprotation=no" - または "stamprotation=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--stamprotation" - で変更できます。 - nomagiccontrols=yes - 「まほう」ツールの中には、「ふで」ツールのように画像の一部分だけに効果を及ぼすか、キャンバス全体に効果を及ぼすかを選択できるものがあります。このオプションを設定すると、「まほう」ツールの動作の選択を無効にして、ツールごとに標準の動作だけをするようにします。（たいていは「ふで」のような動作になります） +nostamps=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nomagiccontrols=no" - または "magiccontrols=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--magiccontrols" - で変更できます。 + 「はんこ」の画像を読み込まず、「はんこ」ツールを無効にします。 - nomagicsizes=yes + これによって、初回起動時のプログラムの読み込みが高速になります。 - 「まほう」ツールの中には、描画のサイズや効果が及ぶ幅の大きさを変更できるものがあります。このオプションを設定するとサイズの変更を無効にして、ツールごとの標準のサイズを使用します。（この場合、「れんが」や「めだま」などいくつかのプラグインでは、異なるサイズのツールが追加されます。） + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nostamps=no" または "stamps=yes" を設定すると上書きされることがあり + ます。また、どちらの設定も、コマンドラインオプションの "--stamps" で変更で + きます。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nomagicsizes=no" または - "magicsizes=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--magicsizes" で変更できます。 - noshapecontrols=yes - 「かたち」ツールでの２つの動作モード－マウスをクリックした箇所を中心として図形を拡大するか、マウスをクリックした箇所をコーナーとして図形を拡大するか－を選択するボタンを無効にします。 +nostampcontrols=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "noshapecontrols=no" - または "shapecontrols=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--shapecontrols" - で変更できます。 + 「はんこ」ツールの画像には、上下または左右に反転できたり、大きさを変更した + りできるものがあります。このオプションを設定すると、このような操作を無効に + します。 - nolabel=yes + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nostampcontrols=no" または "stampcontrols=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--stampcontrols" で変更できます。 - 「ラベル」ツールを無効にします。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nolabel=no" または - "label=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--label" - で変更できます。 - nobrushspacing=yes +nostamprotation=yes - 「ふで」ツールとLines「せん」ツールで、描画間隔の調整を無効にします。標準の描画間隔が用いられます。 + はんこを回転させるステップを省略し、１回のクリックで通常の向きにはんこを配 + 置します。 - 📜 注: 描画間隔調整のオプションは、バージョン 0.9.28 - で追加されました。描画間隔調整についての詳細は、EXTENDING.htmlを参照してください。 + 📜 注: はんこの回転機能は Tux Paint バージョン 0.9.29 で追加されました。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nobrushspacing=no" または - "brushspacing=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--brushspacing" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nostamprotation=no" または "stamprotation=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--stamprotation" で変更できます。 - notemplateexport=yes - 「ひらく」ダイアログで、保存された作品を用いて新しいテンプレート画像を作成する機能を無効にします。 - 📜 注: テンプレート作成機能は Tux Paint バージョン 0.9.31 で追加されました。 +nomagiccontrols=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "notemplateexport=no" - または "templateexport=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--templateexport" - で変更できます。 + 「まほう」ツールの中には、「ふで」ツールのように画像の一部分だけに効果を及 + ぼすか、キャンバス全体に効果を及ぼすかを選択できるものがあります。このオプ + ションを設定すると、「まほう」ツールの動作の選択を無効にして、ツールごとに + 標準の動作だけをするようにします。（たいていは「ふで」のような動作になりま + す） - noerase=yes + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nomagiccontrols=no" または "magiccontrols=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--magiccontrols" で変更できます。 + + + +nomagicsizes=yes + + 「まほう」ツールの中には、描画のサイズや効果が及ぶ幅の大きさを変更できるも + のがあります。このオプションを設定するとサイズの変更を無効にして、ツールご + との標準のサイズを使用します。（この場合、「れんが」や「めだま」などいくつ + かのプラグインでは、異なるサイズのツールが追加されます。） + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nomagicsizes=no" または "magicsizes=yes" を設定すると上書きされるこ + とがあります。また、どちらの設定も、コマンドラインオプションの + "--magicsizes" で変更できます。 + + + +noshapecontrols=yes + + 「かたち」ツールでの２つの動作モード－マウスをクリックした箇所を中心として + 図形を拡大するか、マウスをクリックした箇所をコーナーとして図形を拡大するか + －を選択するボタンを無効にします。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "noshapecontrols=no" または "shapecontrols=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--shapecontrols" で変更できます。 + + + +nolabel=yes + + 「ラベル」ツールを無効にします。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nolabel=no" または "label=yes" を設定すると上書きされることがありま + す。また、どちらの設定も、コマンドラインオプションの "--label" で変更できま + す。 + + + +nobrushspacing=yes + + 「ふで」ツールとLines「せん」ツールで、描画間隔の調整を無効にします。標準の + 描画間隔が用いられます。 + + 📜 注: 描画間隔調整のオプションは、バージョン 0.9.28 で追加されました。描画 + 間隔調整についての詳細は、EXTENDING.htmlを参照してください。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "nobrushspacing=no" または "brushspacing=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--brushspacing" で変更できます。 + + + +notemplateexport=yes + + 「ひらく」ダイアログで、保存された作品を用いて新しいテンプレート画像を作成 + する機能を無効にします。 + + 📜 注: テンプレート作成機能は Tux Paint バージョン 0.9.31 で追加されました。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "notemplateexport=no" または "templateexport=yes" を設定すると上書き + されることがあります。また、どちらの設定も、コマンドラインオプションの + "--templateexport" で変更できます。 + + + +noerase=yes + + 「ひらく」ダイアログの「けす」ボタンを使って保存した作品を削除したり、「さ + いしょから」ダイアログの「けす」ボタンを使って自作のテンプレート画像を削除 + する機能を無効にします。特に --saveovernew オプションと組み合わせて、意図し + ない操作で作品を失うのを防ぐことができます。 + + 📜 注: このオプションは Tux Paint バージョン 0.9.31 で追加されました。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "noerase=no" または "erase=yes" を設定すると上書きされることがありま + す。また、どちらの設定も、コマンドラインオプションの "--erase" で変更できま + す。 - 「ひらく」ダイアログの「けす」ボタンを使って保存した作品を削除したり、「さいしょから」ダイアログの「けす」ボタンを使って自作のテンプレート画像を削除する機能を無効にします。特に - --saveovernew オプションと組み合わせて、意図しない操作で作品を失うのを防ぐことができます。 - 📜 注: このオプションは Tux Paint バージョン 0.9.31 で追加されました。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "noerase=no" または - "erase=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--erase" - で変更できます。 言語関連 - 言語 +言語 - lang=LANGUAGE +lang=LANGUAGE - サポートされている中から言語を指定して Tux Paint - を起動します。現時点でLANGUAGEに指定できる言語は以下のとおりです: + サポートされている中から言語を指定して Tux Paint を起動します。現時点で + LANGUAGEに指定できる言語は以下のとおりです: - +-----------------------------------------------------------+ - |english |american-english | | - |---------------------+---------------------+---------------| - |acholi |acoli | | - |---------------------+---------------------+---------------| - |afrikaans | | | - |---------------------+---------------------+---------------| - |akan |twi-fante | | - |---------------------+---------------------+---------------| - |albanian | | | - |---------------------+---------------------+---------------| - |amharic | | | - |---------------------+---------------------+---------------| - |arabic | | | - |---------------------+---------------------+---------------| - |aragones | | | - |---------------------+---------------------+---------------| - |armenian |hayeren | | - |---------------------+---------------------+---------------| - |assamese | | | - |---------------------+---------------------+---------------| - |asturian | | | - |---------------------+---------------------+---------------| - |australian-english | | | - |---------------------+---------------------+---------------| - |azerbaijani | | | - |---------------------+---------------------+---------------| - |bambara | | | - |---------------------+---------------------+---------------| - |basque |euskara | | - |---------------------+---------------------+---------------| - |belarusian |bielaruskaja | | - |---------------------+---------------------+---------------| - |bengali | | | - |---------------------+---------------------+---------------| - |bodo | | | - |---------------------+---------------------+---------------| - |bokmal | | | - |---------------------+---------------------+---------------| - |bosnian | | | - |---------------------+---------------------+---------------| - |brazilian-portuguese |portugues-brazilian |brazilian | - |---------------------+---------------------+---------------| - |breton |brezhoneg | | - |---------------------+---------------------+---------------| - |british-english |british | | - |---------------------+---------------------+---------------| - |bulgarian | | | - |---------------------+---------------------+---------------| - |canadian-english | | | - |---------------------+---------------------+---------------| - |catalan |catala | | - |---------------------+---------------------+---------------| - |chinese |simplified-chinese | | - |---------------------+---------------------+---------------| - |croatian |hrvatski | | - |---------------------+---------------------+---------------| - |czech |cesky | | - |---------------------+---------------------+---------------| - |danish |dansk | | - |---------------------+---------------------+---------------| - | |dogri | | - |---------------------+---------------------+---------------| - |dutch |nederlands | | - |---------------------+---------------------+---------------| - |esperanto | | | - |---------------------+---------------------+---------------| - |estonian | | | - |---------------------+---------------------+---------------| - |faroese | | | - |---------------------+---------------------+---------------| - |finnish |suomi | | - |---------------------+---------------------+---------------| - |french |francais | | - |---------------------+---------------------+---------------| - |fula |fulah |pulaar-fulfulde| - |---------------------+---------------------+---------------| - |gaelic |gaidhlig |irish-gaelic | - |---------------------+---------------------+---------------| - |galician |galego | | - |---------------------+---------------------+---------------| - |georgian | | | - |---------------------+---------------------+---------------| - |german |deutsch | | - |---------------------+---------------------+---------------| - |greek | | | - |---------------------+---------------------+---------------| - |gronings |zudelk-veenkelonioals| | - |---------------------+---------------------+---------------| - |gujarati | | | - |---------------------+---------------------+---------------| - |hebrew | | | - |---------------------+---------------------+---------------| - |hindi | | | - |---------------------+---------------------+---------------| - |hungarian |magyar | | - |---------------------+---------------------+---------------| - |icelandic |islenska | | - |---------------------+---------------------+---------------| - |indonesian |bahasa-indonesia | | - |---------------------+---------------------+---------------| - |inuktitut | | | - |---------------------+---------------------+---------------| - |italian |italiano | | - |---------------------+---------------------+---------------| - |japanese | | | - |---------------------+---------------------+---------------| - |kabyle | |kabylian | - |---------------------+---------------------+---------------| - |kannada | | | - |---------------------+---------------------+---------------| - |kashmiri-devanagari | | | - |---------------------+---------------------+---------------| - |kashmiri-perso-arabic| | | - |---------------------+---------------------+---------------| - |khmer | | | - |---------------------+---------------------+---------------| - |kiga |chiga | | - |---------------------+---------------------+---------------| - |kinyarwanda | | | - |---------------------+---------------------+---------------| - |klingon |tlhIngan | | - |---------------------+---------------------+---------------| - |konkani-devanagari | | | - |---------------------+---------------------+---------------| - |konkani-roman | | | - |---------------------+---------------------+---------------| - |korean | | | - |---------------------+---------------------+---------------| - |kurdish | | | - |---------------------+---------------------+---------------| - |latvian | | | - |---------------------+---------------------+---------------| - |lithuanian |lietuviu | | - |---------------------+---------------------+---------------| - |luganda | | | - |---------------------+---------------------+---------------| - |luxembourgish |letzebuergesch | | - |---------------------+---------------------+---------------| - |macedonian | | | - |---------------------+---------------------+---------------| - |maithili | | | - |---------------------+---------------------+---------------| - |malay | | | - |---------------------+---------------------+---------------| - |malayalam | | | - |---------------------+---------------------+---------------| - |manipuri-bengali | | | - |---------------------+---------------------+---------------| - |manipuri-meitei-mayek| | | - |---------------------+---------------------+---------------| - |marathi | | | - |---------------------+---------------------+---------------| - |mexican-spanish |espanol-mejicano |mexican | - |---------------------+---------------------+---------------| - |mongolian | | | - |---------------------+---------------------+---------------| - |ndebele | | | - |---------------------+---------------------+---------------| - |nepali | | | - |---------------------+---------------------+---------------| - |northern-sotho |sesotho-sa-leboa | | - |---------------------+---------------------+---------------| - |norwegian |nynorsk |norsk | - |---------------------+---------------------+---------------| - |occitan | | | - |---------------------+---------------------+---------------| - |odia |oriya | | - |---------------------+---------------------+---------------| - |ojibwe |ojibway | | - |---------------------+---------------------+---------------| - |persian | | | - |---------------------+---------------------+---------------| - |polish |polski | | - |---------------------+---------------------+---------------| - |portuguese |portugues | | - |---------------------+---------------------+---------------| - |punjabi |panjabi | | - |---------------------+---------------------+---------------| - |romanian | | | - |---------------------+---------------------+---------------| - |russian |russkiy | | - |---------------------+---------------------+---------------| - |sanskrit | | | - |---------------------+---------------------+---------------| - |santali-devanagari | | | - |---------------------+---------------------+---------------| - |santali-ol-chiki | | | - |---------------------+---------------------+---------------| - |scottish |ghaidhlig |scottish-gaelic| - |---------------------+---------------------+---------------| - |serbian | | | - |---------------------+---------------------+---------------| - |serbian-latin | | | - |---------------------+---------------------+---------------| - |shuswap |secwepemctin | | - |---------------------+---------------------+---------------| - |sindhi-devanagari | | | - |---------------------+---------------------+---------------| - |sindhi-perso-arabic | | | - |---------------------+---------------------+---------------| - |slovak | | | - |---------------------+---------------------+---------------| - |slovenian |slovensko | | - |---------------------+---------------------+---------------| - |songhay | | | - |---------------------+---------------------+---------------| - |southafrican-english | | | - |---------------------+---------------------+---------------| - |spanish |espanol | | - |---------------------+---------------------+---------------| - |sundanese | | | - |---------------------+---------------------+---------------| - |swahili | | | - |---------------------+---------------------+---------------| - |swedish |svenska | | - |---------------------+---------------------+---------------| - |tagalog | | | - |---------------------+---------------------+---------------| - |tamil | | | - |---------------------+---------------------+---------------| - |telugu | | | - |---------------------+---------------------+---------------| - |thai | | | - |---------------------+---------------------+---------------| - |tibetan | | | - |---------------------+---------------------+---------------| - |traditional-chinese | | | - |---------------------+---------------------+---------------| - |turkish | | | - |---------------------+---------------------+---------------| - |twi | | | - |---------------------+---------------------+---------------| - |ukrainian | | | - |---------------------+---------------------+---------------| - |urdu | | | - |---------------------+---------------------+---------------| - |venda | | | - |---------------------+---------------------+---------------| - |venetian |veneto | | - |---------------------+---------------------+---------------| - |vietnamese | | | - |---------------------+---------------------+---------------| - |walloon |walon | | - |---------------------+---------------------+---------------| - |welsh |cymraeg | | - |---------------------+---------------------+---------------| - |wolof | | | - |---------------------+---------------------+---------------| - |xhosa | | | - |---------------------+---------------------+---------------| - |miahuatlan-zapotec | |zapotec | - |---------------------+---------------------+---------------| - |zulu | |zulu | - +-----------------------------------------------------------+ + +-----------------------------------------------------------------+ + | english | american-english | | + |-----------------------+-----------------------+-----------------| + | acholi | acoli | | + |-----------------------+-----------------------+-----------------| + | afrikaans | | | + |-----------------------+-----------------------+-----------------| + | akan | twi-fante | | + |-----------------------+-----------------------+-----------------| + | albanian | | | + |-----------------------+-----------------------+-----------------| + | amharic | | | + |-----------------------+-----------------------+-----------------| + | arabic | | | + |-----------------------+-----------------------+-----------------| + | aragones | | | + |-----------------------+-----------------------+-----------------| + | armenian | hayeren | | + |-----------------------+-----------------------+-----------------| + | assamese | | | + |-----------------------+-----------------------+-----------------| + | asturian | | | + |-----------------------+-----------------------+-----------------| + | australian-english | | | + |-----------------------+-----------------------+-----------------| + | azerbaijani | | | + |-----------------------+-----------------------+-----------------| + | bambara | | | + |-----------------------+-----------------------+-----------------| + | basque | euskara | | + |-----------------------+-----------------------+-----------------| + | belarusian | bielaruskaja | | + |-----------------------+-----------------------+-----------------| + | bengali | | | + |-----------------------+-----------------------+-----------------| + | bodo | | | + |-----------------------+-----------------------+-----------------| + | bokmal | | | + |-----------------------+-----------------------+-----------------| + | bosnian | | | + |-----------------------+-----------------------+-----------------| + | brazilian-portuguese | portugues-brazilian | brazilian | + |-----------------------+-----------------------+-----------------| + | breton | brezhoneg | | + |-----------------------+-----------------------+-----------------| + | british-english | british | | + |-----------------------+-----------------------+-----------------| + | bulgarian | | | + |-----------------------+-----------------------+-----------------| + | canadian-english | | | + |-----------------------+-----------------------+-----------------| + | catalan | catala | | + |-----------------------+-----------------------+-----------------| + | chinese | simplified-chinese | | + |-----------------------+-----------------------+-----------------| + | croatian | hrvatski | | + |-----------------------+-----------------------+-----------------| + | czech | cesky | | + |-----------------------+-----------------------+-----------------| + | danish | dansk | | + |-----------------------+-----------------------+-----------------| + | | dogri | | + |-----------------------+-----------------------+-----------------| + | dutch | nederlands | | + |-----------------------+-----------------------+-----------------| + | esperanto | | | + |-----------------------+-----------------------+-----------------| + | estonian | | | + |-----------------------+-----------------------+-----------------| + | faroese | | | + |-----------------------+-----------------------+-----------------| + | finnish | suomi | | + |-----------------------+-----------------------+-----------------| + | french | francais | | + |-----------------------+-----------------------+-----------------| + | fula | fulah | pulaar-fulfulde | + |-----------------------+-----------------------+-----------------| + | gaelic | gaidhlig | irish-gaelic | + |-----------------------+-----------------------+-----------------| + | galician | galego | | + |-----------------------+-----------------------+-----------------| + | georgian | | | + |-----------------------+-----------------------+-----------------| + | german | deutsch | | + |-----------------------+-----------------------+-----------------| + | greek | | | + |-----------------------+-----------------------+-----------------| + | gronings | zudelk-veenkelonioals | | + |-----------------------+-----------------------+-----------------| + | gujarati | | | + |-----------------------+-----------------------+-----------------| + | hebrew | | | + |-----------------------+-----------------------+-----------------| + | hindi | | | + |-----------------------+-----------------------+-----------------| + | hungarian | magyar | | + |-----------------------+-----------------------+-----------------| + | icelandic | islenska | | + |-----------------------+-----------------------+-----------------| + | indonesian | bahasa-indonesia | | + |-----------------------+-----------------------+-----------------| + | inuktitut | | | + |-----------------------+-----------------------+-----------------| + | italian | italiano | | + |-----------------------+-----------------------+-----------------| + | japanese | | | + |-----------------------+-----------------------+-----------------| + | kabyle | | kabylian | + |-----------------------+-----------------------+-----------------| + | kannada | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-devanagari | | | + |-----------------------+-----------------------+-----------------| + | kashmiri-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | khmer | | | + |-----------------------+-----------------------+-----------------| + | kiga | chiga | | + |-----------------------+-----------------------+-----------------| + | kinyarwanda | | | + |-----------------------+-----------------------+-----------------| + | klingon | tlhIngan | | + |-----------------------+-----------------------+-----------------| + | konkani-devanagari | | | + |-----------------------+-----------------------+-----------------| + | konkani-roman | | | + |-----------------------+-----------------------+-----------------| + | korean | | | + |-----------------------+-----------------------+-----------------| + | kurdish | | | + |-----------------------+-----------------------+-----------------| + | latvian | | | + |-----------------------+-----------------------+-----------------| + | lithuanian | lietuviu | | + |-----------------------+-----------------------+-----------------| + | luganda | | | + |-----------------------+-----------------------+-----------------| + | luxembourgish | letzebuergesch | | + |-----------------------+-----------------------+-----------------| + | macedonian | | | + |-----------------------+-----------------------+-----------------| + | maithili | | | + |-----------------------+-----------------------+-----------------| + | malay | | | + |-----------------------+-----------------------+-----------------| + | malayalam | | | + |-----------------------+-----------------------+-----------------| + | manipuri-bengali | | | + |-----------------------+-----------------------+-----------------| + | manipuri-meitei-mayek | | | + |-----------------------+-----------------------+-----------------| + | marathi | | | + |-----------------------+-----------------------+-----------------| + | mexican-spanish | espanol-mejicano | mexican | + |-----------------------+-----------------------+-----------------| + | mongolian | | | + |-----------------------+-----------------------+-----------------| + | ndebele | | | + |-----------------------+-----------------------+-----------------| + | nepali | | | + |-----------------------+-----------------------+-----------------| + | northern-sotho | sesotho-sa-leboa | | + |-----------------------+-----------------------+-----------------| + | norwegian | nynorsk | norsk | + |-----------------------+-----------------------+-----------------| + | occitan | | | + |-----------------------+-----------------------+-----------------| + | odia | oriya | | + |-----------------------+-----------------------+-----------------| + | ojibwe | ojibway | | + |-----------------------+-----------------------+-----------------| + | persian | | | + |-----------------------+-----------------------+-----------------| + | polish | polski | | + |-----------------------+-----------------------+-----------------| + | portuguese | portugues | | + |-----------------------+-----------------------+-----------------| + | punjabi | panjabi | | + |-----------------------+-----------------------+-----------------| + | romanian | | | + |-----------------------+-----------------------+-----------------| + | russian | russkiy | | + |-----------------------+-----------------------+-----------------| + | sanskrit | | | + |-----------------------+-----------------------+-----------------| + | santali-devanagari | | | + |-----------------------+-----------------------+-----------------| + | santali-ol-chiki | | | + |-----------------------+-----------------------+-----------------| + | scottish | ghaidhlig | scottish-gaelic | + |-----------------------+-----------------------+-----------------| + | serbian | | | + |-----------------------+-----------------------+-----------------| + | serbian-latin | | | + |-----------------------+-----------------------+-----------------| + | shuswap | secwepemctin | | + |-----------------------+-----------------------+-----------------| + | sindhi-devanagari | | | + |-----------------------+-----------------------+-----------------| + | sindhi-perso-arabic | | | + |-----------------------+-----------------------+-----------------| + | slovak | | | + |-----------------------+-----------------------+-----------------| + | slovenian | slovensko | | + |-----------------------+-----------------------+-----------------| + | songhay | | | + |-----------------------+-----------------------+-----------------| + | southafrican-english | | | + |-----------------------+-----------------------+-----------------| + | spanish | espanol | | + |-----------------------+-----------------------+-----------------| + | sundanese | | | + |-----------------------+-----------------------+-----------------| + | swahili | | | + |-----------------------+-----------------------+-----------------| + | swedish | svenska | | + |-----------------------+-----------------------+-----------------| + | tagalog | | | + |-----------------------+-----------------------+-----------------| + | tamil | | | + |-----------------------+-----------------------+-----------------| + | telugu | | | + |-----------------------+-----------------------+-----------------| + | thai | | | + |-----------------------+-----------------------+-----------------| + | tibetan | | | + |-----------------------+-----------------------+-----------------| + | traditional-chinese | | | + |-----------------------+-----------------------+-----------------| + | turkish | | | + |-----------------------+-----------------------+-----------------| + | twi | | | + |-----------------------+-----------------------+-----------------| + | ukrainian | | | + |-----------------------+-----------------------+-----------------| + | urdu | | | + |-----------------------+-----------------------+-----------------| + | venda | | | + |-----------------------+-----------------------+-----------------| + | venetian | veneto | | + |-----------------------+-----------------------+-----------------| + | vietnamese | | | + |-----------------------+-----------------------+-----------------| + | walloon | walon | | + |-----------------------+-----------------------+-----------------| + | welsh | cymraeg | | + |-----------------------+-----------------------+-----------------| + | wolof | | | + |-----------------------+-----------------------+-----------------| + | xhosa | | | + |-----------------------+-----------------------+-----------------| + | miahuatlan-zapotec | | zapotec | + |-----------------------+-----------------------+-----------------| + | zulu | | zulu | + +-----------------------------------------------------------------+ - --locale LOCALE - Tux Paint で使用する言語を指定します。使用する言語ごとの言語コードの設定（例えば、ドイツ語では - "de_DE"）については、以下の "使用する言語を変更する" の項もごらん下さい。 - （環境変数 "$LANG" - などによって言語環境が設定されている場合は、環境設定が優先されるので、このオプションを設定するは必要ありません。） +--locale LOCALE - mirrorstamps=yes + Tux Paint で使用する言語を指定します。使用する言語ごとの言語コードの設定（ + 例えば、ドイツ語では "de_DE"）については、以下の "使用する言語を変更する" + の項もごらん下さい。 - 反転可能なスタンプは、はじめから反転されるようにします。 + （環境変数 "$LANG" などによって言語環境が設定されている場合は、環境設定が優 + 先されるので、このオプションを設定するは必要ありません。） - 左から右ではなく右から左に向かって描き進むことを好むユーザーに役に立つオプションです。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "mirrorstamps=no" または - "dontmirrorstamps=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--dontmirrorstamps" - で変更できます。 - フォント +mirrorstamps=yes - sysfonts=yes + 反転可能なスタンプは、はじめから反転されるようにします。 - もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux Paint - はパッケージに付属するフォントだけを使用します。 + 左から右ではなく右から左に向かって描き進むことを好むユーザーに役に立つオプ + ションです。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "sysfonts=no" または - "nosysfonts=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--nosysfonts" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "mirrorstamps=no" または "dontmirrorstamps=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--dontmirrorstamps" で変更できます。 - alllocalefonts=yes - バージョン0.9.21以前では、Tux - Paintは、特定の言語のみに固有のもの（例えば、ラテン文字を持たないチベット語のフォントなど）も含めて、fonts - ディレクトリにあるすべてのフォントを読み込んでいました。0.9.21 以降では、Tux Paint - が動作している言語環境に合ったフォントだけが読み込まれます。 - 以前のバージョンのように全てのフォントを読み込むようにするには、このオプションを有効にします。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "alllocalefonts=no" または - "currentlocalefont=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--currentlocalefont" - で変更できます。 +フォント + +sysfonts=yes + + もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux + Paint はパッケージに付属するフォントだけを使用します。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "sysfonts=no" または "nosysfonts=yes" を設定すると上書きされることが + あります。また、どちらの設定も、コマンドラインオプションの "--nosysfonts" + で変更できます。 + + + +alllocalefonts=yes + + バージョン0.9.21以前では、Tux Paintは、特定の言語のみに固有のもの（例えば、 + ラテン文字を持たないチベット語のフォントなど）も含めて、fonts ディレクトリ + にあるすべてのフォントを読み込んでいました。0.9.21 以降では、Tux Paint が動 + 作している言語環境に合ったフォントだけが読み込まれます。 + + 以前のバージョンのように全てのフォントを読み込むようにするには、このオプシ + ョンを有効にします。 + + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "alllocalefonts=no" または "currentlocalefont=yes" を設定すると上書 + きされることがあります。また、どちらの設定も、コマンドラインオプションの + "--currentlocalefont" で変更できます。 + + + +uifont=FONT NAME + + もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux + Paint はパッケージに付属するフォントだけを使用します。 + + "default" を指定すると、規定のフォントが使用されます。（標準の動作） - uifont=FONT NAME - もじツールで、オペレーティングシステムのフォントを使用します。通常では、Tux Paint - はパッケージに付属するフォントだけを使用します。 - "default" を指定すると、規定のフォントが使用されます。（標準の動作） 印刷 - 印刷の制御 +印刷の制御 - noprint=yes +noprint=yes - 印刷を無効にします。 + 印刷を無効にします。 - printdelay=SECONDS - SECONDS で設定した秒数ごとに１回だけしか印刷できなくなります。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "printdelay=0" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--printdelay=0" - で変更できます。 +printdelay=SECONDS - 印刷ダイアログの表示 + SECONDS で設定した秒数ごとに１回だけしか印刷できなくなります。 - altprint=always + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ + イルで "printdelay=0" を設定すると上書きされることがあります。また、どちら + の設定も、コマンドラインオプションの "--printdelay=0" で変更できます。 - "いんさつ" ボタンをクリックすると、常に印刷ダイアログを表示します（Linux と Unix - では、"altprintcommand" で設定したプログラムが起動します）。[Alt] キーを押しながら "いんさつ" - ボタンをクリックするのと同じ動作ですが、毎回 [Alt] キーを押す必要がないということです。 - altprint=never - "いんさつ" ボタンを押したときの [Alt] キーの効果を無効にして、印刷ダイアログが表示されないようにします（Linux と - Unix では、"altprintcommand" で設定したコマンドが起動されなくなります）。 - altprint=mod +印刷ダイアログの表示 - 印刷時の標準の動作です。[Alt] キーを押しながら "いんさつ" ボタンをクリックすると印刷ダイアログが表示され、[Alt] - キーを押さずに "いんさつ" ボタンをクリックすると、ダイアログを表示せずに印刷します。 +altprint=always - 印刷設定の保存 + "いんさつ" ボタンをクリックすると、常に印刷ダイアログを表示します（Linux と + Unix では、"altprintcommand" で設定したプログラムが起動します）。[Alt] キー + を押しながら "いんさつ" ボタンをクリックするのと同じ動作ですが、毎回 [Alt] + キーを押す必要がないということです。 - printcfg=yes - （Windows と macOS のみ） - 印刷の設定をファイルから読み込みます。[Alt] キーを押しながら "いんさつ" ボタンを押すと、Windows - の印刷ダイアログが起動します。 +altprint=never - "printcfg" オプションが設定されていれば、変更した印刷の設定は "userdata/print.cfg" - ファイルに保存され、再利用されます。 + "いんさつ" ボタンを押したときの [Alt] キーの効果を無効にして、印刷ダイアロ + グが表示されないようにします（Linux と Unix では、"altprintcommand" で設定 + したコマンドが起動されなくなります）。 - 💡 注: これはフルスクリーンモードではない場合のみ有効です。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "printcfg=no" または - "noprintcfg=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--noprintcfg" で変更できます。 - 印刷コマンド +altprint=mod - printcommand=COMMAND + 印刷時の標準の動作です。[Alt] キーを押しながら "いんさつ" ボタンをクリック + すると印刷ダイアログが表示され、[Alt] キーを押さずに "いんさつ" ボタンをク + リックすると、ダイアログを表示せずに印刷します。 - (Linux 及び Unix の場合のみ) - "いんさつ" ボタンが押されると、COMMAND で指定したコマンドを用いて PostScript - 形式のファイルを印刷します。標準では以下のコマンドが使用されます: - lpr - 📜 注: バージョン 0.9.15 より前までは、印刷コマンド（標準では "pngtopnm | pnmtops | - lpr"）に PNG 形式のデータを送信していました。 +印刷設定の保存 - このため、バージョン 0.9.15 以前で printcommand を lpr - 以外に設定していた場合は、この設定を変更する必要があります。 + printcfg=yes - altprintcommand=COMMAND + （Windows と macOS のみ） - (Linux 及び Unix の場合のみ) + 印刷の設定をファイルから読み込みます。[Alt] キーを押しながら "いんさつ" + ボタンを押すと、Windows の印刷ダイアログが起動します。 - [Alt] キーを押しながら "いんさつ" ボタンをクリックすると、COMMAND で指定したコマンドを用いて - PostScript 形式のファイルを印刷します。（Windows やmacOSで [Alt] + '印刷' - とすると、印刷ダイアログが表示されるのと似ています） + "printcfg" オプションが設定されていれば、変更した印刷の設定は "userdata + /print.cfg" ファイルに保存され、再利用されます。 - 標準では、以下の KDE の印刷ダイアログが用いられます: + 💡 注: これはフルスクリーンモードではない場合のみ有効です。 - kprinter + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "printcfg=no" または "noprintcfg=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--noprintcfg" で変更できます。 - 用紙サイズ - papersize=PAPERSIZE - （Windows, macOS, BeOS, Haiku を除く、内蔵 PostScript - 出力エンジンを使用するプラットフォーム向け） - 生成する PostScript ファイルの用紙サイズを指定します。指定がなければ、最初に環境変数 $PAPER が、次に - /etc/papersize ファイルがチェックされ、最後に 'libpaper'ライブラリの標準の用紙サイズが使用されます。 + 印刷コマンド - 次のサイズ指定が使えます: letter, legal, tabloid, executive, note, - statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, - b2 b3, b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, - folio, quarto, ledger, archA, archB, archC, archD, archE, flsa, - flse, csheet, dsheet, esheet. + printcommand=COMMAND -保存 + (Linux 及び Unix の場合のみ) - 上書き保存 + "いんさつ" ボタンが押されると、COMMAND で指定したコマンドを用いて + PostScript 形式のファイルを印刷します。標準では以下のコマンドが使用され + ます: - saveover=yes + lpr - 以前の絵を編集して保存するときに、"いまかいたえと まえのえを いれかえる？" - と確認を求めないようにします。この設定では、前の絵は常に上書きされます。 + 📜 注: バージョン 0.9.15 より前までは、印刷コマンド（標準では "pngtopnm + | pnmtops | lpr"）に PNG 形式のデータを送信していました。 - saveover=new + このため、バージョン 0.9.15 以前で printcommand を lpr 以外に設定してい + た場合は、この設定を変更する必要があります。 - 上記と同様に保存の確認を求めないようにしますが、この設定では、前の絵を上書きせずに、常に新しいファイルを作成して保存します。 - saveover=ask - （絵を保存するときの標準の動作なので、この設定は冗長なものとなります） - 以前の絵を編集して保存するときに、以前の絵を上書きするかどうかを尋ねられます。 + altprintcommand=COMMAND - 起動時の設定 + (Linux 及び Unix の場合のみ) - startblank=yes + [Alt] キーを押しながら "いんさつ" ボタンをクリックすると、COMMAND で指 + 定したコマンドを用いて PostScript 形式のファイルを印刷します。（Windows + やmacOSで [Alt] + '印刷' とすると、印刷ダイアログが表示されるのと似てい + ます） - Tux Paint を起動する際、前回最後に開いていた絵を読み込む代わりに、毎回、空のキャンバスで開始します。 + 標準では、以下の KDE の印刷ダイアログが用いられます: - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "startblank=no" または - "startlast=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--startlast" で変更できます。 + kprinter - newcolorslast=yes - 「さいしょから」でキャンバスを選択する際、単色のキャンバスが末尾に、スターター画像やテンプレートが先頭になるよう、表示順序を変更します。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "newcolorslast=no" - または "newcolorsfirst=yes" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--newcolorsfirst" - で変更できます。 - 保存・書き出し先のディレクトリ + 用紙サイズ - savedir=DIRECTORY + papersize=PAPERSIZE - Tux Paint が、作品を保存する "saved" ディレクトリの場所を変更します。 + （Windows, macOS, BeOS, Haiku を除く、内蔵 PostScript 出力エンジンを使 + 用するプラットフォーム向け） - 特に設定していなければ、標準のディレクトリは次の場所にあります: + 生成する PostScript ファイルの用紙サイズを指定します。指定がなければ、 + 最初に環境変数 $PAPER が、次に /etc/papersize ファイルがチェックされ、 + 最後に 'libpaper'ライブラリの標準の用紙サイズが使用されます。 - * Linux および Unix — ユーザーのホームディレクトリ（"~" または "$HOME"）にある隠しディレクトリ - ".tuxpaint" 以下 - 例: /home/username/.tuxpaint/saved/ - * Windows — ユーザーごとの "Application Data" フォルダーにある "TuxPaint" - フォルダー以下 - 例: C:\Documents and Settings\Username\Application - Data\TuxPaint\saved\ - * macOS — ユーザーごとの "Application Support" フォルダーにある "TuxPaint" - フォルダー以下 - 例: /Users/Username/Library/Application - Support/TuxPaint/saved/ + 次のサイズ指定が使えます: letter, legal, tabloid, executive, note, + statement, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, b0, b1, b2 b3, + b4, 10x14, 11x17, halfletter, halfexecutive, halfnote, folio, quarto, + ledger, archA, archB, archC, archD, archE, flsa, flse, csheet, dsheet, + esheet. - 💡 注: Windowsのドライブ（例: "H:\"）を指定する際は、サブディレクトリも指定する必要があります。 - 📜 注: バージョン 0.9.18 - 以前は、作品データ以外に、個人用データファイル（ペイントブラシ、スタンプ、スターター、フォント）を検索する場所としても、"savedir" - の設定を使用していました。バージョン 0.9.18 からは、これらのディレクトリの場所を別途指定することができます（後述の - "datadir" オプションを参照）。 - 例: savedir=Z:\tuxpaint\ - exportdir=DIRECTORY + 保存 - 「かきだす」によって、作品を画像にエクスポートして他で利用する場合や、アニメーションGIFによるスライドショーデータなど、データの出力先のディレクトリを変更します。 + 上書き保存 - 特に設定していなければ、標準のディレクトリは次の場所にあります: + saveover=yes - * Linux および Unix — XDG (X Desktop Group) - 標準に基づく設定が利用可能な場合、個々のデスクトップ環境において画像保存用として設定されているディレクトリ（"xdg-user-dir - PICTURES" コマンドで確認できます） - 英語環境では一般的にユーザーのホームディレクトリ（"$HOME/Pictures" あるいは - "~/Pictures"）以下の "Pictures" ディレクトリになります。（日本語環境では "画像"） - XDGの設定が読み取れない場合や、"XDG_PICTURES_DIR - "に何も設定されていない場合は、上記の英語環境で一般的なディレクトリ（~/Pictures）を使用します。 - * Windows — 各ユーザーの "ピクチャ" ディレクトリ（通常は - "C:\Users\ユーザー名\Pictures"）。 - また、次のようにして、フォルダを直接開くこともできます: - * "[Windows]+[R]" キーを押して "ファイル名を指定して実行" ダイアログを開く。 - * テキストボックスに "Shell:My Pictures" と入力して [OK] を押す。 - * macOS — TBD! + 以前の絵を編集して保存するときに、"いまかいたえとまえのえをいれかえる？ + " と確認を求めないようにします。この設定では、前の絵は常に上書きされま + す。 - 💡 注: 標準では、サブディレクトリ "TuxPaint" が作成されます。（例: - "~/Pictures/TuxPaint"）一方、"--exportdir" - オプションを用いると、指定されたパスがそのまま使用されます（サブディレクトリ "TuxPaint" は作成されません）。 - ディレクトリ（例: "~/Pictures/TuxPaint"）が存在しない場合は新たに作成されます。 - 一つ上の親ディレクトリ（例: - "~/Pictures/TuxPaint"）が存在しない場合もディレクトリの作成を試みますが、それ以上の階層のディレクトリを作成することはありません。 + saveover=new - 例: exportdir=/home/penguin/TuxPaintExports + 上記と同様に保存の確認を求めないようにしますが、この設定では、前の絵を + 上書きせずに、常に新しいファイルを作成して保存します。 - 保存関連の追加オプション - nosave=yes - 絵の保存ができないようにします（"セーブ" - ボタンも無効になります）。一時的なお遊びに使う場合や、テスト環境で使えるオプションです。 + saveover=ask - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nosave=no" または - "save=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--save" - で変更できます。 + （絵を保存するときの標準の動作なので、この設定は冗長なものとなります） + 以前の絵を編集して保存するときに、以前の絵を上書きするかどうかを尋ねら + れます。 - autosave=yes - プログラムを終了するときに、絵を保存するかどうか尋ねずに、自動的に保存します。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "autosave=no" または - "noautosave=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--noautosave" で変更できます。 - reversesort=yes + 起動時の設定 - 「ひらく」と「スライド」のダイアログで、先頭から新しい順に、作品を表示します。 + startblank=yes - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "reversesort=no" または - "noreversesort=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--noreversesort" で変更できます。 + Tux Paint を起動する際、前回最後に開いていた絵を読み込む代わりに、毎回 + 、空のキャンバスで開始します。 -データ + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "startblank=no" または "startlast=yes" を設定すると上書きさ + れることがあります。また、どちらの設定も、コマンドラインオプションの + "--startlast" で変更できます。 - ロックファイル - nolockfile=yes - 標準では、Tux Paint - は「ロックファイル」と呼ばれるものを使用して、30秒間に1回以上起動できないようになっています。これは、シングルクリックのランチャーをダブルクリックしたり、アイコンをせわしなく何度もクリックしたりして、誤って複数回起動してしまうことを防ぐためです。 + newcolorslast=yes - ロックファイルを無視して、起動してから30秒以内であっても再びすぐに実行できるようにするには、設定ファイルでこの設定を有効にするか、コマンドラインで - --nolockfile オプションを指定して Tux Paint を実行してください。 + 「さいしょから」でキャンバスを選択する際、単色のキャンバスが末尾に、ス + ターター画像やテンプレートが先頭になるよう、表示順序を変更します。 - 標準では、Linux および Unix では "~/.tuxpaint/" に、Windows では "userdata\" - にロックファイルが保存されます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "newcolorslast=no" または "newcolorsfirst=yes" を設定すると + 上書きされることがあります。また、どちらの設定も、コマンドラインオプシ + ョンの "--newcolorsfirst" で変更できます。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nolockfile=no" または - "lockfile=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--lockfile" で変更できます。 - データ・ディレクトリ - datadir=DIRECTORY - 個人用データファイル（ペイントブラシ、スタンプ、スターター、テンプレート、個人用のフォント）を検索する場所を変更します。 + 保存・書き出し先のディレクトリ - Tux Paint は、ここで指定されたディレクトリ以下の "brushes", "stamps", "starters", - "templates", and "fonts" という名前のサブディレクトリをそれぞれ検索します。 + savedir=DIRECTORY - 特に設定していなければ、標準のディレクトリは次の場所にあります: + Tux Paint が、作品を保存する "saved" ディレクトリの場所を変更します。 - * Linux および Unix — ユーザーのホームディレクトリ（"~" または "$HOME"）にある隠しディレクトリ - ".tuxpaint" 以下 - 例: /home/username/.tuxpaint/brushes/ - * Windows — ユーザーごとの "Application Data" フォルダーにある "TuxPaint" - フォルダー以下 - 例: C:\Documents and Settings\Username\Application - Data\TuxPaint\brushes\ - * macOS — ユーザーごとの "Application Support" フォルダーにある "TuxPaint" - フォルダー以下 - 例: /Users/Username/Library/Application - Support/TuxPaint/brushes/ + 特に設定していなければ、標準のディレクトリは次の場所にあります: - 📜 注: バージョン 0.9.18 以前では、個人用データの検索先として "savedir" - の指定と同じディレクトリを使用していましたが、0.9.18 以降では個別に設定できるようになりました。 + o Linux および Unix — ユーザーのホームディレクトリ（"~" または + "$HOME"）にある隠しディレクトリ ".tuxpaint" 以下 + 例: /home/username/.tuxpaint/saved/ + o Windows — ユーザーごとの "Application Data" フォルダーにある + "TuxPaint" フォルダー以下 + 例: C:\Documents and Settings\Username\Application Data\TuxPaint\ + saved\ + o macOS — ユーザーごとの "Application Support" フォルダーにある + "TuxPaint" フォルダー以下 + 例: /Users/Username/Library/Application Support/TuxPaint/saved/ - 💡 注: Windowsのドライブ（例: "H:\"）を指定する際は、サブディレクトリも指定する必要があります。 + 💡 注: Windowsのドライブ（例: "H:\"）を指定する際は、サブディレクトリも + 指定する必要があります。 - 例: datadir=/home/johnny/tuxpaint-data/ + 📜 注: バージョン 0.9.18 以前は、作品データ以外に、個人用データファイル + （ペイントブラシ、スタンプ、スターター、フォント）を検索する場所として + も、"savedir" の設定を使用していました。バージョン 0.9.18 からは、これ + らのディレクトリの場所を別途指定することができます（後述の "datadir" オ + プションを参照）。 - カラーパレットファイル + 例: savedir=Z:\tuxpaint\ - colorfile=ファイル名 - お好みのカラーパレットを記述した簡単なテキストファイルを作成して、そのファイル名を "colorfile" - オプションで指定すれば、標準のカラーパレットを置き換えることができます。 - ファイルは、１行ごとに１色のリストです。色は RGB の形式で、各色 0 から 255 - の範囲で指定します。（詳細は、Wikipedia の "RGB" のページを参照して下さい。） + exportdir=DIRECTORY - 各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 - 進数の組からなる6桁または3桁の表記（例: "#ff4488" または "#F48”）で指定します。 + 「かきだす」によって、作品を画像にエクスポートして他で利用する場合や、 + アニメーションGIFによるスライドショーデータなど、データの出力先のディレ + クトリを変更します。 - 色の定義に続いて、色の説明を同じ行に書いておけば、カラーパレットでその色をクリックしたときに Tux - がその説明文を表示します。（例: "#FFF 雪のような白。"） + 特に設定していなければ、標準のディレクトリは次の場所にあります: - 参考となる例として、標準で使われているカラーパレット "default_colors.txt" をご確認ください。 + o Linux および Unix — XDG (X Desktop Group) 標準に基づく設定が利用可 + 能な場合、個々のデスクトップ環境において画像保存用として設定されて + いるディレクトリ（"xdg-user-dir PICTURES" コマンドで確認できます） + 英語環境では一般的にユーザーのホームディレクトリ（"$HOME/Pictures" + あるいは "~/Pictures"）以下の "Pictures" ディレクトリになります。（ + 日本語環境では "画像"） + XDGの設定が読み取れない場合や、"XDG_PICTURES_DIR "に何も設定されて + いない場合は、上記の英語環境で一般的なディレクトリ（~/Pictures）を + 使用します。 + o Windows — 各ユーザーの "ピクチャ" ディレクトリ（通常は "C:\Users\ユ + ーザー名\Pictures"）。 + また、次のようにして、フォルダを直接開くこともできます: + # "[Windows]+[R]" キーを押して "ファイル名を指定して実行" ダイア + ログを開く。 + # テキストボックスに "Shell:My Pictures" と入力して [OK] を押す。 + o macOS — TBD! - 注: 十進数の値は空白文字で区切って記載し、16進数の値は "#" - で始める必要があります。3桁の16進数では、各桁がバイトの上位と下位の両方に使用されるため、"#FFF" は "#F0F0F0" - ではなく "#FFFFFF" を意味します。 + 💡 注: 標準では、サブディレクトリ "TuxPaint" が作成されます。（例: "~/ + Pictures/TuxPaint"）一方、"--exportdir" オプションを用いると、指定され + たパスがそのまま使用されます（サブディレクトリ "TuxPaint" は作成されま + せん）。 -操作方法 + ディレクトリ（例: "~/Pictures/TuxPaint"）が存在しない場合は新たに作成さ + れます。 - マウス + 一つ上の親ディレクトリ（例: "~/Pictures/TuxPaint"）が存在しない場合もデ + ィレクトリの作成を試みますが、それ以上の階層のディレクトリを作成するこ + とはありません。 - mouse-accessibility=yes + 例: exportdir=/home/penguin/TuxPaintExports - 例えば「せん」ツールなどでは、マウスをクリックしてドラッグした後にマウスボタンを放すというのが標準の操作ですが、このモードを設定すると、マウスをクリックしてからマウスを動かした後に再度マウスをクリックするという操作になります。 - キーボード - keyboard=yes - キーボードの矢印キーによるマウスポインターの操作が行えるようにします（マウスが使えない場合や、マウス操作が難しいユーザー向けの機能です） + 保存関連の追加オプション - 使用方法: + nosave=yes - * キャンバスエリアでは、通常はなめらかに、Shift キーを押しながらでは飛び飛びにカーソルが動きます。 - * ツールボタンのエリアでは、飛び飛びにカーソルが動きます。 - * 各キーの動作: - * [Left]/[Right]/[Up]/[Down], テンキーの [1] から [9]: - マウスカーソルの移動 - * [Space]/[5]: マウスクリック（テキストツールまたはラベルツールを使っている場合を除く) - * [Insert]/[F5]: マウスクリック - * [F4]: 「どうぐ」、「いろ」、キャンバスの間を順にジャンプ - * マウスカーソルが左側の「どうぐ」または下部の「いろ」のエリアにある場合: - * [F7]（[F8]）: 上のボタン（下のボタン）に移動（「どうぐ」エリアのみ） - * [F11]（[F12]）: 前のボタン（次のボタン）に移動 - * クリック＆ドラッグの操作は、クリックキーのどちらか（例えば [Insert]）を押しながら、マウス移動のキー（例えば - [Left]）を押します。 + 絵の保存ができないようにします（"セーブ" ボタンも無効になります）。一時 + 的なお遊びに使う場合や、テスト環境で使えるオプションです。 - 💡 注: "mouse-accessibility" - オプションの機能は、キーボードの操作にも連動します。両方のオプションを有効にした場合、例えば線を引く場合は、「クリック」のキーを一度押してから「移動」のキーで描画し、最後にもう一度「クリック」キーを押して描画を完了します。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "nosave=no" または "save=yes" を設定すると上書きされることが + あります。また、どちらの設定も、コマンドラインオプションの "--save" で + 変更できます。 - * 通常のマウスやジョイスティックも同時に使用することができます（例えば、マウスで移動してキーボードでクリックしたり、その逆も可能です）。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "keyboard=no" または - "mouse=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--mouse" で変更できます。 - 画面キーボード + autosave=yes - onscreen-keyboard=yes + プログラムを終了するときに、絵を保存するかどうか尋ねずに、自動的に保存 + します。 - 「もじ」ツールと「ラベル」ツールで、画面キーボードを表示します。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "autosave=no" または "noautosave=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--noautosave" で変更できます。 - onscreen-keyboard-layout=レイアウト名 - もじツールとラベルツールで使用する画面キーボードの初期レイアウトを指定します。 - このオプションが設定されると onscreen-keyboard=yes も設定されているとみなします。 - onscreen-keyboard-disable-change=yes + reversesort=yes - 画面キーボードの変更をできないようにします。小さな子供向けにシンプルにしたい場合に設定します。 - このオプションが設定されると onscreen-keyboard=yes も設定されているとみなします。 + 「ひらく」と「スライド」のダイアログで、先頭から新しい順に、作品を表示 + します。 - ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで - "onscreen-keyboard-disable-change=no" - を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの - "--onscreen-keyboard-disable-change=no" で変更できます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "reversesort=no" または "noreversesort=yes" を設定すると上書 + きされることがあります。また、どちらの設定も、コマンドラインオプション + の "--noreversesort" で変更できます。 -ジョイスティック - デバイスの設定 - joystick-dev=N - 何番目のジョイスティックデバイスを使うかを設定します。標準では 0 （最初のジョイスティック） + データ - joystick-slowness=SPEED + ロックファイル - ジョイスティックの感度を SPEED の値で設定します。0 から 500 までの値が設定できます。標準の値は 15 です。 + nolockfile=yes - joystick-threshold=THRESHOLD + 標準では、Tux Paint は「ロックファイル」と呼ばれるものを使用して、30秒 + 間に1回以上起動できないようになっています。これは、シングルクリックのラ + ンチャーをダブルクリックしたり、アイコンをせわしなく何度もクリックした + りして、誤って複数回起動してしまうことを防ぐためです。 - ジョイスティックでポインターを動かし始めるためのしきい値を THRESHOLD の値で設定します。0 から 32766 - までの値が設定できます。標準の値は 3200 です。 + ロックファイルを無視して、起動してから30秒以内であっても再びすぐに実行 + できるようにするには、設定ファイルでこの設定を有効にするか、コマンドラ + インで --nolockfile オプションを指定して Tux Paint を実行してください。 - joystick-maxsteps=STEPS + 標準では、Linux および Unix では "~/.tuxpaint/" に、Windows では + "userdata\" にロックファイルが保存されます。 - ポインターの移動速度の上限を STEPS にピクセル単位で設定します。1 から 7 までの値が設定可能で、標準の値は 7 です。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "nolockfile=no" または "lockfile=yes" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--lockfile" で変更できます。 - ハットスイッチ - joystick-hat-slowness=SPEED - ハットスイッチの感度を設定します。設定可能な値は 0 から 500 で、標準の値は 15 です。 - joystick-hat-timeout=MILLISECONDS + データ・ディレクトリ - ジョイスティックのハットスイッチを押し続けたときに、ポインターが連続して動き始めるまでの時間を MILLISECONDS - にミリ秒単位で設定します。0 から 3000 までの値が設定可能で、標準の設定は 1000 です。 + datadir=DIRECTORY - ボタンの無効化 + 個人用データファイル（ペイントブラシ、スタンプ、スターター、テンプレー + ト、個人用のフォント）を検索する場所を変更します。 - joystick-buttons-ignore=BUTTON1,BUTTON2,... + Tux Paint は、ここで指定されたディレクトリ以下の "brushes", "stamps", + "starters", "templates", and "fonts" という名前のサブディレクトリをそれ + ぞれ検索します。 - 無効にするジョイスティックのボタンの番号を指定します。何も指定しない場合、上記の "joystick-btn-" - オプションで機能が設定されたボタン以外は、マウスの左ボタンと同じ動作になります。 + 特に設定していなければ、標準のディレクトリは次の場所にあります: - ボタンショートカット + o Linux および Unix — ユーザーのホームディレクトリ（"~" または + "$HOME"）にある隠しディレクトリ ".tuxpaint" 以下 + 例: /home/username/.tuxpaint/brushes/ + o Windows — ユーザーごとの "Application Data" フォルダーにある + "TuxPaint" フォルダー以下 + 例: C:\Documents and Settings\Username\Application Data\TuxPaint\ + brushes\ + o macOS — ユーザーごとの "Application Support" フォルダーにある + "TuxPaint" フォルダー以下 + 例: /Users/Username/Library/Application Support/TuxPaint/brushes/ - joystick-btn-escape=BUTTON NUMBER + 📜 注: バージョン 0.9.18 以前では、個人用データの検索先として "savedir" + の指定と同じディレクトリを使用していましたが、0.9.18 以降では個別に設定 + できるようになりました。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "ESC" キーの機能を割り当てます。（ダイアログの - "もどる" や "やめる" で使います） + 💡 注: Windowsのドライブ（例: "H:\"）を指定する際は、サブディレクトリも + 指定する必要があります。 - joystick-btn-brush=BUTTON NUMBER + 例: datadir=/home/johnny/tuxpaint-data/ - ジョイスティックの BUTTON NUMBER で設定したボタンに "「ふで」ツール" へのショートカットを割り当てます。 - joystick-btn-stamp=BUTTON NUMBER - ジョイスティックの BUTTON NUMBER で設定したボタンに "「はんこ」ツール" へのショートカットを割り当てます。 - joystick-btn-lines=BUTTON NUMBER + カラーパレットファイル - ジョイスティックの BUTTON NUMBER で設定したボタンに "「せん」ツール" へのショートカットを割り当てます。 + colorfile=ファイル名 - joystick-btn-shapes=BUTTON NUMBER + お好みのカラーパレットを記述した簡単なテキストファイルを作成して、その + ファイル名を "colorfile" オプションで指定すれば、標準のカラーパレットを + 置き換えることができます。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "「かたち」ツール" へのショートカットを割り当てます。 + ファイルは、１行ごとに１色のリストです。色は RGB の形式で、各色 0 から + 255 の範囲で指定します。（詳細は、Wikipedia の "RGB" のページを参照して + 下さい。） - joystick-btn-text=BUTTON NUMBER + 各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 + 進数の組からなる6桁または3桁の表記（例: "#ff4488" または "#F48”）で指定 + します。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "「もじ」ツール" へのショートカットを割り当てます。 + 色の定義に続いて、色の説明を同じ行に書いておけば、カラーパレットでその + 色をクリックしたときに Tux がその説明文を表示します。（例: "#FFF 雪のよ + うな白。"） - joystick-btn-label=BUTTON NUMBER + 参考となる例として、標準で使われているカラーパレット " + default_colors.txt" をご確認ください。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "「ラベル」ツール" へのショートカットを割り当てます。 + 注: 十進数の値は空白文字で区切って記載し、16進数の値は "#" で始める必要 + があります。3桁の16進数では、各桁がバイトの上位と下位の両方に使用される + ため、"#FFF" は "#F0F0F0" ではなく "#FFFFFF" を意味します。 - joystick-btn-fill=BUTTON NUMBER - ジョイスティックの BUTTON NUMBER で設定したボタンに "「ぬる」ツール" へのショートカットを割り当てます。 - joystick-btn-magic=BUTTON NUMBER - ジョイスティックの BUTTON NUMBER で設定したボタンに "「まほう」ツール" へのショートカットを割り当てます。 + 操作方法 - joystick-btn-undo=BUTTON NUMBER + マウス - ジョイスティックの BUTTON NUMBER で設定したボタンに "「とりけし」" へのショートカットを割り当てます。 + mouse-accessibility=yes - joystick-btn-redo=BUTTON NUMBER + 例えば「せん」ツールなどでは、マウスをクリックしてドラッグした後にマウ + スボタンを放すというのが標準の操作ですが、このモードを設定すると、マウ + スをクリックしてからマウスを動かした後に再度マウスをクリックするという + 操作になります。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "「やりなおし」" を選択するショートカットを割り当てます。 - joystick-btn-eraser=BUTTON NUMBER - ジョイスティックの BUTTON NUMBER で設定したボタンに "「けしごむ」" を選択するショートカットを割り当てます。 - joystick-btn-new=BUTTON NUMBER + キーボード - ジョイスティックの BUTTON NUMBER で設定したボタンに、「さいしょから」ダイアログへのショートカットを割り当てます。 + keyboard=yes - joystick-btn-open=BUTTON NUMBER + キーボードの矢印キーによるマウスポインターの操作が行えるようにします（ + マウスが使えない場合や、マウス操作が難しいユーザー向けの機能です） - ジョイスティックの BUTTON NUMBER で設定したボタンに、「ひらく」ダイアログへのショートカットを割り当てます。 + 使用方法: - joystick-btn-save=BUTTON NUMBER + o キャンバスエリアでは、通常はなめらかに、Shift キーを押しながらでは + 飛び飛びにカーソルが動きます。 + o ツールボタンのエリアでは、飛び飛びにカーソルが動きます。 + o 各キーの動作: + # [Left]/[Right]/[Up]/[Down], テンキーの [1] から [9]: マウスカー + ソルの移動 + # [Space]/[5]: マウスクリック（テキストツールまたはラベルツールを + 使っている場合を除く) + # [Insert]/[F5]: マウスクリック + # [F4]: 「どうぐ」、「いろ」、キャンバスの間を順にジャンプ + # マウスカーソルが左側の「どうぐ」または下部の「いろ」のエリアに + ある場合: + @ [F7]（[F8]）: 上のボタン（下のボタン）に移動（「どうぐ」エ + リアのみ） + @ [F11]（[F12]）: 前のボタン（次のボタン）に移動 + o クリック＆ドラッグの操作は、クリックキーのどちらか（例えば [Insert] + ）を押しながら、マウス移動のキー（例えば [Left]）を押します。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "「ほぞん」" へのショートカットを割り当てます。 + 💡 注: "mouse-accessibility" オプションの機能は、キーボードの操作に + も連動します。両方のオプションを有効にした場合、例えば線を引く場合 + は、「クリック」のキーを一度押してから「移動」のキーで描画し、最後 + にもう一度「クリック」キーを押して描画を完了します。 - joystick-btn-pgsetup=BUTTON NUMBER + o 通常のマウスやジョイスティックも同時に使用することができます（例え + ば、マウスで移動してキーボードでクリックしたり、その逆も可能です） + 。 - ジョイスティックの BUTTON NUMBER で設定したボタンに "印刷設定ダイアログ" へのショートカットを割り当てます。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "keyboard=no" または "mouse=yes" を設定すると上書きされるこ + とがあります。また、どちらの設定も、コマンドラインオプションの + "--mouse" で変更できます。 - joystick-btn-print=BUTTON NUMBER - ジョイスティックの BUTTON NUMBER で設定したボタンに "「いんさつ」" へのショートカットを割り当てます。 - システム全体の設定を上書きする - （Linux および Unix ユーザー向け） + 画面キーボード - "/etc/tuxpaint/tuxpaint.config" でオプションが設定されている場合でも、ユーザー各自の - "~/.tuxpaintrc" ファイルの設定が優先されます。 + onscreen-keyboard=yes - "noprint" や "grab" のように、真か偽で設定するオプションでは、ユーザー毎の "~/.tuxpaintrc" - ファイルで、例えば次のように、単純に 「'no' に等しい」と設定することができます: + 「もじ」ツールと「ラベル」ツールで、画面キーボードを表示します。 - noprint=no - uppercase=no - また、以下の例のように、コマンドラインオプションによる上書きのように記述することもできます: - print=yes - mixedcase=yes + onscreen-keyboard-layout=レイアウト名 - コマンドラインオプション + もじツールとラベルツールで使用する画面キーボードの初期レイアウトを指定 + します。 + このオプションが設定されると onscreen-keyboard=yes も設定されているとみ + なします。 - 各種オプションは、Tux Paint を起動する際のコマンドラインで指定することもできます。 - --fullscreen - --WIDTHxHEIGHT - --buttonsize=SIZE - --colorsrows=ROWS - --orient=portrait - --native - --allowscreensaver - --startblank - --nosound - --nostereo - --noquit - --noprint - --printdelay=SECONDS - --printcfg - --altprintnever - --altprintalways - --papersize=PAPERSIZE - --printcommand=COMMAND - --altprintcommand=COMMAND - --nolockfile - --simpleshapes - --uppercase - --grab - --noshortcuts - --nowheelmouse - --nobuttondistinction - --nofancycursors - --hidecursor - --nooutlines - --nostamps - --nostampcontrols - --nostamprotation - --nomagiccontrols - --nomagicsizes - --noshapecontrols - --nolabel - --nobrushspacing - --newcolorslast - --mouse-accessibility - --onscreen-keyboard - --onscreen-keyboard-layout - --onscreen-keyboard-disable-change - --joystick-dev - --joystick-slowness - --joystick-threshold - --joystick-maxsteps - --joystick-hat-slowness - --joystick-hat-timeout - --joystick-btn-escape - --joystick-btn-brush - --joystick-btn-stamp - --joystick-btn-lines - --joystick-btn-shapes - --joystick-btn-text - --joystick-btn-label - --joystick-btn-magic - --joystick-btn-undo - --joystick-btn-redo - --joystick-btn-eraser - --joystick-btn-new - --joystick-btn-open - --joystick-btn-save - --joystick-btn-pgsetup - --joystick-btn-print - --joystick-buttons-ignore - --sysfonts - --uifont=FONT NAME - --alllocalefonts - --mirrorstamps - --stampsize=SIZE - --keyboard - --savedir DIRECTORY - --datadir DIRECTORY - --exportdir DIRECTORY - --saveover - --saveovernew - --nosave - --autosave - --reversesort - --lang LANGUAGE - --colorfile FILE - - 以上のオプションは、上記で説明した設定ファイルでの各種オプションと関連しています。 - - --windowed - --800x600 - --orient=landscape - --disablescreensaver - --startlast - --sound - --stereo - --quit - --print - --printdelay=0 - --noprintcfg - --altprintmod - --lockfile - --complexshapes - --mixedcase - --dontgrab - --shortcuts - --wheelmouse - --buttondistinction - --fancycursors - --showcursor - --outlines - --stamps - --stampcontrols - --stamprotation - --magiccontrols - --magicsizes - --shapecontrols - --label - --brushspacing - --newcolorsfirst - --nosysfonts - --currentlocalefont - --uifont=default - --dontmirrorstamps - --stampsize=default - --mouse - --saveoverask - --save - --noautosave - --noreversesort - - 以上のオプションは、設定ファイルでの設定を上書きするために用いられます。（オプションが設定ファイルで指定されていない場合、設定を上書きしないというオプションが必要です） - - --nosysconfig - - Linux および Unix において、システム全体の設定ファイル "/etc/tuxpaint/tuxpaint.conf" - から設定を読み込まないようにします。 - - ユーザーごとの設定ファイル "~/.tuxpaintrc" が存在すれば、このファイルのみから設定を読み込みます。 - -情報を表示するためのコマンドラインオプション - - 以下の各オプションは、Tux Paint を起動せず、情報をテキスト画面に表示して終了します。 - - --version - --verbose-version - - プログラムのバージョンとリリース日を表示します。"--verbose-version" - オプションでは、コンパイル時のオプションも追加で表示します。（ドキュメント "Tux Paint のインストール" および - "よくある質問" もごらんください。） - - --copying - - Tux Paint のライセンスについての情報を表示します。 - - --usage - - 利用可能なコマンドラインオプションの一覧を表示します。 - - --help - - Tux Paint の使い方についての簡単な説明を表示します。 - - --lang help - - Tux Paint で利用可能な言語の一覧を表示します。 - - --joystick-dev list - - 接続されているジョイスティックについて、Tux Paint で利用可能なものの一覧を表示します。 - - 使用する言語の選択 - - Tux Paint は非常に多くの言語に翻訳されています。翻訳された言語で Tux Paint を使うには、コマンドラインオプション - "--lang" を用いて、"--lang spanish" のように指定するか、設定ファイル中の "lang=" オプションを用いて - "lang=spanish" のように指定します。 - - また、Tux Paint はお使いの環境の言語設定にも従います。（"--locale" - オプションにより環境の設定を上書きすることができます。前述の説明もごらんください） - - "--lang help" オプションを用いれば、利用可能な言語の一覧が表示されます。 - -利用可能な言語 - - +----------------------------------------------------------------------+ - |言語コード |言語名 |言語名 |入力切り替えキー | - | |（原語表記） |（英語表記） | | - |----------------+---------------------+-------------------+-----------| - |C | |English | | - |----------------+---------------------+-------------------+-----------| - |ach_UG |Acoli |Acholi | | - |----------------+---------------------+-------------------+-----------| - |af_ZA | |Afrikaans | | - |----------------+---------------------+-------------------+-----------| - |ak_GH | |Akan | | - |----------------+---------------------+-------------------+-----------| - |am_ET | |Amharic | | - |----------------+---------------------+-------------------+-----------| - |an_ES | |Aragones | | - |----------------+---------------------+-------------------+-----------| - |ar_SA | |Arabic | | - |----------------+---------------------+-------------------+-----------| - |as_IN | |Assamese | | - |----------------+---------------------+-------------------+-----------| - |ast_ES | |Asturian | | - |----------------+---------------------+-------------------+-----------| - |az_AZ | |Azerbaijani | | - |----------------+---------------------+-------------------+-----------| - |bm_ML | |Bambara | | - |----------------+---------------------+-------------------+-----------| - |bn_IN | |Bengali | | - |----------------+---------------------+-------------------+-----------| - |be_BY |Bielaruskaja |Belarusian | | - |----------------+---------------------+-------------------+-----------| - |bg_BG | |Bulgarian | | - |----------------+---------------------+-------------------+-----------| - |bo_CN (*) | |Tibetan | | - |----------------+---------------------+-------------------+-----------| - |br_FR |Brezhoneg |Breton | | - |----------------+---------------------+-------------------+-----------| - |brx_IN | |Bodo | | - |----------------+---------------------+-------------------+-----------| - |bs_BA | |Bosnian | | - |----------------+---------------------+-------------------+-----------| - |ca_ES |Català |Catalan | | - |----------------+---------------------+-------------------+-----------| - |ca_ES@valencia |Valencia |Valencian | | - |----------------+---------------------+-------------------+-----------| - |cgg_UG |Chiga |Kiga | | - |----------------+---------------------+-------------------+-----------| - |cs_CZ |Cesky |Czech | | - |----------------+---------------------+-------------------+-----------| - |cy_GB |Cymraeg |Welsh | | - |----------------+---------------------+-------------------+-----------| - |da_DK |Dansk |Danish | | - |----------------+---------------------+-------------------+-----------| - |de_DE |Deutsch |German | | - |----------------+---------------------+-------------------+-----------| - |doi_IN | |Dogri | | - |----------------+---------------------+-------------------+-----------| - |et_EE | |Estonian | | - |----------------+---------------------+-------------------+-----------| - |el_GR (*) | |Greek | | - |----------------+---------------------+-------------------+-----------| - |en_AU | |Australian English | | - |----------------+---------------------+-------------------+-----------| - |en_CA | |Canadian English | | - |----------------+---------------------+-------------------+-----------| - |en_GB | |British English | | - |----------------+---------------------+-------------------+-----------| - |en_ZA | |South African | | - | | |English | | - |----------------+---------------------+-------------------+-----------| - |eo | |Esperanto | | - |----------------+---------------------+-------------------+-----------| - |es_ES |Español |Spanish | | - |----------------+---------------------+-------------------+-----------| - |es_MX |Español-Mejicano |Mexican Spanish | | - |----------------+---------------------+-------------------+-----------| - |eu_ES |Euskara |Basque | | - |----------------+---------------------+-------------------+-----------| - |fa_IR | |Persian | | - |----------------+---------------------+-------------------+-----------| - |ff_SN |Fulah |Fula | | - |----------------+---------------------+-------------------+-----------| - |fi_FI |Suomi |Finnish | | - |----------------+---------------------+-------------------+-----------| - |fo_FO | |Faroese | | - |----------------+---------------------+-------------------+-----------| - |fr_FR |Français |French | | - |----------------+---------------------+-------------------+-----------| - |ga_IE |Gàidhlig |Irish Gaelic | | - |----------------+---------------------+-------------------+-----------| - |gd_GB |Ghaidhlig |Scottish Gaelic | | - |----------------+---------------------+-------------------+-----------| - |gl_ES |Galego |Galician | | - |----------------+---------------------+-------------------+-----------| - |gos_NL |Zudelk Veenkelonioals|Gronings | | - |----------------+---------------------+-------------------+-----------| - |gu_IN | |Gujarati | | - |----------------+---------------------+-------------------+-----------| - |he_IL (*) | |Hebrew | | - |----------------+---------------------+-------------------+-----------| - |hi_IN (*) | |Hindi | | - |----------------+---------------------+-------------------+-----------| - |hr_HR |Hrvatski |Croatian | | - |----------------+---------------------+-------------------+-----------| - |hu_HU |Magyar |Hungarian | | - |----------------+---------------------+-------------------+-----------| - |hy_AM |Hayeren |Armenian | | - |----------------+---------------------+-------------------+-----------| - |id_ID |Bahasa Indonesia |Indonesian | | - |----------------+---------------------+-------------------+-----------| - |is_IS |Íslenska |Icelandic | | - |----------------+---------------------+-------------------+-----------| - |it_IT |Italiano |Italian | | - |----------------+---------------------+-------------------+-----------| - |iu_CA | |Inuktitut | | - |----------------+---------------------+-------------------+-----------| - |ja_JP (*) | |Japanese |右 [Alt] または| - | | | |左 [Alt] | - |----------------+---------------------+-------------------+-----------| - |ka_GE | |Georgian | | - |----------------+---------------------+-------------------+-----------| - |kab | |Kabyle | | - |----------------+---------------------+-------------------+-----------| - |km_KH | |Khmer | | - |----------------+---------------------+-------------------+-----------| - |kn_IN | |Kannada | | - |----------------+---------------------+-------------------+-----------| - |ko_KR (*) | |Korean |右 [Alt] または| - | | | |左 [Alt] | - |----------------+---------------------+-------------------+-----------| - |kok_IN | |Konkani | | - | | |(Devanagari) | | - |----------------+---------------------+-------------------+-----------| - |kok@roman | |Konkani (Roman) | | - |----------------+---------------------+-------------------+-----------| - |ks_IN@devanagari| |Kashmiri | | - | | |(Devanagari) | | - |----------------+---------------------+-------------------+-----------| - |ks_IN | |Kashmiri | | - | | |(Perso-Arabic) | | - |----------------+---------------------+-------------------+-----------| - |ku_TR | |Kurdish | | - |----------------+---------------------+-------------------+-----------| - |lb_LU |Letzebuergesch |Luxembourgish | | - |----------------+---------------------+-------------------+-----------| - |lg_UG | |Luganda | | - |----------------+---------------------+-------------------+-----------| - |lt_LT |Lietuviu |Lithuanian | | - |----------------+---------------------+-------------------+-----------| - |lv_LV | |Latvian | | - |----------------+---------------------+-------------------+-----------| - |mk_MK | |Macedonian | | - |----------------+---------------------+-------------------+-----------| - |mai_IN | |Maithili | | - |----------------+---------------------+-------------------+-----------| - |ml_IN | |Malayalam | | - |----------------+---------------------+-------------------+-----------| - |mn_MN | |Mongolian | | - |----------------+---------------------+-------------------+-----------| - |mni_IN | |Manipuri (Bengali) | | - |----------------+---------------------+-------------------+-----------| - |mni@meiteimayek | |Manipuri (Meitei | | - | | |Mayek) | | - |----------------+---------------------+-------------------+-----------| - |mr_IN | |Marathi | | - |----------------+---------------------+-------------------+-----------| - |ms_MY | |Malay | | - |----------------+---------------------+-------------------+-----------| - |nb_NO |Norsk (bokmål) |Norwegian Bokmål | | - |----------------+---------------------+-------------------+-----------| - |ne_NP |Nepali | | | - |----------------+---------------------+-------------------+-----------| - |nl_NL | |Dutch | | - |----------------+---------------------+-------------------+-----------| - |nn_NO |Norsk (nynorsk) |Norwegian Nynorsk | | - |----------------+---------------------+-------------------+-----------| - |nr_ZA | |Ndebele | | - |----------------+---------------------+-------------------+-----------| - |nso_ZA |Sesotho sa Leboa |Northern Sotho | | - |----------------+---------------------+-------------------+-----------| - |oc_FR | |Occitan | | - |----------------+---------------------+-------------------+-----------| - |oj_CA |Ojibwe |Ojibway | | - |----------------+---------------------+-------------------+-----------| - |pa_IN | |Punjabi | | - |----------------+---------------------+-------------------+-----------| - |or_IN |Odia |Oriya | | - |----------------+---------------------+-------------------+-----------| - |pl_PL |Polski |Polish | | - |----------------+---------------------+-------------------+-----------| - |pt_BR |Portugês Brazileiro |Brazilian | | - | | |Portuguese | | - |----------------+---------------------+-------------------+-----------| - |pt_PT |Portugês |Portuguese | | - |----------------+---------------------+-------------------+-----------| - |ro_RO | |Romanian | | - |----------------+---------------------+-------------------+-----------| - |ru_RU |Russkiy |Russian | | - |----------------+---------------------+-------------------+-----------| - |rw_RW | |Kinyarwanda | | - |----------------+---------------------+-------------------+-----------| - |sa_IN | |Sanskrit | | - |----------------+---------------------+-------------------+-----------| - |sat_IN | |Santali | | - | | |(Devanagari) | | - |----------------+---------------------+-------------------+-----------| - |sat@olchiki | |Santali (Ol-Chikii)| | - |----------------+---------------------+-------------------+-----------| - |shs_CA |Secwepemctin |Shuswap | | - |----------------+---------------------+-------------------+-----------| - |si_LK | |Sinhala | | - |----------------+---------------------+-------------------+-----------| - |sd_IN@devanagari| |Sindhi (Devanagari)| | - |----------------+---------------------+-------------------+-----------| - |sd_IN | |Sindhi | | - |----------------+---------------------+-------------------+-----------| - |sk_SK | |Slovak | | - |----------------+---------------------+-------------------+-----------| - |sl_SI | |Slovenian | | - |----------------+---------------------+-------------------+-----------| - |son | |Songhay | | - |----------------+---------------------+-------------------+-----------| - |sq_AL | |Albanian | | - |----------------+---------------------+-------------------+-----------| - |sr_YU | |Serbian (cyrillic) | | - |----------------+---------------------+-------------------+-----------| - |sr_RS@latin | |Serbian (latin) | | - |----------------+---------------------+-------------------+-----------| - |su_ID | |Sundanese | | - |----------------+---------------------+-------------------+-----------| - |sv_SE |Svenska |Swedish | | - |----------------+---------------------+-------------------+-----------| - |sw_TZ | |Swahili | | - |----------------+---------------------+-------------------+-----------| - |ta_IN (*) | |Tamil | | - |----------------+---------------------+-------------------+-----------| - |te_IN (*) | |Telugu | | - |----------------+---------------------+-------------------+-----------| - |th_TH (*) | |Thai | | - |----------------+---------------------+-------------------+-----------| - |tl_PH (*) | |Tagalog | | - |----------------+---------------------+-------------------+-----------| - |tlh |tlhIngan |Klingon | | - |----------------+---------------------+-------------------+-----------| - |tr_TR | |Turkish | | - |----------------+---------------------+-------------------+-----------| - |tw_GH | |Twi | | - |----------------+---------------------+-------------------+-----------| - |uk_UA | |Ukrainian | | - |----------------+---------------------+-------------------+-----------| - |ur_IN | |Urdu | | - |----------------+---------------------+-------------------+-----------| - |ve_ZA | |Venda | | - |----------------+---------------------+-------------------+-----------| - |vec |Venèto |Venetian | | - |----------------+---------------------+-------------------+-----------| - |vi_VN | |Vietnamese | | - |----------------+---------------------+-------------------+-----------| - |wa_BE | |Walloon | | - |----------------+---------------------+-------------------+-----------| - |wo_SN | |Wolof | | - |----------------+---------------------+-------------------+-----------| - |xh_ZA | |Xhosa | | - |----------------+---------------------+-------------------+-----------| - |zh_CN (*) | |Chinese | | - | | |(Simplified) | | - |----------------+---------------------+-------------------+-----------| - |zh_TW (*) | |Chinese | | - | | |(Traditional) | | - |----------------+---------------------+-------------------+-----------| - |zam | |Zapotec | | - | | |(Miahuatlan) | | - |----------------+---------------------+-------------------+-----------| - |zu_ZA | |Zulu | | - +----------------------------------------------------------------------+ - - (*) - これらの原語では専用のフォントが必要です。以下の"言語固有のフォント"の項をごらんください。 - - 💡 注: - いくつかの言語では、もじツールでの入力に、その言語用の入力方式が利用できます。もじツールが有効になっているときに、上の表に示されたキーの組み合わせを使えば、利用可能な入力方式を順に切り替えることができます。 - -環境で使用する言語の設定 - - システムの言語を変更すると環境に大きな影響があります。 - - ここまでで説明したとおり、コマンドラインオプション（"--lang" および "--locale"）を用いて実行時に言語を選択できるほか、Tux - Paint は、お使いのシステムの言語環境の設定を参照します。 - - 言語環境を設定するやり方は以下のとおりです: - - Linux または Unix のユーザー - - まず最初に、使用したい言語が有効になるように "/etc/locale.gen" ファイルを確認、編集した後、管理者権限で - "locale-gen" コマンドを実行します。 - - 💡 注: Debian Linux のユーザーは、"dpkg-reconfigure locales" - というコマンドを管理者権限で実行すれば、ダイアログ形式で設定を行えます。Ubuntu では、"localeconf" - パッケージがインストールされていれば "sudo dpkg-reconfigure localeconf" - というコマンドが使えます。また、"/usr/share/i18n/SUPPORTED" ファイルにある言語のリストの中から、使用したい言語を - "/var/lib/locales/supported.d/local" ファイルに追加するという方法もあります。 - - 次に、Tux Paint を起動する前に、環境変数 "$LANG" - を上記のリストの言語コードのいずれかに設定します。（言語の設定を、全てのプログラムに適用したい場合は、以下の設定をログインスクリプト（"~/.profile", - "~/.bashrc", "~/.cshrc" など）に記述する方法もあります。 - - BASH などの Bourne Shell 系列の環境の場合: - - export LANG=es_ES ; \ - tuxpaint - - TCSH などの C Shell 系列の場合: - - setenv LANG es_ES ; \ - tuxpaint - - Windows のユーザー - - 何もしなくても、利用している言語環境に応じて適切な設定が用いられますので、以下は、他の言語で利用したい場合のための説明になります。 - - ショートカットに "--lang" スイッチを記述するのが最も簡単です（"Tux Paint - のインストール"のドキュメントを参照）。また、コマンドプロンプトで、以下のようなコマンドを実行する方法もあります: - - set LANG=es_ES - - ... この言語指定は、実行したコマンドプロンプトウィンドウが終了するまでの間だけ有効となります。 - - 常にこの言語設定を有効にするには、以下のようにして、"システムのプロパティ" ダイアログで環境変数を設定します: - - * "[Windows]+[R]" キーを押して "ファイル名を指定して実行" ダイアログを開く。 - * テキストボックスに "sysdm.cpl" と入力して "[OK]" ボタンを押し、"システムのプロパティ" ダイアログを開く。 - * "詳細設定" タブを選択。 - * "環境変数(N)..." ボタンをクリック。 - * 環境変数 "LANG" の値を編集。（変数が設定されていなければ新たに作成） - -言語固有のフォント - - いくつかの言語では、専用のフォントが必要になります。TrueType（TTF）形式のフォントファイルは、サイズが非常に大きいので、Tux - Paint のダウンロードファイルには含めず、個別にダウンロードできるようにしています。（"使用する言語の選択"の項の表を参照してください） - 📜 注: バージョン 0.9.18 の時点で、Tux Paint では SDL_ttf - ライブラリを直接には使わず、テキストレンダリングライブラリ "Pango" をSDL経由で使うための "SDL_Pango" - ライブラリを用いています。お使いの Tux Paint が Pango - のサポートを無効にしてコンパイルされていない限り、言語固有のフォントは必要ありません + onscreen-keyboard-disable-change=yes - 固有のフォントを必要とする言語で Tux Paint を使用する場合、システム全体の "fonts" ディレクトリ（"locale" - 以下にあります）からフォントファイルを読み込みます。フォントファイルのファイル名は、言語コードの最初の2文字と対応します（例えば、韓国語では - "ko"、日本語では "ja"、繁体中国語では "zh_tw" となります）。 + 画面キーボードの変更をできないようにします。小さな子供向けにシンプルに + したい場合に設定します。 + このオプションが設定されると onscreen-keyboard=yes も設定されているとみ + なします。 - 例えば、Linux や Unix では、（例えば "--lang korean" オプションをつけて）韓国語で Tux Paint - を使う場合、次のファイルを読み込もうとします。 + ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定 + ファイルで "onscreen-keyboard-disable-change=no" を設定すると上書きされ + ることがあります。また、どちらの設定も、コマンドラインオプションの + "--onscreen-keyboard-disable-change=no" で変更できます。 - /usr/share/tuxpaint/fonts/locale/ko.ttf - サポートされる言語用のフォントファイルは、Tux Paint のウェブサイト https://www.tuxpaint.org/ - からダウンロードできます。（'ダウンロード' ページの 'フォント' セクションにあります） - Unix や Linux では、同梱の Makefile を使って、適切な場所にフォントをインストールすることができます。 + + ジョイスティック + + デバイスの設定 + + joystick-dev=N + + 何番目のジョイスティックデバイスを使うかを設定します。標準では 0 （最初 + のジョイスティック） + + + + joystick-slowness=SPEED + + ジョイスティックの感度を SPEED の値で設定します。0 から 500 までの値が + 設定できます。標準の値は 15 です。 + + + + joystick-threshold=THRESHOLD + + ジョイスティックでポインターを動かし始めるためのしきい値を THRESHOLD の + 値で設定します。0 から 32766 までの値が設定できます。標準の値は 3200 で + す。 + + + + joystick-maxsteps=STEPS + + ポインターの移動速度の上限を STEPS にピクセル単位で設定します。1 から 7 + までの値が設定可能で、標準の値は 7 です。 + + + + + ハットスイッチ + + joystick-hat-slowness=SPEED + + ハットスイッチの感度を設定します。設定可能な値は 0 から 500 で、標準の + 値は 15 です。 + + + + joystick-hat-timeout=MILLISECONDS + + ジョイスティックのハットスイッチを押し続けたときに、ポインターが連続し + て動き始めるまでの時間を MILLISECONDS にミリ秒単位で設定します。0 から + 3000 までの値が設定可能で、標準の設定は 1000 です。 + + + + + ボタンの無効化 + + joystick-buttons-ignore=BUTTON1,BUTTON2,... + + 無効にするジョイスティックのボタンの番号を指定します。何も指定しない場 + 合、上記の "joystick-btn-" オプションで機能が設定されたボタン以外は、マ + ウスの左ボタンと同じ動作になります。 + + + + +ボタンショートカット + + joystick-btn-escape=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "ESC" キーの機能を + 割り当てます。（ダイアログの "もどる" や "やめる" で使います） + + + + joystick-btn-brush=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「ふで」ツール" へ + のショートカットを割り当てます。 + + + + joystick-btn-stamp=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「はんこ」ツール" + へのショートカットを割り当てます。 + + + + joystick-btn-lines=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「せん」ツール" へ + のショートカットを割り当てます。 + + + + joystick-btn-shapes=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「かたち」ツール" + へのショートカットを割り当てます。 + + + + joystick-btn-text=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「もじ」ツール" へ + のショートカットを割り当てます。 + + + + joystick-btn-label=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「ラベル」ツール" + へのショートカットを割り当てます。 + + + + joystick-btn-fill=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「ぬる」ツール" へ + のショートカットを割り当てます。 + + + + joystick-btn-magic=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「まほう」ツール" + へのショートカットを割り当てます。 + + + + joystick-btn-undo=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「とりけし」" への + ショートカットを割り当てます。 + + + + joystick-btn-redo=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「やりなおし」" を + 選択するショートカットを割り当てます。 + + + + joystick-btn-eraser=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「けしごむ」" を選 + 択するショートカットを割り当てます。 + + + + joystick-btn-new=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに、「さいしょから」ダ + イアログへのショートカットを割り当てます。 + + + + joystick-btn-open=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに、「ひらく」ダイアロ + グへのショートカットを割り当てます。 + + + + joystick-btn-save=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「ほぞん」" へのシ + ョートカットを割り当てます。 + + + + joystick-btn-pgsetup=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "印刷設定ダイアログ + " へのショートカットを割り当てます。 + + + + joystick-btn-print=BUTTON NUMBER + + ジョイスティックの BUTTON NUMBER で設定したボタンに "「いんさつ」" への + ショートカットを割り当てます。 + + + + + システム全体の設定を上書きする + + （Linux および Unix ユーザー向け） + + "/etc/tuxpaint/tuxpaint.config" でオプションが設定されている場合でも、ユー + ザー各自の "~/.tuxpaintrc" ファイルの設定が優先されます。 + + "noprint" や "grab" のように、真か偽で設定するオプションでは、ユーザー毎の + "~/.tuxpaintrc" ファイルで、例えば次のように、単純に「'no' に等しい」と設定 + することができます: + + noprint=no + uppercase=no + + また、以下の例のように、コマンドラインオプションによる上書きのように記述す + ることもできます: + + print=yes + mixedcase=yes + + コマンドラインオプション + + 各種オプションは、Tux Paint を起動する際のコマンドラインで指定することもで + きます。 + + --fullscreen + --WIDTHxHEIGHT + --buttonsize=SIZE + --colorsrows=ROWS + --orient=portrait + --native + --allowscreensaver + --startblank + --nosound + --nostereo + --noquit + --noprint + --printdelay=SECONDS + --printcfg + --altprintnever + --altprintalways + --papersize=PAPERSIZE + --printcommand=COMMAND + --altprintcommand=COMMAND + --nolockfile + --simpleshapes + --uppercase + --grab + --noshortcuts + --nowheelmouse + --nobuttondistinction + --nofancycursors + --hidecursor + --nooutlines + --nostamps + --nostampcontrols + --nostamprotation + --nomagiccontrols + --nomagicsizes + --noshapecontrols + --nolabel + --nobrushspacing + --newcolorslast + --mouse-accessibility + --onscreen-keyboard + --onscreen-keyboard-layout + --onscreen-keyboard-disable-change + --joystick-dev + --joystick-slowness + --joystick-threshold + --joystick-maxsteps + --joystick-hat-slowness + --joystick-hat-timeout + --joystick-btn-escape + --joystick-btn-brush + --joystick-btn-stamp + --joystick-btn-lines + --joystick-btn-shapes + --joystick-btn-text + --joystick-btn-label + --joystick-btn-magic + --joystick-btn-undo + --joystick-btn-redo + --joystick-btn-eraser + --joystick-btn-new + --joystick-btn-open + --joystick-btn-save + --joystick-btn-pgsetup + --joystick-btn-print + --joystick-buttons-ignore + --sysfonts + --uifont=FONT NAME + --alllocalefonts + --mirrorstamps + --stampsize=SIZE + --keyboard + --savedir DIRECTORY + --datadir DIRECTORY + --exportdir DIRECTORY + --saveover + --saveovernew + --nosave + --autosave + --reversesort + --lang LANGUAGE + --colorfile FILE + + 以上のオプションは、上記で説明した設定ファイルでの各種オプションと関連 + しています。 + + + + --windowed + --800x600 + --orient=landscape + --disablescreensaver + --startlast + --sound + --stereo + --quit + --print + --printdelay=0 + --noprintcfg + --altprintmod + --lockfile + --complexshapes + --mixedcase + --dontgrab + --shortcuts + --wheelmouse + --buttondistinction + --fancycursors + --showcursor + --outlines + --stamps + --stampcontrols + --stamprotation + --magiccontrols + --magicsizes + --shapecontrols + --label + --brushspacing + --newcolorsfirst + --nosysfonts + --currentlocalefont + --uifont=default + --dontmirrorstamps + --stampsize=default + --mouse + --saveoverask + --save + --noautosave + --noreversesort + + 以上のオプションは、設定ファイルでの設定を上書きするために用いられます + 。（オプションが設定ファイルで指定されていない場合、設定を上書きしない + というオプションが必要です） + + + + --nosysconfig + + Linux および Unix において、システム全体の設定ファイル "/etc/tuxpaint/ + tuxpaint.conf" から設定を読み込まないようにします。 + + ユーザーごとの設定ファイル "~/.tuxpaintrc" が存在すれば、このファイルの + みから設定を読み込みます。 + + + + + 情報を表示するためのコマンドラインオプション + + 以下の各オプションは、Tux Paint を起動せず、情報をテキスト画面に表示して終 + 了します。 + + --version + --verbose-version + + プログラムのバージョンとリリース日を表示します。"--verbose-version" オ + プションでは、コンパイル時のオプションも追加で表示します。（ドキュメン + ト "Tux Paint のインストール" および "よくある質問" もごらんください。 + ） + + + + --copying + + Tux Paint のライセンスについての情報を表示します。 + + + + --usage + + 利用可能なコマンドラインオプションの一覧を表示します。 + + + + --help + + Tux Paint の使い方についての簡単な説明を表示します。 + + + + --lang help + + Tux Paint で利用可能な言語の一覧を表示します。 + + + + --joystick-dev list + + 接続されているジョイスティックについて、Tux Paint で利用可能なものの一 + 覧を表示します。 + + + + + 使用する言語の選択 + + Tux Paint は非常に多くの言語に翻訳されています。翻訳された言語で Tux Paint + を使うには、コマンドラインオプション "--lang" を用いて、"--lang spanish" の + ように指定するか、設定ファイル中の "lang=" オプションを用いて "lang= + spanish" のように指定します。 + + また、Tux Paint はお使いの環境の言語設定にも従います。（"--locale" オプショ + ンにより環境の設定を上書きすることができます。前述の説明もごらんください） + + "--lang help" オプションを用いれば、利用可能な言語の一覧が表示されます。 + + 利用可能な言語 + + +-------------------------------------------------------------------------+ + | 言語コード | 言語名 | 言語名 | 入力切り替えキ | + | | （原語表記） | （英語表記） | ー | + |------------------+------------------+-----------------+-----------------| + | C | | English | | + |------------------+------------------+-----------------+-----------------| + | ach_UG | Acoli | Acholi | | + |------------------+------------------+-----------------+-----------------| + | af_ZA | | Afrikaans | | + |------------------+------------------+-----------------+-----------------| + | ak_GH | | Akan | | + |------------------+------------------+-----------------+-----------------| + | am_ET | | Amharic | | + |------------------+------------------+-----------------+-----------------| + | an_ES | | Aragones | | + |------------------+------------------+-----------------+-----------------| + | ar_SA | | Arabic | | + |------------------+------------------+-----------------+-----------------| + | as_IN | | Assamese | | + |------------------+------------------+-----------------+-----------------| + | ast_ES | | Asturian | | + |------------------+------------------+-----------------+-----------------| + | az_AZ | | Azerbaijani | | + |------------------+------------------+-----------------+-----------------| + | bm_ML | | Bambara | | + |------------------+------------------+-----------------+-----------------| + | bn_IN | | Bengali | | + |------------------+------------------+-----------------+-----------------| + | be_BY | Bielaruskaja | Belarusian | | + |------------------+------------------+-----------------+-----------------| + | bg_BG | | Bulgarian | | + |------------------+------------------+-----------------+-----------------| + | bo_CN (*) | | Tibetan | | + |------------------+------------------+-----------------+-----------------| + | br_FR | Brezhoneg | Breton | | + |------------------+------------------+-----------------+-----------------| + | brx_IN | | Bodo | | + |------------------+------------------+-----------------+-----------------| + | bs_BA | | Bosnian | | + |------------------+------------------+-----------------+-----------------| + | ca_ES | Català | Catalan | | + |------------------+------------------+-----------------+-----------------| + | ca_ES@valencia | Valencia | Valencian | | + |------------------+------------------+-----------------+-----------------| + | cgg_UG | Chiga | Kiga | | + |------------------+------------------+-----------------+-----------------| + | cs_CZ | Cesky | Czech | | + |------------------+------------------+-----------------+-----------------| + | cy_GB | Cymraeg | Welsh | | + |------------------+------------------+-----------------+-----------------| + | da_DK | Dansk | Danish | | + |------------------+------------------+-----------------+-----------------| + | de_DE | Deutsch | German | | + |------------------+------------------+-----------------+-----------------| + | doi_IN | | Dogri | | + |------------------+------------------+-----------------+-----------------| + | et_EE | | Estonian | | + |------------------+------------------+-----------------+-----------------| + | el_GR (*) | | Greek | | + |------------------+------------------+-----------------+-----------------| + | en_AU | | Australian | | + | | | English | | + |------------------+------------------+-----------------+-----------------| + | en_CA | | Canadian | | + | | | English | | + |------------------+------------------+-----------------+-----------------| + | en_GB | | British English | | + |------------------+------------------+-----------------+-----------------| + | en_ZA | | South African | | + | | | English | | + |------------------+------------------+-----------------+-----------------| + | eo | | Esperanto | | + |------------------+------------------+-----------------+-----------------| + | es_ES | Español | Spanish | | + |------------------+------------------+-----------------+-----------------| + | es_MX | Español-Mejicano | Mexican Spanish | | + |------------------+------------------+-----------------+-----------------| + | eu_ES | Euskara | Basque | | + |------------------+------------------+-----------------+-----------------| + | fa_IR | | Persian | | + |------------------+------------------+-----------------+-----------------| + | ff_SN | Fulah | Fula | | + |------------------+------------------+-----------------+-----------------| + | fi_FI | Suomi | Finnish | | + |------------------+------------------+-----------------+-----------------| + | fo_FO | | Faroese | | + |------------------+------------------+-----------------+-----------------| + | fr_FR | Français | French | | + |------------------+------------------+-----------------+-----------------| + | ga_IE | Gàidhlig | Irish Gaelic | | + |------------------+------------------+-----------------+-----------------| + | gd_GB | Ghaidhlig | Scottish Gaelic | | + |------------------+------------------+-----------------+-----------------| + | gl_ES | Galego | Galician | | + |------------------+------------------+-----------------+-----------------| + | gos_NL | Zudelk | Gronings | | + | | Veenkelonioals | | | + |------------------+------------------+-----------------+-----------------| + | gu_IN | | Gujarati | | + |------------------+------------------+-----------------+-----------------| + | he_IL (*) | | Hebrew | | + |------------------+------------------+-----------------+-----------------| + | hi_IN (*) | | Hindi | | + |------------------+------------------+-----------------+-----------------| + | hr_HR | Hrvatski | Croatian | | + |------------------+------------------+-----------------+-----------------| + | hu_HU | Magyar | Hungarian | | + |------------------+------------------+-----------------+-----------------| + | hy_AM | Hayeren | Armenian | | + |------------------+------------------+-----------------+-----------------| + | id_ID | Bahasa Indonesia | Indonesian | | + |------------------+------------------+-----------------+-----------------| + | is_IS | Íslenska | Icelandic | | + |------------------+------------------+-----------------+-----------------| + | it_IT | Italiano | Italian | | + |------------------+------------------+-----------------+-----------------| + | iu_CA | | Inuktitut | | + |------------------+------------------+-----------------+-----------------| + | ja_JP (*) | | Japanese | 右 [Alt] または | + | | | | 左 [Alt] | + |------------------+------------------+-----------------+-----------------| + | ka_GE | | Georgian | | + |------------------+------------------+-----------------+-----------------| + | kab | | Kabyle | | + |------------------+------------------+-----------------+-----------------| + | km_KH | | Khmer | | + |------------------+------------------+-----------------+-----------------| + | kn_IN | | Kannada | | + |------------------+------------------+-----------------+-----------------| + | ko_KR (*) | | Korean | 右 [Alt] または | + | | | | 左 [Alt] | + |------------------+------------------+-----------------+-----------------| + | kok_IN | | Konkani | | + | | | (Devanagari) | | + |------------------+------------------+-----------------+-----------------| + | kok@roman | | Konkani (Roman) | | + |------------------+------------------+-----------------+-----------------| + | ks_IN@devanagari | | Kashmiri | | + | | | (Devanagari) | | + |------------------+------------------+-----------------+-----------------| + | ks_IN | | Kashmiri | | + | | | (Perso-Arabic) | | + |------------------+------------------+-----------------+-----------------| + | ku_TR | | Kurdish | | + |------------------+------------------+-----------------+-----------------| + | lb_LU | Letzebuergesch | Luxembourgish | | + |------------------+------------------+-----------------+-----------------| + | lg_UG | | Luganda | | + |------------------+------------------+-----------------+-----------------| + | lt_LT | Lietuviu | Lithuanian | | + |------------------+------------------+-----------------+-----------------| + | lv_LV | | Latvian | | + |------------------+------------------+-----------------+-----------------| + | mk_MK | | Macedonian | | + |------------------+------------------+-----------------+-----------------| + | mai_IN | | Maithili | | + |------------------+------------------+-----------------+-----------------| + | ml_IN | | Malayalam | | + |------------------+------------------+-----------------+-----------------| + | mn_MN | | Mongolian | | + |------------------+------------------+-----------------+-----------------| + | mni_IN | | Manipuri | | + | | | (Bengali) | | + |------------------+------------------+-----------------+-----------------| + | mni@meiteimayek | | Manipuri | | + | | | (Meitei Mayek) | | + |------------------+------------------+-----------------+-----------------| + | mr_IN | | Marathi | | + |------------------+------------------+-----------------+-----------------| + | ms_MY | | Malay | | + |------------------+------------------+-----------------+-----------------| + | nb_NO | Norsk (bokmål) | Norwegian | | + | | | Bokmål | | + |------------------+------------------+-----------------+-----------------| + | ne_NP | Nepali | | | + |------------------+------------------+-----------------+-----------------| + | nl_NL | | Dutch | | + |------------------+------------------+-----------------+-----------------| + | nn_NO | Norsk (nynorsk) | Norwegian | | + | | | Nynorsk | | + |------------------+------------------+-----------------+-----------------| + | nr_ZA | | Ndebele | | + |------------------+------------------+-----------------+-----------------| + | nso_ZA | Sesotho sa Leboa | Northern Sotho | | + |------------------+------------------+-----------------+-----------------| + | oc_FR | | Occitan | | + |------------------+------------------+-----------------+-----------------| + | oj_CA | Ojibwe | Ojibway | | + |------------------+------------------+-----------------+-----------------| + | pa_IN | | Punjabi | | + |------------------+------------------+-----------------+-----------------| + | or_IN | Odia | Oriya | | + |------------------+------------------+-----------------+-----------------| + | pl_PL | Polski | Polish | | + |------------------+------------------+-----------------+-----------------| + | pt_BR | Portugês | Brazilian | | + | | Brazileiro | Portuguese | | + |------------------+------------------+-----------------+-----------------| + | pt_PT | Portugês | Portuguese | | + |------------------+------------------+-----------------+-----------------| + | ro_RO | | Romanian | | + |------------------+------------------+-----------------+-----------------| + | ru_RU | Russkiy | Russian | | + |------------------+------------------+-----------------+-----------------| + | rw_RW | | Kinyarwanda | | + |------------------+------------------+-----------------+-----------------| + | sa_IN | | Sanskrit | | + |------------------+------------------+-----------------+-----------------| + | sat_IN | | Santali | | + | | | (Devanagari) | | + |------------------+------------------+-----------------+-----------------| + | sat@olchiki | | Santali | | + | | | (Ol-Chikii) | | + |------------------+------------------+-----------------+-----------------| + | shs_CA | Secwepemctin | Shuswap | | + |------------------+------------------+-----------------+-----------------| + | si_LK | | Sinhala | | + |------------------+------------------+-----------------+-----------------| + | sd_IN@devanagari | | Sindhi | | + | | | (Devanagari) | | + |------------------+------------------+-----------------+-----------------| + | sd_IN | | Sindhi | | + |------------------+------------------+-----------------+-----------------| + | sk_SK | | Slovak | | + |------------------+------------------+-----------------+-----------------| + | sl_SI | | Slovenian | | + |------------------+------------------+-----------------+-----------------| + | son | | Songhay | | + |------------------+------------------+-----------------+-----------------| + | sq_AL | | Albanian | | + |------------------+------------------+-----------------+-----------------| + | sr_YU | | Serbian | | + | | | (cyrillic) | | + |------------------+------------------+-----------------+-----------------| + | sr_RS@latin | | Serbian (latin) | | + |------------------+------------------+-----------------+-----------------| + | su_ID | | Sundanese | | + |------------------+------------------+-----------------+-----------------| + | sv_SE | Svenska | Swedish | | + |------------------+------------------+-----------------+-----------------| + | sw_TZ | | Swahili | | + |------------------+------------------+-----------------+-----------------| + | ta_IN (*) | | Tamil | | + |------------------+------------------+-----------------+-----------------| + | te_IN (*) | | Telugu | | + |------------------+------------------+-----------------+-----------------| + | th_TH (*) | | Thai | | + |------------------+------------------+-----------------+-----------------| + | tl_PH (*) | | Tagalog | | + |------------------+------------------+-----------------+-----------------| + | tlh | tlhIngan | Klingon | | + |------------------+------------------+-----------------+-----------------| + | tr_TR | | Turkish | | + |------------------+------------------+-----------------+-----------------| + | tw_GH | | Twi | | + |------------------+------------------+-----------------+-----------------| + | uk_UA | | Ukrainian | | + |------------------+------------------+-----------------+-----------------| + | ur_IN | | Urdu | | + |------------------+------------------+-----------------+-----------------| + | ve_ZA | | Venda | | + |------------------+------------------+-----------------+-----------------| + | vec | Venèto | Venetian | | + |------------------+------------------+-----------------+-----------------| + | vi_VN | | Vietnamese | | + |------------------+------------------+-----------------+-----------------| + | wa_BE | | Walloon | | + |------------------+------------------+-----------------+-----------------| + | wo_SN | | Wolof | | + |------------------+------------------+-----------------+-----------------| + | xh_ZA | | Xhosa | | + |------------------+------------------+-----------------+-----------------| + | zh_CN (*) | | Chinese | | + | | | (Simplified) | | + |------------------+------------------+-----------------+-----------------| + | zh_TW (*) | | Chinese | | + | | | (Traditional) | | + |------------------+------------------+-----------------+-----------------| + | zam | | Zapotec | | + | | | (Miahuatlan) | | + |------------------+------------------+-----------------+-----------------| + | zu_ZA | | Zulu | | + +-------------------------------------------------------------------------+ + + (*) - これらの原語では専用のフォントが必要です。以下の"言語固有のフォント" + の項をごらんください。 + + 💡 注: いくつかの言語では、もじツールでの入力に、その言語用の入力方式が利用 + できます。もじツールが有効になっているときに、上の表に示されたキーの組み合 + わせを使えば、利用可能な入力方式を順に切り替えることができます。 + + 環境で使用する言語の設定 + + システムの言語を変更すると環境に大きな影響があります。 + + ここまでで説明したとおり、コマンドラインオプション（"--lang" および + "--locale"）を用いて実行時に言語を選択できるほか、Tux Paint は、お使いのシ + ステムの言語環境の設定を参照します。 + + 言語環境を設定するやり方は以下のとおりです: + + Linux または Unix のユーザー + + まず最初に、使用したい言語が有効になるように "/etc/locale.gen" ファイルを確 + 認、編集した後、管理者権限で "locale-gen" コマンドを実行します。 + + 💡 注: Debian Linux のユーザーは、"dpkg-reconfigure locales" というコマンド + を管理者権限で実行すれば、ダイアログ形式で設定を行えます。Ubuntu では、 + "localeconf" パッケージがインストールされていれば "sudo dpkg-reconfigure + localeconf" というコマンドが使えます。また、"/usr/share/i18n/SUPPORTED" フ + ァイルにある言語のリストの中から、使用したい言語を "/var/lib/locales/ + supported.d/local" ファイルに追加するという方法もあります。 + + 次に、Tux Paint を起動する前に、環境変数 "$LANG" を上記のリストの言語コード + のいずれかに設定します。（言語の設定を、全てのプログラムに適用したい場合は + 、以下の設定をログインスクリプト（"~/.profile", "~/.bashrc", "~/.cshrc" な + ど）に記述する方法もあります。 + + BASH などの Bourne Shell 系列の環境の場合: + + export LANG=es_ES ; \ + tuxpaint + + TCSH などの C Shell 系列の場合: + + setenv LANG es_ES ; \ + tuxpaint + + Windows のユーザー + + 何もしなくても、利用している言語環境に応じて適切な設定が用いられますので、 + 以下は、他の言語で利用したい場合のための説明になります。 + + ショートカットに "--lang" スイッチを記述するのが最も簡単です（"Tux Paint の + インストール"のドキュメントを参照）。また、コマンドプロンプトで、以下のよう + なコマンドを実行する方法もあります: + + set LANG=es_ES + + ... この言語指定は、実行したコマンドプロンプトウィンドウが終了するまでの間 + だけ有効となります。 + + 常にこの言語設定を有効にするには、以下のようにして、"システムのプロパティ" + ダイアログで環境変数を設定します: + + + "[Windows]+[R]" キーを押して "ファイル名を指定して実行" ダイアログを開 + く。 + + テキストボックスに "sysdm.cpl" と入力して "[OK]" ボタンを押し、"システ + ムのプロパティ" ダイアログを開く。 + + "詳細設定" タブを選択。 + + "環境変数(N)..." ボタンをクリック。 + + 環境変数 "LANG" の値を編集。（変数が設定されていなければ新たに作成） + + 言語固有のフォント + + いくつかの言語では、専用のフォントが必要になります。TrueType（TTF）形式のフ + ォントファイルは、サイズが非常に大きいので、Tux Paint のダウンロードファイ + ルには含めず、個別にダウンロードできるようにしています。（"使用する言語の選 + 択"の項の表を参照してください） + + 📜 注: バージョン 0.9.18 の時点で、Tux Paint では SDL_ttf ライブラリを直接に + は使わず、テキストレンダリングライブラリ "Pango" をSDL経由で使うための + "SDL_Pango" ライブラリを用いています。お使いの Tux Paint が Pango のサポー + トを無効にしてコンパイルされていない限り、言語固有のフォントは必要ありませ + ん + + 固有のフォントを必要とする言語で Tux Paint を使用する場合、システム全体の " + fonts" ディレクトリ（"locale" 以下にあります）からフォントファイルを読み込 + みます。フォントファイルのファイル名は、言語コードの最初の2文字と対応します + （例えば、韓国語では "ko"、日本語では "ja"、繁体中国語では "zh_tw" となりま + す）。 + + 例えば、Linux や Unix では、（例えば "--lang korean" オプションをつけて）韓 + 国語で Tux Paint を使う場合、次のファイルを読み込もうとします。 + + /usr/share/tuxpaint/fonts/locale/ko.ttf + + サポートされる言語用のフォントファイルは、Tux Paint のウェブサイト https:// + www.tuxpaint.org/ からダウンロードできます。（'ダウンロード' ページの 'フォ + ント' セクションにあります） + + Unix や Linux では、同梱の Makefile を使って、適切な場所にフォントをインス + トールすることができます。 + diff --git a/docs/ja_JP.UTF-8/PNG.txt b/docs/ja_JP.UTF-8/PNG.txt index 6861d03df..bf1542384 100644 --- a/docs/ja_JP.UTF-8/PNG.txt +++ b/docs/ja_JP.UTF-8/PNG.txt @@ -1,88 +1,92 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 PNG Documentation - Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照. + Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2022年6月 4日 + 2022年6月 4日 - About PNGs +About PNGs - 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 - not "lossy" like JPEGs - lossiness allows files to be much smaller, but - introduces 'mistakes' in the image when saved), and supports 24-bit color - (16.7 million colors) as well as a full "alpha channel" - that is, each - pixel can have a varying degree of transparency. +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 not +"lossy" like JPEGs - lossiness allows files to be much smaller, but introduces +'mistakes' in the image when saved), and supports 24-bit color (16.7 million +colors) as well as a full "alpha channel" - that is, each pixel can have a +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) - make it the best choice for Tux Paint. (Tux Paint's support for the PNG - format comes from the Open Source SDL_Image library, which in turn gets it - from the libPNG library.) +These features (openness, losslessness, compression, transparency/alpha) make +it the best choice for Tux Paint. (Tux Paint's support for the PNG format comes +from the Open Source SDL_Image library, which in turn gets it from the libPNG +library.) - Support for many colors allows photo-quality "rubber stamp" images to be - used in Tux Paint, and alpha transparency allows for high-quality brushes. +Support for many colors allows photo-quality "rubber stamp" images to be used +in Tux Paint, and alpha transparency allows for high-quality brushes. How To Make PNGs - The following is a very brief list of ways to create PNGs or convert - existing images into PNGs. +The following is a very brief list of ways to create PNGs or convert existing +images into PNGs. - GIMP & Krita +GIMP & Krita - Excellent tools with which to create PNG images for use in Tux - Paint are GIMP and Krita, both high-quality Open Source - interactive drawing and photo editing programs. + Excellent tools with which to create PNG images for use in Tux Paint are + GIMP and Krita, both high-quality Open Source interactive drawing and photo + 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 - NetPBM - The Portable Bitmap tools (collectively known as - "NetPBM") is a collection of Open Source command-line - tools which convert to and from various formats, - including GIF, TIFF, BMP, PNG, and many more. +Command-line Tools - 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/. + NetPBM - cjpeg/djpeg + The Portable Bitmap tools (collectively known as "NetPBM") is a + collection of Open Source command-line tools which convert to and from + various formats, 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/. + + + + cjpeg/djpeg + + The "cjpeg" and "djpeg" command-line programs convert between the + NetPBM Portable Any Map (PNM) format and JPEGs. 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 https://jpegclub.org/. + + + + + + +Proprietary Software for Windows + + CorelDRAW (Corel) — http://www.corel.com/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Paint Shop Pro (Corel) — https://www.paintshoppro.com/ + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html + + PIXresizer (Bluefive software) — http://bluefive.pair.com/ + pixresizer.htm + + +Macintosh Users + + CorelDRAW (Corel) — http://www.corel.com/ + + GraphicConverter (Lemke Software) — https://www.lemkesoft.de/ + mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Photoshop (Adobe) — http://www.adobe.com/products/photoshop.html - The "cjpeg" and "djpeg" command-line programs convert - between the NetPBM Portable Any Map (PNM) format and - JPEGs. 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 - https://jpegclub.org/. - Proprietary Software for Windows - * CorelDRAW (Corel) — http://www.corel.com/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Paint Shop Pro (Corel) — https://www.paintshoppro.com/ - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html - * PIXresizer (Bluefive software) — - http://bluefive.pair.com/pixresizer.htm - Macintosh Users - * CorelDRAW (Corel) — http://www.corel.com/ - * GraphicConverter (Lemke Software) — - https://www.lemkesoft.de/mac-fotobearbeitung-mac-diashow-mac-grafikprogramm-mac-bildbetrachter/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Photoshop (Adobe) — - http://www.adobe.com/products/photoshop.html diff --git a/docs/ja_JP.UTF-8/README.txt b/docs/ja_JP.UTF-8/README.txt index b8d26c2d1..1a865891c 100644 --- a/docs/ja_JP.UTF-8/README.txt +++ b/docs/ja_JP.UTF-8/README.txt @@ -1,921 +1,1251 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 - 子供向けのシンプルなお絵かきプログラム + 子供向けのシンプルなお絵かきプログラム - Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. + Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2023年7月13日 + 2023年7月13日 - +---------------------------------------+ - |目次 | - |---------------------------------------| - |I. Tux Paint について | - |II. Tux Paint の使い方 | - | A. Tux Paint の起動 | - | B. 起動画面 | - | C. メインの画面 | - | D. 各種のツール | - | 1. 描画ツール | - | a. ペイントブラシ「ふで」 | - | b. 「はんこ」ツール | - | c. 「せん」ツール | - | d. 「かたち」ツール | - | e. 「もじ」ツール、「ラベル」ツール | - | f. 「ぬる」ツール | - | g. 「まほう」ツール（特殊効果） | - | h. けしゴム | - | 2. そのほかの操作 | - | a. 「とりけし」と「やりなおし」 | - | b. 「さいしょから」 | - | c. 「ひらく」 | - | d. 「セーブ」 | - | e. 「いんさつ」 | - | f. 「スライドショー」 | - | g. プログラムの終了 | - | h. 効果音を消すには | - | E. 操作方法 | - |III. 他の画像の Tux Paint への読み込み | - |IV. その他のドキュメント | - |V. お問い合わせ先 | - |VI. プロジェクトへの参加 | - +---------------------------------------+ ++--------------------------------------------------+ +| 目次 | +|--------------------------------------------------| +| I. Tux Paint について | +| II. Tux Paint の使い方 | +| A. Tux Paint の起動 | +| B. 起動画面 | +| C. メインの画面 | +| D. 各種のツール | +| 1. 描画ツール | +| a. ペイントブラシ「ふで」 | +| b. 「はんこ」ツール | +| c. 「せん」ツール | +| d. 「かたち」ツール | +| e. 「もじ」ツール、「ラベル」ツール | +| f. 「ぬる」ツール | +| g. 「まほう」ツール（特殊効果） | +| h. けしゴム | +| 2. そのほかの操作 | +| a. 「とりけし」と「やりなおし」 | +| b. 「さいしょから」 | +| c. 「ひらく」 | +| d. 「セーブ」 | +| e. 「いんさつ」 | +| f. 「スライドショー」 | +| g. プログラムの終了 | +| h. 効果音を消すには | +| E. 操作方法 | +| III. 他の画像の Tux Paint への読み込み | +| IV. その他のドキュメント | +| V. お問い合わせ先 | +| VI. プロジェクトへの参加 | ++--------------------------------------------------+ - I. Tux Paint について +I. Tux Paint について A. "Tux Paint" とは？ - Tux Paint - は、３歳以上の小さな子供向けにデザインされたフリーのお絵かきソフトです。シンプルで使いやすい操作方法と楽しい効果音を備え、マスコットキャラクターが子供たちの案内役を務めます。空っぽのキャンバスと様々な描画ツールが、子供たちの創造力をかき立てます。 +Tux Paint は、３歳以上の小さな子供向けにデザインされたフリーのお絵かきソフトで +す。シンプルで使いやすい操作方法と楽しい効果音を備え、マスコットキャラクターが +子供たちの案内役を務めます。空っぽのキャンバスと様々な描画ツールが、子供たちの +創造力をかき立てます。 B. 特長 - 簡単に、そして楽しく - Tux Paint - は、一般向けの描画ツールではなく、小さな子供のためのシンプルなお絵かきソフトとなることを目指して、楽しく容易に使えるように作られています。効果音とマスコットキャラクターが、プログラムの操作をわかりやすく教えてくれるとともに、ユーザーを楽しませてくれます。また、大きくて見やすいイラスト調のマウスポインターを採用しています。 +簡単に、そして楽しく + Tux Paint は、一般向けの描画ツールではなく、小さな子供のためのシンプルなお + 絵かきソフトとなることを目指して、楽しく容易に使えるように作られています。 + 効果音とマスコットキャラクターが、プログラムの操作をわかりやすく教えてくれ + るとともに、ユーザーを楽しませてくれます。また、大きくて見やすいイラスト調 + のマウスポインターを採用しています。 - 拡張性 - Tux Paint - は、機能を拡張することができます。「ふで」や「はんこ」は、追加や削除が可能です。例えば、授業では、様々な生き物の画像を追加しておいて、生徒に生態系を描かせるといったことができます。それぞれの「はんこ」には、選択時に流れる音声、表示される説明文を設定できます。 +拡張性 + Tux Paint は、機能を拡張することができます。「ふで」や「はんこ」は、追加や + 削除が可能です。例えば、授業では、様々な生き物の画像を追加しておいて、生徒 + に生態系を描かせるといったことができます。それぞれの「はんこ」には、選択時 + に流れる音声、表示される説明文を設定できます。 - 移植性 - Tux Paint は、Windows, Macintosh, Linux - など、様々なプラットフォームに移植されており、どのプラットフォームでも見た目や使い方は変わりません。Tux Paint - は、Pentium 133のような旧式のシステムでもうまく動作し、さらに遅いシステムでも動作するように構築することもできます。 +移植性 + Tux Paint は、Windows, Macintosh, Linux など、様々なプラットフォームに移植 + されており、どのプラットフォームでも見た目や使い方は変わりません。Tux Paint + は、Pentium 133のような旧式のシステムでもうまく動作し、さらに遅いシステムで + も動作するように構築することもできます。 - 簡単な操作 - ユーザーは、コンピューターの複雑な機能に直接触れる必要がありません。描画中の作品は、プログラム終了時に保存され、再開時に表示されます。作品を保存するために、ファイル名をつけたりキーボードを使う必要はありません。保存された作品は、縮小画像の一覧から選択するだけで読み込むことができ、コンピューターの他のファイルにアクセスすることはありません。 +簡単な操作 + ユーザーは、コンピューターの複雑な機能に直接触れる必要がありません。描画中 + の作品は、プログラム終了時に保存され、再開時に表示されます。作品を保存する + ために、ファイル名をつけたりキーボードを使う必要はありません。保存された作 + 品は、縮小画像の一覧から選択するだけで読み込むことができ、コンピューターの + 他のファイルにアクセスすることはありません。 + +操作方法 + Tux Paint には、ボタンのサイズ拡大、UIフォントの変更、キーボードや他の入力 + デバイス（ジョイスティック、ゲームパッドなど）を用いたカーソル操作、オンス + クリーンキーボード、マウスクリックの固定など、操作性に関する多くのオプショ + ンが用意されています。 - 操作方法 - Tux Paint - には、ボタンのサイズ拡大、UIフォントの変更、キーボードや他の入力デバイス（ジョイスティック、ゲームパッドなど）を用いたカーソル操作、オンスクリーンキーボード、マウスクリックの固定など、操作性に関する多くのオプションが用意されています。 C. 著作権 - Tux Paint - は、オープンソースのプロジェクトで、GNUの一般公衆利用許諾（GPL）基づき公開されているフリーソフトウェアです。このソフトウェアは無料で、プログラムのソースコードが利用可能です。（これにより、誰でも、機能を追加したり、不具合を修正したり、プログラムの一部を自分のGPLソフトウェアに使用することができます。） +Tux Paint は、オープンソースのプロジェクトで、GNUの一般公衆利用許諾（GPL）基づ +き公開されているフリーソフトウェアです。このソフトウェアは無料で、プログラムの +ソースコードが利用可能です。（これにより、誰でも、機能を追加したり、不具合を修 +正したり、プログラムの一部を自分のGPLソフトウェアに使用することができます。） - ライセンスの全文は、COPYING.txtをお読みください。 +ライセンスの全文は、COPYING.txtをお読みください。 D. Tux Paint バージョン 0.9.31 での変更点 - ぼかし消しゴム - 消しゴムツールに端がぼやけた丸い消しゴムが追加されました +ぼかし消しゴム + 消しゴムツールに端がぼやけた丸い消しゴムが追加されました - 「まほう」ツールの追加 - 「ループ」「リボン」「なめらかなせん」「くしゃくしゃ」 +「まほう」ツールの追加 + 「ループ」「リボン」「なめらかなせん」「くしゃくしゃ」 - 独自テンプレートの作成機能 - 「ひらく」ダイアログの新しいオプションにより、保存した作品をテンプレートに変換し、新規に絵を作成する際に使用ることができます。(この機能は簡略化オプション - "notemplateexport" を使用して無効にすることができます)。 +独自テンプレートの作成機能 + 「ひらく」ダイアログの新しいオプションにより、保存した作品をテンプレートに + 変換し、新規に絵を作成する際に使用ることができます。(この機能は簡略化オプシ + ョン "notemplateexport" を使用して無効にすることができます)。 - ユーザーインターフェースフォントの指定 - ボタンラベル、ポップアップダイアログ、操作ガイドなどのユーザーインターフェイスに使用されるフォントを変更することができます。("uifont"オプションを参照。利用可能なフォントは"-listfonts"オプションで確認できます) +ユーザーインターフェースフォントの指定 + ボタンラベル、ポップアップダイアログ、操作ガイドなどのユーザーインターフェ + イスに使用されるフォントを変更することができます。("uifont"オプションを参照 + 。利用可能なフォントは"-listfonts"オプションで確認できます) - 削除の無効化 - 保存した作品や自作のテンプレートを削除するボタンを無効にすることができます。(設定オプション"noerase"を参照) +削除の無効化 - Tux Paint の操作の説明を追加 - マウスやタブレット、タッチスクリーン、ジョイスティック、キーボードなど、各種のデバイスを用いた Tux Paint - の操作方法の概要が README ドキュメントに追加されました。 + 保存した作品や自作のテンプレートを削除するボタンを無効にすることができます + 。(設定オプション"noerase"を参照) - 全ての変更点については、CHANGES.txt をお読みください。 +Tux Paint の操作の説明を追加 - II. Tux Paint の使い方 + マウスやタブレット、タッチスクリーン、ジョイスティック、キーボードなど、各 + 種のデバイスを用いた Tux Paint の操作方法の概要が README ドキュメントに追加 + されました。 + + +全ての変更点については、CHANGES.txt をお読みください。 + +II. Tux Paint の使い方 A. Tux Paint の起動 - 1. Linux または Unix のユーザー +1. Linux または Unix のユーザー - KDE あるいは GNOME のメニューの「グラフィックス」以下に、起動アイコンが設定されているはずです。 +KDE あるいは GNOME のメニューの「グラフィックス」以下に、起動アイコンが設定され +ているはずです。 - その他、シェルプロンプト（例: "$"）で次のコマンドを実行する方法があります: +その他、シェルプロンプト（例: "$"）で次のコマンドを実行する方法があります: - $ tuxpaint + $ tuxpaint - エラーが発生した場合は、端末にその内容が表示されます。（標準エラー出力） +エラーが発生した場合は、端末にその内容が表示されます。（標準エラー出力） - 2. Windows のユーザー +2. Windows のユーザー - [Tux Paint アイコン] - Tux Paint +[Tux Paint アイコン] + Tux Paint - インストーラーを用いて Tux Paint - をインストールする際、スタート・メニューやデスクトップにショートカットを作成するかどうかが選択できます。ショートカットを作成していれば、これらのアイコンから簡単に - Tux Paint を起動できます。 +インストーラーを用いて Tux Paint をインストールする際、スタート・メニューやデス +クトップにショートカットを作成するかどうかが選択できます。ショートカットを作成 +していれば、これらのアイコンから簡単に Tux Paint を起動できます。 - ポータブル版（ZIPファイル版）をダウンロードして Tux Paint - をインストールした場合や、インストーラーでショートカットを作成しなかった場合は、"Tux Paint"のフォルダにある "tuxpaint.exe" - のアイコンをダブルクリックします。 +ポータブル版（ZIPファイル版）をダウンロードして Tux Paint をインストールした場 +合や、インストーラーでショートカットを作成しなかった場合は、"Tux Paint"のフォル +ダにある "tuxpaint.exe" のアイコンをダブルクリックします。 - インストーラーを用いた場合、「Tux Paint」のフォルダは、通常、"C:\Program Files\" - に配置されます。（インストール時に、これを変更することもできます） +インストーラーを用いた場合、「Tux Paint」のフォルダは、通常、"C:\Program Files\ +" に配置されます。（インストール時に、これを変更することもできます） - ZIP ファイルを用いた場合、「Tux Paint」のフォルダは、任意の場所に配置できます。 +ZIP ファイルを用いた場合、「Tux Paint」のフォルダは、任意の場所に配置できます。 - 3. macOS のユーザー +3. macOS のユーザー - "Tux Paint" のアイコンをダブルクリックします。 +"Tux Paint" のアイコンをダブルクリックします。 - [起動画面] +[起動画面] B. 起動画面 - Tux Paint を起動すると、タイトル画面が表示されます。 +Tux Paint を起動すると、タイトル画面が表示されます。 - プログラムの読み込みが完了すると、何かキーを押すかマウスのクリックにより次に進みます。（タイトル画面は、約5秒後に自動的に閉じます） +プログラムの読み込みが完了すると、何かキーを押すかマウスのクリックにより次に進 +みます。（タイトル画面は、約5秒後に自動的に閉じます） C. メインの画面 - メインの画面は、次の各部に分けられます: +メインの画面は、次の各部に分けられます: - [どうぐ: ふで, はんこ, せん, かたち, もじ, まほう, ラベル, とりけし, やりなおし, けしゴム, さいしょから, ひらく, セーブ, - いんさつ, やめる] +[どうぐ: ふで, はんこ, せん, かたち, もじ, まほう, ラベル, とりけし, やりなお + し, けしゴム, さいしょから, ひらく, セーブ, いんさつ, やめる] +左側: ツールバー「どうぐ」 - 左側: ツールバー「どうぐ」 + ツールバーには、描画や編集を行うためのアイコンがあります。 - ツールバーには、描画や編集を行うためのアイコンがあります。 - [描画キャンバス] - 中央部: 描画キャンバス + [描画キャンバス] +中央部: 描画キャンバス - 中央部の最も広い領域が描画キャンバスです。ここが絵を描く部分になります！ + 中央部の最も広い領域が描画キャンバスです。ここが絵を描く部分になります！ - 💡 注: 描画キャンバスのサイズは、Tux Paint のウィンドウサイズに応じて変わります。Tux Paint - のウィンドウサイズは、Tux Paint - 設定ツールを用いて変更できます。その他の方法については、各種設定についてのドキュメントを参照してください。 + 💡 注: 描画キャンバスのサイズは、Tux Paint のウィンドウサイズに応じて変わり + ます。Tux Paint のウィンドウサイズは、Tux Paint 設定ツールを用いて変更でき + ます。その他の方法については、各種設定についてのドキュメントを参照してくだ + さい。 - [セレクタ - ふで、もじ、かたち、はんこ] - 右側: セレクタ - セレクタに表示される内容は、使用しているツールに応じて変わります。例えば、「ふで」ツールでは、様々な種類の筆が表示され、「はんこ」ツールでは、はんこの画像が表示されます。 + [セレクタ - ふで、もじ、かたち、はんこ] +右側: セレクタ - [いろ - いろ - くろ、しろ、あか、ぴんく、おれんじ、きいろ、みどり、みずいろ、あお、むらさき、ちゃいろ、はいいろ] + セレクタに表示される内容は、使用しているツールに応じて変わります。例えば、 + 「ふで」ツールでは、様々な種類の筆が表示され、「はんこ」ツールでは、はんこ + の画像が表示されます。 - 下部: カラーパレット「いろ」 - 使用中のツールが色をサポートしている場合、画面の下部付近に色の選択肢がパレットで表示されます。このパレットをクリックして色を選択すると、その色がツールで使用されます。(例えば、「ふで」ツールでは選択したブラシで描く色として、「ぬる」ツールでは画像の領域を塗りつぶす色として使用します)。 - 右端には色に関する3つの特別なオプションがあります。 - * スポイト - スポイトを使えば、絵の中から色を選ぶことができます。 - （この機能を使うためのショートカットキーがあります; 以降を参照） - * レインボーパレット - レインボーパレットは、色相、彩度、明度を選択することで、任意の色を選ぶことができます。 左側のボックスには、 - 数百段階の色相 — 上部の赤から下部の紫まで — が、数百段階の彩度 — 左側の淡い色から右側の純色まで — - で表示されます。縦のグレーの領域では、数百段階で、明度 — 上部が最も明るく、下部が最も暗い — を選ぶことができます。 - 緑色のチェックボタンをクリックして色を確定します。「もどる」ボタンをクリックすると、色を選択せずにポップアップを終了します。 - このツールの選択色に次のいずれかの色をセットすることもできます: - * 組み込みのカラーパレットから選んだ色 - * スポイトで選んだ色 - * カラーミキサーで選んだ色 - * カラーミキサー - 絵の具のパレットのようなアイコンの「カラーミキサー」では、加法混色の三原色 — - 赤、青、黄と、白（色合い）、グレー（色調）、黒（濃淡）を混ぜて色を作成することができます。 - どのボタンも複数回クリックできます（例えば、赤 + 赤 + 黄 - とクリックすると、赤橙色になります）。混合された色の比率は画面下部に表示されます。 - 「さいしょから」ボタンをクリックすると、最初からやり直す（色がない状態に戻す）ことができます。また、間違えた場合は、手順を何回でも取り消したり、やり直したりすることができます（最初からやり直す必要はありません）。 - 緑色のチェックボタンをクリックして色を確定します。「もどる」ボタンをクリックすると、色を選択せずにポップアップを終了します。 + [いろ - いろ - くろ、しろ、あか、ぴんく、おれんじ、きいろ、みどり、みずいろ + 、あお、むらさき、ちゃいろ、はいいろ] +下部: カラーパレット「いろ」 - ⌨ - 使用中のツールが色をサポートしている場合、「スポイト」機能に素早くアクセスするためのショートカットを使用することができます。[Control] - キーを押しながらマウスをクリックしたままカーソルを動かすと、マウスカーソルの下にある色が表示されます。キャンバス全体をドラッグして欲しい色が見つかったところでマウスボタンを離すと、カーソルの下にある色が選択されます。マウスをキャンバスの外（例えば「どうぐ」の部分）で離すと、色の選択は変更されません。 + 使用中のツールが色をサポートしている場合、画面の下部付近に色の選択肢がパレ + ットで表示されます。このパレットをクリックして色を選択すると、その色がツー + ルで使用されます。(例えば、「ふで」ツールでは選択したブラシで描く色として、 + 「ぬる」ツールでは画像の領域を塗りつぶす色として使用します)。 - ⚙ 注: カラーパレットの色は好みに応じて変更できます。変更方法については、"各種設定について"のドキュメントを参照してください。 + 右端には色に関する3つの特別なオプションがあります。 + + スポイト + スポイトを使えば、絵の中から色を選ぶことができます。 + （この機能を使うためのショートカットキーがあります; 以降を参照） + + レインボーパレット + レインボーパレットは、色相、彩度、明度を選択することで、任意の色を選ぶ + ことができます。左側のボックスには、数百段階の色相 — 上部の赤から下部の + 紫まで — が、数百段階の彩度 — 左側の淡い色から右側の純色まで — で表示さ + れます。縦のグレーの領域では、数百段階で、明度 — 上部が最も明るく、下部 + が最も暗い — を選ぶことができます。 + 緑色のチェックボタンをクリックして色を確定します。「もどる」ボタンをク + リックすると、色を選択せずにポップアップを終了します。 + このツールの選択色に次のいずれかの色をセットすることもできます: + o 組み込みのカラーパレットから選んだ色 + o スポイトで選んだ色 + o カラーミキサーで選んだ色 + + カラーミキサー + 絵の具のパレットのようなアイコンの「カラーミキサー」では、加法混色の三 + 原色 — 赤、青、黄と、白（色合い）、グレー（色調）、黒（濃淡）を混ぜて色 + を作成することができます。 + どのボタンも複数回クリックできます（例えば、赤 + 赤 + 黄とクリックする + と、赤橙色になります）。混合された色の比率は画面下部に表示されます。 + 「さいしょから」ボタンをクリックすると、最初からやり直す（色がない状態 + に戻す）ことができます。また、間違えた場合は、手順を何回でも取り消した + り、やり直したりすることができます（最初からやり直す必要はありません） + 。 + 緑色のチェックボタンをクリックして色を確定します。「もどる」ボタンをク + リックすると、色を選択せずにポップアップを終了します。 + + ⌨ 使用中のツールが色をサポートしている場合、「スポイト」機能に素早くアクセ + スするためのショートカットを使用することができます。[Control] キーを押しな + がらマウスをクリックしたままカーソルを動かすと、マウスカーソルの下にある色 + が表示されます。キャンバス全体をドラッグして欲しい色が見つかったところでマ + ウスボタンを離すと、カーソルの下にある色が選択されます。マウスをキャンバス + の外（例えば「どうぐ」の部分）で離すと、色の選択は変更されません。 + + ⚙ 注: カラーパレットの色は好みに応じて変更できます。変更方法については、"各 + 種設定について"のドキュメントを参照してください。 + + + + (「かたち」ツールの使い方を説明している例) +最下部: ヘルプエリア + + 画面の一番下の部分では、Linux ペンギンの Tux が、様々なヒントや関連情報をご + 提供します。 - (「かたち」ツールの使い方を説明している例) - 最下部: ヘルプエリア - 画面の一番下の部分では、Linux ペンギンの Tux が、様々なヒントや関連情報をご提供します。 D. 各種のツール - 1. 描画ツール +1. 描画ツール - a. ペイントブラシ「ふで」 +a. ペイントブラシ「ふで」 - 右側のセレクタから筆の種類を、下のパレットから色を選んで、フリーハンドで描画します。 + 右側のセレクタから筆の種類を、下のパレットから色を選んで、フリーハンドで描 + 画します。 - ボタンを押したままマウスを動かすと、描画できます。 + ボタンを押したままマウスを動かすと、描画できます。 - アニメーションブラシ — - 描画中に形状が変化します。例として、ブドウ形のブラシが挙げられます。このタイプのブラシの選択ボタンには、小さなフィルムのアイコンが付いています。 + アニメーションブラシ — 描画中に形状が変化します。例として、ブドウ形のブラシ + が挙げられます。このタイプのブラシの選択ボタンには、小さなフィルムのアイコ + ンが付いています。 - 向きのあるブラシ — 描いている方向によって異なる形を描きます。 例として、Tux Paint に含まれる矢印ブラシがあります。 - これらのブラシの選択ボタンには、小さな8方向の矢印のアイコンが付いています。 + 向きのあるブラシ — 描いている方向によって異なる形を描きます。例として、Tux + Paint に含まれる矢印ブラシがあります。これらのブラシの選択ボタンには、小さ + な8方向の矢印のアイコンが付いています。 - また、いくつかのブラシは、方向とアニメーションを併せ持ちます。例として、猫やリスのブラシがあります。このタイプのブラシの選択ボタンには、小さなフィルムと８方向の矢印のアイコンが付いています。 + また、いくつかのブラシは、方向とアニメーションを併せ持ちます。例として、猫 + やリスのブラシがあります。このタイプのブラシの選択ボタンには、小さなフィル + ムと８方向の矢印のアイコンが付いています。 - 描画中にはサウンドが流れます。筆の大きさが大きいほど、低い音になります。 + 描画中にはサウンドが流れます。筆の大きさが大きいほど、低い音になります。 - ブラシの描画間隔 + ブラシの描画間隔 - 「ふで」でキャンバスに描画する際の間隔を変更できます。標準で、いくつかのブラシ (足跡や花など) - は重ならないように十分な間隔を空けてあります。他のブラシ (基本的な円形のものなど) - は狭い間隔で連続した線になるように設定されています。 - 描画の間隔は、右下にある三角形になったバーの列をクリックすることで変更できます。長いバーが広い間隔に対応します。描画間隔は、「ふで」を使用するツール（「ふで」ツールと「せん」ツール）の両方に影響します。 + 「ふで」でキャンバスに描画する際の間隔を変更できます。標準で、いくつか + のブラシ (足跡や花など) は重ならないように十分な間隔を空けてあります。 + 他のブラシ (基本的な円形のものなど) は狭い間隔で連続した線になるように + 設定されています。 - ⚙ 注: "nobrushspacing" - オプションが設定されると、描画間隔の調整が無効になります。詳しくは"各種設定について"のドキュメントを参照してください。 + 描画の間隔は、右下にある三角形になったバーの列をクリックすることで変更 + できます。長いバーが広い間隔に対応します。描画間隔は、「ふで」を使用す + るツール（「ふで」ツールと「せん」ツール）の両方に影響します。 - b.「はんこ」ツール + ⚙ 注: "nobrushspacing" オプションが設定されると、描画間隔の調整が無効に + なります。詳しくは"各種設定について"のドキュメントを参照してください。 - 「はんこ」ツールは、スタンプやステッカーを集めたようなものです。馬や木、月など、あらかじめ用意された様々な写真やイラストを絵に貼り付けることができます。 - マウスを動かすと、スタンプが押される位置と大きさを示す輪郭線が表示されるので、押したい場所でクリックします。 - スタンプの分類 - スタンプは、動物、植物、宇宙、乗り物、人物といった多くのカテゴリに分類されています。セレクタの左右の矢印のボタンを使ってカテゴリを切り替えることができます。 +b.「はんこ」ツール - "スタンプの回転" + 「はんこ」ツールは、スタンプやステッカーを集めたようなものです。馬や木、月 + など、あらかじめ用意された様々な写真やイラストを絵に貼り付けることができま + す。 - 右下のトグルボタンを使って、スタンプを配置する際の回転を有効にすることができます。 - スタンプを配置したらキャンバス上でマウスを動かして回転させる角度を選びます。 - もう一度マウスボタンをクリックすると、スタンプが追加されます。 + マウスを動かすと、スタンプが押される位置と大きさを示す輪郭線が表示されるの + で、押したい場所でクリックします。 - ⚙ 注:"スタンプの回転" - オプションが無効化されている場合、回転の手順は省略され、マウスを放した時点でスタンプが確定します。 - ""スタンプの回転"" ("stamprotation") についての詳細は、各種設定について" - のドキュメントを参照して下さい。 + スタンプの分類 + スタンプは、動物、植物、宇宙、乗り物、人物といった多くのカテゴリに分類 + されています。セレクタの左右の矢印のボタンを使ってカテゴリを切り替える + ことができます。 - 📜 注: はんこの回転機能は Tux Paint バージョン 0.9.29 で追加されました。 + "スタンプの回転" - スタンプの操作 + 右下のトグルボタンを使って、スタンプを配置する際の回転を有効にすること + ができます。スタンプを配置したらキャンバス上でマウスを動かして回転させ + る角度を選びます。もう一度マウスボタンをクリックすると、スタンプが追加 + されます。 - スタンプを絵に貼り付ける前に、以下の様々な効果を適用することができます（スタンプの種類によって異なります）: + ⚙ 注:"スタンプの回転" オプションが無効化されている場合、回転の手順は省 + 略され、マウスを放した時点でスタンプが確定します。 ""スタンプの回転"" + ("stamprotation") についての詳細は、各種設定について" のドキュメントを + 参照して下さい。 - * スタンプには色をつけることができるものがあります。その場合、カラーパレットが有効になり、スタンプを絵に貼り付ける前に色を選ぶことができます。 - * スタンプは、右下の三角形のバーの中をクリックすることで、縮小・拡大することができます。 - * 多くのスタンプは、右下の操作ボタンを使って、上下・左右に反転させることができます。 + 📜 注: はんこの回転機能は Tux Paint バージョン 0.9.29 で追加されました。 - ⚙ 注: "nostampcontrols" - オプションが設定されると、スタンプの回転、拡大・縮小、反転が無効になります。詳しくは"各種設定について"のドキュメントを参照してください。 - スタンプの効果音 - 個々のスタンプごとに効果音を設定することができます。画面下部の左側のヘルプエリア（Linux ペンギン - "Tux"の近く）にあるボタンを押すと、効果音を再生することができます。 + スタンプの操作 - c.「せん」ツール + スタンプを絵に貼り付ける前に、以下の様々な効果を適用することができます + （スタンプの種類によって異なります）: - 様々な種類の筆と好きな色を使って直線を描くツールです。 + o スタンプには色をつけることができるものがあります。その場合、カラー + パレットが有効になり、スタンプを絵に貼り付ける前に色を選ぶことがで + きます。 + o スタンプは、右下の三角形のバーの中をクリックすることで、縮小・拡大 + することができます。 + o 多くのスタンプは、右下の操作ボタンを使って、上下・左右に反転させる + ことができます。 - 線を引き始めたい場所でクリックして、そのままマウスを動かすと、描かれる線の位置が細い「ゴムバンド」のような線で示され、画面の下には、線の角度が表示されます。右にまっすぐ伸びる線は0度、上にまっすぐ伸びる線は90度、左にまっすぐ伸びる線は180度、下にまっすぐ伸びる線は270度、という具合です。 + ⚙ 注: "nostampcontrols" オプションが設定されると、スタンプの回転、拡大 + ・縮小、反転が無効になります。詳しくは"各種設定について"のドキュメント + を参照してください。 - マウスを放すと、バネのような効果音とともに線が描画されます。 - アニメーション対応のブラシでは、線に沿って形が変化します。 指向性のブラシでは、線の角度に応じて異なる形状を表示します。 - さらに、アニメーションと指向性の両方を備えたブラシもあります。 詳しくは、上記の「ふで」の項をご覧ください。 - 線に沿って形が並んだり、連続した線になったりと、それぞれの「ふで」毎に異なる描画間隔が設定されており、この間隔は変更することができます。詳しくは、"ペイントブラシ「ふで」"の"ブラシの描画間隔"のセクションを参照して下さい。 + スタンプの効果音 - d.「かたち」ツール + 個々のスタンプごとに効果音を設定することができます。画面下部の左側のヘ + ルプエリア（Linux ペンギン "Tux"の近く）にあるボタンを押すと、効果音を + 再生することができます。 - 簡単な図形を描きます。 - まず、円、正方形、楕円など、描きたい図形を、右側のセレクタから選択します。 - 右下のオプションボタンで「かたち」ツールの動作を選択します: - 真ん中から広げる - 最初にクリックした位置を中心として図形を拡大します。 - 📜 バージョン 0.9.24 までは、このような動作だけでした。 - 角から広げる - 最初にクリックした位置を左上の角として図形を拡大します。これは、他の多くのお絵かきソフトの標準的な動作です。 +c.「せん」ツール - 📜 このオプションは、バージョン 0.9.25 以降で追加されました。 + 様々な種類の筆と好きな色を使って直線を描くツールです。 - ⚙ 注: "noshapecontrols" - オプションをつけて起動するなどして、「かたち」ツールの動作の制御を無効にした場合、オプションボタンは表示されず、真ん中から図形を広げる動作になります。 + 線を引き始めたい場所でクリックして、そのままマウスを動かすと、描かれる線の + 位置が細い「ゴムバンド」のような線で示され、画面の下には、線の角度が表示さ + れます。右にまっすぐ伸びる線は0度、上にまっすぐ伸びる線は90度、左にまっすぐ + 伸びる線は180度、下にまっすぐ伸びる線は270度、という具合です。 - 図形を描くには、キャンバス上でマウスをクリックし、そのままマウスを動かして図形を広げます。楕円や長方形のように縦横比を変えられる図形と、正方形や円のように縦横比を変えられない図形があります。 + マウスを放すと、バネのような効果音とともに線が描画されます。 - 比率を変更できる図形の場合は、下部に図形の長短の比率が表示されます。例えば - 、正方形（縦と横が同じ長さ）の場合は「1：1」、横が縦の2倍または縦が横の2倍の場合は「2：1」といった具合です。 + アニメーション対応のブラシでは、線に沿って形が変化します。指向性のブラシで + は、線の角度に応じて異なる形状を表示します。さらに、アニメーションと指向性 + の両方を備えたブラシもあります。詳しくは、上記の「ふで」の項をご覧ください + 。 - 図形を広げ終わったらマウスを放します。 + 線に沿って形が並んだり、連続した線になったりと、それぞれの「ふで」毎に異な + る描画間隔が設定されており、この間隔は変更することができます。詳しくは、"ペ + イントブラシ「ふで」"の"ブラシの描画間隔"のセクションを参照して下さい。 - 通常の動作 - ここで、キャンバス上でマウスを動かして図形を回転させることができます。回転した図形の角度は画面の下に表示されます（「せん」ツールと同様）。 - 最後にもう一度マウスをクリックして、図形が完成します。 +d.「かたち」ツール - 簡易描画モード - 簡易描画モードが設定されている場合、図形を回転させる手順は省略され、マウスを放した時点で図形が描画されます。 + 簡単な図形を描きます。 - ⚙ "簡易描画モード" ("simpleshapes") についての詳細は、各種設定について" - のドキュメントを参照して下さい。 + まず、円、正方形、楕円など、描きたい図形を、右側のセレクタから選択します。 - e.「もじ」ツール、「ラベル」ツール + 右下のオプションボタンで「かたち」ツールの動作を選択します: - まず、右側のセレクタからフォントを、下部のパレットから色を選択します。さらに、テキストに太字や斜体のスタイルを適用することもできます。画面をクリックするとカーソルが表示され、文字を入力することができます。(入力した文字がキャンバスに反映される前に、フォント、色、スタイルを変更することができます) + 真ん中から広げる + 最初にクリックした位置を中心として図形を拡大します。 - [Enter]キー、または[Return]キーを押すと文字が描画され、カーソルが次の行に下がります。 + 📜 バージョン 0.9.24 までは、このような動作だけでした。 - また、[Tab]キーを押すと、文字が描画された後、カーソルは、次の行ではなく、右側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、色などを混在させたい場合に便利な方法です。 - 文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り付ける位置をクリックした位置に移動させ、文字入力を続けることができます。 - 「もじ」ツールと「ラベル」ツールの違い + 角から広げる + 最初にクリックした位置を左上の角として図形を拡大します。これは、他の多 + くのお絵かきソフトの標準的な動作です。 - 「もじ」ツールは、Tux Paint - に以前からある文字入力ツールです。このツールで入力した文字列は絵と一体化するため、後から文字列の内容を編集したり、動かしたりすることはできません。一方、絵と一体化することで、上から塗りつぶしたり、「よごす」「そめる」「うきぼり」といった「まほう」ツールの効果で修正を加えることができます。 + 📜 このオプションは、バージョン 0.9.25 以降で追加されました。 - Tux Paint バージョン 0.9.22 - で追加された「ラベル」ツールでは、文字は絵から「浮いて」おり、文字列の内容、位置、フォント、色などの情報は個別に記録されます。これにより、「ラベル」は後から移動や編集が可能です。 - ラベルを編集するには、ラベルと指が描かれた「ラベル選択」ボタンをクリックします。図面内のすべてのラベルがハイライト表示されるので、編集したいラベルをクリックするか、[Tab] - キーでラベルの選択を順に切り替えて、編集したいラベルで [Enter] キーか [Return] - キーを押すと、そのラベルを編集できます。（[Backspace] - キーで文字を消したり、追加で文字を入力したり、キャンバス内をクリックしてラベルの位置を変えたり、パレット内をクリックしてラベルの文字の色を変えたり、など）。 - ラベルと手のひらが描かれた「貼り付け」ボタンをクリックすると、もじツールを使って文字を書き加えたかのように、ラベルをキャンバスに固定することができます。(この機能は - Tux Paint version 0.9.28 で追加されました。) - 作品のすべてのラベルがハイライト表示されるので、ラベルを編集する場合と同じように、ラベルを選択します。選択したラベルは削除され、文字がキャンバスに直接書き込まれます。 - ⚙ 「ラベル」ツールは、Tux Paint - 設定ツールや、"nolabel"オプションにより、無効にすることができます。 + ⚙ 注: "noshapecontrols" オプションをつけて起動するなどして、「かたち」ツー + ルの動作の制御を無効にした場合、オプションボタンは表示されず、真ん中から図 + 形を広げる動作になります。 - 多言語文字入力 + 図形を描くには、キャンバス上でマウスをクリックし、そのままマウスを動かして + 図形を広げます。楕円や長方形のように縦横比を変えられる図形と、正方形や円の + ように縦横比を変えられない図形があります。 - Tux Paint では、様々な言語の文字を入力することができます。たいていのラテン文字（A-Z, ñ, - è - など）は、直接入力できます。また、いくつかの言語では、入力モードを切り替えて、複数のキーの組み合わせを用いて文字を入力する必要があります。 + 比率を変更できる図形の場合は、下部に図形の長短の比率が表示されます。例えば + 、正方形（縦と横が同じ長さ）の場合は「1：1」、横が縦の2倍または縦が横の2倍 + の場合は「2：1」といった具合です。 - Tux Paint - が、個別の入力モードがサポートされている言語に設定されている場合、特定のキーを押下することで、入力モードを切り替えることができます。 + 図形を広げ終わったらマウスを放します。 - サポートされている言語、入力方式、切り替えキーは以下のとおりです。 + 通常の動作 - * 日本語— ローマ字入力方式のひらがな、カタカナ— 右[Alt] キー または 左[Alt] キー - * ハングル— 2-Bul入力方式— 右[Alt] キー または 左[Alt] キー - * 繁体中文— 右[Alt] キー または 左[Alt] キー キー - * タイ語— 右[Alt] キー + ここで、キャンバス上でマウスを動かして図形を回転させることができます。 + 回転した図形の角度は画面の下に表示されます（「せん」ツールと同様）。 - 💡 注: - 大抵のフォントには全ての言語の全ての文字は含まれていません。このため、入力したい文字が含まれるフォントに変更する必要がある場合があります。 + 最後にもう一度マウスをクリックして、図形が完成します。 - 画面キーボード - 「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキーボード」では、キーボードレイアウトを変えたり、文字の合成（例: - "a "と "e "を "æ "に合成）を行うことができます。 - ⚙ 詳細については "各種設定について" と "Tux Paintの拡張" - のドキュメントを参照してください。 + 簡易描画モード + 簡易描画モードが設定されている場合、図形を回転させる手順は省略され、マ + ウスを放した時点で図形が描画されます。 - f.「ぬる」ツール + ⚙ "簡易描画モード" ("simpleshapes") についての詳細は、各種設定について" + のドキュメントを参照して下さい。 - 「ぬる」ツールは、描画の連続した領域を好きな色で塗りつぶします。以下の3 つの塗りつぶしオプションが用意されています: - * たんしょく — 領域を一つの色で塗りつぶします。 - * ふで — フリーハンドでドラッグして、領域を一つの色で塗りつぶします。 - * せんけい — - 領域をクリックしてからドラッグすると、ドラッグした方向に向かって色が薄くなるようにグラデーションをつけて塗りつぶします。 - * ほうしゃ — クリックした場所を中心に周りに向かって放射状に色が薄くなるようにグラデーションをつけて塗りつぶします。 - * あわせる — クリックした領域の輪郭に合わせて色が薄くなるようにグラデーションをつけて塗りつぶします。 - 📜 注: Tux Paint 0.9.24 - より前のバージョンでは、このツールは「まほう」ツールのひとつでした。（「まほう」ツールについては、以下をご覧ください） Tux - Paint 0.9.26 より前のバージョンでは、「たんしょく」の塗りつぶし方法しかありませんでした。 Tux Paint - 0.9.29で、「あわせる」の塗りつぶし方法が追加されました。 - g.「まほう」ツール（特殊効果） - 「まほう」ツールは、様々な特殊なツールを集めたものです。右側のセレクタで、「まほう」の効果を選択することができます。効果を適用する方法は、クリック＋ドラッグ、単なるクリックなど、ツールごとに様々です。 - 「まほう」効果の制御 - クリック＋ドラッグを使用するツールの場合、右側のセレクタの下部左側にある「描画モード」を表すボタンが有効になります。１クリックで画面全体に効果を及ぼすツールの場合、右側の「全画面モード」を表すボタンが有効になります。 +e.「もじ」ツール、「ラベル」ツール - ⚙ 注: "nomagiccontrols" - オプションが設定されると、「描画モード」「全画面モード」の選択ボタンが無効になります。詳しくは"各種設定について"のドキュメントを参照してください。 + まず、右側のセレクタからフォントを、下部のパレットから色を選択します。さら + に、テキストに太字や斜体のスタイルを適用することもできます。画面をクリック + するとカーソルが表示され、文字を入力することができます。(入力した文字がキャ + ンバスに反映される前に、フォント、色、スタイルを変更することができます) - 💡 - 「まほう」効果の制御が無効にされた場合、いくつかの「まほう」プラグインは「描画モード」「全画面モード」に対応するツールに分かれて利用できるようになります。 + [Enter]キー、または[Return]キーを押すと文字が描画され、カーソルが次の行に下 + がります。 - 「まほう」サイズの制御 + また、[Tab]キーを押すと、文字が描画された後、カーソルは、次の行ではなく、右 + 側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、 + 色などを混在させたい場合に便利な方法です。 - 「まほう」ツールの中には描画のサイズや効果が及ぶ幅の大きさを変更できるものがあり、その場合、画面の右下にスライダーボタンが表示されます。 + 文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り + 付ける位置をクリックした位置に移動させ、文字入力を続けることができます。 - ⚙ 注: "nomagicsizes" - オプションが設定されると、サイズを変更スライダーのボタンが無効になります。詳しくは"各種設定について"のドキュメントを参照してください。 + 「もじ」ツールと「ラベル」ツールの違い - 💡 - サイズ変更が無効にされると、単にツールごとの標準のサイズに固定される場合と、例えば「れんが」や「めだま」などいくつかのプラグインのように、異なるサイズのツールが追加される場合があります。 + 「もじ」ツールは、Tux Paint に以前からある文字入力ツールです。このツー + ルで入力した文字列は絵と一体化するため、後から文字列の内容を編集したり + 、動かしたりすることはできません。一方、絵と一体化することで、上から塗 + りつぶしたり、「よごす」「そめる」「うきぼり」といった「まほう」ツール + の効果で修正を加えることができます。 - 📜 このオプションは、バージョン 0.9.30 以降で追加されました。 + Tux Paint バージョン 0.9.22 で追加された「ラベル」ツールでは、文字は絵 + から「浮いて」おり、文字列の内容、位置、フォント、色などの情報は個別に + 記録されます。これにより、「ラベル」は後から移動や編集が可能です。 - 「magic-docs」フォルダ内のドキュメント「まほう」ツールの一覧もお読みください。 + ラベルを編集するには、ラベルと指が描かれた「ラベル選択」ボタンをクリッ + クします。図面内のすべてのラベルがハイライト表示されるので、編集したい + ラベルをクリックするか、[Tab] キーでラベルの選択を順に切り替えて、編集 + したいラベルで [Enter] キーか [Return] キーを押すと、そのラベルを編集で + きます。（[Backspace] キーで文字を消したり、追加で文字を入力したり、キ + ャンバス内をクリックしてラベルの位置を変えたり、パレット内をクリックし + てラベルの文字の色を変えたり、など）。 - h.けしゴム + ラベルと手のひらが描かれた「貼り付け」ボタンをクリックすると、もじツー + ルを使って文字を書き加えたかのように、ラベルをキャンバスに固定すること + ができます。(この機能は Tux Paint version 0.9.28 で追加されました。) 作 + 品のすべてのラベルがハイライト表示されるので、ラベルを編集する場合と同 + じように、ラベルを選択します。選択したラベルは削除され、文字がキャンバ + スに直接書き込まれます。 - このツールは「ふで」ツールに似ています。クリック（または、クリック＋ドラッグ）をした部分が消されます。（消した部分は、白あるいはその他の色、また、レイヤーキャンバスなど、絵によって異なる状態に戻ります。） + ⚙ 「ラベル」ツールは、Tux Paint 設定ツールや、"nolabel"オプションにより + 、無効にすることができます。 - いくつもの大きさの正方形と円形の消しゴムがあります。端がぼやけた円形の消しゴムも用意されています。 - 正方形の輪郭がマウスカーソルの位置に表示され、絵のどの部分が消されるかを示します。 - 消している間、「キュッキュッ」と擦って消す効果音が流れます。 + 多言語文字入力 - ⌨ [X] - キーを押しながらマウスをクリックすると、小さな丸い消しゴムをすばやく使うことができます（もじ/ラベルツール選択時、はんこや図形の回転中、インタラクティブなまほうツールを使用している間は無効です）。マウスを離すと、選択中のツールに戻ります。 + Tux Paint では、様々な言語の文字を入力することができます。たいていのラ + テン文字（A-Z, ñ, è など）は、直接入力できます。また、いくつかの言語で + は、入力モードを切り替えて、複数のキーの組み合わせを用いて文字を入力す + る必要があります。 - 2. そのほかの操作 + Tux Paint が、個別の入力モードがサポートされている言語に設定されている + 場合、特定のキーを押下することで、入力モードを切り替えることができます + 。 - a.「とりけし」と「やりなおし」 + サポートされている言語、入力方式、切り替えキーは以下のとおりです。 - 「とりけし」ボタンをクリックすると、直前に行った操作が取り消されます。いくつもの操作をさかのぼって取り消すことができます！ + o 日本語— ローマ字入力方式のひらがな、カタカナ— 右[Alt] キーまたは左 + [Alt] キー + o ハングル— 2-Bul入力方式— 右[Alt] キーまたは左[Alt] キー + o 繁体中文— 右[Alt] キーまたは左[Alt] キーキー + o タイ語— 右[Alt] キー - ⌨ 注: キーボードで [Control / ⌘] + [Z] を押してもとりけしできます。 + 💡 注: 大抵のフォントには全ての言語の全ての文字は含まれていません。この + ため、入力したい文字が含まれるフォントに変更する必要がある場合がありま + す。 - 「やりなおし」ボタンをクリックすると、「とりけし」ボタンで取り消した操作を元に戻すことができます。 - 「とりけし」操作の後、描画を行っていなければ、取り消した全ての操作を元に戻せます！ - ⌨ 注: キーボードで [Control / ⌘] + [R] を押してもやりなおしできます。 + 画面キーボード - b.「さいしょから」 + 「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキー + ボード」では、キーボードレイアウトを変えたり、文字の合成（例: "a "と "e + "を "æ "に合成）を行うことができます。 - 「さいしょから」のボタンを押すと、新規に絵を描き始めることができます。ダイアログ画面が表示され、キャンバスの背景色やレイヤー画像（後述）を選べます。 + ⚙ 詳細については "各種設定について" と "Tux Paintの拡張" のドキュメント + を参照してください。 - ⌨ 注: キーボードで [Control / ⌘] + [N] を押しても新規作成ができます。 - 単色のキャンバス - あらかじめ用意されている背景色のほか、レインボーパレットやカラーミキサーで色を選択することができます。これらは、絵を描くときにキャンバスの下に表示されるカラーパレットにあるオプションと同じように操作します。詳細は - メインの画面 > 下部: カラーパレット「いろ」 > 色に関する特別なオプション を参照。 - レイヤー画像 - * レイヤー画像には、塗り絵のページのようなもの（白黒の線で描かれ、色を塗ることができる）や、前景レイヤーと背景レイヤーに挟まれた部分に絵を描ける３Ｄ画像のようなものがあります。 - * また、このほかに、背景レイヤーだけの画像も用意されています。 - 「消しゴム」ツールを使用すると、元のレイヤー画像が消されずに残ります。また、マジックツールの「反転」と「ミラー」は、レイヤー画像も反転させます。 - レイヤー画像は、その上に絵を描いて保存すると新しい絵として保存され、元々のレイヤー画像自体は上書きされないので、後で（「さいしょから」ダイアログからアクセスして）何度でも使うことができます。 - ⚙ 独自のスターター画像やテンプレート画像を作成することができます。ドキュメント「Tux Paint - の拡張」の「スターター」と「テンプレート」のセクションを参照してください。 +f.「ぬる」ツール - 💡 また、保存した作品をTux - Paintの「ひらく」ダイアログから直接テンプレートに変換することもできます。以下の「ひらく」を参照してください。 + 「ぬる」ツールは、描画の連続した領域を好きな色で塗りつぶします。以下の3 つ + の塗りつぶしオプションが用意されています: + + たんしょく — 領域を一つの色で塗りつぶします。 + + ふで — フリーハンドでドラッグして、領域を一つの色で塗りつぶします。 + + せんけい — 領域をクリックしてからドラッグすると、ドラッグした方向に向か + って色が薄くなるようにグラデーションをつけて塗りつぶします。 + + ほうしゃ — クリックした場所を中心に周りに向かって放射状に色が薄くなるよ + うにグラデーションをつけて塗りつぶします。 + + あわせる — クリックした領域の輪郭に合わせて色が薄くなるようにグラデーシ + ョンをつけて塗りつぶします。 - 自作テンプレートの削除 + 📜 注: Tux Paint 0.9.24 より前のバージョンでは、このツールは「まほう」ツール + のひとつでした。（「まほう」ツールについては、以下をご覧ください） Tux + Paint 0.9.26 より前のバージョンでは、「たんしょく」の塗りつぶし方法しかあり + ませんでした。 Tux Paint 0.9.29で、「あわせる」の塗りつぶし方法が追加されま + した。 - 「さいしょから」ダイアログで自作テンプレート（「ひらく」ダイアログの「テンプレート」ボタンを使って作成したもの）を選択すると、リストの右下に「けす」（ゴミ箱）ボタンが表示されます。これをクリックすると、選択したテンプレートが消去されます。(確認を求められます） - 💡 注: - Linux、Windows、macOSでは、削除した作品は、デスクトップのゴミ箱に移動するので、後で元に戻すことができます。 - ⚙ 注: 「けす」ボタンは、"noerase" オプションで無効にできます。 +g.「まほう」ツール（特殊効果） - ⚙ 注:単色のキャンバスは、"newcolorslast" - オプションによって、「さいしょから」ダイアログの最後（スターターとテンプレートの下）に配置することができます。 + 「まほう」ツールは、様々な特殊なツールを集めたものです。右側のセレクタで、 + 「まほう」の効果を選択することができます。効果を適用する方法は、クリック＋ + ドラッグ、単なるクリックなど、ツールごとに様々です。 - c.「ひらく」 + 「まほう」効果の制御 - 「ひらく」をクリックすると、保存されている全ての作品のリストが表示されます。リストが画面に収まりきらない場合は、上下の矢印のボタンでリストをスクロールできます。 - まず、絵をクリックして選択します… - * 左下にある緑色の「ひらく」ボタンで、選択した作品を読み込んで編集することができます。 + クリック＋ドラッグを使用するツールの場合、右側のセレクタの下部左側にあ + る「描画モード」を表すボタンが有効になります。１クリックで画面全体に効 + 果を及ぼすツールの場合、右側の「全画面モード」を表すボタンが有効になり + ます。 - (または、開きたい作品をダブルクリックします） + ⚙ 注: "nomagiccontrols" オプションが設定されると、「描画モード」「全画 + 面モード」の選択ボタンが無効になります。詳しくは"各種設定について"のド + キュメントを参照してください。 - 💡 絵を開く時に、それまで描いていた絵が保存されていなければ、保存するかどうかを確認します。（「セーブ」の項を参照） + 💡 「まほう」効果の制御が無効にされた場合、いくつかの「まほう」プラグイ + ンは「描画モード」「全画面モード」に対応するツールに分かれて利用できる + ようになります。 - * 右下にある茶色の「けす」(ゴミ箱) ボタンで、選択した作品を削除します。(本当に削除して良いか確認されます) + 「まほう」サイズの制御 - 📜 注: Linux（バージョン 0.9.22以降）、Windows（バージョン - 0.9.27以降）、macOS（バージョン - 0.9.29以降）では、削除した作品は、デスクトップのゴミ箱に移動するので、後で元に戻すことができます。 - ⚙ 注: 「けす」ボタンは、"noerase" オプションで無効にできます。 + 「まほう」ツールの中には描画のサイズや効果が及ぶ幅の大きさを変更できる + ものがあり、その場合、画面の右下にスライダーボタンが表示されます。 - * 右下の「かきだす」のボタンをクリックすると、ユーザーの標準の画像フォルダ（例: - "~/Pictures/TuxPaint/")に画像を出力します。 + ⚙ 注: "nomagicsizes" オプションが設定されると、サイズを変更スライダーの + ボタンが無効になります。詳しくは"各種設定について"のドキュメントを参照 + してください。 - 「ひらく」の画面からは、以下のこともできます: - * 左側の一番下にある青色の「スライド」のボタンを押すと、スライドショーモードになります。詳しくは「スライドショー」の項を参照。 + 💡 サイズ変更が無効にされると、単にツールごとの標準のサイズに固定される + 場合と、例えば「れんが」や「めだま」などいくつかのプラグインのように、 + 異なるサイズのツールが追加される場合があります。 - * 左下の青い「テンプレート」ボタンをクリックすると、選択した作品が新しいテンプレートに変換され、「さいしょから」ダイアログから利用できるようになります。 + 📜 このオプションは、バージョン 0.9.30 以降で追加されました。 - 📜 注: テンプレート作成機能は Tux Paint バージョン 0.9.31 で追加されました。 - 上記以外の方法で独自のテンプレートを作成するには, ドキュメント「Tux Paint の拡張」をご覧下さい。 + 「magic-docs」フォルダ内のドキュメント「まほう」ツールの一覧もお読みくださ + い。 - ⚙ テンプレート作成機能は、Tux Paint - 設定ツールで「テンプレート作成機能を無効にする」を選択するか、"notemplateexport"オプションを指定してTux - Paintを起動することで無効にすることができます。 - * 右下にある赤色の「もどる」ボタンを押すと、絵を描く画面に戻ります。 - ⌨ 注: キーボードで [Control / ⌘] + [O] を押しても「ひらく」ダイアログを表示できます。 +h.けしゴム - d.「セーブ」 + このツールは「ふで」ツールに似ています。クリック（または、クリック＋ドラッ + グ）をした部分が消されます。（消した部分は、白あるいはその他の色、また、レ + イヤーキャンバスなど、絵によって異なる状態に戻ります。） - 描画中の作品を保存します。 + いくつもの大きさの正方形と円形の消しゴムがあります。端がぼやけた円形の消し + ゴムも用意されています。 - 一度も保存していない作品の場合、作品のリストに新しく追加されます。(つまり、新しいファイルを作成します) + 正方形の輪郭がマウスカーソルの位置に表示され、絵のどの部分が消されるかを示 + します。 - 💡 注: ファイル名の入力などを求めることはなく、カメラのシャッター音の効果音とともに、単に作品を保存します。 + 消している間、「キュッキュッ」と擦って消す効果音が流れます。 - 一度保存操作をした後や、「ひらく」コマンドで読みこんだ作品の場合、以前のバージョンを上書きするか、新しく追加して保存するかを確認します。 + ⌨ [X] キーを押しながらマウスをクリックすると、小さな丸い消しゴムをすばやく + 使うことができます（もじ/ラベルツール選択時、はんこや図形の回転中、インタラ + クティブなまほうツールを使用している間は無効です）。マウスを離すと、選択中 + のツールに戻ります。 - ⚙ 注: "saveover" オプション、または "saveovernew" - オプションのどちらかが設定されている場合は、確認なしに保存されます。詳しくは"各種設定について"のドキュメントを参照してください。) - ⌨ 注: キーボードで [Control / ⌘] + [S] を押しても作品を保存できます。 - e.「いんさつ」 - このボタンを押して作品を印刷します！ +2. そのほかの操作 - 多くのプラットフォームでは、[Alt] key (Mac では [Option] キー) - を押しながら「いんさつ」ボタンを押すと、プリンターの設定画面が開きます。この機能は、フルスクリーンモードでは動作しない点に注意して下さい。 +a.「とりけし」と「やりなおし」 - 印刷の無効化 + 「とりけし」ボタンをクリックすると、直前に行った操作が取り消されます。いく + つもの操作をさかのぼって取り消すことができます！ - オプションで "noprint" を設定すれば、「いんさつ」のボタンを無効にすることができます。 + ⌨ 注: キーボードで [Control / ⌘] + [Z] を押してもとりけしできます。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + 「やりなおし」ボタンをクリックすると、「とりけし」ボタンで取り消した操作を + 元に戻すことができます。 - 印刷機能の制限 + 「とりけし」操作の後、描画を行っていなければ、取り消した全ての操作を元に戻 + せます！ - オプションで "printdelay" - を設定すれば、設定に応じた一定の時間ごとに１回だけしか印刷できなくなります。 + ⌨ 注: キーボードで [Control / ⌘] + [R] を押してもやりなおしできます。 - 例えば、設定ファイルで "printdelay=602" と設定すれば、1分間に1回だけ印刷ができます。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 - 印刷コマンド +b.「さいしょから」 - (Linux 及び Unix の場合のみ) + 「さいしょから」のボタンを押すと、新規に絵を描き始めることができます。ダイ + アログ画面が表示され、キャンバスの背景色やレイヤー画像（後述）を選べます。 - Tux Paint は、PostScript - 形式の印刷データを作成し、外部プログラムに渡して印刷を行います。標準の設定では、以下のコマンドが使用されます: + ⌨ 注: キーボードで [Control / ⌘] + [N] を押しても新規作成ができます。 - lpr + 単色のキャンバス + あらかじめ用意されている背景色のほか、レインボーパレットやカラーミキサ + ーで色を選択することができます。これらは、絵を描くときにキャンバスの下 + に表示されるカラーパレットにあるオプションと同じように操作します。詳細 + はメインの画面 > 下部: カラーパレット「いろ」 > 色に関する特別なオプシ + ョンを参照。 - このコマンドは、設定ファイルの "printcommand" オプションを設定することで変更できます。 + レイヤー画像 + o レイヤー画像には、塗り絵のページのようなもの（白黒の線で描かれ、色 + を塗ることができる）や、前景レイヤーと背景レイヤーに挟まれた部分に + 絵を描ける３Ｄ画像のようなものがあります。 + o また、このほかに、背景レイヤーだけの画像も用意されています。 - フルスクリーンモードでなければ "[Alt]" - キーを押しながら「いんさつ」ボタンを押すと、別の印刷プログラムを起動することができます。標準の設定では、KDE - のグラフィカルな印刷ダイアログである、以下のプログラムが使用されます: + 「消しゴム」ツールを使用すると、元のレイヤー画像が消されずに残ります。 + また、マジックツールの「反転」と「ミラー」は、レイヤー画像も反転させま + す。 - kprinter + レイヤー画像は、その上に絵を描いて保存すると新しい絵として保存され、元 + 々のレイヤー画像自体は上書きされないので、後で（「さいしょから」ダイア + ログからアクセスして）何度でも使うことができます。 - このコマンドは、設定ファイルの "altprintcommand" - オプションを設定することで変更できます。 + ⚙ 独自のスターター画像やテンプレート画像を作成することができます。ドキ + ュメント「Tux Paint の拡張」の「スターター」と「テンプレート」のセクシ + ョンを参照してください。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + 💡 また、保存した作品をTux Paintの「ひらく」ダイアログから直接テンプレー + トに変換することもできます。以下の「ひらく」を参照してください。 - プリンターの設定 - (Windows 及び macOS) - 標準の設定では、「いんさつ」ボタンを押すと、通常使うプリンターに出力されます。 + 自作テンプレートの削除 - フルスクリーンモードでなければ、[Alt] (または [Option]) - キーを押しながら「いんさつ」ボタンを押すと、オペレーションシステム標準の印刷ダイアログが表示され、出力先などの設定を変更することができます。 + 「さいしょから」ダイアログで自作テンプレート（「ひらく」ダイアログの「 + テンプレート」ボタンを使って作成したもの）を選択すると、リストの右下に + 「けす」（ゴミ箱）ボタンが表示されます。これをクリックすると、選択した + テンプレートが消去されます。(確認を求められます） - "printcfg" オプションを設定すれば、プリンターの設定の変更を保存することができます。 + 💡 注: Linux、Windows、macOSでは、削除した作品は、デスクトップのゴミ箱に + 移動するので、後で元に戻すことができます。 - "printcfg" オプションを設定すると、プリンターの設定は、ユーザーの個人フォルダの - "printcfg.cfg" から読み込まれ、変更した設定はこのファイルに保存されます。 + ⚙ 注: 「けす」ボタンは、"noerase" オプションで無効にできます。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 - 印刷ダイアログのオプション - 標準の設定では、印刷ダイアログは、[Alt] (または [Option]) - キーを押しながら「いんさつ」ボタンを押した場合にのみ表示されます（Linux/Unixでは、"lpr" - の代わりに "altprintcommand"; すなわち "kprinter" が起動します。） - この印刷ダイアログの動作は、設定により変更できます。毎回必ず印刷ダイアログを表示させるには、コマンドラインで - "--altprintalways" を指定するか、設定ファイルで "altprint=always" - を指定します。反対に、"--altprintnever" または "altprint=never" - を指定することで、"[Alt]" (または "[Option]2) キーの効果を無効にできます。 + ⚙ 注:単色のキャンバスは、"newcolorslast" オプションによって、「さいしょから + 」ダイアログの最後（スターターとテンプレートの下）に配置することができます + 。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 - f.「スライドショー」 - 「スライドショー」の機能は、「ひらく」ダイアログから利用できます。Tux Paint - の中で、簡単なアニメーションや画像のスライドショーを再生することができます。また、選択した画像を元にアニメーションGIFを書き出すこともできます。 +c.「ひらく」 - 画像を選ぶ + 「ひらく」をクリックすると、保存されている全ての作品のリストが表示されます + 。リストが画面に収まりきらない場合は、上下の矢印のボタンでリストをスクロー + ルできます。 - 「スライド」セクションに入ると、「ひらく」ダイアログと同じように、保存したファイルの一覧が表示されます。 + まず、絵をクリックして選択します… + + 左下にある緑色の「ひらく」ボタンで、選択した作品を読み込んで編集するこ + とができます。 - 次に、スライドショーで表示したい作品を、一つずつクリックして選択します。それぞれの画像の上に、スライドショーで表示される順番を表す数字が示されます。 + (または、開きたい作品をダブルクリックします） - 選択された画像をもう一度クリックすると、選択を解除し、スライドショーから除外します。同じ画像もう一度クリックすると、をリストの最後に追加できます。 + 💡 絵を開く時に、それまで描いていた絵が保存されていなければ、保存するか + どうかを確認します。（「セーブ」の項を参照） - 再生スピードの設定 + + 右下にある茶色の「けす」(ゴミ箱) ボタンで、選択した作品を削除します。 + (本当に削除して良いか確認されます) - 画面左下「かいし」の隣にあるのスライドバーで、スライドショーやアニメーションGIFのスピードを調節できます。 - スライドバーを一番左に設定すると、スライドショーの自動進行が無効になり、次のスライドに進むにはクリックが必要になります。（以下をご確認下さい） + 📜 注: Linux（バージョン 0.9.22以降）、Windows（バージョン 0.9.27以降） + 、macOS（バージョン 0.9.29以降）では、削除した作品は、デスクトップのゴ + ミ箱に移動するので、後で元に戻すことができます。 - 💡 注: - 最も遅いスピードに設定するとスライドの自動進行が無効になります。１枚ずつ手動でスライドを進めたい場合に、この設定を用いてください。（この動作はアニメーションGIFには適用されません） + ⚙ 注: 「けす」ボタンは、"noerase" オプションで無効にできます。 - Tux Paint 上での再生 + + 右下の「かきだす」のボタンをクリックすると、ユーザーの標準の画像フォル + ダ（例: "~/Pictures/TuxPaint/")に画像を出力します。 - Tux Paint 内でスライドショーを再生するには「かいし」ボタンをクリックします。 + 「ひらく」の画面からは、以下のこともできます: + + 左側の一番下にある青色の「スライド」のボタンを押すと、スライドショーモ + ードになります。詳しくは「スライドショー」の項を参照。 - 💡 注: 作品を一つも選択していない場合、保存されている全ての作品がスライドショーで表示されます！ + + 左下の青い「テンプレート」ボタンをクリックすると、選択した作品が新しい + テンプレートに変換され、「さいしょから」ダイアログから利用できるように + なります。 - スライドショーの実行中は、[Space] キー、[Enter] キー、[Return] キー、[右矢印] - キーのいずれかを押すか、または、画面左下の "つぎへ" - ボタンのクリックすれば、手動で次のスライドに進みます。[左矢印] キーを押すと前のスライドに戻ります。 + 📜 注: テンプレート作成機能は Tux Paint バージョン 0.9.31 で追加されまし + た。上記以外の方法で独自のテンプレートを作成するには, ドキュメント「Tux + Paint の拡張」をご覧下さい。 - [Escape] - キーを押すか、右下の「もどる」ボタンをクリックすると、スライドショーを終了し、作品選択の画面に戻ります。 + ⚙ テンプレート作成機能は、Tux Paint 設定ツールで「テンプレート作成機能 + を無効にする」を選択するか、"notemplateexport"オプションを指定してTux + Paintを起動することで無効にすることができます。 - アニメーションGIFの書き出し + + 右下にある赤色の「もどる」ボタンを押すと、絵を描く画面に戻ります。 - 右下の「かきだす」ボタンをクリックすると、選択した画像を元にアニメーションGIFファイルを生成します。 + ⌨ 注: キーボードで [Control / ⌘] + [O] を押しても「ひらく」ダイアログを表示 + できます。 - 💡 注: - 少なくとも２つの画像を選択する必要があります。（画像を１枚だけ書き出す場合は、「ひらく」ダイアログの「かきだす」オプションを用います）。１枚も画像を選択していない場合、アニメーションGIFは生成されません。 - アニメーションGIFの生成中に [Escape] - キーを押すと、処理を中断して「スライドショー」ダイアログに戻ります。 - さらに「もどる」ボタンをクリックすれば、「ひらく」ダイアログに戻ります。 +d.「セーブ」 - g.プログラムの終了 + 描画中の作品を保存します。 - 「やめる」ボタンを押すか、Tux Paint のウィンドウを閉じるか、[Escape] キーを押せば、Tux Paint - が終了します。 + 一度も保存していない作品の場合、作品のリストに新しく追加されます。(つまり、 + 新しいファイルを作成します) - その際、本当に終了するかどうかを確認されます。 + 💡 注: ファイル名の入力などを求めることはなく、カメラのシャッター音の効果音 + とともに、単に作品を保存します。 - 作品を保存していない状態で終了しようとした場合は、絵を保存するかどうかを訪ねられます。さらに、新規に作成した作品でなければ、以前のバージョンを上書きするか、新しく保存するかを確認されます。(上記の「セーブ」の項をご覧下さい。) + 一度保存操作をした後や、「ひらく」コマンドで読みこんだ作品の場合、以前のバ + ージョンを上書きするか、新しく追加して保存するかを確認します。 - ⚙ 注: "startblank" オプションが設定されている場合を除き、終了時に保存した作品は、次に Tux Paint - を起動するときに自動的に読み込まれます。 + ⚙ 注: "saveover" オプション、または "saveovernew" オプションのどちらかが設 + 定されている場合は、確認なしに保存されます。詳しくは"各種設定について"のド + キュメントを参照してください。) - ⚙ 注: 「やめる」ボタンと [Escape] キーによるプログラム終了は、"noquit" オプションで無効にできます。 + ⌨ 注: キーボードで [Control / ⌘] + [S] を押しても作品を保存できます。 - この場合、タイトルバーの「閉じる」ボタンか、[Alt] + [F4] キーで終了することができます。 - また、上記のどちらの方法も使えない場合、[Shift] + [Control / ⌘] + [Escape] - のキーの組み合わせで終了できます。 - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 +e.「いんさつ」 - h.効果音を消すには + このボタンを押して作品を印刷します！ + + 多くのプラットフォームでは、[Alt] key (Mac では [Option] キー) を押しながら + 「いんさつ」ボタンを押すと、プリンターの設定画面が開きます。この機能は、フ + ルスクリーンモードでは動作しない点に注意して下さい。 + + 印刷の無効化 + + オプションで "noprint" を設定すれば、「いんさつ」のボタンを無効にするこ + とができます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + + 印刷機能の制限 + + オプションで "printdelay" を設定すれば、設定に応じた一定の時間ごとに１ + 回だけしか印刷できなくなります。 + + 例えば、設定ファイルで "printdelay=602" と設定すれば、1分間に1回だけ印 + 刷ができます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + + 印刷コマンド + + (Linux 及び Unix の場合のみ) + + Tux Paint は、PostScript 形式の印刷データを作成し、外部プログラムに渡し + て印刷を行います。標準の設定では、以下のコマンドが使用されます: + + lpr + + このコマンドは、設定ファイルの "printcommand" オプションを設定すること + で変更できます。 + + フルスクリーンモードでなければ "[Alt]" キーを押しながら「いんさつ」ボタ + ンを押すと、別の印刷プログラムを起動することができます。標準の設定では + 、KDE のグラフィカルな印刷ダイアログである、以下のプログラムが使用され + ます: + + kprinter + + このコマンドは、設定ファイルの "altprintcommand" オプションを設定するこ + とで変更できます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + + プリンターの設定 + + (Windows 及び macOS) + + 標準の設定では、「いんさつ」ボタンを押すと、通常使うプリンターに出力さ + れます。 + + フルスクリーンモードでなければ、[Alt] (または [Option]) キーを押しなが + ら「いんさつ」ボタンを押すと、オペレーションシステム標準の印刷ダイアロ + グが表示され、出力先などの設定を変更することができます。 + + "printcfg" オプションを設定すれば、プリンターの設定の変更を保存すること + ができます。 + + "printcfg" オプションを設定すると、プリンターの設定は、ユーザーの個人フ + ォルダの "printcfg.cfg" から読み込まれ、変更した設定はこのファイルに保 + 存されます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + + 印刷ダイアログのオプション + + 標準の設定では、印刷ダイアログは、[Alt] (または [Option]) キーを押しな + がら「いんさつ」ボタンを押した場合にのみ表示されます（Linux/Unixでは、 + "lpr" の代わりに "altprintcommand"; すなわち "kprinter" が起動します。 + ） + + この印刷ダイアログの動作は、設定により変更できます。毎回必ず印刷ダイア + ログを表示させるには、コマンドラインで "--altprintalways" を指定するか + 、設定ファイルで "altprint=always" を指定します。反対に、 + "--altprintnever" または "altprint=never" を指定することで、"[Alt]" (ま + たは "[Option]2) キーの効果を無効にできます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + + + + +f.「スライドショー」 + + 「スライドショー」の機能は、「ひらく」ダイアログから利用できます。Tux Paint + の中で、簡単なアニメーションや画像のスライドショーを再生することができます + 。また、選択した画像を元にアニメーションGIFを書き出すこともできます。 + + 画像を選ぶ + + 「スライド」セクションに入ると、「ひらく」ダイアログと同じように、保存 + したファイルの一覧が表示されます。 + + 次に、スライドショーで表示したい作品を、一つずつクリックして選択します + 。それぞれの画像の上に、スライドショーで表示される順番を表す数字が示さ + れます。 + + 選択された画像をもう一度クリックすると、選択を解除し、スライドショーか + ら除外します。同じ画像もう一度クリックすると、をリストの最後に追加でき + ます。 + + + + 再生スピードの設定 + + 画面左下「かいし」の隣にあるのスライドバーで、スライドショーやアニメー + ションGIFのスピードを調節できます。スライドバーを一番左に設定すると、ス + ライドショーの自動進行が無効になり、次のスライドに進むにはクリックが必 + 要になります。（以下をご確認下さい） + + 💡 注: 最も遅いスピードに設定するとスライドの自動進行が無効になります。 + １枚ずつ手動でスライドを進めたい場合に、この設定を用いてください。（こ + の動作はアニメーションGIFには適用されません） + + + + Tux Paint 上での再生 + + Tux Paint 内でスライドショーを再生するには「かいし」ボタンをクリックし + ます。 + + 💡 注: 作品を一つも選択していない場合、保存されている全ての作品がスライ + ドショーで表示されます！ + + スライドショーの実行中は、[Space] キー、[Enter] キー、[Return] キー、 + [右矢印] キーのいずれかを押すか、または、画面左下の "つぎへ" ボタンのク + リックすれば、手動で次のスライドに進みます。[左矢印] キーを押すと前のス + ライドに戻ります。 + + [Escape] キーを押すか、右下の「もどる」ボタンをクリックすると、スライド + ショーを終了し、作品選択の画面に戻ります。 + + + + アニメーションGIFの書き出し + + 右下の「かきだす」ボタンをクリックすると、選択した画像を元にアニメーシ + ョンGIFファイルを生成します。 + + 💡 注: 少なくとも２つの画像を選択する必要があります。（画像を１枚だけ書 + き出す場合は、「ひらく」ダイアログの「かきだす」オプションを用います） + 。１枚も画像を選択していない場合、アニメーションGIFは生成されません。 + + アニメーションGIFの生成中に [Escape] キーを押すと、処理を中断して「スラ + イドショー」ダイアログに戻ります。 + + + + + さらに「もどる」ボタンをクリックすれば、「ひらく」ダイアログに戻ります。 + + + +g.プログラムの終了 + + 「やめる」ボタンを押すか、Tux Paint のウィンドウを閉じるか、[Escape] キーを + 押せば、Tux Paint が終了します。 + + その際、本当に終了するかどうかを確認されます。 + + 作品を保存していない状態で終了しようとした場合は、絵を保存するかどうかを訪 + ねられます。さらに、新規に作成した作品でなければ、以前のバージョンを上書き + するか、新しく保存するかを確認されます。(上記の「セーブ」の項をご覧下さい + 。) + + ⚙ 注: "startblank" オプションが設定されている場合を除き、終了時に保存した作 + 品は、次に Tux Paint を起動するときに自動的に読み込まれます。 + + ⚙ 注: 「やめる」ボタンと [Escape] キーによるプログラム終了は、"noquit" オプ + ションで無効にできます。 + + この場合、タイトルバーの「閉じる」ボタンか、[Alt] + [F4] キーで終了すること + ができます。 + + また、上記のどちらの方法も使えない場合、[Shift] + [Control / ⌘] + [Escape] + のキーの組み合わせで終了できます。 + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 + + + +h.効果音を消すには + + 今のところ画面上には消音のためのボタンはありませんが、[Alt] + [S] キーを押 + すと効果音は無効になり、もう一度押すと有効になります。 + + なお、"nosound" オプションによって効果音が無効にされている場合は、[Alt] + + [S] キーによる効果音の操作はできません。（親や先生が効果音を無効にすれば、 + この操作で音を出すことはできないということです） + + ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 - 今のところ画面上には消音のためのボタンはありませんが、[Alt] + [S] - キーを押すと効果音は無効になり、もう一度押すと有効になります。 - なお、"nosound" オプションによって効果音が無効にされている場合は、[Alt] + [S] - キーによる効果音の操作はできません。（親や先生が効果音を無効にすれば、この操作で音を出すことはできないということです） - ⚙ 詳細は "各種設定について" のドキュメントを参照して下さい。 E. 操作方法 - 1. マウス・トラックボールによる操作 +1. マウス・トラックボールによる操作 - Tux Paint - の操作の大部分は、標準的なマウス、トラックボール、トラックパッド、お絵かきタブレット（通常はスタイラスペンで操作）、タッチスクリーン（指やスタイラスペンで操作）など、OS上でマウスとして認識されるデバイスを使用します（詳しくは後述の「タブレット端末やタッチスクリーンでの操作」をご覧ください）。 +Tux Paint の操作の大部分は、標準的なマウス、トラックボール、トラックパッド、お +絵かきタブレット（通常はスタイラスペンで操作）、タッチスクリーン（指やスタイラ +スペンで操作）など、OS上でマウスとして認識されるデバイスを使用します（詳しくは +後述の「タブレット端末やタッチスクリーンでの操作」をご覧ください）。 - 通常はマウスの左ボタンを使用しますが、これはOSレベルの設定で変更することができます。デフォルトでは他のボタンからの入力は無視され、他のボタンを使用しようとすると、認識できるのは1つのボタンだけであることを知らせるポップアップダイアログが表示されます。ただし、どのボタンからの入力も受け付けるように設定することもできます（ドキュメント「各種設定について」を参照してください）。 +通常はマウスの左ボタンを使用しますが、これはOSレベルの設定で変更することができ +ます。デフォルトでは他のボタンからの入力は無視され、他のボタンを使用しようとす +ると、認識できるのは1つのボタンだけであることを知らせるポップアップダイアログが +表示されます。ただし、どのボタンからの入力も受け付けるように設定することもでき +ます（ドキュメント「各種設定について」を参照してください）。 - a. スクロール操作 +a. スクロール操作 - マウスホイール、トラックボールのスクロールリング、トラックパッドの「スクロール」ジェスチャー（2本指での垂直移動やトラックパッドの端での垂直移動など）はスクロール入力として認識され、スタンプ、まほうツール、新規作成ダイアログや開くダイアログなどのリストを素早くスクロールできます。 +マウスホイール、トラックボールのスクロールリング、トラックパッドの「スクロール +」ジェスチャー（2本指での垂直移動やトラックパッドの端での垂直移動など）はスクロ +ール入力として認識され、スタンプ、まほうツール、新規作成ダイアログや開くダイア +ログなどのリストを素早くスクロールできます。 - また、これらのリストの上下にあるスクロールボタンをクリックし続ければ自動的にスクロールします。 +また、これらのリストの上下にあるスクロールボタンをクリックし続ければ自動的にス +クロールします。 - b. マウスによる操作 +b. マウスによる操作 - 上記のほかにも、マウスとして認識される以下のようなデバイスであれば、Tux Paint の操作に使用できます: - * ヘッドポインティング/トラッキングデバイス - * 視線追跡デバイス - * フットマウス +上記のほかにも、マウスとして認識される以下のようなデバイスであれば、Tux Paint +の操作に使用できます: - Tux Paint - には「マウスクリックのトグル動作」という操作設定があり、シングルクリックでクリック＆ドラッグ操作が始まり、その後のクリックで終了します。（ドキュメント「各種設定について」を参照してください） + * ヘッドポインティング/トラッキングデバイス + * 視線追跡デバイス + * フットマウス - 2. タブレット端末やタッチスクリーンでの操作 +Tux Paint には「マウスクリックのトグル動作」という操作設定があり、シングルクリ +ックでクリック＆ドラッグ操作が始まり、その後のクリックで終了します。（ドキュメ +ント「各種設定について」を参照してください） - 上述のように Tux Paint はマウスとして認識されるあらゆるデバイス ー タブレットやタッチスクリーンなど ー - を使用することができます。これらのデバイスの多くは以下のような追加機能をサポートしていますが、これらは現在のところ Tux Paint - ではサポートされていません: - * 筆圧や傾きの検出 - * けしゴムペン先機能 - * マルチタッチジェスチャー +2. タブレット端末やタッチスクリーンでの操作 - 3. ジョイスティック等のデバイスによる操作 +上述のように Tux Paint はマウスとして認識されるあらゆるデバイスータブレットやタ +ッチスクリーンなどーを使用することができます。これらのデバイスの多くは以下のよ +うな追加機能をサポートしていますが、これらは現在のところ Tux Paint ではサポート +されていません: - Tux Paintは OS - 上でジョイスティックとして表示されるあらゆるゲームコントローラーからの入力を認識するように設定できます。USBやBluetoothで接続された最新のゲーム機のコントローラー（Nintendo - SwitchやMicrosoft Xboxのゲームパッドなど）も含まれます！ + * 筆圧や傾きの検出 + * けしゴムペン先機能 + * マルチタッチジェスチャー - 使用する機器やユーザーのニーズに合わせて、数多くの設定オプションが用意されています。おおまかな動きにはアナログ入力が使われ、細かい動きにはデジタルの「ハット」入力が使われます。コントローラーのボタンは、Tux - Paintのさまざまな操作にマッピングできます（例えば [Escape] - キーとして機能したり、ペイントツールに切り替えたり、UndoやRedo操作を呼び出したりなど）。詳しくはドキュメント「各種設定について」を参照してください。 +3. ジョイスティック等のデバイスによる操作 - 4. キーボードによる操作 +Tux Paintは OS 上でジョイスティックとして表示されるあらゆるゲームコントローラー +からの入力を認識するように設定できます。USBやBluetoothで接続された最新のゲーム +機のコントローラー（Nintendo SwitchやMicrosoft Xboxのゲームパッドなど）も含まれ +ます！ - タックスペイントでは、キーボードからマウスポインタを操作することができます。これには、マウスポインタの移動とクリック、およびインターフェイスの特定の部分を移動するためのショートカットが含まれます。詳しくはドキュメント「各種設定について」を参照してください。 +使用する機器やユーザーのニーズに合わせて、数多くの設定オプションが用意されてい +ます。おおまかな動きにはアナログ入力が使われ、細かい動きにはデジタルの「ハット +」入力が使われます。コントローラーのボタンは、Tux Paintのさまざまな操作にマッピ +ングできます（例えば [Escape] キーとして機能したり、ペイントツールに切り替えた +り、UndoやRedo操作を呼び出したりなど）。詳しくはドキュメント「各種設定について +」を参照してください。 - III. 他の画像の Tux Paint への読み込み +4. キーボードによる操作 + +タックスペイントでは、キーボードからマウスポインタを操作することができます。こ +れには、マウスポインタの移動とクリック、およびインターフェイスの特定の部分を移 +動するためのショートカットが含まれます。詳しくはドキュメント「各種設定について +」を参照してください。 + +III. 他の画像の Tux Paint への読み込み A. 概要 - Tux Paint の「ひらく」ダイアログでは、Tux Paint - で作成した画像だけが表示されます。その他の画像や写真を読み込んで編集するにはどのようにすれば良いでしょうか？ +Tux Paint の「ひらく」ダイアログでは、Tux Paint で作成した画像だけが表示されま +す。その他の画像や写真を読み込んで編集するにはどのようにすれば良いでしょうか？ - そのための方法は簡単で、画像ファイルを PNG (Portable Network Graphic) 形式に変換して、Tux Paint - で作成した画像が保存されている "saved" フォルダにコピーします。（標準では以下のフォルダ）: +そのための方法は簡単で、画像ファイルを PNG (Portable Network Graphic) 形式に変 +換して、Tux Paint で作成した画像が保存されている "saved" フォルダにコピーします +。（標準では以下のフォルダ）: - Windows 10, 8, 7, Vista - 各ユーザーの "AppData" フォルダ。例: - "C:\Users\username\AppData\Roaming\TuxPaint\saved\"。 +Windows 10, 8, 7, Vista + 各ユーザーの "AppData" フォルダ。例: "C:\Users\username\AppData\Roaming\ + TuxPaint\saved\"。 - Windows 2000, XP - 各ユーザーの "Application Data" フォルダ。例: "C:\Documents and - Settings\username\Application Data\TuxPaint\saved\"。 +Windows 2000, XP + 各ユーザーの "Application Data" フォルダ。例: "C:\Documents and Settings\ + username\Application Data\TuxPaint\saved\"。 - macOS - 各ユーザーの "Library" フォルダ。例: "/Users/username/Library/Application - Support/Tux Paint/saved/"。 +macOS + 各ユーザーの "Library" フォルダ。例: "/Users/username/Library/Application + Support/Tux Paint/saved/"。 - Linux/Unix - 各ユーザーのホームディレクトリ("$HOME")の隠しディレクトリ ".tuxpaint" 以下 ― 例: - "/home/username/.tuxpaint/saved/"。 +Linux/Unix + 各ユーザーのホームディレクトリ("$HOME")の隠しディレクトリ ".tuxpaint" 以下 + ― 例: "/home/username/.tuxpaint/saved/"。 - 💡 注: Tux Paint - で作成した画像を他のアプリケーションを使って開く場合も、これらのフォルダからになります。しかしながら、「ひらく」ダイアログの「かきだす」の機能を使えば、Tux - Paint で作成した画像を、もっと簡単で安全にアクセスできるフォルダにコピーすることができます。 + +💡 注: Tux Paint で作成した画像を他のアプリケーションを使って開く場合も、これら +のフォルダからになります。しかしながら、「ひらく」ダイアログの「かきだす」の機 +能を使えば、Tux Paint で作成した画像を、もっと簡単で安全にアクセスできるフォル +ダにコピーすることができます。 B. "tuxpaint-import" スクリプトを使う - Linux と Unix では、Tux Paint と同時に、シェルスクリプト "tuxpaint-import" - がインストールされています。このスクリプトは、NetPBM のツール ("anytopnm") を用いて画像を変換し、 Tux Paint - のキャンバスに合うように画像サイズを変更 ("pnmscale") し、PNG 形式に変換 ("pnmtopng") します。 +Linux と Unix では、Tux Paint と同時に、シェルスクリプト "tuxpaint-import" がイ +ンストールされています。このスクリプトは、NetPBM のツール ("anytopnm") を用いて +画像を変換し、 Tux Paint のキャンバスに合うように画像サイズを変更 ("pnmscale") +し、PNG 形式に変換 ("pnmtopng") します。 - また、このスクリプトは、"date" コマンドを使用して、Tux Paint - が保存するファイル名に用いる日付と時刻を取得します。(作品を保存したり開いたりするときに、ファイル名を聞かれることはない、ということを思い出してください！) +また、このスクリプトは、"date" コマンドを使用して、Tux Paint が保存するファイル +名に用いる日付と時刻を取得します。(作品を保存したり開いたりするときに、ファイル +名を聞かれることはない、ということを思い出してください！) - スクリプトの使用法は簡単で、コマンドプロンプトで、取り込みたい画像のファイル名を引数として実行するだけです。 +スクリプトの使用法は簡単で、コマンドプロンプトで、取り込みたい画像のファイル名 +を引数として実行するだけです。 - ファイルは変換された後、Tux Paint の "saved" ディレクトリに格納されます。 +ファイルは変換された後、Tux Paint の "saved" ディレクトリに格納されます。 - 💡 注: 例えばお子さんなど、他のユーザーのために変換作業を行う場合は、そのユーザーのアカウントでコマンドを実行する必要があります。 +💡 注: 例えばお子さんなど、他のユーザーのために変換作業を行う場合は、そのユーザ +ーのアカウントでコマンドを実行する必要があります。 - 例: +例: - $ tuxpaint-import おばあちゃん.jpg - おばあちゃん.jpg -> /home/username/.tuxpaint/saved/20211231012359.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import おばあちゃん.jpg + おばあちゃん.jpg -> /home/username/.tuxpaint/saved/20211231012359.png + jpegtopnm: WRITING A PPM FILE - 1行目 ("tuxpaint-import おばあちゃん.jpg") が実行するコマンドで、続く2行がプログラムの実行中の出力です。 +1行目 ("tuxpaint-import おばあちゃん.jpg") が実行するコマンドで、続く2行がプロ +グラムの実行中の出力です。 - これで、Tux Paint を起動して、「ひらく」ダイアログから変換した画像を開くことができます。後は、アイコンをダブルクリックするだけです！ +これで、Tux Paint を起動して、「ひらく」ダイアログから変換した画像を開くことが +できます。後は、アイコンをダブルクリックするだけです！ C. 手動での取り込み - Windows、MacOS、BeOS、そして Haiku のユーザーは、手動で変換作業を行う必要があります。 +Windows、MacOS、BeOS、そして Haiku のユーザーは、手動で変換作業を行う必要があり +ます。 - 変換したい画像ファイルの読み込み、PNG - 形式ファイルでの保存に対応した画像処理プログラムを起動します。(推奨されるソフトウェア、その他の情報については、"PNG.html" - をお読みください。) +変換したい画像ファイルの読み込み、PNG 形式ファイルでの保存に対応した画像処理プ +ログラムを起動します。(推奨されるソフトウェア、その他の情報については、" +PNG.html" をお読みください。) - Tux Paint で、描画キャンパスと異なる大きさの画像を読み込む場合、キャンバスに合うように拡大・縮小されます。 +Tux Paint で、描画キャンパスと異なる大きさの画像を読み込む場合、キャンバスに合 +うように拡大・縮小されます。 - 画像が引き伸ばされたりぼやけたりしないようにするには、キャンパスの大きさに合うようにサイズを変更します。キャンパスの大きさは、Tux Paint - のウィンドウサイズや、フルスクリーン動作時の画面解像度に依存します。(注: 標準の解像度は 800x600 です)。 以下の - "イメージサイズの計算方法" をごらんください。 +画像が引き伸ばされたりぼやけたりしないようにするには、キャンパスの大きさに合う +ようにサイズを変更します。キャンパスの大きさは、Tux Paint のウィンドウサイズや +、フルスクリーン動作時の画面解像度に依存します。(注: 標準の解像度は 800x600 で +す)。以下の "イメージサイズの計算方法" をごらんください。 - 1. ファイル名の付け方 +1. ファイル名の付け方 - 画像は PNG 形式で保存してください。また、以下のように、Tux Paint - における命名規則である、現在の日付と時刻を用いたファイル名を使用することを強くお勧めします。 +画像は PNG 形式で保存してください。また、以下のように、Tux Paint における命名規 +則である、現在の日付と時刻を用いたファイル名を使用することを強くお勧めします。 - YYYYMMDDhhmmss.png + YYYYMMDDhhmmss.png - * YYYY = 年 - * MM = 月 (2桁, "01"-"12") - * DD = 日 (2桁, "01"-"31") - * HH = 時 (2桁, 24時間表示, "00"-"23") - * mm = 分 (2桁, "00"-"59") - * ss = 秒 (2桁, "00"-"59") + * YYYY = 年 + * MM = 月 (2桁, "01"-"12") + * DD = 日 (2桁, "01"-"31") + * HH = 時 (2桁, 24時間表示, "00"-"23") + * mm = 分 (2桁, "00"-"59") + * ss = 秒 (2桁, "00"-"59") - 例: 2021年7月31日 午前11時5分であれば、20210731110500.png のようになります。 +例: 2021年7月31日午前11時5分であれば、20210731110500.png のようになります。 - PNG ファイルを Tux Paint の "saved" ディレクトリにコピーします。（上記参照） +PNG ファイルを Tux Paint の "saved" ディレクトリにコピーします。（上記参照） - 2. イメージサイズの計算方法 +2. イメージサイズの計算方法 - "buttonsize" のオプションが追加されたため、この部分は全面的に書き直す必要があります。とりあえずは、Tux Paint - で作成した画像のサイズ（ピクセル幅と高さ）を調べて、取り込む画像をそれに合わせて拡大縮小してみてください。 +"buttonsize" のオプションが追加されたため、この部分は全面的に書き直す必要があり +ます。とりあえずは、Tux Paint で作成した画像のサイズ（ピクセル幅と高さ）を調べ +て、取り込む画像をそれに合わせて拡大縮小してみてください。 - IV.その他のドキュメント +IV.その他のドキュメント - このドキュメントの他、"docs" フォルダには、次のようなドキュメントがあります: +このドキュメントの他、"docs" フォルダには、次のようなドキュメントがあります: - Tux Paint の使用: - * OPTIONS.html - コマンドライン、設定ファイルのオプションに関する詳細な情報。Tux Paint Config を使用したくない人向け。 - * 「まほう」ツールに関するドキュメント ("magic-docs") - インストールされている、それぞれの「まほう」ツールに関する説明。 +Tux Paint の使用: + + OPTIONS.html + コマンドライン、設定ファイルのオプションに関する詳細な情報。Tux Paint + Config を使用したくない人向け。 + + 「まほう」ツールに関するドキュメント ("magic-docs") + インストールされている、それぞれの「まほう」ツールに関する説明。 - Tux Paint の拡張: - * EXTENDING.html - ブラシ、はんこ、背景画像の作成方法、フォントを追加する方法、追加のスクリーンキーボードの作成、言語入力の追加など、Tux - Paint の拡張についての詳細説明。 - * PNG.html - PNG 形式の画像を作成する方法。 - * SVG.html - SVG 形式のヴェクタ画像を作成する方法。 - 技術情報: - * INSTALL.html - コンパイル、インストールの手順. - * SIGNALS.html - Tux Paint が応答する POSIX シグナルに関する情報。 - * MAGIC-API.html - プラグインAPIを用いた独自の「まほう」ツールの作成 +Tux Paint の拡張: + + EXTENDING.html + ブラシ、はんこ、背景画像の作成方法、フォントを追加する方法、追加のスク + リーンキーボードの作成、言語入力の追加など、Tux Paint の拡張についての + 詳細説明。 + + PNG.html + PNG 形式の画像を作成する方法。 + + SVG.html + SVG 形式のヴェクタ画像を作成する方法。 - 開発の記録及びライセンス: - * AUTHORS.txt - 作者と協力者のリスト. - * CHANGES.txt - リリース毎の変更点の概要. - * COPYING.txt - Tux Paint ソフトウェアのライセンス GNU 一般公衆利用許諾 (GPL) - V.お問い合わせ先 +技術情報: + + INSTALL.html + コンパイル、インストールの手順. + + SIGNALS.html + Tux Paint が応答する POSIX シグナルに関する情報。 + + MAGIC-API.html + プラグインAPIを用いた独自の「まほう」ツールの作成 - お困りのことがある場合、Tux Paint の開発者や他のユーザーとコミュニケーションをとるための多くの方法があります。 - * バグを発見した場合や機能追加の要望については、プロジェクトの バグトラッキングシステムから報告できます - * プロジェクトに関する様々なメーリングリストに参加できます - * 開発者へ直接連絡することもできます - もっとお知りになりたい場合、Tux Paint のウェブサイト の "連絡先" のページ - (https://tuxpaint.org/contact/) をごらん下さい +開発の記録及びライセンス: + + AUTHORS.txt + 作者と協力者のリスト. + + CHANGES.txt + リリース毎の変更点の概要. + + COPYING.txt + Tux Paint ソフトウェアのライセンス GNU 一般公衆利用許諾 (GPL) - VI.プロジェクトへの参加 - Tux Paint はボランティアベースのプロジェクトであり、様々な形でのご協力を受け付けています。 - * Tux Paint の翻訳の作成 - * 既存の翻訳の改善 - * アートワークの作成 (スタンプ、背景画像、ペイントブラシなど) - * 機能の追加や改良、「まほう」ツールの作成 - * 学習教材の作成 - * 宣伝や、他の Tux Paint ユーザーのサポート - もっとお知りになりたい場合、Tux Paint のウェブサイト の "私たちにご協力を" のページ - (https://tuxpaint.org/help/) をごらん下さい +V.お問い合わせ先 - VII.Tux Paint プロジェクトの SNS アカウント +お困りのことがある場合、Tux Paint の開発者や他のユーザーとコミュニケーションを +とるための多くの方法があります。 - Tux Paint は様々な SNS アカウントを利用し、最新情報や作品を投稿しています。 - * Facebook で Tux Paint のページに参加する - * Instagram で @TuxPaintDevs をフォローする - * Mastdon で @tuxpaint@floss.socal をフォローする - * Reddit で u/TuxPaintDevs をフォローする - * Threads で @TuxPaintDevs をフォローする - * Tumblr で Tux Paint をフォローする - * Twitter で @TuxPaintTweets をフォローする + * バグを発見した場合や機能追加の要望については、プロジェクトのバグトラッキン + グシステムから報告できます + * プロジェクトに関する様々なメーリングリストに参加できます + * 開発者へ直接連絡することもできます - VIII. 商標について +もっとお知りになりたい場合、Tux Paint のウェブサイトの "連絡先" のページ ( +https://tuxpaint.org/contact/) をごらん下さい + +VI.プロジェクトへの参加 + +Tux Paint はボランティアベースのプロジェクトであり、様々な形でのご協力を受け付 +けています。 + + * Tux Paint の翻訳の作成 + * 既存の翻訳の改善 + * アートワークの作成 (スタンプ、背景画像、ペイントブラシなど) + * 機能の追加や改良、「まほう」ツールの作成 + * 学習教材の作成 + * 宣伝や、他の Tux Paint ユーザーのサポート + +もっとお知りになりたい場合、Tux Paint のウェブサイトの "私たちにご協力を" のペ +ージ (https://tuxpaint.org/help/) をごらん下さい + +VII.Tux Paint プロジェクトの SNS アカウント + +Tux Paint は様々な SNS アカウントを利用し、最新情報や作品を投稿しています。 + + * Facebook で Tux Paint のページに参加する + * Instagram で @TuxPaintDevs をフォローする + * Mastdon で @tuxpaint@floss.socal をフォローする + * Reddit で u/TuxPaintDevs をフォローする + * Threads で @TuxPaintDevs をフォローする + * Tumblr で Tux Paint をフォローする + * Twitter で @TuxPaintTweets をフォローする + +VIII. 商標について + + * "Linux" は Linus Torvalds の登録商標です。 + * "Microsoft" および "Windows" は、Microsoft 社の登録商標です。 + * "Apple" および "macOS" は Apple 社の登録商標です。 + * "Facebook", "Instagram" および "Threads" は Meta Platforms 社の登録商標です + 。 + * "Mastodon" は Mastodon gGmbH の登録商標です。 + * "Reddit" は、Reddit 社の登録商標です。 + * "Tumblr" は Tumblr 社の登録商標です。 + * "Twitter" は、X 社の登録商標です。 - * "Linux" は Linus Torvalds の登録商標です。 - * "Microsoft" および "Windows" は、Microsoft 社の登録商標です。 - * "Apple" および "macOS" は Apple 社の登録商標です。 - * "Facebook", "Instagram" および "Threads" は Meta Platforms 社の登録商標です。 - * "Mastodon" は Mastodon gGmbH の登録商標です。 - * "Reddit" は、Reddit 社の登録商標です。 - * "Tumblr" は Tumblr 社の登録商標です。 - * "Twitter" は、X 社の登録商標です。 diff --git a/docs/ja_JP.UTF-8/SIGNALS.txt b/docs/ja_JP.UTF-8/SIGNALS.txt index b09f3feff..fa87670fc 100644 --- a/docs/ja_JP.UTF-8/SIGNALS.txt +++ b/docs/ja_JP.UTF-8/SIGNALS.txt @@ -1,53 +1,57 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 Signals Documentation - Copyright © 2019-2022 by various contributors; AUTHORS.txt 参照. + Copyright © 2019-2022 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2022年6月 4日 + 2022年6月 4日 - Tux Paint responds to the following signals (which can be sent to the - program's process via `kill` or `killall`, for example). +Tux Paint responds to the following signals (which can be sent to the program's +process via `kill` or `killall`, for example). - SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) +SIGTERM (also, [Control] + [C] from a terminal running `tuxpaint`) - Tux Paint responds as if the "Quit" button were pressed, or the - desktop environment was told to close Tux Paint (e.g., by clicking - a window close button, or pressing [Alt] + [F4] on most systems). + Tux Paint responds as if the "Quit" button were pressed, or the desktop + environment was told to close Tux Paint (e.g., by clicking a window close + button, or pressing [Alt] + [F4] on most systems). - From the main interface, Tux Paint will prompt whether or not you - wish to quit, and (unless overridden by the auto-save option, e.g. - "--autosave") if you'd like to save the current drawing (if - unsaved), and if so, and it's a modified version of an existing - drawing (unless overridden by the options to save over old images, - or always save new images; e.g. "--saveover" and "--saveovernew", - respectively), whether or not to overwrite the existing drawing, - or save to a new file. + From the main interface, Tux Paint will prompt whether or not you wish to + quit, and (unless overridden by the auto-save option, e.g. "--autosave") if + you'd like to save the current drawing (if unsaved), and if so, and it's a + modified version of an existing drawing (unless overridden by the options + to save over old images, or always save new images; e.g. "--saveover" and + "--saveovernew", respectively), whether or not to overwrite the existing + drawing, or save to a new file. - 例: killall tuxpaint + 例: killall tuxpaint - 💡 Note: From other parts of the interface, the signal is currently - interpreted as a request to go back (e.g., from the "New" dialog - back to the main interface), as if a "Back" button in Tux Paint - were clicked, or the [Esc] was key pressed. + 💡 Note: From other parts of the interface, the signal is currently + interpreted as a request to go back (e.g., from the "New" dialog back to + the main interface), as if a "Back" button in Tux Paint were clicked, or + the [Esc] was key pressed. - SIGUSR1 & SIGUSR2 - Tux Paint responds by setting its auto-save option (as if it had - been launched with "--autosave"), as well as either the option to - always save new images (as if launched with "--saveovernew") in - the case of receiving a SIGUSR1 signal, or to always save over the - existing image (as if launched with "--saveover") in the case of - receiving SIGUSR2. Then Tux Paint sends itself a SIGTERM signal, - in an attempt to quit. (See above.) - So, from the main interface, Tux Paint should quit almost - immediately, with no questions asked. +SIGUSR1 & SIGUSR2 + + Tux Paint responds by setting its auto-save option (as if it had been + launched with "--autosave"), as well as either the option to always save + new images (as if launched with "--saveovernew") in the case of receiving a + SIGUSR1 signal, or to always save over the existing image (as if launched + with "--saveover") in the case of receiving SIGUSR2. Then Tux Paint sends + itself a SIGTERM signal, in an attempt to quit. (See above.) + + So, from the main interface, Tux Paint should quit almost immediately, with + no questions asked. + + 例: killall -s SIGUSR1 tuxpaint + + 💡 Note: From other parts of the interface, unfortunately, Tux Paint will go + back one level in the interface. Therefore, at this time, it may be + necessary to send this signal to Tux Paint a few times, for it to quit + completely. + + - 例: killall -s SIGUSR1 tuxpaint - 💡 Note: From other parts of the interface, unfortunately, Tux - Paint will go back one level in the interface. Therefore, at this - time, it may be necessary to send this signal to Tux Paint a few - times, for it to quit completely. diff --git a/docs/ja_JP.UTF-8/SVG.txt b/docs/ja_JP.UTF-8/SVG.txt index 6ab967aab..12d79f1c9 100644 --- a/docs/ja_JP.UTF-8/SVG.txt +++ b/docs/ja_JP.UTF-8/SVG.txt @@ -1,36 +1,37 @@ Tux Paint - バージョン 0.9.31 + バージョン 0.9.31 SVG Documentation - Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照. + Copyright © 2007-2022 by various contributors; AUTHORS.txt 参照. https://tuxpaint.org/ - 2022年6月 4日 + 2022年6月 4日 - About SVGs +About SVGs - SVG (Scalable Vector Graphics) is an open standard used to describe - two-dimensional vector graphics. It is great for diagrams and shapes, - while PNGs are better for photographs. SVG files are a bit like - instructions on how to make an image. This means that they can be resized - without looking pixelated or blocky. +SVG (Scalable Vector Graphics) is an open standard used to describe +two-dimensional vector graphics. It is great for diagrams and shapes, while +PNGs are better for photographs. SVG files are a bit like instructions on how +to make an image. This means that they can be resized without looking pixelated +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 - Inkscape, a high-quality Open Source interactive drawing program available - for Windows, macOS, and Linux. There are also other applications that can - produce SVGs, both free/open source, and commerical/proprietary. +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 for +Windows, macOS, and Linux. There are also other applications that can produce +SVGs, both free/open source, and commerical/proprietary. - Open Source - * Inkscape — http://www.inkscape.org/ - * Karbon — https://calligra.org/karbon/ +Open Source + + Inkscape — http://www.inkscape.org/ + + Karbon — https://calligra.org/karbon/ + + +Proprietary + + CorelDRAW (Corel) — https://www.coreldraw.com/en/ + + Illustrator (Adobe) — http://www.adobe.com/products/illustrator.html + + Boxy SVG — https://boxy-svg.com/ + + Sketch (Sketch B.V.) — https://boxy-svg.com/ - Proprietary - * CorelDRAW (Corel) — https://www.coreldraw.com/en/ - * Illustrator (Adobe) — - http://www.adobe.com/products/illustrator.html - * Boxy SVG — https://boxy-svg.com/ - * Sketch (Sketch B.V.) — https://boxy-svg.com/ diff --git a/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt b/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt index e7e2c7b7e..a557d62f4 100644 --- a/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt +++ b/docs/ja_JP.UTF-8/tuxpaint-quickstart-guide.txt @@ -1,174 +1,215 @@ - Tux Paint 0.9.29 クイックスタートガイド +Tux Paint 0.9.29 クイックスタートガイド 描画ツール - 🖌ふで +🖌ふで - * 右側のブラシを選択します。 - * ブラシには、アニメーションするもの 🎞, 方向があるもの ✲ があり、両方を併せ持つブラシもあります。 - * 右下のバー 📶 でブラシの間隔を変更します。 - * 色を選択します（"色" のセクションを参照） - * キャンバスをクリックまたはタップしてドラッグし、描画します。 + * 右側のブラシを選択します。 + * ブラシには、アニメーションするもの 🎞, 方向があるもの ✲ があり、両方を併せ持 + つブラシもあります。 + * 右下のバー 📶 でブラシの間隔を変更します。 + * 色を選択します（"色" のセクションを参照） + * キャンバスをクリックまたはタップしてドラッグし、描画します。 - ⌧はんこ +⌧はんこ - * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 - * 右側のスタンプを選択してください。 - * スタンプの中には、右下の操作ボタンを使って、上下 🪞 左右 ↕ に反転させることができるものがあります。 - * 色を変えられるスタンプもあります（"色" のセクションを参照） - * 右下のバー 📶 でスタンプのサイズを変更します。 - * 回転 ⟳ は、お好みに応じて有効にすることができます。 - * キャンバスをクリックまたはタップしてスタンプの位置を決めます。 - * 回転が有効に設定されている場合、ドラッグして回転させ、もう一度クリックまたはタップして描画します。 - * 効果音があるスタンプでは、スピーカー 🕪 ボタンを押すと、もう一度聞くことができます。 - * 音声解説付きのスタンプもあります。ヘッドフォン 🎧 ボタンを押すと、もう一度聞くことができます。 + * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 + * 右側のスタンプを選択してください。 + * スタンプの中には、右下の操作ボタンを使って、上下 🪞 左右 ↕ に反転させること + ができるものがあります。 + * 色を変えられるスタンプもあります（"色" のセクションを参照） + * 右下のバー 📶 でスタンプのサイズを変更します。 + * 回転 ⟳ は、お好みに応じて有効にすることができます。 + * キャンバスをクリックまたはタップしてスタンプの位置を決めます。 + + 回転が有効に設定されている場合、ドラッグして回転させ、もう一度クリック + またはタップして描画します。 + * 効果音があるスタンプでは、スピーカー 🕪 ボタンを押すと、もう一度聞くことがで + きます。 + * 音声解説付きのスタンプもあります。ヘッドフォン 🎧 ボタンを押すと、もう一度聞 + くことができます。 - ⚟せん +⚟せん - * （描画ツールのセクションを参照） - * クリックまたはタップしてドラッグし、線を引きます。 + * （描画ツールのセクションを参照） + * クリックまたはタップしてドラッグし、線を引きます。 - ⭓かたち +⭓かたち - * 右側の図形を選択してください。 - * 右下のコントロールを使用して、図形を中心 ⧈ から広げるかコーナー ◰ から広げるかを選択します。 - * クリックまたはタップして位置を決め、ドラッグして大きさを変えます。 - * ドラッグして回転させ、もう一度クリックまたはタップして描画します。 + * 右側の図形を選択してください。 + * 右下のコントロールを使用して、図形を中心 ⧈ から広げるかコーナー ◰ から広げ + るかを選択します。 + * クリックまたはタップして位置を決め、ドラッグして大きさを変えます。 + * ドラッグして回転させ、もう一度クリックまたはタップして描画します。 - 🄰もじ +🄰もじ - * 右側のフォントを選択します。 - * 右下にあるコントロールを使用して、太字 𝗔 や斜体 𝘈 にするかを選択します。 - * 右下の上矢印 🡁 と下矢印 🡃 ボタンを使用して、テキストのサイズを変更します。 - * 色を選択します（"色" のセクションを参照） - * キャンバスをクリックまたはタップして、入力カーソルの位置を決めます。 - * キーボードまたはスクリーン キーボードを使用してテキストを入力します。 - * テキストの位置を変更したい場合は、キャンバスをもう一度クリックまたはタップします。 - * [Enter]/[Return] を押すか、⮨ をクリックまたはタップするとテキストが追加され、次の行の入力が開始されます。 - * [Tab] を押すか ⟷ をクリック/タップすれば、テキストが追加され、すぐ右側に続けてテキストを入力できます。 - * スクリーン キーボードの使い方: - * 「Cmp」は文字を合成するために使用できます。たとえば、Cmp ' a は á になります。 - * 「AltGr」を使用すると、より多くの文字にすばやくアクセスできます。 - * 左右の矢印で、キーボード レイアウトを切り替えます (例: "QWERTY" と "ABC") + * 右側のフォントを選択します。 + * 右下にあるコントロールを使用して、太字 𝗔 や斜体 𝘈 にするかを選択します。 + * 右下の上矢印 🡁 と下矢印 🡃 ボタンを使用して、テキストのサイズを変更します。 + * 色を選択します（"色" のセクションを参照） + * キャンバスをクリックまたはタップして、入力カーソルの位置を決めます。 + * キーボードまたはスクリーンキーボードを使用してテキストを入力します。 + * テキストの位置を変更したい場合は、キャンバスをもう一度クリックまたはタップ + します。 + * [Enter]/[Return] を押すか、⮨ をクリックまたはタップするとテキストが追加され + 、次の行の入力が開始されます。 + * [Tab] を押すか ⟷ をクリック/タップすれば、テキストが追加され、すぐ右側に続 + けてテキストを入力できます。 + * スクリーンキーボードの使い方: + + 「Cmp」は文字を合成するために使用できます。たとえば、Cmp ' a は á にな + ります。 + + 「AltGr」を使用すると、より多くの文字にすばやくアクセスできます。 + + 左右の矢印で、キーボードレイアウトを切り替えます (例: "QWERTY" と + "ABC") - 🅰ラベル +🅰ラベル - * （「もじ」を参照） - * ラベルは絵から離れて「浮いて」います。描画やスタンプでの上書きや、「まほう」の効果などは適用されません。 - * ラベルは、後からでも、編集や移動、スタイルの変更ができます。 - * 右下の ☝ - ボタンをクリックまたはタップして、ラベルを選択します。変更するラベルをクリックまたはタップしてから、キャンバス内の別の場所をクリックまたはタップして位置を変更したり、フォントやスタイル、色を変更したり、タイプしてテキストを編集したりできます。 - * 右下にある 🖑 ボタン押すと、ラベルはキャンバスに貼り付けられ、以後は編集できなくなります。 + * （「もじ」を参照） + * ラベルは絵から離れて「浮いて」います。描画やスタンプでの上書きや、「まほう + 」の効果などは適用されません。 + * ラベルは、後からでも、編集や移動、スタイルの変更ができます。 + * 右下の ☝ ボタンをクリックまたはタップして、ラベルを選択します。変更するラベ + ルをクリックまたはタップしてから、キャンバス内の別の場所をクリックまたはタ + ップして位置を変更したり、フォントやスタイル、色を変更したり、タイプしてテ + キストを編集したりできます。 + * 右下にある 🖑 ボタン押すと、ラベルはキャンバスに貼り付けられ、以後は編集でき + なくなります。 - 🪣ぬる +🪣ぬる - * 右側で塗りつぶしモードを選択します。 - * 色を選択します（"色" のセクションを参照） - * クリックまたはタップして（「ふで」モードと「リニア」モードでは、さらにドラッグして)、閉じたエリアを色で塗りつぶします。 - * なし - グラデーション無しの一色で塗りつぶします - * ふで - ブラシを使ってエリアからはみ出さないように塗りつぶします - * リニア - エリアを線形グラデーションで塗りつぶします (ドラッグして角度とグラデーションを選択します) - * ほうしゃ - クリックまたはタップした場所を中心に、放射状のグラデーションでエリアを塗りつぶします - * あわせる - エリアの輪郭に合わせたグラデーションで塗りつぶします。 + * 右側で塗りつぶしモードを選択します。 + * 色を選択します（"色" のセクションを参照） + * クリックまたはタップして（「ふで」モードと「リニア」モードでは、さらにドラ + ッグして)、閉じたエリアを色で塗りつぶします。 + + なし - グラデーション無しの一色で塗りつぶします + + ふで - ブラシを使ってエリアからはみ出さないように塗りつぶします + + リニア - エリアを線形グラデーションで塗りつぶします (ドラッグして角度と + グラデーションを選択します) + + ほうしゃ - クリックまたはタップした場所を中心に、放射状のグラデーション + でエリアを塗りつぶします + + あわせる - エリアの輪郭に合わせたグラデーションで塗りつぶします。 - 🪄まほう +🪄まほう - * 右側から、使いたい特殊効果ツールを選択します。 - * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 - * クリックまたはタップとドラッグによって描画または効果を適用するツール 〰🪄 と、絵の全体に影響するツール 🖻🪄 - があります。両方に対応したツールでは、右下のコントロールでどちらかを選択します。 - * 効果のサイズを変更できるツールもあります。右下のバー 📶 でサイズを変更します。 - * 使う際に色を選べるツールもあります。 + * 右側から、使いたい特殊効果ツールを選択します。 + * 右下の左右の矢印のボタン ⇦⇨ で、カテゴリを切り替えます。 + * クリックまたはタップとドラッグによって描画または効果を適用するツール〰🪄 と + 、絵の全体に影響するツール 🖻🪄 があります。両方に対応したツールでは、右下の + コントロールでどちらかを選択します。 + * 効果のサイズを変更できるツールもあります。右下のバー 📶 でサイズを変更します + 。 + * 使う際に色を選べるツールもあります。 - 🖓とりけし +🖓とりけし - * 直近の変更を元に戻します (何回でも遡って取り消すことができます)。 - * ショートカット: [Ctrl]+[Z] + * 直近の変更を元に戻します (何回でも遡って取り消すことができます)。 + * ショートカット: [Ctrl]+[Z] - 🖒やりなおし +🖒やりなおし - * 取り消した変更をやり直します（何回の取り消しでもやり直せます）。 - * ショートカット: [Ctrl]+[R] + * 取り消した変更をやり直します（何回の取り消しでもやり直せます）。 + * ショートカット: [Ctrl]+[R] - ◪けしゴム +◪けしゴム - * 右側から、消しゴムの大きさと形を選びます。 - * クリックまたはタップしてドラッグすると、ドラッグした部分が消去されます。 - * ショートカット: [X]を押しながらクリックまたはタップ（使用中のツールによっては、ショートカットが無効な場合があります） + * 右側から、消しゴムの大きさと形を選びます。 + * クリックまたはタップしてドラッグすると、ドラッグした部分が消去されます。 + * ショートカット: [X]を押しながらクリックまたはタップ（使用中のツールによって + は、ショートカットが無効な場合があります） 制御ツール - 🗏さいしょから +🗏さいしょから - * 開始するキャンバスを、単色の背景、スターター画像、テンプレートから選択します。 - * スターター画像では、（例えば塗り絵のように）前面のレイヤーの下に描画されます。さらに背景レイヤーを有するものもあります。 - * テンプレートは背景レイヤーのみの画像です。 - * 消しゴムツール ◪ で消した部分は、単色の背景またはスターター/テンプレートの背面レイヤーが現れます。 - * 「🕮⮫ひらく」をクリックまたはタップして、新しい描画を開始します。 - * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 - * ショートカット: [Ctrl]+[N] + * 開始するキャンバスを、単色の背景、スターター画像、テンプレートから選択しま + す。 + + スターター画像では、（例えば塗り絵のように）前面のレイヤーの下に描画さ + れます。さらに背景レイヤーを有するものもあります。 + + テンプレートは背景レイヤーのみの画像です。 + + 消しゴムツール ◪ で消した部分は、単色の背景またはスターター/テンプレー + トの背面レイヤーが現れます。 + * 「🕮⮫ひらく」をクリックまたはタップして、新しい描画を開始します。 + * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 + * ショートカット: [Ctrl]+[N] - 🕮⮫ひらく +🕮⮫ひらく - * 以前に保存した作品を選択して開きます (書き出しや消去もできます)。 - * 「🕮⮫ひらく」をクリックまたはタップして、保存した作品を開き、編集を続けます。 - * 「🗏⮫エクスポート」をクリックまたはタップして、作品をシステムの「ピクチャ」フォルダに保存します。 - * 「🗑けす」をクリックまたはタップして、作品をシステムのごみ箱に移動します。 - * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 - * 「📽スライド」をクリックまたはタップすると、スライドショー モードに切り替わります: - * 保存された中から、再生したい順に複数の作品をクリックまたはタップして選択します。順序がサムネール上に表示されます。 - * 左下のバー 📶 で、再生速度を設定します。 - * 「⯈かいし」をクリックまたはタップすると、スライドショー／アニメーションが開始します。 - * ここで「🎞かきだす」をクリックまたはタップすると、アニメーションGIF形式のファイルををシステムの「ピクチャ」フォルダに出力します。 - * 「⤺もどる」をクリックまたはタップして、「ひらく」ダイアログに戻ります。 - * ショートカット: [Ctrl]+[O] + * 以前に保存した作品を選択して開きます (書き出しや消去もできます)。 + * 「🕮⮫ひらく」をクリックまたはタップして、保存した作品を開き、編集を続けます + 。 + * 「🗏⮫エクスポート」をクリックまたはタップして、作品をシステムの「ピクチャ」 + フォルダに保存します。 + * 「🗑けす」をクリックまたはタップして、作品をシステムのごみ箱に移動します。 + * 「⤺もどる」をクリックまたはタップすると、元の画面に戻ります。 + * 「📽スライド」をクリックまたはタップすると、スライドショーモードに切り替わり + ます: + + 保存された中から、再生したい順に複数の作品をクリックまたはタップして選 + 択します。順序がサムネール上に表示されます。 + + 左下のバー 📶 で、再生速度を設定します。 + + 「⯈かいし」をクリックまたはタップすると、スライドショー／アニメーション + が開始します。 + + ここで「🎞かきだす」をクリックまたはタップすると、アニメーションGIF形式 + のファイルををシステムの「ピクチャ」フォルダに出力します。 + + 「⤺もどる」をクリックまたはタップして、「ひらく」ダイアログに戻ります。 + * ショートカット: [Ctrl]+[O] - 🕮⮪セーブ +🕮⮪セーブ - * クリックまたはタップして作品を保存します。 - * 以前に保存したことがある場合は、既存の作品を上書きするか、新しい作品として保存するかを選択するよう求められます。 - * ショートカット: [Ctrl]+[S] + * クリックまたはタップして作品を保存します。 + * 以前に保存したことがある場合は、既存の作品を上書きするか、新しい作品として + 保存するかを選択するよう求められます。 + * ショートカット: [Ctrl]+[S] - 🖶いんさつ +🖶いんさつ - * クリックまたはタップして、作品を印刷します。 - * [Alt] または [Option] を押しながらクリックまたはタップすると、（対応している場合は）システムの印刷ダイアログが表示されます。 - * ショートカット: [Ctrl]+[P] + * クリックまたはタップして、作品を印刷します。 + * [Alt] または [Option] を押しながらクリックまたはタップすると、（対応してい + る場合は）システムの印刷ダイアログが表示されます。 + * ショートカット: [Ctrl]+[P] - 🗙やめる +🗙やめる - * クリックまたはタップして、Tux Paint を終了します。 - * ショートカット: [Esc] + * クリックまたはタップして、Tux Paint を終了します。 + * ショートカット: [Esc] いろ - * クリックまたはタップして、色が選べるツール（ふで、せん、かたちツール、および、はんこ、まほうツール）で使用する色を選択します。 - * 画像の中から色を選択するには、ピペット/カラーピッカー 💉 ボタンを使います。 - * ショートカット: [Ctrl] を押しながらキャンバスをクリックまたはタップすると、画像の中から素早く色を選択できます。 - * 虹 🌈 のボタンをクリックまたはタップして、レインボーパレットから、好きな色を選択します。 - * 左側の正方形のエリアをクリックまたはタップして色を選択します（色相と彩度を決める） - * 灰色のグラデーション バーをクリックまたはタップして、明るさを調整します。 - * 緑のチェックボックス ✓ をクリックまたはタップして決定します。 - * 「⤺戻る」をクリックまたはタップして中止し、パレットを閉じます。 - * 色がついた矢印 ⇫ - の形のボタンをクリックして、カラーパレット、スポイト、カラーミキサーのいずれかで選択した色をセットすることができます。 - * 絵の具パレット 🎨 ボタンをクリックまたはタップして、赤、黄、青の３原色と、白（色合い）、グレー（色調）、黒（濃淡）を混ぜて色を作成します。 - * 緑のチェックボックス ✓ をクリックまたはタップして決定します。 - * カラーミキサーでは「🖓とりけし」および「🖒やりなおし」オプションが使えます。 - * 「🗑さいしょから」をクリックまたはタップすると、最初からやり直せます。 - * 「⤺戻る」をクリックまたはタップすると、色の作成をを中止してダイアログを終了します。 + * クリックまたはタップして、色が選べるツール（ふで、せん、かたちツール、およ + び、はんこ、まほうツール）で使用する色を選択します。 + * 画像の中から色を選択するには、ピペット/カラーピッカー 💉 ボタンを使います。 + + ショートカット: [Ctrl] を押しながらキャンバスをクリックまたはタップする + と、画像の中から素早く色を選択できます。 + * 虹 🌈 のボタンをクリックまたはタップして、レインボーパレットから、好きな色を + 選択します。 + + 左側の正方形のエリアをクリックまたはタップして色を選択します（色相と彩 + 度を決める） + + 灰色のグラデーションバーをクリックまたはタップして、明るさを調整します + 。 + + 緑のチェックボックス ✓ をクリックまたはタップして決定します。 + + 「⤺戻る」をクリックまたはタップして中止し、パレットを閉じます。 + + 色がついた矢印 ⇫ の形のボタンをクリックして、カラーパレット、スポイト、 + カラーミキサーのいずれかで選択した色をセットすることができます。 + * 絵の具パレット 🎨 ボタンをクリックまたはタップして、赤、黄、青の３原色と、白 + （色合い）、グレー（色調）、黒（濃淡）を混ぜて色を作成します。 + + 緑のチェックボックス ✓ をクリックまたはタップして決定します。 + + カラーミキサーでは「🖓とりけし」および「🖒やりなおし」オプションが使えま + す。 + + 「🗑さいしょから」をクリックまたはタップすると、最初からやり直せます。 + + 「⤺戻る」をクリックまたはタップすると、色の作成をを中止してダイアログを + 終了します。 描画中に利用できるショートカット: - * [Ctrl]+クリック/タップ - クイックピペット / カラーピッカー 💉 - * [X]+クリック/タップ - クイック消しゴム ◪ - * [Ctrl]+[Z] - 🖓とりけし - * [Ctrl]+[R] - 🖒やりなおし - * [Ctrl]+[N] - 🗏さいしょから - * [Ctrl]+[O] - 🕮⮫ひらく - * [Ctrl]+[S] - 🕮⮪セーブ - * [Ctrl]+[P] - 🖶いんさつ - * [Alt]+[S] - サウンドのオン/オフを切り替え - * [Esc] - ⤺もどる または 🗙やめる + * [Ctrl]+クリック/タップ - クイックピペット / カラーピッカー 💉 + * [X]+クリック/タップ - クイック消しゴム ◪ + * [Ctrl]+[Z] - 🖓とりけし + * [Ctrl]+[R] - 🖒やりなおし + * [Ctrl]+[N] - 🗏さいしょから + * [Ctrl]+[O] - 🕮⮫ひらく + * [Ctrl]+[S] - 🕮⮪セーブ + * [Ctrl]+[P] - 🖶いんさつ + * [Alt]+[S] - サウンドのオン/オフを切り替え + * [Esc] - ⤺もどるまたは 🗙やめる + +最終更新日: 2023年5月 9日 - 最終更新日: 2023年5月 9日