Documenting Export & GIF Export in README
This commit is contained in:
Bill Kendrick
parent
cbb56c4041
commit
dfdf720895
5 changed files with 180 additions and 73 deletions
|
|
@ -20,10 +20,8 @@ $Id$
|
||||||
https://github.com/ImageOptim/libimagequant
|
https://github.com/ImageOptim/libimagequant
|
||||||
(GPL v3 or later, for Free/Libre Open Source Software)
|
(GPL v3 or later, for Free/Libre Open Source Software)
|
||||||
* WORK IN PROGRESS -- Ignores speed
|
* WORK IN PROGRESS -- Ignores speed
|
||||||
* WORK IN PROGRESS -- Needs documentation
|
|
||||||
* Single image (PNG) export from the Open dialog.
|
* Single image (PNG) export from the Open dialog.
|
||||||
(Closes https://sourceforge.net/p/tuxpaint/feature-requests/192/)
|
(Closes https://sourceforge.net/p/tuxpaint/feature-requests/192/)
|
||||||
* WORK IN PROGRESS -- Needs documentation
|
|
||||||
* Both utilize XDG user dirs settings, if available, to determine
|
* Both utilize XDG user dirs settings, if available, to determine
|
||||||
where to store them, or "~/Pictures", otherwise. In those cases,
|
where to store them, or "~/Pictures", otherwise. In those cases,
|
||||||
files are stored in a new "TuxPaint" subdirectory.
|
files are stored in a new "TuxPaint" subdirectory.
|
||||||
|
|
|
||||||
|
|
@ -497,6 +497,10 @@ Available Tools
|
||||||
Note: As of version 0.9.22, the picture will be
|
Note: As of version 0.9.22, the picture will be
|
||||||
placed in your desktop's trash can, on Linux only.
|
placed in your desktop's trash can, on Linux only.
|
||||||
|
|
||||||
|
* Click the "Export" button near the lower right to
|
||||||
|
export the image to your export folder. (e.g.,
|
||||||
|
"~/Pictures/TuxPaint/")
|
||||||
|
|
||||||
* Click the blue "Slides" (slide projector) button at
|
* Click the blue "Slides" (slide projector) button at
|
||||||
the lower left to go to slideshow mode. See "Slides",
|
the lower left to go to slideshow mode. See "Slides",
|
||||||
below, for details.
|
below, for details.
|
||||||
|
|
@ -653,43 +657,80 @@ Available Tools
|
||||||
Slides (under "Open")
|
Slides (under "Open")
|
||||||
|
|
||||||
The "Slides" button is available in the "Open" dialog. It
|
The "Slides" button is available in the "Open" dialog. It
|
||||||
displays a list of your saved files, just like the "Open"
|
can be used to play a simple animation within Tux Paint, or
|
||||||
dialog.
|
a slideshow of pictures. It can also export an animated GIF
|
||||||
|
based on the chosen images.
|
||||||
|
|
||||||
Click each of the images you wish to display in a
|
Chosing pictures
|
||||||
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
|
When you enter the "Slides" section of
|
||||||
of your slideshow).
|
Tux Paint, it displays a list of your saved
|
||||||
|
files, just like the "Open" dialog.
|
||||||
|
|
||||||
A sliding scale at the lower left of the screen (next to the
|
Click each of the images you wish to display in
|
||||||
"Play" button) can be used to adjust the speed of the
|
a slideshow-style presentation, one by one. A
|
||||||
slideshow, from slowest to fastest. Choose the leftmost
|
digit will appear over each image, letting you
|
||||||
setting to disable automatic advancement — you will need to
|
know in which order they will be displayed.
|
||||||
press a key or click to go to the next slide (see below).
|
|
||||||
|
|
||||||
Note: The slowest setting does not automatically advance
|
You can click a selected image to unselect it
|
||||||
through the slides. Use it for when you want to step through
|
(take it out of your slideshow). Click it again
|
||||||
them manually.
|
if you wish to add it to the end of the list.
|
||||||
|
|
||||||
When you're ready, click the "Play" button to begin the
|
Set playback speed
|
||||||
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
|
A sliding scale at the lower left of the screen
|
||||||
the [Right Arrow], or click the "Next" button at the lower
|
(next to the "Play" button) can be used to
|
||||||
left, to manually advance to the next slide. Press [Left] to
|
adjust the speed of the slideshow or animated
|
||||||
go back to the previous slide.
|
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).
|
||||||
|
|
||||||
Press [Escape], or click the "Back" button at the lower
|
Note: The slowest setting does not
|
||||||
right, to exit the slideshow and return to the slideshow
|
automatically advance through the slides. Use
|
||||||
image selection screen.
|
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] 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 "Open" dialog.) If no images are
|
||||||
|
selected, Tux Paint will NOT attempt to
|
||||||
|
generate a GIF based on all saved images.
|
||||||
|
|
||||||
|
Pressing [Escape] during export will abort the
|
||||||
|
process, and return you to the "Slideshow"
|
||||||
|
dialog.
|
||||||
|
|
||||||
Click "Back" in the slideshow image selection screen to
|
Click "Back" in the slideshow image selection screen to
|
||||||
return to the "Open" dialog.
|
return to the "Open" dialog.
|
||||||
|
|
||||||
|
----------------------------------------------------------------------
|
||||||
|
|
||||||
Quit
|
Quit
|
||||||
|
|
||||||
Clicking the "Quit" button, closing the Tux Paint window, or
|
Clicking the "Quit" button, closing the Tux Paint window, or
|
||||||
|
|
@ -720,6 +761,8 @@ Available Tools
|
||||||
[Shift] + [Control] + [Escape] may be used to quit. (See the
|
[Shift] + [Control] + [Escape] may be used to quit. (See the
|
||||||
"Options" documentation.)
|
"Options" documentation.)
|
||||||
|
|
||||||
|
----------------------------------------------------------------------
|
||||||
|
|
||||||
Sound Muting
|
Sound Muting
|
||||||
|
|
||||||
There is no on-screen control button at this time, but by
|
There is no on-screen control button at this time, but by
|
||||||
|
|
|
||||||
|
|
@ -347,7 +347,7 @@
|
||||||
The toolbar contains the drawing and editing
|
The toolbar contains the drawing and editing
|
||||||
controls.
|
controls.
|
||||||
</p>
|
</p>
|
||||||
<!-- FIXME: Updated screenshot -->
|
<!-- FIXME: Update screenshot to add "Fill" tool -->
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="../../html/images/tools.jpg"
|
<img src="../../html/images/tools.jpg"
|
||||||
|
|
@ -1141,6 +1141,20 @@
|
||||||
<br clear="all">
|
<br clear="all">
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
|
<li>
|
||||||
|
<img src="../../html/images/open_export.png"
|
||||||
|
width="48"
|
||||||
|
height="48"
|
||||||
|
alt=""
|
||||||
|
align="right">
|
||||||
|
<p>
|
||||||
|
Click the "Export" button near the lower right
|
||||||
|
to export the image to your export folder.
|
||||||
|
(e.g., "<code>~/Pictures/TuxPaint/</code>")
|
||||||
|
</p>
|
||||||
|
<br clear="all">
|
||||||
|
</li>
|
||||||
|
|
||||||
<li>
|
<li>
|
||||||
<img src="../../html/images/open_slides.png"
|
<img src="../../html/images/open_slides.png"
|
||||||
width="48"
|
width="48"
|
||||||
|
|
@ -1466,64 +1480,114 @@
|
||||||
align="right">
|
align="right">
|
||||||
<p>
|
<p>
|
||||||
The "Slides" button is available in the "Open"
|
The "Slides" button is available in the "Open"
|
||||||
dialog. It displays a list of your saved files,
|
dialog. It can be used to play a simple animation
|
||||||
just like the "Open" dialog.
|
within Tux Paint, or a slideshow of pictures.
|
||||||
|
It can also export an animated GIF based on the
|
||||||
|
chosen images.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<dl>
|
||||||
Click each of the images you wish to display in a
|
<dt><b>Chosing pictures</b></dt>
|
||||||
slideshow-style presentation, one by one. A digit
|
<dd>
|
||||||
will appear over each image, letting you know in
|
<p>
|
||||||
which order they will be displayed.
|
When you enter the "Slides" section of Tux Paint,
|
||||||
</p>
|
it displays a list of your saved files, just like the
|
||||||
|
"Open" dialog.
|
||||||
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
You can click a selected image to unselect it (take
|
Click each of the images you wish to display in a
|
||||||
it out of your slideshow).
|
slideshow-style presentation, one by one. A digit
|
||||||
</p>
|
will appear over each image, letting you know in
|
||||||
|
which order they will be displayed.
|
||||||
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
A sliding scale at the lower left of the screen
|
You can click a selected image to unselect it (take
|
||||||
(next to the "Play" button) can be used to adjust
|
it out of your slideshow). Click it again if you
|
||||||
the speed of the slideshow, from slowest to
|
wish to add it to the end of the list.
|
||||||
fastest. Choose the leftmost setting to disable
|
</p>
|
||||||
automatic advancement — you will need to press a
|
</dd>
|
||||||
key or click to go to the next slide (see below).
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
<dt><b>Set playback speed</b></dt>
|
||||||
<b>Note:</b> The slowest setting does not
|
<dd>
|
||||||
automatically advance through the slides. Use it
|
<p>
|
||||||
for when you want to step through them manually.
|
A sliding scale at the lower left of the screen
|
||||||
</p>
|
(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).
|
||||||
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
When you're ready, click the "Play" button to begin
|
<b>Note:</b> The slowest setting does not
|
||||||
the slideshow. (Note: If you hadn't selected ANY
|
automatically advance through the slides. Use it
|
||||||
images, then ALL images will be played in the
|
for when you want to step through them manually.
|
||||||
slideshow.)
|
(This does not apply to an exported animated GIF.)
|
||||||
</p>
|
</p>
|
||||||
|
</dd>
|
||||||
|
|
||||||
<p>
|
<dt><b>Playback in Tux Paint</b></dt>
|
||||||
During the slideshow, press <b>[Space]</b>,
|
<dd>
|
||||||
<b>[Enter]</b> or <b>[Return]</b> or the
|
<p>
|
||||||
<b>[Right Arrow]</b>, or click the "Next"
|
To play a slideshow within Tux Paint, click the
|
||||||
button at the lower left, to manually advance to
|
"Play" button. (Note: If you hadn't selected ANY
|
||||||
the next slide. Press <b>[Left]</b> to go back to
|
images, then ALL of your saved images will be played
|
||||||
the previous slide.
|
in the slideshow!)
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Press <b>[Escape]</b>, or click the "Back" button
|
During the slideshow, press <b>[Space]</b>,
|
||||||
at the lower right, to exit the slideshow and
|
<b>[Enter]</b> or <b>[Return]</b>, or the
|
||||||
return to the slideshow image selection screen.
|
<b>[Right Arrow]</b> — or click the "Next"
|
||||||
</p>
|
button at the lower left — to manually advance to
|
||||||
|
the next slide. Press <b>[Left]</b> to go back to
|
||||||
|
the previous slide.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Press <b>[Escape]</b>, or click the "Back" button
|
||||||
|
at the lower right, to exit the slideshow and
|
||||||
|
return to the slideshow image selection screen.
|
||||||
|
</p>
|
||||||
|
</dd>
|
||||||
|
|
||||||
|
<dt><b>Exporting an animated GIF</b></dt>
|
||||||
|
<dd>
|
||||||
|
<p>
|
||||||
|
<img src="../../html/images/open_slides_export_gif.png"
|
||||||
|
width="48"
|
||||||
|
height="48"
|
||||||
|
alt=""
|
||||||
|
align="right">
|
||||||
|
Click the "GIF Export" button near the lower right
|
||||||
|
to have Tux Paint generate an animated GIF file
|
||||||
|
based on the selected images.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
<b>Note:</b> At least two images must be selected.
|
||||||
|
(To export a single image, use the "Export" option
|
||||||
|
from the "Open" dialog.) If no images are selected,
|
||||||
|
Tux Paint will NOT attempt to generate a GIF
|
||||||
|
based on all saved images.
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
Pressing [Escape] during export will abort the process,
|
||||||
|
and return you to the "Slideshow" dialog.
|
||||||
|
</p>
|
||||||
|
<br clear="all" />
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Click "Back" in the slideshow image selection
|
Click "Back" in the slideshow image selection
|
||||||
screen to return to the "Open" dialog.
|
screen to return to the "Open" dialog.
|
||||||
</p>
|
</p>
|
||||||
<br clear="all">
|
<br clear="all">
|
||||||
|
|
||||||
|
<hr size="1">
|
||||||
</dd>
|
</dd>
|
||||||
|
|
||||||
<dt>
|
<dt>
|
||||||
|
|
@ -1586,6 +1650,8 @@
|
||||||
"OPTIONS.html"><i>Options</i></a>" documentation.)
|
"OPTIONS.html"><i>Options</i></a>" documentation.)
|
||||||
</p>
|
</p>
|
||||||
<br clear="all">
|
<br clear="all">
|
||||||
|
|
||||||
|
<hr size="1">
|
||||||
</dd>
|
</dd>
|
||||||
|
|
||||||
<dt>
|
<dt>
|
||||||
|
|
|
||||||
BIN
docs/html/images/open_export.png
Normal file
BIN
docs/html/images/open_export.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.9 KiB |
BIN
docs/html/images/open_slides_export_gif.png
Normal file
BIN
docs/html/images/open_slides_export_gif.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.6 KiB |
Loading…
Add table
Add a link
Reference in a new issue