More precise description of the pan view find feature and a note about ressources...
[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 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.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         <tr>
21           <th>
22             <p class="previous"><a href="image_presentation.html">Previous</a>
23             </p>
24           </th>
25
26           <th>
27             <p class="navtop_title">Slide Show &ndash; Image Presentation</p>
28           </th>
29
30           <th>
31             <p class="next"><a href="image_presentation_fullscreen.html">Next</a>
32             </p>
33           </th>
34         </tr>
35     </table>
36   </div>
37
38   <hr />
39
40   <h1>Slide Show</h1>
41
42   <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>
43
44   <h2>Starting a slide show</h2>
45
46   <p>A slide show can be started in a number of ways:</p>
47
48   <ul>
49     <li>
50       <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>
51     </li>
52
53     <li>
54       <p>From the keyboard - press the <b>S</b> key to toggle the slide show on or off.</p>
55     </li>
56
57     <li>
58       <p>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>
59     </li>
60   </ul>
61
62   <h2>Stopping a slide show</h2>
63
64   <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>
65
66   <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>
67
68   <h2>Slide show status</h2>
69
70   <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>
71
72   <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>
73
74   <h2>Pausing a slide show</h2>
75
76   <p>An active slide show can be paused in two ways:</p>
77
78   <ul>
79     <li>
80       <p>From the keyboard - press the <b>P</b> key while a slide show is active.</p>
81     </li>
82
83     <li>
84       <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>
85     </li>
86   </ul>
87
88   <h2>Selecting the images to include in a slide show</h2>
89
90   <p>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>
91
92   <p>To only include some images in a slide show, use multiple selection to select the images to include before starting the slide show.</p>
93
94   <p>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>
95
96   <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>
97
98   <h2>Recursive slide show</h2>
99
100   <p>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>
101
102   <ul>
103     <li>
104       <p>Slide show: This will start a slide show that includes all images in the selected folder.</p>
105     </li>
106
107     <li>
108       <p>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>
109     </li>
110   </ul>
111
112   <h2><a name="navigation" id="navigation"></a>Slide show sequence navigation</h2>
113   
114   <p>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>
115
116   <h2>Configuring a slide show</h2>
117
118   <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>
119
120   <dl class="dialog_desc">
121   <dt>Display time</dt>
122   <dd><p>The delay between each image in the slide show can be adjusted with the <span class="option_name">Delay before image change</span> option.</p></dd>
123
124   <dt>Repeat</dt>
125   <dd><p>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></dd>
126
127   <dt>Random</dt>
128   <dd><p>This will display images randomly selected from the slide show list. Each image from the slide show list will be displayed once. When Repeat is also enabled, the random sequence is changed after each complete cycle of the images.</p></dd>
129   </dl>
130
131   <hr id="bottomseparator" />
132
133   <div class="navbottom">
134     <table width="100%" border="0" cellpadding="4" cellspacing="0">
135       <col id="navbottom_col1" width="33%"></col>
136       <col id="navbottom_col2" width="33%"></col>
137       <col id="navbottom_col3" width="33%"></col>
138
139         <tr>
140           <th>
141             <p class="previous"><a href="image_presentation.html">Previous</a>
142             </p>
143           </th>
144
145           <th>
146             <p class="navbottom_title"><a href="index.html">Contents</a>
147             </p>
148           </th>
149
150           <th>
151             <p class="next"><a href="image_presentation_fullscreen.html">Next</a>
152             </p>
153           </th>
154         </tr>
155
156     </table>
157   </div>
158
159   <div class="footer">Geeqie User Manual</div>
160   <div class="bottomspacer">&nbsp;</div>
161 </body>
162 </html>