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
|
||||
(GPL v3 or later, for Free/Libre Open Source Software)
|
||||
* WORK IN PROGRESS -- Ignores speed
|
||||
* WORK IN PROGRESS -- Needs documentation
|
||||
* Single image (PNG) export from the Open dialog.
|
||||
(Closes https://sourceforge.net/p/tuxpaint/feature-requests/192/)
|
||||
* WORK IN PROGRESS -- Needs documentation
|
||||
* Both utilize XDG user dirs settings, if available, to determine
|
||||
where to store them, or "~/Pictures", otherwise. In those cases,
|
||||
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
|
||||
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
|
||||
the lower left to go to slideshow mode. See "Slides",
|
||||
below, for details.
|
||||
|
|
@ -653,43 +657,80 @@ Available Tools
|
|||
Slides (under "Open")
|
||||
|
||||
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
|
||||
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] 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 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).
|
||||
|
||||
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).
|
||||
|
||||
Note: The slowest setting does not automatically advance
|
||||
through the slides. Use it for when you want to step through
|
||||
them manually.
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
----------------------------------------------------------------------
|
||||
|
||||
Quit
|
||||
|
||||
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
|
||||
"Options" documentation.)
|
||||
|
||||
----------------------------------------------------------------------
|
||||
|
||||
Sound Muting
|
||||
|
||||
There is no on-screen control button at this time, but by
|
||||
|
|
|
|||
|
|
@ -347,7 +347,7 @@
|
|||
The toolbar contains the drawing and editing
|
||||
controls.
|
||||
</p>
|
||||
<!-- FIXME: Updated screenshot -->
|
||||
<!-- FIXME: Update screenshot to add "Fill" tool -->
|
||||
|
||||
<p align="center">
|
||||
<img src="../../html/images/tools.jpg"
|
||||
|
|
@ -1141,6 +1141,20 @@
|
|||
<br clear="all">
|
||||
</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>
|
||||
<img src="../../html/images/open_slides.png"
|
||||
width="48"
|
||||
|
|
@ -1466,8 +1480,19 @@
|
|||
align="right">
|
||||
<p>
|
||||
The "Slides" button is available in the "Open"
|
||||
dialog. It displays a list of your saved files,
|
||||
just like the "Open" dialog.
|
||||
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.
|
||||
</p>
|
||||
|
||||
<dl>
|
||||
<dt><b>Chosing pictures</b></dt>
|
||||
<dd>
|
||||
<p>
|
||||
When you enter the "Slides" section of Tux Paint,
|
||||
it displays a list of your saved files, just like the
|
||||
"Open" dialog.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
|
|
@ -1479,36 +1504,45 @@
|
|||
|
||||
<p>
|
||||
You can click a selected image to unselect it (take
|
||||
it out of your slideshow).
|
||||
it out of your slideshow). Click it again if you
|
||||
wish to add it to the end of the list.
|
||||
</p>
|
||||
</dd>
|
||||
|
||||
<dt><b>Set playback speed</b></dt>
|
||||
<dd>
|
||||
<p>
|
||||
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).
|
||||
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>
|
||||
<b>Note:</b> 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.)
|
||||
</p>
|
||||
</dd>
|
||||
|
||||
<dt><b>Playback in Tux Paint</b></dt>
|
||||
<dd>
|
||||
<p>
|
||||
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.)
|
||||
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!)
|
||||
</p>
|
||||
|
||||
<p>
|
||||
During the slideshow, press <b>[Space]</b>,
|
||||
<b>[Enter]</b> or <b>[Return]</b> or the
|
||||
<b>[Right Arrow]</b>, or click the "Next"
|
||||
button at the lower left, to manually advance to
|
||||
<b>[Enter]</b> or <b>[Return]</b>, or the
|
||||
<b>[Right Arrow]</b> — or click the "Next"
|
||||
button at the lower left — to manually advance to
|
||||
the next slide. Press <b>[Left]</b> to go back to
|
||||
the previous slide.
|
||||
</p>
|
||||
|
|
@ -1518,12 +1552,42 @@
|
|||
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>
|
||||
Click "Back" in the slideshow image selection
|
||||
screen to return to the "Open" dialog.
|
||||
</p>
|
||||
<br clear="all">
|
||||
|
||||
<hr size="1">
|
||||
</dd>
|
||||
|
||||
<dt>
|
||||
|
|
@ -1586,6 +1650,8 @@
|
|||
"OPTIONS.html"><i>Options</i></a>" documentation.)
|
||||
</p>
|
||||
<br clear="all">
|
||||
|
||||
<hr size="1">
|
||||
</dd>
|
||||
|
||||
<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