view doc/main_window_image_pane.html @ 1692:d9a53661cc73

fixed mnemonic conflicts
author nadvornik
date Wed, 01 Jul 2009 19:33:09 +0000
parents 473a7c4881cd
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>Image Pane - 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="main_window_folder_pane.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Image Pane &ndash; Main Window</p>
          </th>

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

  <hr />

  <h1>Image Pane</h1>

  <p>The image pane is the region of the main window that displays the selected image. The image pane allows adjustment of display size and orientation; it also provides several methods to manipulate the image with the mouse and keyboard.</p>

  <h2>Image display</h2>

  <p>The image is drawn to the screen as it is decoded from disk. The image can be panned and zoomed while it is still loading. Image adjustment operations for rotation, mirror, and flip will delay until the image is completed. The adjustment queue will remember one operation and will retain the most recently requested function, which will be performed once the image has finished loading.</p>

  <p>The quality of the image, especially when using the zoom feature, is dependent on the settings that are available on the <a href="options_image.html">Image tab</a> of the preferences dialog.</p>

  <p>To increase the speed of loading the next image when navigating the image list in sequence, enable the <a href="options_image.html" class="option_name">Preload next image</a> option.</p>

  <h2>Image panning and manipulation</h2>

  <p>When the image size is larger than the image pane, the visible region can be changed with the keyboard or mouse. The keyboard can also be used to adjust the orientation of the image.</p>

  <h3>Keyboard</h3>
  <p>Use the <span class="key">Arrows</span> to pan the image in the desired direction, to increase the panning speed hold down the <span class="key">Shift</span> + <span class="key">Arrows</span>.<br />Press <span class="key">Ctrl</span> +  <span class="key">Arrows</span> to move to the respective edge of the image. The image can only be panned with the keyboard when the image has the focus, indicated by a dotted line surrounding the image pane.</p>

  <div class="shortcuts">
    <table width="80%" border="1" cellpadding="2" cellspacing="0">
    <col id="image_pane_shortcuts_col1" width="25%"></col>
    <col id="image_pane_shortcuts_col2" width="25%"></col>
    <col id="image_pane_shortcuts_col3" width="50%"></col>

    <thead>
      <tr>
        <td>
          <p>Shortcut</p>
        </td>

        <td>
          <p>Context menu name</p>
        </td>

        <td>
          <p>Description</p>
        </td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>
          <p><span class="key">+</span></p>
	  <p><span class="key">=</span></p>
        </td>

        <td>
          <p>Zoom in</p>
        </td>

        <td>
          <p>Zoom in.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">-</span></p>
	</td>

        <td>
          <p>Zoom out</p>
        </td>

        <td>
          <p>Zoom out.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">X</span></p>
	  <p>[Keypad] <span class="key">*</span></p>
	</td>

        <td>
          <p>Fit image to window</p>
        </td>

        <td>
          <p>Scale the image to fit the available display area.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">Z</span></p>
	  <p>[Keypad] <span class="key">/</span></p>
	</td>

        <td>
          <p>Zoom 1:1</p>
        </td>

        <td>
          <p>Reset the zoom to original image size.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">]</span></p>
	</td>

        <td>
          <p>Adjust &gt; Rotate clockwise</p>
        </td>

        <td>
          <p>Rotate the image clockwise 90 degrees.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">[</span></p>
	</td>

        <td>
          <p>Adjust &gt; Rotate counterclockwise</p>
        </td>

        <td>
          <p>Rotate the image counterclockwise 90 degrees.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">Shift</span> + <span class="key">R</span></p>
	</td>

        <td>
          <p>Adjust &gt; Rotate 180</p>
        </td>

        <td>
          <p>Rotate the image 180 degrees.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">Shift</span> + <span class="key">M</span></p>
	</td>

        <td>
          <p>Adjust &gt; Mirror</p>
        </td>

        <td>
          <p>Flip the image horizontally.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p><span class="key">Shift</span> + <span class="key">F</span></p>
	</td>

        <td>
          <p>Adjust &gt; Flip</p>
        </td>

        <td>
          <p>Flip the image vertically.</p>
        </td>
      </tr>
    </tbody>
  </table>
  </div>
  <p class="note"><span class="note_label">Note:</span> The rotation, mirror, and flip functions will not change the image file on disk.</p>

  <h3>Mouse</h3>
  <p>Press the primary mouse button on the image and hold it, then move the mouse to pan the image in the desired direction. Releasing the mouse button will stop the panning operation. The mouse wheel can also be used to scroll the image when holding down the <span class="key">Shift</span> key <a href="#bottomnote1" class="bottomnote">(*)</a>.</p>

  <p>To scale the image size hold down the <span class="key">Ctrl</span> key and scroll the mouse wheel up to zoom in, or down to zoom out.</p>

  <h4>Smooth Scroll</h4>
  <p>To start the smooth scroll function hold down the <span class="key">Shift</span> key and click the primary mouse button. An icon will appear at the location of the mouse pointer, the mouse can then be positioned to pan the image. The image will pan in the direction of the mouse pointer relative to the icon. The pan speed will increase in proportion to the distance that the pointer is from the center of the icon. To end the smooth scroll function click the primary mouse button within the image pane.</p>

  <h2>Navigation</h2>

  <p>The displayed image can be changed to the next or previous image using the keyboard or mouse.</p>

  <h3>Keyboard</h3>
  <p>The <span class="key">PageDown</span> and <span class="key">PageUp</span> keys will change the image to the next or previous image, respectively, in the list. The <span class="key">Home</span> and <span class="key">End</span> keys will jump to the first and last image, respectively. When the image has the focus, the <span class="key">SpaceBar</span> and <span class="key">BackSpace</span> keys can also be used to change the image.</p>

  <h3>Mouse</h3>
  <p>To change to the next image in the list click the left mouse button, click the middle mouse button to change to the previous image. The mouse wheel can also be used to change the current image <a href="#bottomnote1" class="bottomnote">(*)</a>.</p>

  <h2>Context menu</h2>

  <p>Right clicking the mouse or pressing the menu key while the image has the focus will display a menu. The menu functions will perform the same as those that match the window's <a href="main_window_menus.html">menu bar</a>, however a few functions are unique to the context menu:</p>

  <dl class="menu_desc">
  <dt>View in new window</dt><dd>Opens a new window containing a second copy of the current image.</dd>

  <dt>Pause slide show, Continue slide show</dt><dd>Controls the pause state of an active slide show, the text of the menu will change to reflect the action that will be performed.</dd>
  </dl>

  <h2>Drag and Drop</h2>

  <p>Files and folders can be dropped onto the image pane, dropping a file will display the file and dropping a folder will change the main window to display the contents of the folder. When dropping multiple items on the image pane, only the first item in the list will be used, all additional items will be ignored.</p>

  <p>A drag and drop operation can be initiated from the image pane with the middle mouse button, the dragged item will contain the file path of the displayed image.</p>

  <h2>Displaying images side by side</h2>

  <p>Using View &gt; Split item from the main menu, image pane can be splitted in up to four panes, this allows to display images side by side. You may use drag'n drop to change images in each pane.</p>
  
  <p>Connected zoom is possible through the View &gt; Connected zoom menu. Zoom is then applied to all displayed images.</p>
  <p>Connected scrolling is also possible using <span class="key">Shift</span> and primary mouse button.</p>



  <p class="bottomnote"><a id="bottomnote1" name="bottomnote1"></a><span class="note_label">(*) Note:</span> The mouse wheel behavior for scrolling and image step can be swapped with the <span class="option_name">Mouse wheel scrolls image</span> option located on the <a href="options_advanced.html">Advanced tab</a> of the preferences dialog.</p>

  <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="main_window_folder_pane.html">Previous</a>
            </p>
          </th>

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

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

    </table>
  </div>

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