Mercurial > geeqie

view doc/collections.html @ 1451:0e67a5992d51

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
gint -> gboolean where applicable.
author zas_
date Mon, 16 Mar 2009 18:19:11 +0000
parents a72acb0fb9a6
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>Collections - 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">
  <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_search_finding_duplicates.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Collections</p>
          </th>

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

  <hr />

  <h1>Collections</h1>

  <p>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</p>

  <h2>The collection window</h2>
 
  <p>A collection window displays the contents of a collection. It allows the collection to be modified and access to the images contained in the collection.</p>

  <p>To open a new empty collection window press C or select New collection from the file menu.</p>

  <p>To open an existing collection, press O or select Open collection from the file menu. A dialog will appear requesting the location of the collection file. A window will the open containing the selected collection. Recently opened or saved collections can also be opened by selecting the collection's file name from the Open recent sub menu of the file menu.</p>

  <p>The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.</p>

  <h3>Icon pane</h3>

  <p>The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.</p>

  <p>The Icon pane works exactly like the Icon view mode of the <a href="main_window_file_pane.html">file pane</a> in a main window. But with the addition that the contents of the collection can be organized with drag and drop.</p>

  <p>A <b>context menu</b> is available for the icon pane by right clicking the mouse or pressing the Menu key.</p>

  <p><b>Keyboard shortcuts</b> available in the collection window:</p>

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

      <thead>
      <tr>
        <th>
          <p>Shortcut</p>
        </th>

        <th>
          <p>Context menu name</p>
        </th>

        <th>
          <p>Description</p>
        </th>
      </tr>
      </thead>

      <tr>
        <td>
          <p><span class="key">Enter</span></p>
        </td>

        <td>
          <p>View</p>
        </td>

        <td>
          <p>Opens selected image in main window.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">V</span></p>
        </td>

        <td>
          <p>View in new window</p>
        </td>

        <td>
          <p>Opens selected image in a new window.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">A</span></p>
        </td>

        <td>
          <p>Select all</p>
        </td>

        <td>
          <p>Selects all images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">Shift</span> + <span class="key">A</span></p>
        </td>

        <td>
          <p>Select none</p>
        </td>

        <td>
          <p>Clear the image selection.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">1</span> through<br />
          <span class="key">Ctrl</span> + <span class="key">0</span></p>
        </td>

        <td>
          <p>Edit sub menu</p>
        </td>

        <td>
          <p>Executes the respective editor command.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">P</span></p>
        </td>

        <td>
          <p>Properties</p>
        </td>

        <td>
          <p>Opens a properties window for selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">C</span></p>
        </td>

        <td>
          <p>Copy</p>
        </td>

        <td>
          <p>Copy selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">M</span></p>
        </td>

        <td>
          <p>Move</p>
        </td>

        <td>
          <p>Move selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">R</span></p>
        </td>

        <td>
          <p>Rename</p>
        </td>

        <td>
          <p>Rename selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">D</span></p>
        </td>

        <td>
          <p><span class="key">Delete</span></p>
        </td>

        <td>
          <p>Delete selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Delete</span></p>
        </td>

        <td>
          <p>Remove</p>
        </td>

        <td>
          <p>Remove selected images from result list.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">L</span></p>
        </td>

        <td>
          <p>Append from file list</p>
        </td>

        <td>
          <p>Add contents of main window to collection.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">A</span></p>
        </td>

        <td>
          <p>Append from collection</p>
        </td>

        <td>
          <p>Append contents of another collection from a file.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">S</span></p>
        </td>

        <td>
          <p>Save collection</p>
        </td>

        <td>
          <p>Save collection to disk, if the collection is new a dialog will appear to select the file name and location.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">S</span></p>
        </td>

        <td>
          <p>Save collection as</p>
        </td>

        <td>
          <p>Opens a dialog to select a new file name to use for the collection.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">T</span></p>
        </td>

        <td>
          <p>Show filename text</p>
        </td>

        <td>
          <p>Toggle display of text below icons. When set, icon's tooltip will show the full path to the file.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Menu</span></p>
        </td>

        <td>&nbsp;</td>

        <td>
          <p>Displays the context menu.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">N</span></p>
        </td>

        <td>
          <p>Sort by name</p>
        </td>

        <td>
          <p>Sort collection by file name.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">I</span></p>
        </td>

        <td>
          <p>Sort by number</p>
        </td>

        <td>
          <p>Sort collection by file name, using natural numerical order</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">D</span></p>
        </td>

        <td>
          <p>Sort by date</p>
        </td>

        <td>
          <p>Sort collection by file date.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">B</span></p>
        </td>

        <td>
          <p>Sort by size</p>
        </td>

        <td>
          <p>Sort collection by file size.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">P</span></p>
        </td>

        <td>
          <p>Sort by path</p>
        </td>

        <td>
          <p>Sort collection by file location (path to file).</p>
        </td>
      </tr>

      <tr>
        <td>&nbsp;</td>

        <td>
          <p>Print</p>
        </td>

        <td>
          <p>Opens a print dialog for selected images.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><span class="key">Ctrl</span> + <span class="key">W</span></p>
        </td>

        <td>&nbsp;</td>

        <td>
          <p>Close window.</p>
        </td>
      </tr>
    </table>
  </div>

  <p>The <b>selection</b> can be changed using the keyboard and mouse the same as in a <a href="main_window_file_pane.html">file pane</a> of the main window.</p>

  <h3>Status bar</h3>

  <p>The status bar displays the total number of images in the collection, and the number of selected images in parenthesis. A progress bar also displays whenever thumbnails are loading from disk.</p>

  <h3>Drag and Drop</h3>

  <p>Drag and drop can be initialized with the primary or middle mouse buttons. Dragging an image that is selected will include all selected images in the drag. Dragging an image that is not selected will drag only that image.</p>

  <p>Dropping files and folders onto the collection window will add them to the collection, they will be inserted at the location of the drop. A red arrow will indicate the location of the drop as files are dragged over the collection window. When one or more folders are included in the drop list, a menu will appear to select how to handle the contents of the folders.</p>

  <p>To move images within the collection to change their order, initiate a drag for the selected image(s) and then move the mouse to the desired location within the window. A red arrow will appear to assist in determining the destination of the dragged images. Release the drag to move the images to the new location in the list.</p>

  <p class="note"><span class="note_label">Note:</span> When renaming or moving files within Geeqie, the contents of collections located in the folder ($HOME)/.geeqie/collections will automatically update to the new name or location.</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="image_search_finding_duplicates.html">Previous</a>
            </p>
          </th>

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

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

    </table>
  </div>

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