Add style.css to list of files to install.
[geeqie.git] / doc / image_presentation_slideshow.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Slide Show - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" />
11 </head>
12
13 <body lang="en-US" dir="ltr" xml:lang="en-US">
14   <div class="gq-slideshow-4">
15     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-slideshow-3">
16
17       <thead>
18         <tr valign="top">
19           <td width="33%">
20             <p class="previous"><a href="image_presentation.html">Previous</a>
21             </p>
22           </td>
23
24           <td width="33%">
25             <p class="gq-slideshow-1">Slide Show &ndash; Image Presentation</p>
26           </td>
27
28           <td width="33%">
29             <p class="gq-slideshow-2"><a href="image_presentation_fullscreen.html">Next</a>
30             </p>
31           </td>
32         </tr>
33       </thead>
34     </table>
35   </div>
36
37   <hr />
38
39   <h1>Slide Show</h1>
40
41   <p>The image pane can be set to automatically change the displayed image after a period of time, in Geeqie this is referred to as a slide show.</p>
42
43   <p><br />
44   <br />
45   </p>
46
47   <h2>Starting a slide show</h2>
48
49   <p>A slide show can be started in a number of ways:</p>
50
51   <ul>
52     <li>
53       <p>From the menu bar - open the <b>View</b> menu and select <b>Toggle slide show</b> to toggle the slide show on or off .</p>
54     </li>
55
56     <li>
57       <p class="gq-slideshow-5">From the keyboard - press the <b>S</b> key to toggle the slide show on or off.</p>
58     </li>
59
60     <li>
61       <p class="gq-slideshow-5">From a context menu - right click an image pane, and select <b>Start slide show</b>, or <b>Stop slide show</b>; the text will change depending on the state of the current slide show.</p>
62     </li>
63   </ul>
64
65   <p><br />
66   <br />
67   </p>
68
69   <h2>Stopping a slide show</h2>
70
71   <p>An active slide show can be stopped by using the same functions available to start one, as they work like a toggle switch. If slide show repeat is not enabled in the <a href="options_general.html">options dialog</a>, the slide show will stop when the last image in the sequence is displayed.</p>
72
73   <p>Any action that changes the image pane to a new image will stop the active slide show, with the exception of the methods discussed in <a href="#navigation">Slide show sequence navigation</a>.</p>
74
75   <p><br />
76   <br />
77   </p>
78
79   <h2>Slide show status</h2>
80
81   <p>The main window <a href="main_window_status_bar.html">status bar</a> can be used to determine when a slide show is active, <b>Slide show</b> will be displayed next to the file count field. An individual <a href="other_windows_image_window.html">Image Window</a> can also display a slide show, however the status will not be immediately visible. To determine the slide show status in an image window, open a context menu by right clicking or using the menu key, the slide show menu item will reflect the slide show status; if <b>Start slide show</b> is displayed, no slide show is active, conversely if <b>Stop slide show</b> is displayed a slide show is active.</p>
82
83   <p>When a Slide show is paused, the main window status bar will display <b>Paused</b> instead of <b>Slide show</b>. Likewise, the image context menu will display <b>Pause slide show</b> or <b>Continue slide show</b>, depending on the current state.</p>
84
85   <p><br />
86   <br />
87   </p>
88
89   <h2>Pausing a slide show</h2>
90
91   <p>An active slide show can be paused in two ways:</p>
92
93   <ul>
94     <li>
95       <p>From the keyboard - press the <b>P</b> key while a slide show is active.</p>
96     </li>
97
98     <li>
99       <p>From a context menu - right click the image pane displaying the slide show, and select <b>Pause slide show</b>, or <b>Continue slide show</b> depending on the current slide show state.</p>
100     </li>
101   </ul>
102
103   <p><br />
104   <br />
105   </p>
106
107   <h2>Selecting the images to include in a slide show</h2>
108
109   <p class="gq-slideshow-5">When a single image is selected, all images in the current folder are included in the slide show. The sequence will begin with the current image; however if random slide shows are enabled, the sequence will begin with a random image from the list.</p>
110
111   <p class="gq-slideshow-5">To only include some images in a slide show, use multiple selection to select the images to include before starting the slide show.</p>
112
113   <p class="gq-slideshow-5">An image collection can be used as the list of images, to do this drag an image from a collection window onto the image pane. Starting a slide show will then include the images from that collection.</p>
114
115   <p>So far, the methods described are for slide shows in a main window, in an <a href="other_windows_image_window.html">Image Window</a>, the slide show will use all images referenced by that window.</p>
116
117   <p><br />
118   <br />
119   </p>
120
121   <h2>Recursive slide show</h2>
122
123   <p class="gq-slideshow-5">In the main window, a recursive slide show can be started from a folder's context menu; the folder's right click menu will include two slide show options:</p>
124
125   <ul>
126     <li>
127       <p class="gq-slideshow-5">Slide show: This will start a slide show that includes all images in the selected folder.</p>
128     </li>
129
130     <li>
131       <p class="gq-slideshow-5">Slide show recursive: The slide show will include all images in the selected folder, and all images in the folders that are contained within the selected folder.</p>
132     </li>
133   </ul>
134
135   <p><br />
136   <br />
137   </p>
138
139   <h2><a name="navigation" id="navigation"></a>Slide show sequence navigation</h2>
140   
141   <p class="gq-slideshow-5">When a slide show is active, functions that normally change the image forward and backward can be used to step through those contained in the slide show.</p>
142
143   <p><br />
144   <br />
145   </p>
146
147   <h2>Configuring a slide show</h2>
148
149   <p>The options that control the behavior of slide shows are located on the <a href="options_general.html">General tab</a> of the options dialog.</p>
150
151   <p class="gq-slideshow-7"><b>Display time</b>: The delay between each image in the slide show can be adjusted with the <span class="gq-slideshow-6"><b>Delay before image change</b> option.</span></p>
152
153   <p class="gq-slideshow-8"><b>Repeat</b>: This will cause the slide show to loop indefinitely, it will continue with the first image after displaying the last image in the slide show list.</p>
154
155   <p class="gq-slideshow-9"><span class="gq-slideshow-6"><b>Random</b>: This will display images randomly selected from the slide show list. Each image from the slide show list will be displayed once.</span> When Repeat is also enabled, the random sequence is changed after each complete cycle of the images.</p>
156
157   <p><br />
158   <br />
159   </p>
160
161   <p><br />
162   <br />
163   </p>
164
165   <hr />
166
167   <div class="gq-slideshow-4">
168     <table width="100%" border="0" cellpadding="4" cellspacing="0">
169
170       <thead>
171         <tr valign="top">
172           <td width="33%">
173             <p class="previous"><a href="image_presentation.html">Previous</a>
174             </p>
175           </td>
176
177           <td width="33%">
178             <p class="gq-slideshow-1"><a href="index.html">Contents</a>
179             </p>
180           </td>
181
182           <td width="33%">
183             <p class="gq-slideshow-2"><a href="image_presentation_fullscreen.html">Next</a>
184             </p>
185           </td>
186         </tr>
187       </thead>
188
189       <tbody>
190         <tr valign="top">
191           <td width="33%">
192             <p><br />
193             </p>
194           </td>
195
196           <td width="33%">
197             <p class="gq-slideshow-1"><br />
198             </p>
199           </td>
200
201           <td width="33%">
202             <p class="gq-slideshow-2">Geeqie User Manual</p>
203           </td>
204         </tr>
205       </tbody>
206     </table>
207   </div>
208
209   <p class="gq-slideshow-10"><br />
210   </p>
211 </body>
212 </html>