Mercurial > geeqie.yaz

view doc/collections.html @ 1110:7cd49c6dc302

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Reformatting: notes, advanced options page and more.
author zas_
date Mon, 10 Nov 2008 10:26:51 +0000
parents 215e102c1819
children 79e69e5f4642
line wrap: on
line source

<?xml version="1.0" encoding="iso-8859-1"?>

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

      <thead>
        <tr>
          <td>
            <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
            </p>
          </td>

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

          <td>
            <p class="next"><a href="sidebars.html">Next</a>
            </p>
          </td>
        </tr>
      </thead>
    </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>

  <p><br />
  <br />
  </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="gq-collections-4">
    <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>Enter</p>
        </td>

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

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

      <tr>
        <td>
          <p>V</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>Control + A</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + Shift + A</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + 1 through<br />
          Control + 0</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + P</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + C</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + M</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + R</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + D</p>
        </td>

        <td>
          <p>Delete</p>
        </td>

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

      <tr>
        <td>
          <p>Delete</p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + L</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>A</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>S</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>Control + S</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>Control + T</p>
        </td>

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

        <td>
          <p>Toggle display of text below icons.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p>Menu</p>
        </td>

        <td>
          <p><br />
          </p>
        </td>

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

      <tr>
        <td>
          <p>N</p>
        </td>

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

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

      <tr>
        <td>
          <p>I</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>D</p>
        </td>

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

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

      <tr>
        <td>
          <p>B</p>
        </td>

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

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

      <tr>
        <td>
          <p>P</p>
        </td>

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

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

      <tr>
        <td>
          <p><br />
          </p>
        </td>

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

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

      <tr>
        <td>
          <p>Control + W</p>
        </td>

        <td>
          <p><br />
          </p>
        </td>

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

  <p><br />
  <br />
  </p>

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

  <p><br />
  <br />
  </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>

  <p><br />
  <br />
  </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><br />
  <br />
  </p>

  <p class="note">Note: 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>

  <p><br />
  <br />
  </p>

  <hr />

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

      <thead>
        <tr>
          <td>
            <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
            </p>
          </td>

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

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

    </table>
  </div>

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