From 67af2ea91f393f68a71732446976c2c4f90087e7 Mon Sep 17 00:00:00 2001 From: William Kendrick Date: Wed, 25 Apr 2007 17:22:28 +0000 Subject: [PATCH] Added information on right+[Alt] for alternative input methods in Text tool. Added missing information on [Tab] to complete text input in Text tool. --- docs/README.txt | 830 ++++++++++++++++++++++++------------------ docs/html/README.html | 45 ++- 2 files changed, 504 insertions(+), 371 deletions(-) diff --git a/docs/README.txt b/docs/README.txt index 85a15cabd..ec753f4a3 100644 --- a/docs/README.txt +++ b/docs/README.txt @@ -3,13 +3,13 @@ A simple drawing program for children - Copyright 2002-2006 by Bill Kendrick and others + Copyright 2002-2007 by Bill Kendrick and others New Breed Software bill@newbreedsoftware.com http://www.tuxpaint.org/ - June 14, 2002 - October 26, 2006 + June 14, 2002 - April 24, 2007 -------------------------------------------------------------------------- @@ -273,531 +273,633 @@ Available Tools Press [Enter] or [Return] and the text will be drawn onto the picture and the cursor will move down one line. - Click elsewhere in the picture and the current line of text - will move there, where you can continue editing. + 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: Like this.) + + 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). + + International Character Input + + Tux Paint allows inputting characters in + different languages. Most Latin characters + (A-Z, n, egrave;, 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 + supported languages that require an alternate + input mode, press the right [Alt] or + right [Option] key to toggle between the normal + (Latin character) and locale-specific modes. + + Currently supported locales, and their input + methods, are listed below. Note: Many fonts do + not include all characters for all languages. + + * Japanese -- Romanized Hiragana and + Katakana + * Korean -- Hangul 2-Bul -------------------------------------------------------------------------- - Magic (Special Effects) + Magic (Special Effects) - The 'Magic' tool is actually a set of special tools. Select - one of the "magic" effects from the selector on the right, - and then click and drag around the picture to apply the - effect. + The 'Magic' tool is actually a set of special + tools. Select one of the "magic" effects from + the selector on the right, and then click and + drag around the picture to apply the effect. - Rainbow - This is similar to the paint brush, but as you - move the mouse around, it goes through all of - the colors in the rainbow. + Rainbow + This is similar to the paint brush, + but as you move the mouse around, it + goes through all of the colors in the + rainbow. - Sparkles - This draws glowing yellow sparkles on the - picture. + Sparkles + This draws glowing yellow sparkles on + the picture. - Mirror - When you click the mouse in your picture with - the "Mirror" magic effect selected, the entire - image will be reversed, turning it into a - mirror image. + Mirror + When you click the mouse in your + picture with the "Mirror" magic + effect selected, the entire image + will be reversed, turning it into a + mirror image. - Flip - Similar to "Mirror." Click and the entire image - will be turned upside-down. + Flip + Similar to "Mirror." Click and the + entire image will be turned + upside-down. - Blur - This makes the picture fuzzy wherever you drag - the mouse. + Blur + This makes the picture fuzzy wherever + you drag the mouse. - Smudge - This pushes the colors around under the mouse, - like finger painting with wet paint. + Smudge + This pushes the colors around under + the mouse, like finger painting with + wet paint. - Fade - This fades the colors wherever you drag the - mouse. (Do it to the same spot many times, and - it will eventually become white.) + Fade + This fades the colors wherever you + drag the mouse. (Do it to the same + spot many times, and it will + eventually become white.) - Darken - This dakrens the colors wherever you drag the - mouse. (Do it to the same spot many times, and - it will eventually become black.) + Darken + This dakrens the colors wherever you + drag the mouse. (Do it to the same + spot many times, and it will + eventually become black.) - Chalk - This makes parts of the picture (where you move - the mouse) look like a chalk drawing. + Chalk + This makes parts of the picture + (where you move the mouse) look like + a chalk drawing. - Blocks - This makes the picture blocky looking - ("pixelated") wherever you drag the mouse. + Blocks + This makes the picture blocky looking + ("pixelated") wherever you drag the + mouse. - Negative - This inverts the colors wherever you drag the - mouse. (e.g., white becomes black, and vice - versa.) + Negative + This inverts the colors wherever you + drag the mouse. (e.g., white becomes + black, and vice versa.) - Tint - This changes the parts of the picture to the - selected color. + Tint + This changes the parts of the picture + to the selected color. - Drip - This makes the paint "drip" wherever you move - the mouse. + Drip + This makes the paint "drip" wherever + you move the mouse. - Cartoon - This makes the picture look like a cartoon -- - with thick outlines and solid colors -- - wherever you move the mouse. + Cartoon + This makes the picture look like a + cartoon -- with thick outlines and + solid colors -- wherever you move the + mouse. - Fill - This floods the picture with a color. It lets - you quickly fill parts of the picture, as if it - were a coloring book. + Fill + This floods the picture with a color. + It lets you quickly fill parts of the + picture, as if it were a coloring + book. -------------------------------------------------------------------------- - Eraser + Eraser - This tool is similar to the Paint Brush. Wherever you click - (or click and drag), the picture will be erased either to - white, or to the background picture, if you began the - current drawing with a 'Starter' image. + This tool is similar to the Paint Brush. + Wherever you click (or click and drag), the + picture will be erased either to white, or to + the background picture, if you began the + current drawing with a 'Starter' image. - A number of eraser sizes are available. + A number of eraser sizes are 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 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. + As you erase, a "squeaky clean" eraser/wiping + sound is played. -------------------------------------------------------------------------- Other Controls - Undo + Undo - Clicking this tool will undo the last drawing action. You - can even undo more than once! + Clicking this tool will undo the last drawing + action. You can even undo more than once! - Note: You can also press [Control]-[Z] on the keyboard to - undo. + Note: You can also press [Control]-[Z] on the + keyboard to undo. -------------------------------------------------------------------------- - Redo + Redo - Clicking this tool will redo the drawing action you just - "undid" with the 'Undo' button. + Clicking this tool will redo the drawing + action you just "undid" with the 'Undo' + button. - As long as you don't draw again, you can redo as many times - as you had "undone!" + 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. + Note: You can also press [Control]-[R] on the + keyboard to redo. -------------------------------------------------------------------------- - New + New - Clicking the "New" button will start a new drawing. You will - first be asked whether you really want to do this. + Clicking the "New" button will start a new + drawing. 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. + Note: You can also press [Control]-[N] on the + keyboard to start a new drawing. -------------------------------------------------------------------------- - Open + Open - 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. + 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, then... + Click a picture to select it, then... - * Click the green "Open" button at the lower left of - the list to load the selected picture. + * Click the green "Open" button at the + lower left of the list to load the + selected picture. - (Alternatively, you can double-click a picture's icon - to load it.) + (Alternatively, you can double-click a + picture's icon to load it.) - * 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.) + * 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.) - * Click the blue "Slides" (slide projector) button at - the lower left to go to slideshow mode. See "Slides", - below, for details. + * Click the blue "Slides" (slide + projector) button at the lower left to + go to slideshow mode. See "Slides", + below, for details. - * Or click the red "Back" arrow button at the lower - right of the list to cancel and return to the picture - you were drawing. + * Or click the red "Back" arrow button + at the lower right of the list to + cancel and return to the picture you + were drawing. - 'Starter' Images + 'Starter' Images - Along with pictures you've created, Tux Paint can provided - 'Starter' images. Opening them is like creating a new - picture, except that the picture isn't blank. 'Starters' - can be like a page from a coloring book (a black-and-white - outline of a picture, which you can then color in), or - like a 3D photograph, where you draw the bits in between. + Along with pictures you've created, + Tux Paint can provided 'Starter' images. + Opening them is like creating a new + picture, except that the picture isn't + blank. 'Starters' can be like a page from a + coloring book (a black-and-white outline of + a picture, which you can then color in), or + like a 3D photograph, where you draw the + bits in between. - 'Starter' images have a green background in the 'Open' - screen. (Normal images have a blue background.) When you - load a 'Starter,' draw on it, and then click 'Save,' it - creates a new picture (it doesn't overwrite the original - 'Starter,' so you can use it again later). + 'Starter' images have a green background in + the 'Open' screen. (Normal images have a + blue background.) When you load a + 'Starter,' draw on it, and then click + 'Save,' it creates a new picture (it + doesn't overwrite the original 'Starter,' + so you can use it again later). - 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.) + 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.) - Note: You can also press [Control]-[O] on the keyboard to - get the 'Open' dialog. + Note: You can also press [Control]-[O] on the + keyboard to get the 'Open' dialog. -------------------------------------------------------------------------- - Save + Save - This saves your current picture. + 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) + 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. + 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). + 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: 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. + Note: You can also press [Control]-[S] on the + keyboard to save. -------------------------------------------------------------------------- - Print + Print - Click this button and your picture will be printed! + Click this button and your picture will be + printed! - On most platforms, you can also hold the [Alt] key while - clicking the 'Print' button to get a printer dialog, as long - as you're not running Tux Paint in fullscreen mode. See - below. + On most platforms, you can also hold the + [Alt] key while clicking the 'Print' button + to get a printer dialog, as long as you're + not running Tux Paint in fullscreen mode. See + below. - Disabling Printing + Disabling Printing - If the "noprint" option was set (either with - "noprint=yes" in Tux Paint's configuration - file, or using "--noprint" on the - command-line), the "Print" button will be - disabled. + If the "noprint" option was set + (either with "noprint=yes" in + Tux Paint's configuration file, or + using "--noprint" on the + command-line), the "Print" button + will be disabled. - See the "Options" documentation.) + See the "Options" documentation.) - Restricting Printing + Restricting Printing - If the "printdelay" option was used (either - with "printdelay=SECONDS" in the configuration - file, or using "--printdelay=SECONDS" on the - command-line), you can only print once every - SECONDS seconds. + If the "printdelay" option was used + (either with "printdelay=SECONDS" in + the configuration file, or using + "--printdelay=SECONDS" on the + command-line), you can only print + once every SECONDS seconds. - For example, with "printdelay=60", you can - print only once a minute. + For example, with "printdelay=60", + you can print only once a minute. - See the "Options" documentation.) + See the "Options" documentation.) - Printing Commands + Printing Commands - (Linux and Unix only) + (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: + Tux Paint prints by generating a + PostScript representation of the + drawing and sending it to an external + program. By default, the program is: - lpr + lpr - This command can be changed by setting the - "printcommand" value in Tux Paint's - configuration file. + This command can be changed by + setting the "printcommand" value in + Tux Paint's configuration file. - If the [Alt] key on the keyboard is being - pushed while 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: + If the [Alt] key on the keyboard is + being pushed while 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 + kprinter - This command can be changed by setting the - "altprintcommand" value in Tux Paint's - configuration file. + This command can be changed by + setting the "altprintcommand" value + in Tux Paint's configuration file. - For information on how to change the printing - commands, see the "Options" documentation. + For information on how to change the + printing commands, see the "Options" + documentation. - Printer Settings + Printer Settings - (Windows only) + (Windows only) - By default, Tux Paint simply prints to the - default printer with default settings when the - 'Print' button is pushed. + 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] key on the - keyboard while pushing the button, as long as - you're not in fullscreen mode, a Windows print - dialog will appear, where you can change the - settings. + However, if you hold the [Alt] key on + the keyboard while pushing the + button, as long as you're not in + fullscreen mode, a Windows print + dialog will appear, where you can + change the settings. - You can have the printer configuration changes - stored by using the "printcfg" option, either - by using "--printcfg" on the command-line, or - "printcfg=yes" in Tux Paint's own configuration - file ("tuxpaint.cfg"). + You can have the printer + configuration changes stored by using + the "printcfg" option, either by + using "--printcfg" on the + command-line, or "printcfg=yes" in + Tux Paint's own configuration file + ("tuxpaint.cfg"). - If the "printcfg" option is used, printer - settings will be loaded from the file - "print.cfg" in your personal folder (see - below). Any changes will be saved there as - well. + If the "printcfg" option is used, + printer settings will be loaded from + the file "print.cfg" in your personal + folder (see below). Any changes will + be saved there as well. - See the "Options" documentation.) + See the "Options" documentation.) - Printer Dialog Options + Printer Dialog Options - By default, Tux Paint only shows the printer - dialog (or, on Linux/Unix, runs the - "altprintcommand", e.g., "kprinter" instead of - "lpr") if the [Alt] key is held while clicking - the 'Print' button. + 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] 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. Or, you can prevent the [Alt] key from - having any effect by using "--altprintnever", - or "altprint=never". + 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. Or, + you can prevent the [Alt] key from + having any effect by using + "--altprintnever", or + "altprint=never". - See the "Options" documentation.) + See the "Options" documentation.) -------------------------------------------------------------------------- - Slides + Slides - The "Slides" button is available in the "Open" dialog. It - displays a list of your saved files, similar to the "Open" - dialog, but without listing 'Starter' images. + The "Slides" button is available in the + "Open" dialog. It displays a list of your + saved files, similar to the "Open" dialog, + but without listing 'Starter' images. - 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. + 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). + You can click a selected image to unselect it + (take it out of your slideshow). - 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, from slowest to fastest. Choose the leftmost - setting to disable automatic advancement -- you will need to - press a key or click to go to the next slide (see below). + 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, + from slowest to fastest. Choose the leftmost + setting to disable automatic advancement -- + you will need to press a key or click to go + to the next slide (see below). - When you're ready, click the "Play" button to begin the - slideshow. (Note: If you hadn't selected ANY images, then - ALL images will be played in the slideshow.) + When you're ready, click the "Play" button to + begin the slideshow. (Note: If you hadn't + selected ANY images, then ALL 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] to - go back to the previous slide. + 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] 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. + Press [Escape], or click the "Back" button at + the lower right, to exit the slideshow and + return to the slideshow image selection + screen. - Click "Back" in the slideshow image selection screen to - return to the "Open" dialog. + Click "Back" in the slideshow image selection + screen to return to the "Open" dialog. - Quit + Quit - Clicking the "Quit" button, closing the Tux Paint window, or - pushing the [Escape] key will quit Tux Paint. + 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. + 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.) + 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! + NOTE: If the image is saved, it will be + reloaded automatically the next time you run + Tux Paint! - NOTE: The "Quit" button and [Escape] key can be disabled - (e.g., by selecting "Disable 'Quit' Button" in - Tux Paint Config. or running Tux Paint with the "--noquit" - command-line option). + NOTE: The "Quit" button and [Escape] key can + be disabled (e.g., by selecting + "Disable 'Quit' Button" in Tux Paint Config. + or running Tux Paint with the "--noquit" + command-line 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. + 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.) + If neither of those are possible, the key + sequence of [Shift] + [Control] + [Escape] + may be used to quit. (See the "Options" + documentation.) - Sound Muting + Sound Muting - There is no on-screen control button at this time, but by - pressing [Alt] + [S], sound effects can be disabled and - re-enabled (muted and unmuted) while the program is running. + There is no on-screen control button at this + time, but by pressing [Alt] + [S], sound + effects can be disabled and re-enabled (muted + and unmuted) while the program is running. - Note that if sounds are completely disabled (e.g., by - unselecting "Enable Sound Effects" in Tux Paint Config or - running Tux Paint with the "--nosound" command-line option), - the [Alt] + [S] key sequence has no effect. (i.e., it cannot - be used to turn on sounds when the parent/teach wants them - disabled.) + Note that if sounds are completely disabled + (e.g., by unselecting "Enable Sound Effects" + in Tux Paint Config or running Tux Paint with + the "--nosound" command-line option), the + [Alt] + [S] key sequence has no effect. + (i.e., it cannot be used to turn on sounds + when the parent/teach wants them disabled.) -------------------------------------------------------------------------- Loading Other Pictures into Tux Paint - Since Tux Paint's 'Open' dialog only displays pictures you created with - Tux Paint, what if you want to load some other picture or photograph - into Tux Paint to edit? + Since Tux Paint's 'Open' dialog only displays pictures you + created with Tux Paint, what if you want to load some + other picture or photograph into Tux Paint to edit? - To do so, you simply need to convert the picture into a PNG (Portable - Network Graphic) image file, and place it in Tux Paint's "saved" - directory: + To do so, you simply need to convert the picture into a + PNG (Portable Network Graphic) image file, and place it in + Tux Paint's "saved" directory: - Windows - Inside the user's "Application Data" folder, e.g.: "C:\Documents - and Settings\(user name)\Application Data\TuxPaint\saved\" + Windows + Inside the user's "Application Data" folder, + e.g.: "C:\Documents and + Settings\(user name)\Application + Data\TuxPaint\saved\" - Mac OS X - Inside the user's "Library" folder: - "/Users/(user name)/Library/Application - Support/Tux Paint/saved/" + Mac OS X + Inside the user's "Library" folder: + "/Users/(user name)/Library/Application + Support/Tux Paint/saved/" - Linux/Unix - Inside a hidden ".tuxpaint" directory, in the user's home - directory: "$(HOME)/.tuxpaint/saved/" + Linux/Unix + Inside a hidden ".tuxpaint" directory, in the + user's home directory: + "$(HOME)/.tuxpaint/saved/" Using '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 'tuxpaint-import', simply run the command from a command-line - prompt and provide it the name(s) of the file(s) you wish to convert. + To use 'tuxpaint-import', simply run the command 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. - (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.) + 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.) - Example: + Example: - $ tuxpaint-import grandma.jpg - grandma.jpg -> /home/username/.tuxpaint/saved/20020921123456.png - jpegtopnm: WRITING A PPM FILE + $ tuxpaint-import grandma.jpg + grandma.jpg -> + /home/username/.tuxpaint/saved/20020921123456.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! Doing it Manually - Windows, Mac OS X and BeOS users must currently do the conversion - manually. + Windows, Mac OS X and BeOS users must currently do the + conversion manually. - Load a graphics program that is capable of both loading your picture - and saving a PNG format file. (See the documentation file "PNG.txt" - 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.txt" for a list of suggested + software, and other references.) - Reduce the size of the image to no wider than 448 pixels across and no - taller than 376 pixels tall. (i.e., the maximum size is 448 x 376 - pixels) + Reduce the size of the image to no wider than 448 pixels + across and no taller than 376 pixels tall. (i.e., the + maximum size is 448 x 376 pixels) - 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 (01-12) - * DD = Day (01-31) - * HH = Hour, in 24-hour format (00-23) - * mm = Minute (00-59) - * ss = Second (00-59) + * YYYY = Year + * MM = Month (01-12) + * DD = Day (01-31) + * HH = Hour, in 24-hour format (00-23) + * mm = Minute (00-59) + * ss = Second (00-59) - e.g.: + e.g.: - 20020921130500 - for September 21, 2002, 1:05:00pm + 20020921130500 - for September 21, 2002, 1:05:00pm - Place this PNG file in your Tux Paint 'saved' directory. (See above.) + Place this PNG file in your Tux Paint 'saved' directory. + (See above.) -------------------------------------------------------------------------- Further Reading - Other documentation included with Tux Paint (in the "docs" - folder/directory) include: + Other documentation included with Tux Paint (in the "docs" + folder/directory) include: - * AUTHORS.txt - List of authors and contributors - * CHANGES.txt - Summary of changed between releases - * COPYING.txt - Copying license (The GNU General Public License) - * INSTALL.txt - Instructions for compiling/installing, when applicable - * EXTENDING.html - Detailed instructions on creating brushes, stamps and starters, and - adding fonts, to extend Tux Paint. - * OPTIONS.html - Detailed instructions on command-line and configuration-file - options, for those who don't want to use Tux Paint Config. - * PNG.txt - Notes on creating PNG format bitmapped images for use in Tux Paint - * SVG.txt - Notes on creating SVG format vector images for use in Tux Paint + * AUTHORS.txt + List of authors and contributors + * CHANGES.txt + Summary of changed between releases + * COPYING.txt + Copying license (The GNU General Public License) + * INSTALL.txt + Instructions for compiling/installing, when + applicable + * EXTENDING.html + Detailed instructions on creating brushes, stamps and + starters, and adding fonts, to extend Tux Paint. + * OPTIONS.html + Detailed instructions on command-line and + configuration-file options, for those who don't want + to use Tux Paint Config. + * PNG.txt + Notes on creating PNG format bitmapped images for use + in Tux Paint + * SVG.txt + Notes on creating SVG format vector images for use in + Tux Paint -------------------------------------------------------------------------- How to Get Help - If you need help, feel free to contact New Breed Software: + If you need help, feel free to contact New Breed Software: - http://www.newbreedsoftware.com/ + http://www.newbreedsoftware.com/ - You may also wish to participate in the numerous Tux Paint mailing - lists: + You may also wish to participate in the numerous Tux Paint + mailing lists: - http://www.tuxpaint.org/lists/ + http://www.tuxpaint.org/lists/ diff --git a/docs/html/README.html b/docs/html/README.html index 9c3a7c869..0f27e7aff 100644 --- a/docs/html/README.html +++ b/docs/html/README.html @@ -17,13 +17,13 @@ version

A simple drawing program for children

-

Copyright 2002-2006 by Bill Kendrick and others
+

Copyright 2002-2007 by Bill Kendrick and others
New Breed Software

bill@newbreedsoftware.com
http://www.tuxpaint.org/

-

June 14, 2002 - October 26, 2006

+

June 14, 2002 - April 24, 2007

@@ -385,15 +385,46 @@ New Breed Software

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: + Like this.)

-

Click elsewhere in the picture and the current line of text will - move there, where you can continue editing.

+

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).

-
- -

+
+
International Character Input
+
+

Tux Paint allows inputting characters in different languages. + Most Latin characters (A-Z, + ñ, egrave;, 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 supported + languages that require an alternate input mode, press + the right [Alt] or right [Option] key to + toggle between the normal (Latin character) and locale-specific + modes.

+ +

Currently supported locales, and their input methods, are listed + below. Note: Many fonts do not include all characters for + all languages. +

    +
  • Japanese — Romanized Hiragana and Katakana +
  • Korean — Hangul 2-Bul +
+

+
+