Index cleanup.
[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="navtop">
15     <table width="100%" border="0" cellpadding="4" cellspacing="0">
16       <col id="navtop_col1" width="33%"></col>
17       <col id="navtop_col2" width="33%"></col>
18       <col id="navtop_col3" width="33%"></col>
19
20       <thead>
21         <tr>
22           <td>
23             <p class="previous"><a href="image_presentation.html">Previous</a>
24             </p>
25           </td>
26
27           <td>
28             <p class="gq-slideshow-1">Slide Show &ndash; Image Presentation</p>
29           </td>
30
31           <td>
32             <p class="gq-slideshow-2"><a href="image_presentation_fullscreen.html">Next</a>
33             </p>
34           </td>
35         </tr>
36       </thead>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>Slide Show</h1>
43
44   <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>
45
46   <p><br />
47   <br />
48   </p>
49
50   <h2>Starting a slide show</h2>
51
52   <p>A slide show can be started in a number of ways:</p>
53
54   <ul>
55     <li>
56       <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>
57     </li>
58
59     <li>
60       <p class="gq-slideshow-5">From the keyboard - press the <b>S</b> key to toggle the slide show on or off.</p>
61     </li>
62
63     <li>
64       <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>
65     </li>
66   </ul>
67
68   <p><br />
69   <br />
70   </p>
71
72   <h2>Stopping a slide show</h2>
73
74   <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>
75
76   <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>
77
78   <p><br />
79   <br />
80   </p>
81
82   <h2>Slide show status</h2>
83
84   <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>
85
86   <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>
87
88   <p><br />
89   <br />
90   </p>
91
92   <h2>Pausing a slide show</h2>
93
94   <p>An active slide show can be paused in two ways:</p>
95
96   <ul>
97     <li>
98       <p>From the keyboard - press the <b>P</b> key while a slide show is active.</p>
99     </li>
100
101     <li>
102       <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>
103     </li>
104   </ul>
105
106   <p><br />
107   <br />
108   </p>
109
110   <h2>Selecting the images to include in a slide show</h2>
111
112   <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>
113
114   <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>
115
116   <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>
117
118   <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>
119
120   <p><br />
121   <br />
122   </p>
123
124   <h2>Recursive slide show</h2>
125
126   <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>
127
128   <ul>
129     <li>
130       <p class="gq-slideshow-5">Slide show: This will start a slide show that includes all images in the selected folder.</p>
131     </li>
132
133     <li>
134       <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>
135     </li>
136   </ul>
137
138   <p><br />
139   <br />
140   </p>
141
142   <h2><a name="navigation" id="navigation"></a>Slide show sequence navigation</h2>
143   
144   <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>
145
146   <p><br />
147   <br />
148   </p>
149
150   <h2>Configuring a slide show</h2>
151
152   <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>
153
154   <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>
155
156   <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>
157
158   <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>
159
160   <p><br />
161   <br />
162   </p>
163
164   <p><br />
165   <br />
166   </p>
167
168   <hr />
169
170   <div class="navbottom">
171     <table width="100%" border="0" cellpadding="4" cellspacing="0">
172       <col id="navbottom_col1" width="33%"></col>
173       <col id="navbottom_col2" width="33%"></col>
174       <col id="navbottom_col3" width="33%"></col>
175
176       <thead>
177         <tr>
178           <td>
179             <p class="previous"><a href="image_presentation.html">Previous</a>
180             </p>
181           </td>
182
183           <td>
184             <p class="gq-slideshow-1"><a href="index.html">Contents</a>
185             </p>
186           </td>
187
188           <td>
189             <p class="gq-slideshow-2"><a href="image_presentation_fullscreen.html">Next</a>
190             </p>
191           </td>
192         </tr>
193       </thead>
194
195     </table>
196   </div>
197
198   <div class="footer">Geeqie User Manual</div>
199   <div class="bottomspacer">&nbsp;</div>
200 </body>
201 </html>