~ubuntu-branches/ubuntu/karmic/tuxpaint-config/karmic

« back to all changes in this revision

Viewing changes to docs/README.txt

  • Committer: Bazaar Package Importer
  • Author(s): Ben Armstrong
  • Date: 2007-07-03 22:12:27 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20070703221227-4rcr4gusu3gjj8ll
Tags: 0.0.8-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
                               Tux Paint Config.
2
 
                                 version 0.0.7
 
2
                                 version 0.0.8
3
3
 
4
4
                        Configuration tool for Tux Paint
5
5
 
6
 
                Copyright 2002-2006 by Bill Kendrick and others
 
6
                Copyright 2002-2007 by Bill Kendrick and others
7
7
                               New Breed Software
8
8
 
9
9
                           bill@newbreedsoftware.com
10
10
                            http://www.tuxpaint.org/
11
11
 
12
 
                     September 22, 2004 - September 9, 2006
 
12
                       September 22, 2004 - June 18, 2007
13
13
 
14
14
   --------------------------------------------------------------------------
15
15
 
40
40
     Other documentation included with Tux Paint Config. (in the "docs"
41
41
     folder/directory) include:
42
42
 
43
 
       * AUTHORS.txt
 
43
       * AUTHORS
44
44
         List of authors and contributors
45
 
       * CHANGES.txt
 
45
       * CHANGES
46
46
         Summary of changed between releases
47
 
       * INSTALL.txt
 
47
       * INSTALL
48
48
         Instructions on how to compile and install
49
 
       * COPYING.txt
 
49
       * COPYING
50
50
         Copying license (The GPL)
51
 
       * README.txt
 
51
       * README
52
52
         (This file)
53
 
       * TODO.txt
 
53
       * TODO
54
54
         A list of pending features or bugs needing fixed
55
55
 
56
56
   --------------------------------------------------------------------------
69
69
         you didn't make any changes to the options.)
70
70
       * Apply - This saves settings of all the options, on all the tabs, to
71
71
         your Tux Paint configuration file. (On Linux and Unix, this is
72
 
         "~/.tuxpaintrc". On Windows, this is "tuxpaint.cfg".)
 
72
         "~/.tuxpaintrc". On Windows, this is "tuxpaint.cfg". On Mac OS X, it
 
73
         is " ~/Library/Application Support/TuxPaint/tuxpaint.cfg".)
73
74
       * Reset - This discards all unsaved changes on all the tabs. It loads
74
75
         whatever settings are currently stored in your Tux Paint
75
76
         configuration file.
76
77
 
 
78
     Also at the bottom are two additional options:
 
79
 
 
80
       * Settings for: - This lets you change which configuration file
 
81
         Tux Paitn Config. tries to save to when you click "Apply": either
 
82
         the Current User's, or All Users' (the system-wide config. file).
 
83
       * Use "All Users" Settings - Checking this option causes all
 
84
         configuration options in Tux Paint Config. to be greyed out. When
 
85
         you click "Apply", the current user's config. file will be deleted,
 
86
         causing them to use only the system-wide ("All users") config. file!
 
87
 
77
88
     The various tabs, and the options found within, are described below:
78
89
 
79
90
About
87
98
           causes Tux Paint to display across your entire screen (or as much
88
99
           as it can, with a border around the outside), in essense turning
89
100
           your monitor into a Tux Paint-only display.
90
 
         * Resolution / Window Size - By default, Tux Paint creates a
91
 
           relatively small window (640 pixels across by 480 pixels high).
92
 
           Since many people prefer a larger drawing canvas, Tux Paint can be
93
 
           told to create an 800x600 window, instead. (If running in
94
 
           fullscreen, this also determines the monitor resolution Tux Paint
95
 
           will try to switch into.)
 
101
 
 
102
              * Native - This causes Tux Paint to run using your current
 
103
                desktop resolution when you run in fullscreen mode. Example:
 
104
                If you have Tux Paint set to run in a 800x600 window on your
 
105
                1280x800 laptop, but you have this option enabled, it will
 
106
                run at 1280x800 when you launch Tux Paint in fullscreen mode
 
107
                (rather than dropping your laptop's LCD display down to
 
108
                800x600, which might not look right).
 
109
 
 
110
         * Window Size - By default, Tux Paint creates a relatively small
 
111
           window (800 pixels across by 600 pixels high). Since many people
 
112
           prefer a larger drawing canvas, or have screens at different
 
113
           aspect ratios or larger sizes, Tux Paint can be told to create a
 
114
           larger window, instead. If running in fullscreen, this also
 
115
           determines the monitor resolution Tux Paint will try to switch
 
116
           into, unless the "Native" option is set.
 
117
         * Rotate Orientation - This option swaps the width and height values
 
118
           given in the "Window Size" setting, which can be useful for
 
119
           displays with portrait aspect ratios (e.g., a tablet PC in the
 
120
           tablet orientation, vs. the laptop orientation).
96
121
         * Enable Sound Effects - By default, Tux Paint plays sounds for
97
122
           practically every action that takes place... drawing with the
98
123
           brush, displaying a pop-up dialog, painting a rainbow. By
99
124
           un-checking this option, you can turn sounds off.
 
125
         * Use Alternative Color Palette - This allows you to specify a file
 
126
           containing colors that Tux Paint should provide to the user. (See
 
127
           Tux Paint's documentation for details on the format.)
100
128
 
101
129
Mouse & Keyboard
102
130
 
106
134
           drawing lines, for example. However, the large brushes can cause
107
135
           problems on some systems, so you can disable this option if the
108
136
           brushes don't work right for you.
 
137
         * Hide Cursor - Completely hides the mouse pointer in Tux Paint.
 
138
           Useful when using a touchscreen (such as a tablet PC or handheld
 
139
           device), rather than a mouse or drawing tablet.
 
140
         * Enable Keyboard Shortcuts - Tux Paint supports some keyboard
 
141
           shortcuts ('accelerators'), like Control + S to Save and
 
142
           Control + Z to Undo. If your child hits the keyboard accidentally,
 
143
           you can disable these shortcuts to prevent them from being used
 
144
           accidentally.
109
145
         * Grab Mouse Pointer - If you'd rather not run Tux Paint in
110
146
           fullscreen mode, but you want to keep children from getting at
111
147
           your desktop files or other applications, you can have Tux Paint
112
148
           'grab' the mouse pointer, which prevents it from leaving the
113
149
           Tux Paint window.
114
 
         * Mouse Wheen Support - If your mouse has a scroll wheel, Tux Paint
 
150
         * Mouse Wheel Support - If your mouse has a scroll wheel, Tux Paint
115
151
           will let you use it to scroll up and down through the selection
116
152
           menu on the right (e.g., the brush or stamp collections). However,
117
153
           if your child still lacks dexterity with the mouse, they may hit
118
154
           the scroll wheel accidentally, and get frustrated. You can tell
119
155
           Tux Paint to ignore the mouse wheel, if that is the case.
120
 
         * Enable Keyboard Shortcuts - Tux Paint supports some keyboard
121
 
           shortcuts ('accelerators'), like Control + S to Save and
122
 
           Control + Z to Undo. If your child hits the keyboard accidentally,
123
 
           you can disable these shortcuts to prevent them from being used
124
 
           accidentally.
 
156
         * No Button Distinction - Tux Paint notices if the user is
 
157
           accidentally clicking with the middle or right button on a mouse,
 
158
           and after a number of clicks, pops up a window explaining which
 
159
           button should be used. If this option is enabled, the pop-up does
 
160
           not appear, and the middle and right mouse button can be used
 
161
           (they act the same as the left button).
125
162
 
126
163
Simplification
127
164
 
170
207
           left-to-right, and many can be mirrored using the 'Mirror' stamp
171
208
           control. You can tell Tux Paint to mirror all such stamps, by
172
209
           default, when it starts up.
 
210
         * Load System Fonts - This causes Tux Paint to look around typical
 
211
           locations on your hard drive for fonts, and adds ones that seem
 
212
           useful to the fonts available in the "Text" tool.
173
213
 
174
214
Printing
175
215
 
179
219
           limit it to, say, only once every 5 minutes, you can enter a delay
180
220
           value (in seconds). After printing, Tux Paint will wait that long
181
221
           before the 'Print' button works again.
 
222
         * Show Printer Dialog - Tux Paint can bring up a system printer
 
223
           dialog if the [Alt] key ([Option] on Macs) is held while the
 
224
           "Print" button is clicked. These options allow you to disable this
 
225
           feature (never show a dialog), or to always show a dialog, even
 
226
           when [Alt] isn't being held.
182
227
         * Use Alternative Print Command / Alternative Print Command:
183
228
           (Advanced! Unix/Linux only!) By default, Tux Paint under Linux and
184
229
           Unix uses the external program 'lpr' for printing pictures. You
185
230
           can specify a different command here. The command you specify must
186
231
           accept PostScript format on it's standard input (STDIN).
 
232
         * Use Alternative Print Dialog (Advanced! Unix/Linux only!) By
 
233
           default, Tux Paint under Linux and Unix uses the extnernal program
 
234
           'kprinter' (KDE, the K Desktop Environment's printer tool). You
 
235
           can specify a different command here. The command you specify must
 
236
           accept PostScript format on it's standard input (STDIN).
187
237
 
188
238
Saving
189
239
 
221
271
             includes an 'Erase' button, so you can do this from within
222
272
             Tux Paint.)
223
273
 
 
274
  Start Blank
 
275
 
 
276
         This option tells Tux Paint to always start with a blank (white)
 
277
         drawing canvas, rather than re-loading the last-saved picture (its
 
278
         default behavior).
 
279
 
224
280
  Save Directory
225
281
 
226
282
         Since Tux Paint never asks where to save pictures (or what filename
238
294
 
239
295
         See Tux Paint's own documentation for more on the subject.
240
296
 
241
 
  Disable Saving
 
297
  Disable 'Save' Button
242
298
 
243
299
         If you wish for Tux Paint to be used only as a 'scratch pad' for
244
300
         drawing, you may disable the 'Save' button. Obviously, this makes it
245
301
         impossible to save any drawings, so most people will have no use for
246
302
         this option.
247
303
 
 
304
  Auto-save on Quit
 
305
 
 
306
         This tells Tux Paint not to ask whether you wish to save the current
 
307
         picture (if unsaved) when you quit. It will assume you always do.
 
308
         (If it needs to ask about saving over an old copy, it will still do
 
309
         so.)
 
310
 
248
311
   --------------------------------------------------------------------------
249
312
 
250
313
                                More Information