view doc/image_presentation_slideshow.html @ 1337:091ba3e6aedb

image_change_complete(): reduce code redundancy and implify.
author zas_
date Sat, 28 Feb 2009 16:59:20 +0000
parents 2562e0bc89a1
children
line wrap: on
line source

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />

  <title>Slide Show - Geeqie User Manual</title>
  <link rel="stylesheet" type="text/css" href="style.css" media="all" />
  <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
  <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
</head>

<body lang="en-US" dir="ltr" xml:lang="en-US">
  <div class="navtop">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navtop_col1" width="33%"></col>
      <col id="navtop_col2" width="33%"></col>
      <col id="navtop_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="image_presentation.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Slide Show &ndash; Image Presentation</p>
          </th>

          <th>
            <p class="next"><a href="image_presentation_fullscreen.html">Next</a>
            </p>
          </th>
        </tr>
    </table>
  </div>

  <hr />

  <h1>Slide Show</h1>

  <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>

  <h2>Starting a slide show</h2>

  <p>A slide show can be started in a number of ways:</p>

  <ul>
    <li>
      <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>
    </li>

    <li>
      <p>From the keyboard - press the <span class="key">S</span> key to toggle the slide show on or off.</p>
    </li>

    <li>
      <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>
    </li>
  </ul>

  <h2>Stopping a slide show</h2>

  <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>

  <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>

  <h2>Slide show status</h2>

  <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>

  <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>

  <h2>Pausing a slide show</h2>

  <p>An active slide show can be paused in two ways:</p>

  <ul>
    <li>
      <p>From the keyboard - press the <span class="key">P</span> key while a slide show is active.</p>
    </li>

    <li>
      <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>
    </li>
  </ul>

  <h2>Selecting the images to include in a slide show</h2>

  <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>

  <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>

  <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>

  <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>

  <h2>Recursive slide show</h2>

  <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>

  <ul>
    <li>
      <p>Slide show: This will start a slide show that includes all images in the selected folder.</p>
    </li>

    <li>
      <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>
    </li>
  </ul>

  <h2><a name="navigation" id="navigation"></a>Slide show sequence navigation</h2>
  
  <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>

  <h2>Configuring a slide show</h2>

  <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>

  <dl class="dialog_desc">
  <dt>Display time</dt>
  <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>

  <dt>Repeat</dt>
  <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>

  <dt>Random</dt>
  <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>
  </dl>

  <hr id="bottomseparator" />

  <div class="navbottom">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navbottom_col1" width="33%"></col>
      <col id="navbottom_col2" width="33%"></col>
      <col id="navbottom_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="image_presentation.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navbottom_title"><a href="index.html">Contents</a>
            </p>
          </th>

          <th>
            <p class="next"><a href="image_presentation_fullscreen.html">Next</a>
            </p>
          </th>
        </tr>

    </table>
  </div>

  <div class="footer">Geeqie User Manual</div>
  <div class="bottomspacer">&nbsp;</div>
</body>
</html>