view doc/docbook/GuideOtherWindowsPanView.xml @ 1774:a7f7b9c0050c

build documentation with gnome-doc-tool in makefile

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOtherWindowsPanView">
    <title>
      Pan View Window
    </title>
    <para>
      This window proposes alternative views of the <emphasis role="i">current directory and its children</emphasis>.<?db2html element="br"?>
      You can pan the view as you pan an image in normal view mode, using left mouse button and drag.
    </para>
    <para>
      A primary mouse button click on any image will display informations about the image. Secondary mouse button will show a context menu.
    </para>
    <para>
      Note: The pan view recursively visits each folder under the specified folder, so be careful it can eat a lot of ressources.
    </para>
    <para/><section id="Selectafolder"><title>
      Select a folder
    </title>
    <variablelist><varlistentry><term>
        Location
      </term><listitem><para>
        Set the top folder.
      </para></listitem></varlistentry></variablelist>
    <para/></section><section id="Chooseaviewmode"><title>
      Choose a view mode
    </title>
    <para>
      A select box let you choose among different view modes:
    </para>
    <variablelist><varlistentry><term>
        Timeline
      </term><listitem><para>
        Shows images grouped by date.
      </para></listitem></varlistentry><varlistentry><term>
        Calendar
      </term><listitem><para>
        Shows a calendar with the number of images indicated for each day (as dots and number). Left mouse button click will show images in a popup.
      </para></listitem></varlistentry><varlistentry><term>
        Folders
      </term><listitem><para>
        Show images grouped by folder. Each box represents a folder. Parent and children folders are shown as boxes enclosing other boxes.
      </para></listitem></varlistentry><varlistentry><term>
        Folders (flower)
      </term><listitem><para>
        Show images grouped by folder. Each box represents a folder. Parent folders are linked to children by a line. The top folder is the center of the flower.
      </para></listitem></varlistentry><varlistentry><term>
        Grid
      </term><listitem><para>
        All images are shown on a grid.
      </para></listitem></varlistentry></variablelist>
    <para/></section><section id="Howeachimageshouldberepresented"><title>
      How each image should be represented
    </title>
    <para>
      Another select box let you choose the representation of each image:
    </para>
    <variablelist><varlistentry><term>
        Dots
      </term><listitem><para>
        Each image is represented by a dot.
      </para></listitem></varlistentry><varlistentry><term>
        No images
      </term><listitem><para>
        Each image is represented by a square box.
      </para></listitem></varlistentry><varlistentry><term>
        Small thumbnails
      </term><listitem><para>
        Each image is represented by a small thumbnail.
      </para></listitem></varlistentry><varlistentry><term>
        Normal thumbnails
      </term><listitem><para>
        Each image is represented by a normal thumbnail.
      </para></listitem></varlistentry><varlistentry><term>
        Large thumbnails
      </term><listitem><para>
        Each image is represented by a large thumbnail.
      </para></listitem></varlistentry><varlistentry><term>
        1:10 (10%)
      </term><listitem><para>
        Each image is represented by reduced image (1/10 of the original's dimensions).
      </para></listitem></varlistentry><varlistentry><term>
        1:4 (25%)
      </term><listitem><para>
        Each image is represented by reduced image (1/4 of the original's dimensions).
      </para></listitem></varlistentry><varlistentry><term>
        1:3 (33%)
      </term><listitem><para>
        Each image is represented by reduced image (1/3 of the original's dimensions).
      </para></listitem></varlistentry><varlistentry><term>
        1:2 (50%)
      </term><listitem><para>
        Each image is represented by reduced image (1/2 of the original's dimensions).
      </para></listitem></varlistentry><varlistentry><term>
        1:1 (100%)
      </term><listitem><para>
        The original image is shown at its normal dimensions.
      </para></listitem></varlistentry></variablelist>
    <para/></section><section id="Find"><title>
      Find
    </title>
    <para>
      At the bottom of the window:
    </para>
    <variablelist><varlistentry><term>
        Find button
      </term><listitem><para>
        Shows a text field for image search. One can enter a filename or a part of it or a date (yyyy or yyyy-mm or yyyy-mm-dd format, separator can be '/','-',' ','.',','). Pressing Enter key will start the search, pressing it again will move to the next match. Matched file is made visible and details are shown for it.
      </para></listitem></varlistentry></variablelist>
  <para/></section></section>