[gthumb/ext] added help files
- From: Paolo Bacchilega <paobac src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [gthumb/ext] added help files
- Date: Sun, 2 Aug 2009 20:39:21 +0000 (UTC)
commit 59e3ffdc5614e9b501424760e560fe54322a3e72
Author: Paolo Bacchilega <paobac src gnome org>
Date: Sun Aug 2 22:38:37 2009 +0200
added help files
help/C/gthumb.xml | 4161 +++++++++++++++++++++++++++++++++++++++++++++++++++++
help/C/legal.xml | 76 +
2 files changed, 4237 insertions(+), 0 deletions(-)
---
diff --git a/help/C/gthumb.xml b/help/C/gthumb.xml
new file mode 100644
index 0000000..2643b0c
--- /dev/null
+++ b/help/C/gthumb.xml
@@ -0,0 +1,4161 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd";[
+ <!ENTITY legal SYSTEM "legal.xml">
+ <!ENTITY appversion "2.11.0">
+ <!ENTITY manualversion "2.11.0">
+ <!ENTITY date "October 2006">
+ <!ENTITY appname "gThumb">
+ <!ENTITY app "<application>gThumb</application>">
+<!-- replace version above with actual application version number -->
+<!-- Template Version: 1.0.1 (do not remove this line) -->
+]>
+
+<!-- =============Document Header ============================= -->
+
+<article id="index" lang="en"> <!-- please do not change the id -->
+
+ <articleinfo>
+ <title>&app; Manual V&manualversion;</title>
+ <copyright>
+ <year>2001</year>
+ <year>2002</year>
+ <year>2003</year>
+ <year>2004</year>
+ <year>2006</year>
+ <holder>Paolo Bacchilega</holder>
+ </copyright>
+
+ <!-- translators: uncomment this:
+
+ <copyright>
+ <year>2000</year>
+ <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+ </copyright>
+
+ -->
+
+ <!-- An address can be added to the publisher information. If a role is
+ not specified, the publisher/author is the same for all versions of the
+ document. -->
+ <publisher>
+ <publishername> GNOME Documentation Project </publishername>
+ </publisher>
+
+ &legal;
+
+ <authorgroup>
+ <author role="maintainer">
+ <firstname>Paolo</firstname>
+ <surname>Bacchilega</surname>
+ <affiliation>
+ <address> <email>paolo bacchilega libero it</email> </address>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Alexander</firstname>
+ <surname>Kirillov</surname>
+ <affiliation>
+ <orgname>GNOME Documentation Project</orgname>
+ <address> <email>kirillov math sunysb edu</email> </address>
+ </affiliation>
+ </author>
+ </authorgroup>
+ <!-- do not put authorname in the header except in copyright - use
+ section "authors" below -->
+ <revhistory>
+ <revision>
+ <revnumber>&manualversion;</revnumber>
+ <date>&date;</date>
+ <revdescription>
+ <para role="author">Paolo Bacchilega</para>
+ <para role="publisher">GNOME Documentation Project</para>
+ </revdescription>
+ </revision>
+ </revhistory>
+
+
+ <!-- this is version of manual, not application -->
+ <releaseinfo>
+ This is manual describes version &appversion; of &appname;
+ </releaseinfo>
+ <abstract role="description"><para>&app; is an image viewer and browser for the GNOME environment</para></abstract>
+ </articleinfo>
+
+ <indexterm>
+ <primary>&appname;</primary>
+ </indexterm>
+ <indexterm>
+ <primary>image viewer</primary>
+ </indexterm>
+ <indexterm>
+ <secondary>viewer</secondary>
+ </indexterm>
+
+ <!-- ============= Document Body ============================= -->
+
+ <!-- ============= Introduction ============================== -->
+
+ <sect1 id="intro">
+ <title>Introduction</title>
+ <para>
+ &app; is an image viewer and browser
+ written for the GNOME environment. It lets you browse your hard disk,
+ showing you thumbnails of image files and view single images
+ of many different formats.
+ </para>
+ <para>
+ The most common image formats are JPEG and GIF. The JPEG format
+ is good for medium and big sized images because it has a high
+ compression rate keeping a good image quality.
+ The GIF format is used in Web pages for displaying little
+ animations or little static images.
+ Another important image format is PNG, this format is very
+ common on Unix platforms and is considered
+ a replacement of the GIF format.
+ </para>
+ <para>
+ &app; supports all this formats and many others, it also displays
+ GIF animations.
+ </para>
+ <para>
+ &app; not only lets you view image files but has many other features
+ such as add comments to images, organize images
+ in catalogs, print images, view slideshows, set your desktop
+ background, and more.
+ </para>
+ </sect1>
+
+ <!-- ============= Getting Started ============================== -->
+ <sect1 id="gthumb-getting-started">
+ <title>Getting Started</title>
+ <para>
+ This section provides information on how to start &app;, and
+ describes the main window interface.
+ </para>
+ <sect2 id="get-start">
+ <title>To Start &app;</title>
+ <para>
+ You can start &app; in the following ways:</para>
+ <variablelist>
+ <varlistentry>
+ <term><guimenu>Applications</guimenu> menu</term>
+ <listitem>
+ <para>Choose
+ <menuchoice><guisubmenu>Graphics</guisubmenu><guimenuitem>gThumb</guimenuitem></menuchoice>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Command line</term>
+ <listitem>
+ <para>Type <command>gthumb</command>, then press
+ <keycap>Return</keycap>.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>If you start &app; from the command line you can specify
+ the following options:
+ </para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Command</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para><command>gthumb <replaceable>folder</replaceable></command></para></entry>
+ <entry align="left"><para>Start &app; in the
+ specified folder</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para><command>gthumb <replaceable>name.jpg</replaceable></command></para></entry>
+ <entry align="left"><para>View the image <filename>name.jpg</filename>.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para><command>gthumb <replaceable>*.jpg</replaceable></command></para></entry>
+ <entry align="left"><para>View all the images with a
+ <filename>.jpg</filename> extension.</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ </sect2>
+ <sect2 id="gthumb-main-window">
+ <title>When You Start &app;</title>
+ <para>
+ When you start &app; the following window is displayed:
+
+ <!-- ==== Figure ==== -->
+ <figure id="main-win-fig">
+ <title>The main window</title>
+ <screenshot>
+ <screeninfo>The main window</screeninfo>
+ <graphic format="PNG" fileref="figures/main-win.png" srccredit="Me"/>
+ </screenshot>
+ </figure>
+ <!-- ==== End of Figure ==== -->
+
+ The &app; <guilabel>window</guilabel> contains the following elements:
+ <variablelist>
+ <varlistentry> <term>Menubar</term>
+ <listitem>
+ <para>The menus on the menubar contain all of the commands
+ that you can use in &app;</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry> <term>Toolbar</term>
+ <listitem>
+ <para>The toolbar contains a subset of the commands that
+ you can access from the menubar. </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry> <term>Locationbar</term>
+ <listitem>
+ <para>The locationbar contains the current folder name. </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry> <term>Folder list</term>
+ <listitem>
+ <para>The folder list shows the
+ subfolders contained in the current folder.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry> <term>Image list</term>
+ <listitem>
+ <para>The image list which shows the images in the current folder.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry> <term>Statusbar</term>
+ <listitem>
+ <para>On the statusbar you can read:
+ <orderedlist>
+ <listitem>
+ <para>the total number of images contained in the
+ current folder and their total size.</para>
+ </listitem>
+ <listitem>
+ <para>the number of the selected images and their size.</para>
+ </listitem>
+ <listitem>
+ <para>some properties of the currently focused image.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Browsing Folders ============================== -->
+ <sect1 id="gthumb-browsing">
+ <title>Browsing Folders</title>
+ <para>
+ Browser options can be found in the <xref
+ linkend="preferences-browser"/> of the
+ <guilabel>Preferences</guilabel> dialog.
+ </para>
+ <para>
+ Keyboard shortcuts to browse folders are described in <xref
+ linkend="gthumb-TBL-keyword-shortcuts-browser"/>.
+ </para>
+ <sect2 id="gthumb-change-folder">
+ <title>To Change Folder</title>
+ <para>
+ If you want to change folder you have two ways:
+ <orderedlist>
+ <listitem>
+ <para>click on the folder name in the folder list.</para>
+ </listitem>
+ <listitem>
+ <para>type the folder name in the location entry.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>
+ When using the location entry you can press
+ <keycombo><keycap>TAB</keycap></keycombo> to
+ try to automatically complete the folder name, this simplify the
+ typing of long names. You can quickly give focus to the
+ location entry pressing
+ <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo>.
+ </para>
+ <para>
+ To go to a previously visited folder you can use the
+ toolbar <guilabel>Back</guilabel> button.
+ </para>
+ <para>
+ Other navigation commands are located in the
+ <menuchoice><guimenu>View</guimenu><guisubmenu>Go</guisubmenu></menuchoice>
+ menu.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-sort">
+ <title>To Sort Images</title>
+ <para>
+ To sort images in a different order use the <guimenuitem>Sort
+ images</guimenuitem> submenu in the <guimenu>View</guimenu>
+ menu, use <keycombo><keycap>Ctrl</keycap><keycap>R</keycap>
+ </keycombo> to reload the current folder, type
+ <keycombo><keycap>T</keycap></keycombo> to view or hide the
+ thumbnails in the images list.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-bookmarks">
+ <title>To Add a Folder to the Bookmarks</title>
+ <para>
+ Frequently used folders can be added to the bookmark list for rapid
+ access. Just go to the folder you want to add to the bookmarks and
+ press <keycombo action="simul"><keycap>Ctrl</keycap><keycap>D</keycap>
+ </keycombo> or use the command
+ <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Add
+ Bookmark</guimenuitem></menuchoice>.
+ To remove or rearrange bookmarks in a different order use the
+ <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit
+ Bookmarks</guimenuitem></menuchoice> command.
+ </para>
+ </sect2>
+ </sect1>
+ <sect1 id="gthumb-folders">
+ <title>Working with Folders</title>
+ <para>
+ &app; offers the functionalities to manage folders.
+ <note>
+ <title>WARNING</title>
+ <para>
+ It's highly suggested to move and copy image folders with
+ &app;. This is because if you move or copy folders with
+ &app; image comments will remain attached to images as
+ you expect, but if you move or copy folders with the file
+ manager or other applications you will lose your comments.
+ </para>
+ </note>
+ </para>
+ <sect2 id="gthumb-create-folder">
+ <title>To Create a Folder</title>
+ <para>To create a new folder, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder where the new folder will be created.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>New
+ Folder</guimenuitem></menuchoice> to display the <guilabel>New
+ Folder</guilabel> dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Enter the new folder name.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Create</guibutton>. &app; creates
+ a new folder.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-open-folder">
+ <title>To Open a Folder</title>
+ <para>To open a folder with the file manager, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder you want to open.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Open
+ with the File Manager</guimenuitem></menuchoice>. &app;
+ opens the folder with the file manager.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-rename-folder">
+ <title>To Rename a Folder</title>
+ <para>To rename a folder, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder you want to rename.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Rename</guimenuitem></menuchoice>
+ to display the <guilabel>Rename Folder</guilabel> dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Enter the new folder name.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Rename</guibutton>. &app; renames
+ the folder.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-move-to-trash-folder">
+ <title>To Delete a Folder</title>
+ <para>To delete a folder, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder you want to delete.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Move
+ to Trash</guimenuitem></menuchoice>. &app; moves the folder
+ to the system trash.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-copy-folder">
+ <title>To Copy a Folder</title>
+ <para>To copy a folder to a different location, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder you want to copy.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Copy</guimenuitem></menuchoice>
+ to display the <guilabel>Copy Folder</guilabel> dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>The <guilabel>Copy Folder</guilabel> dialog is used to
+ choose the destination folder. You can type the folder name in
+ the <guilabel>Folder</guilabel> entry, or click on
+ <guibutton>Browse</guibutton> to select a folder from your
+ disk. The <guilabel>Recents</guilabel> list contains the list
+ of recently specified destination folders, while the
+ <guilabel>Bookmarks</guilabel> list contains the folders you
+ have a bookmark for.
+ Click on a folder in these lists to insert the folder name in
+ the <guilabel>Folder</guilabel> entry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app; copies the
+ folder to the destination folder.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-move-folder">
+ <title>To Move a Folder</title>
+ <para>To move a folder to a different location, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder you want to move.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu><guimenuitem>Move</guimenuitem></menuchoice>
+ to display the <guilabel>Move Folder</guilabel> dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>The <guilabel>Move Folder</guilabel> dialog is used to
+ choose the destination folder. You can type the folder name in
+ the <guilabel>Folder</guilabel> entry, or click on
+ <guibutton>Browse</guibutton> to select a folder from your
+ disk. The <guilabel>Recents</guilabel> list contains the list
+ of recently specified destination folders, while the
+ <guilabel>Bookmarks</guilabel> list contains the folders you
+ have a bookmark for.
+ Click on a folder in these lists to insert the folder name in
+ the <guilabel>Folder</guilabel> entry.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app; moves the
+ folder to the destination folder.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Viewing ================================== -->
+ <sect1 id="gthumb-image-viewing">
+ <title>Viewing Images</title>
+ <para>
+ Keyboard shortcuts to view images are described in <xref
+ linkend="gthumb-TBL-keyword-shortcuts-viewer"/>.
+ </para>
+ <sect2 id="gthumb-view-images">
+ <title>To View an Image</title>
+ <para>
+ In order to view an image just click on its thumbnail and the image will
+ be visualized in the viewer pane. If the image doesn't fit the viewer
+ pane you can give more space to the viewer hiding the browser, this can
+ be accomplished double-clicking on the thumbnails or pressing the
+ <keycap>Return</keycap> key, pressing it
+ again the browser will be displayed again.
+ Another way of viewing a big image is to view it in full screen
+ mode, type <keycombo><keycap>F</keycap></keycombo> to
+ activate/disactivate the full screen mode.
+ </para>
+ <para>
+ Mouse operations :
+ </para>
+ <informaltable frame="topbot">
+ <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0"
+ colwidth="30.65*"/>
+ <colspec colname="COLSPEC1" colwidth="69.35*"/>
+ <tbody>
+ <row>
+ <entry>
+ <para>Holding down the left button and moving the mouse</para></entry>
+ <entry>
+ <para>move the image.</para></entry>
+ </row>
+ <row>
+ <entry>
+ <para>Left-click</para></entry>
+ <entry>
+ <para>Show next image.</para></entry>
+ </row>
+ <row>
+ <entry>
+ <para>Middle-click</para></entry>
+ <entry>
+ <para>Show previous image.</para></entry>
+ </row>
+ <row>
+ <entry>
+ <para>Right-click</para></entry>
+ <entry>
+ <para>Pop up the image menu.</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>
+ Another way of moving images is by the navigation button :
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/nav-button.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ located in the
+ right bottom corner of the viewer window when the images does not fit
+ in the window. Clicking and holding this
+ button will show you a preview of the image. Moving the mouse you will
+ move the image to the desired position.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-view-prop">
+ <title>To View the Image Properties</title>
+ <para>
+ To view the image properties, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Select the image.</para>
+ </listitem>
+ <listitem>
+ <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties
+ </guimenuitem></menuchoice>. &app; displays a
+ <guilabel>Properties</guilabel> dialog.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <!-- ============= EXIF ================================== -->
+ <sect2 id="gthumb-exif">
+ <title>To View the Image EXIF Data</title>
+ <para>
+ To view the exif data attached to an image, use the
+ <guilabel>Properties</guilabel> dialog (<xref
+ linkend="gthumb-view-prop"/>) or perform the following
+ steps:
+ <orderedlist>
+ <listitem><para>
+ Select the image.
+ </para></listitem>
+ <listitem><para>
+ View the image pressing <keycap>Return</keycap> or double
+ clicking on it.
+ </para></listitem>
+ <listitem><para>
+ Choose
+ <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
+ Comment</guimenuitem></menuchoice> or press
+ <keycap>I</keycap>. &app; displays the exif data.
+ </para></listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= working with images ================================== -->
+ <sect1 id="gthumb-image-working">
+ <title>Working with Images</title>
+ <sect2 id="gthumb-alter-images">
+ <title>To Modify an Image</title>
+ <para>
+ The current image can be modified in many ways. The commands
+ used to modify an image are located in the <guimenu>Image</guimenu>
+ menu.
+ </para>
+ <informaltable frame="topbot">
+ <tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0"
+ colwidth="30.65*"/>
+ <colspec colname="COLSPEC1" colwidth="69.35*"/>
+ <tbody>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Enhance</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Enhance the image adjusting the color levels.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Resize</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Change the image size performing a zoom in or out.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Crop</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Crop the image.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Transform</guisubmenu>
+ <guimenuitem>Rotate Right</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Rotate the image 90 degrees clockwise.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Transform</guisubmenu>
+ <guimenuitem>Rotate Left</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Rotate the image 90 degrees counter-clockwise.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Transform</guisubmenu>
+ <guimenuitem>Flip</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Create a mirror image by reflecting the image scanlines
+ in the vertical direction.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Transform</guisubmenu>
+ <guimenuitem>Mirror</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Create a mirror image by reflecting the image scanlines
+ in the horizontal direction (as in a mirror).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Desaturate</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ View the image in black and white.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Negative</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ View the image negative.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Color Balance</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Change the color balancement.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Hue-Saturation</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Change the image hue, lightness and saturation level.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Redeye Removal</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Remove red eyes caused by poor flashes.
+ See <xref linkend="gthumb-redeye"/> for more information.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Brightness-Contrast</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Change the image brightness and contrast.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guimenuitem>Posterize</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Reduce the number of colors.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Auto</guisubmenu>
+ <guimenuitem>Equalize Histogram</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Enhance the image equalizing its histogram.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Auto</guisubmenu>
+ <guimenuitem>Normalize</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Automatically normalize the contrast.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <menuchoice>
+ <guisubmenu>Auto</guisubmenu>
+ <guimenuitem>Stretch Contrast</guimenuitem>
+ </menuchoice>
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Automatically stretch the contrast.
+ </para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>When an image is modified the label "[modified]" is
+ displayed near the image filename.
+ <note>
+ <title>NOTE</title>
+ <para>
+ Please note that this modifications do not change the image file.
+ If you want to view the original image just click on its
+ thumbnail again or use the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Revert</guimenuitem>
+ </menuchoice> command.
+ </para>
+ </note>
+ </para>
+ <para>
+ You can save modified images, see <xref
+ linkend="gthumb-save-images"/> for more information.
+ </para>
+ <sect3 id="gthumb-redeye">
+ <title>Redeye Removal</title>
+ <para>
+ Many inexpensive cameras have a flash that is too close to the camera lens.
+ As a result, the light from the flash may travel from the camera and be partially
+ reflected by a subject's retina right back into the camera lens. This causes
+ "redeye".
+ </para>
+ <para>
+ &app; provides a tool to remove this unwanted redeye. When viewing an image
+ with redeye, select <menuchoice><guimenu>Image</guimenu><guimenuitem>Redeye
+ Removal</guimenuitem></menuchoice>. A new window will be launched. Move the mouse
+ pointer over top a redeye region, and click on or near it. This should remove the
+ red region, replacing it with a blacker region. If you are unhappy with the
+ result, simply click <guibutton>Undo</guibutton> to revert the previous change (or changes).
+ (Clicking <guibutton>Cancel</guibutton> will abandon all changes and close the window.)
+ Once you are satisfied with the result, you can click on more redeye regions, or
+ click <guibutton>Save</guibutton> or <guibutton>Done</guibutton> to close the window.
+ </para>
+ <para>
+ If you click <guibutton>Done</guibutton>, the image must be re-saved in the usual manner after using
+ <menuchoice><guimenu>Image</guimenu><guimenuitem>Redeye Removal</guimenuitem></menuchoice>.
+ See <xref linkend="gthumb-save-images"/> for more information.
+ </para>
+ <para>
+ <guibutton>Zoom In</guibutton>, <guibutton>Zoom Out</guibutton>, <guibutton>Actual Size</guibutton>,
+ and <guibutton>Zoom to Fit</guibutton> buttons are provided to allow you to zoom to and from
+ regions of interest. The mouse wheel can also be used to zoom in and out.
+ </para>
+ </sect3>
+ <sect3 id="gthumb-crop">
+ <title>Crop tool</title>
+ <para>
+ &app; provides a crop tool, which can be used to discard some parts of the image or to make it fit to
+ a particular aspect ratio.
+ </para>
+ <para>To use the tool, open the picture to be cropped. Then, select <menuchoice><guimenu>Image</guimenu>
+ <guimenuitem>Crop</guimenuitem></menuchoice>. A new window will be launched. You can select the area
+ you want to keep by dragging the mouse, or by typing values in the fields to the right of the picture.
+ Additionally, you can force your selection to keep a given aspect ratio using the <guimenu>Aspect ratio</guimenu> menu.
+ </para>
+ <para>
+ When you have selected the area to crop, press the <guibutton>Crop</guibutton> button to crop the image.
+ <guibutton>Undo</guibutton> button will cancel the last operation, while the <guibutton>Redo</guibutton> button
+ will revert it. Clicking on the <guibutton>Cancel</guibutton> button will abandon all your changes and close the
+ window. When you're happy with the result, click the <guibutton>Save</guibutton> to save your changes to the file
+ and close the window, or click the <guibutton>Done</guibutton> button to apply your changes to the image without
+ saving it (in which case the file can be saved later using
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>).
+ </para>
+ <para>
+ <guibutton>Zoom In</guibutton>, <guibutton>Zoom Out</guibutton>, <guibutton>Actual Size</guibutton>,
+ and <guibutton>Zoom to Fit</guibutton> buttons are provided to allow you to zoom to and from
+ regions of interest. The mouse wheel can also be used to zoom in and out. There is also a button to
+ show or hide the boundaries of the selected region.
+ </para>
+ </sect3>
+ </sect2>
+ <sect2 id="gthumb-save-images">
+ <title>To Save an Image</title>
+ <para>To save an image, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Display the image.</para>
+ </listitem>
+ <listitem>
+ <para>Modify the image (described in <xref
+ linkend="gthumb-alter-images"/>). Of course this step is
+ optional.</para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Save
+ As</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>Choose the filename and click on
+ <guibutton>Ok</guibutton>.</para>
+ </listitem>
+ <listitem>
+ <para>&app; displays the image format dialog from which
+ you can choose specific file format options. Once you are
+ ok with the options click on
+ <guibutton>Ok</guibutton>. &app; saves the image.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2 id="gthumb-image-open">
+ <title>To Open a Series of Images with Another Program</title>
+ <para>
+ To open a series of images with another program, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Open With</guimenuitem></menuchoice>
+ to display the <guilabel>Open</guilabel> dialog.</para>
+ </listitem>
+ <listitem>
+ <para>Select an application from the <guilabel>Available
+ applications</guilabel> list, or from the <guilabel>Recent
+ applications</guilabel> list; or type a command in the
+ <guilabel>Application</guilabel> entry.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Open</guibutton>. &app; opens the
+ images.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2 id="gthumb-rename-series">
+ <title>To Rename One or More Images</title>
+ <para>
+ To rename one or more images using a name template, choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Rename</guimenuitem></menuchoice>.
+ </para>
+ <para>
+ The name template is simply a pattern that is used for renaming all
+ of the selected images. You can use some special characters
+ to make the new names differ each other (this is essential if you
+ are renaming more than one image, and optional if you are renaming
+ a single image):
+ </para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Symbol</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry>
+ <para><keycap>#</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with
+ the value of a counter that increments itself by 1
+ passing from one image to another. If you specify
+ this symbols in sequence you'll get leading zeros if the
+ counter value has a lesser number of digits, for example ###
+ will produce the sequence: 001, 002, 003, etc..</para></entry>
+ </row>
+ <row valign="top">
+ <entry>
+ <para><keycap>%f</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with the image
+ original name, excluding the extension.</para></entry>
+ </row>
+ <row valign="top">
+ <entry>
+ <para><keycap>%e</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with the image
+ original filename extension.</para></entry>
+ </row>
+ <row valign="top">
+ <entry>
+ <para><keycap>%d</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with the image
+ modified date.</para></entry>
+ </row>
+ <row valign="top">
+ <entry>
+ <para><keycap>%s</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with the image
+ dimensions.</para></entry>
+ </row>
+ <row valign="top">
+ <entry>
+ <para><keycap>%n</keycap></para></entry>
+ <entry align="left">
+ <para>This symbol will be replaced with original image enumerator.
+ For instance, if the original filename was IMG_9876.JPG, this
+ extracts the "9876" portion. If the filename has more than
+ one group of digits embedded in it (for example, IMG_123_456.JPG)
+ only the first number will be used ("123" in this example).</para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>
+ The list at the bottom of the dialog displays how the filenames
+ will be renamed.
+ </para>
+ <para>
+ To rename the images click on <guibutton>Rename</guibutton>.
+ </para>
+ <para>
+ If the renaming of an image can overwrite an already existing
+ image you will be asked how to proceed, five options are
+ available: overwrite the image; do not overwrite the image;
+ always overwrite; never overwrite; specify a new name.
+ </para>
+ </sect2>
+
+ <sect2 id="gthumb-image-delete">
+ <title>To Delete a Series of Images</title>
+ <para>
+ To delete a series of images, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move to
+ Trash</guimenuitem></menuchoice>. &app; deletes the images
+ moving them to the system trash.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2 id="gthumb-image-copy">
+ <title>To Copy a Series of Images</title>
+ <para>
+ To copy a series of images, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>
+ to display the <guilabel>Choose the destination
+ folder</guilabel> dialog.</para>
+ </listitem>
+ <listitem>
+ <para>Select a folder from the <guilabel>Recents</guilabel>
+ list, or from the <guilabel>Bookmarks</guilabel> list; or type
+ a folder name in the
+ <guilabel>Folder</guilabel> entry.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app; copies the
+ images.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <sect2 id="gthumb-image-move">
+ <title>To Move a Series of Images</title>
+ <para>
+ To move a series of images, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move</guimenuitem></menuchoice>
+ to display the <guilabel>Choose the destination
+ folder</guilabel> dialog.</para>
+ </listitem>
+ <listitem>
+ <para>Select a folder from the <guilabel>Recents</guilabel>
+ list, or from the <guilabel>Bookmarks</guilabel> list; or type
+ a folder name in the
+ <guilabel>Folder</guilabel> entry.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app; moves the
+ images.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+
+ <!-- ============= Print ================================== -->
+ <sect2 id="gthumb-print-images">
+ <title>To Print a Series of Images</title>
+ <para>
+ To print a series of images, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose <menuchoice><guimenu>File</guimenu><guimenuitem>Print</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para> In the <guilabel>Print</guilabel> dialog there are two tags:
+ <guilabel>Layout</guilabel> and <guilabel>Paper Details</guilabel>.
+ </para>
+ <para> From the <guilabel>Layout</guilabel> tag you can
+ <itemizedlist>
+ <listitem>
+ <para>Choose the number of images per page.</para>
+ </listitem>
+ <listitem>
+ <para>Include the image comment.</para>
+ </listitem>
+ <listitem>
+ <para>Rotate an image by clicking on it.</para>
+ </listitem>
+ <listitem>
+ <para>Move an image by clicking on it with the left mouse
+ button and dragging it.</para>
+ </listitem>
+ <listitem>
+ <para>Resize the image.</para>
+ </listitem>
+ <listitem>
+ <para> Recenter the image on the page using the <guibutton>Center on
+ Page</guibutton> button.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para> From the <guilabel>Paper Details</guilabel> tag you can
+ <itemizedlist>
+ <listitem>
+ <para>Choose the paper format.</para>
+ </listitem>
+ <listitem>
+ <para>Choose the paper orientation.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>When you are ready to print click on
+ <guibutton>Print</guibutton>. &app; prints the
+ images.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Comments ================================== -->
+ <sect1 id="gthumb-comments">
+ <title>Comments</title>
+ <para>
+ Comments are pieces of information attached to images.
+ <note>
+ <title>WARNING</title>
+ <para>Comments are not embedded in image files, they are saved
+ separately. This means that if you move images or
+ folders with other programs you will lose the comments.
+ </para>
+ </note>
+ <note>
+ <title>FOR EXPERTS</title>
+ <para>The image comment is saved in a subfolder of the image
+ folder named <filename>.comments</filename>.
+ </para>
+ </note>
+ </para>
+ <sect2 id="gthumb-comment-add">
+ <title>To Add a Comment</title>
+ <para>
+ To add a comment to an image select the image and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit comment</guimenuitem>
+ </menuchoice> or type <keycombo><keycap>C</keycap></keycombo>.
+ </para>
+ <para>
+ Comments are structured in various parts :
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Comment</guilabel>: a free text describing the picture.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Place</guilabel>: the place the picture represents.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Date</guilabel>: the date the picture was taken.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Image comments are displayed in the image list in italic text above the
+ image filename. If the comment is too long the simbol "[..]" is
+ appended to the displayed part of the comment to signal you that
+ the comment is not entirely visible, to view the whole comment use
+ the image properties dialog that can be displayed using the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Properties
+ </guimenuitem></menuchoice> command or pressing
+ <keycombo><keycap>I</keycap></keycombo>.
+ </para>
+ <!-- ==== Figure ==== -->
+ <figure id="comment-in-list-fig">
+ <title>An image comment</title>
+ <screenshot>
+ <screeninfo>An image comment</screeninfo>
+ <graphic format="PNG" fileref="figures/comment.png" srccredit="Me"/>
+ </screenshot>
+ </figure>
+ <!-- ==== End of Figure ==== -->
+
+ <sect3 id="gthumb-comment-add-multi">
+ <title>To Add a Comment to Many Images</title>
+ <para>
+ To add a comment to many images, select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Edit
+ comment</guimenuitem> </menuchoice> or type
+ <keycombo><keycap>C</keycap></keycombo>.
+ </para>
+ <para>
+ The <guilabel>Comment</guilabel> dialog will fill in the fields
+ that have the same value for all the images leaving all other
+ fields empty.
+ </para>
+ <para>
+ You can activate the <guilabel>Save only changed fields
+ </guilabel> option (which is active by default) to change one or more
+ fields of many comments leaving all other fields unchanged.
+ </para>
+ </sect3>
+ </sect2>
+ <sect2 id="gthumb-comment-delete">
+ <title>To Remove Comments</title>
+ <para>
+ To remove comments, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog where the images are.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Remove
+ comment</guimenuitem></menuchoice>. &app; removes the
+ comments.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-comment-view">
+ <title>To View an Image Comment</title>
+ <para>
+ To view an image comment, use the
+ <guilabel>Properties</guilabel> dialog (<xref
+ linkend="gthumb-view-prop"/>) or perform the following
+ steps:
+ <orderedlist>
+ <listitem><para>
+ Select the image.
+ </para></listitem>
+ <listitem><para>
+ View the image pressing <keycap>Return</keycap> or double
+ clicking on it.
+ </para></listitem>
+ <listitem><para>
+ Press <keycap>I</keycap> or choose
+ <menuchoice><guimenu>View</guimenu><guisubmenu>View/Hide</guisubmenu><guimenuitem>Image
+ Comment</guimenuitem></menuchoice>.
+ &app; displays the image comment.
+ </para></listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Tags ================================== -->
+ <sect1 id="gthumb-tags">
+ <title>Tags</title>
+ <para>
+ Tags are keywords assigned to images and can be used to perform fine
+ grained searches as described in <xref linkend="gthumb-finding"/>.
+ <note>
+ <title>WARNING</title>
+ <para>Tags are not embedded in image files, they are instead saved
+ separately. This means that if you move images or
+ folders with other programs you will lose your comments.
+ </para>
+ </note>
+ <note>
+ <title>FOR EXPERTS</title>
+ <para>Tags are saved in the subfolder
+ <filename>.comments</filename> of the image folder and in the same file
+ where the image comment is saved.
+ </para>
+ </note>
+ </para>
+ <sect2 id="gthumb-tags-add">
+ <title>To Assign Tags to a Series of Images</title>
+ <para>
+ To add tags to a series of images, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Select the images and choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Tags
+ </guimenuitem></menuchoice>. &app; shows the
+ <guilabel>Tags</guilabel> dialog.</para>
+ </listitem>
+ <listitem>
+ <para>Check the tags in the <guilabel>Available Tags
+ </guilabel> List. You can create new tags clicking on the
+ <guilabel>New</guilabel> button, and delete tags from the
+ list clicking on the <guilabel>Remove</guilabel> button. </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Save</guibutton>. &app; assigns
+ the catories to the images.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-tags-add-to-folder">
+ <title>To Assign Tags to a Folder</title>
+ <para>
+ Instead of assigning tags to single images you can assign them
+ to a folder, this is equivalent to assign the tags to all the images
+ contained in the folder and in all of its subfolders.
+ </para>
+ <para>
+ To add tags to a folder, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Go to the parent folder in order to visualize the folder name
+ in the folder list pane, right-click on the folder name and
+ select the <menuchoice><guimenuitem>Tags</guimenuitem>
+ </menuchoice> command; alternatively go to the folder and select
+ the <menuchoice><guimenu>File</guimenu><guisubmenu>Folder</guisubmenu>
+ <guimenuitem>Tags</guimenuitem></menuchoice> commands. In both
+ cases &app; shows the <guilabel>Tags</guilabel> dialog.</para>
+ </listitem>
+ <listitem>
+ <para>Check the tags in the <guilabel>Available Tags
+ </guilabel> List. You can create new tags clicking on the
+ <guilabel>New</guilabel> button, and delete tags from the
+ list clicking on the <guilabel>Remove</guilabel> button. </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app; assigns
+ the catories to the folder.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-tags-remove">
+ <title>To Remove Tags from an Image or a Folder</title>
+ <para>
+ To remove tags from a series of images or a folder perform the
+ same steps as described above and uncheck the tags you want
+ to remove. Finally click on <guibutton>Ok</guibutton> to confirm the
+ operation.
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Catalogs ================================== -->
+ <sect1 id="catalogs">
+ <title>Catalogs</title>
+ <para>
+ Catalogs lets you organize images without moving them from a folder to
+ another, think of them as "playlists" for images.
+ </para>
+ <para>
+ Catalogs can be organized in libraries. A library is like a folder
+ that can contain catalogs and other libraries.
+ </para>
+ <para>
+ <note>
+ <title>WARNING</title>
+ <para>
+ Catalogs are not updated when you move images, if you want a more flexible
+ catalog you can use the searches described in <xref linkend="gthumb-find"/>,
+ searches are catalogs with search criteria attached, after moving
+ images you can redo the search to get the catalog updated.
+ </para>
+ </note>
+ <note>
+ <title>FOR EXPERTS</title>
+ <para>
+ Catalogs are saved in the
+ <filename>$(HOME)/.gnome2/gthumb/collections</filename> folder.
+ </para>
+ </note>
+ </para>
+ <sect2 id="gthumb-catalog-view">
+ <title>To View the List of Catalogs</title>
+ <para> To view the list of catalogs, perform the
+ following step:
+ <orderedlist>
+ <listitem>
+ <para>Press
+ <keycombo><keycap>Alt</keycap><keycap>2</keycap></keycombo> or
+ choose
+ <menuchoice><guimenu>View</guimenu><guimenuitem>Catalogs</guimenuitem></menuchoice>.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-catalog-view-content">
+ <title>To View a Catalog</title>
+ <para> To view the content of a catalog, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Set the catalogs view (described in <xref
+ linkend="gthumb-catalog-view"/>). </para>
+ </listitem>
+ <listitem>
+ <para>Select the catalog clicking on the catalog name.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>
+ If you want to go to the image folder,
+ select the image and use the
+ <menuchoice><guimenu>View</guimenu><guisubmenu>Go</guisubmenu><guimenuitem>Go
+ to the image folder </guimenuitem></menuchoice> command or
+ press <keycombo
+ action="simul"><keycap>Alt</keycap><keycap>End</keycap></keycombo>.
+ &app; will display the image folder and will scroll the image list in
+ order to make the image visible.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-catalog-add">
+ <title>To Add Images to a Catalog</title>
+ <para>
+ To add a series of images to a catalog, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Select the images you want to add to the catalog and
+ choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>
+ Add to Catalog</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>Select an existing catalog or create a new one.</para>
+ </listitem>
+ <listitem>
+ <para>Choose <guibutton>Ok</guibutton>. &app; adds the
+ selected images to the catalog.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-catalog-delete">
+ <title>To Remove Images from a Catalog</title>
+ <para> To remove images from a catalog, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Set the catalogs view (described in <xref
+ linkend="gthumb-catalog-view"/>). </para>
+ </listitem>
+ <listitem>
+ <para>Select the catalog.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images you want to delete
+ and choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>
+ Remove from Catalog</guimenuitem></menuchoice>. &app;
+ removes the images from the catalog.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-catalog-create">
+ <title>To Create a Catalog</title>
+ <para> To create a catalog, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Set the catalogs view (described in <xref
+ linkend="gthumb-catalog-view"/>). </para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>New
+ Catalog</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>Enter the catalog name and click on
+ <guibutton>Ok</guibutton>. &app; creates the catalog.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-catalog-rename">
+ <title>To Rename, Remove or Move a Catalog</title>
+ <para> To rename, remove or move a catalog, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Set the catalogs view (described in <xref
+ linkend="gthumb-catalog-view"/>). </para>
+ </listitem>
+ <listitem>
+ <para>Select the catalog.</para>
+ </listitem>
+ <listitem>
+ <para>Choose the corresponding command in the
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Catalog</guisubmenu></menuchoice>
+ menu, or use the context menu that can be displayed pressing
+ the right mouse button on the name of the catalog in the
+ catalog list.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-library-create">
+ <title>To Create a Library of Catalogs</title>
+ <para> To create a library of catalogs, perform the
+ following steps:
+ <orderedlist>
+ <listitem>
+ <para>Set the catalogs view (described in <xref
+ linkend="gthumb-catalog-view"/>). </para>
+ </listitem>
+ <listitem>
+ <para>Choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>New
+ Library</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>Enter the library name and click on
+ <guibutton>Ok</guibutton>. &app; creates the library.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Find ================================== -->
+
+ <sect1 id="gthumb-finding">
+ <title>Finding Images</title>
+ <sect2 id="gthumb-find">
+ <title>To Find Images</title>
+ <para>To find images on your hard disk choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem></menuchoice>.
+ &app; displays the <guilabel>Find</guilabel> dialog.</para>
+ <sect3 id="gthumb-simple-search">
+ <title>To Do a Simple Search</title>
+ <para>
+ From the <guilabel>Find</guilabel> dialog
+ you can specify a file name or a pattern in the <guilabel>File name
+ </guilabel> entry.
+ </para>
+ <para>
+ Examples:
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Value</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>
+ <userinput>foo.jpg</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images named <filename>foo.jpg</filename>
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>*.png</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images with the
+ <filename>png</filename> extension.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>*.gif; *.jpg</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images with the
+ <filename>gif</filename> or <filename>jpg</filename>
+ extension.
+ </para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Click on <guibutton>Search</guibutton> to start the search.
+ Once the search has finished you will see the list of images
+ that matches your search, if you want to see these images
+ click on <guibutton>View</guibutton>, if you want to make another
+ search click on <guibutton>New Search</guibutton>.
+ </para>
+ <para>
+ If you choose to view the images, a catalog named <guilabel>Search
+ Results</guilabel> will be created and visualized automatically.
+ A catalog created in this way has a special icon, a magnifier, this
+ is
+ because on this type of catalogs you can perform two more operations:
+ <guibutton>Edit Search</guibutton> and <guibutton>Redo Search
+ </guibutton>.
+
+ These operations can be selected from the
+ <menuchoice><guimenu>File</guimenu><guisubmenu>Catalog</guisubmenu></menuchoice>
+ menu, or from the menu that pops up when pressing the right
+ mouse button on the catalog name.
+ </para>
+ <para>
+ The <guilabel>Edit Search</guilabel> command lets you re-edit
+ the search rules, while <guilabel>Redo Search</guilabel> lets
+ you restart the search, at the end of the search you can
+ decide whether to save the result in the catalog or not.
+ </para>
+ </sect3>
+
+ <sect3 id="gthumb-other-search-opt">
+ <title>Other Search Options</title>
+ <variablelist>
+ <varlistentry>
+ <term><guilabel>Start at</guilabel></term>
+ <listitem>
+ <para>The folder where the search will start from.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Include subfolder</guilabel></term>
+ <listitem>
+ <para>
+ Whether to search even in the sub folders.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Comment</guilabel></term>
+ <listitem>
+ <para>
+ A list of phrases the comment of the image must contain.
+ </para>
+ <para>
+ Examples:
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Value</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>
+ <userinput>paolo</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "paolo" in the comment.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>my birthday</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "my birthday" in the comment.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>holiday ; rome</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "holiday" OR
+ "rome" in the comment.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>holiday in rome; my birthday</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "holiday in rome"
+ OR "my birthday" in the comment.
+ </para></entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><guilabel>Place</guilabel></term>
+ <listitem>
+ <para>
+ A list of phrases the place field of the comment must
+ contain.
+ </para>
+ <para>
+ Examples:
+ </para>
+
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Value</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>
+ <userinput>rome</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "rome" in the
+ place field.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>paris; rome; london</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images that have "paris" OR
+ "rome" OR "london" in the place field.
+ </para></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </listitem>
+
+ </varlistentry>
+ <varlistentry>
+ <!-- -->
+ <term><guilabel>Date</guilabel></term>
+ <listitem>
+ <para>
+ The criteria the date field of the comment must respect:
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>any</guilabel>: the date field is ignored.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <guilabel>before, equal to, after</guilabel>: the date must be less recent, equal to, or more recent than the date specified.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <!-- -->
+ <term><guilabel>Tags</guilabel></term>
+ <listitem>
+ <para>
+ The list of tags an images must belong to.
+ Tags can be added to images using the
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Tags</guimenuitem></menuchoice>
+ command or pressing
+ <keycombo><keycap>K</keycap></keycombo>.
+ </para>
+ <para>
+ You can choose to search for images that belongs to all
+ the specified tags or at least to one of them,
+ checking the corresponding option.
+ </para>
+ <para>
+ Examples:
+ </para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50.00*"/>
+ <colspec colname="COLSPEC1" colwidth="50.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Value</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>
+ <userinput>family</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images with "family" as one of their keywords.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>
+ <userinput>me; family</userinput>
+ </para></entry>
+ <entry align="left"><para>
+ &app; searches for images with "family" and/or "me"
+ in the keywords list.
+ </para></entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ <note>
+ <title>NOTE</title>
+ <para>
+ If you use more than one criteria images must respect
+ all of them.
+ </para>
+ </note>
+ <note>
+ <title>NOTE</title>
+ <para>
+ The search is always case insensitive.
+ </para>
+ </note>
+ </para>
+ </sect3>
+
+ </sect2>
+ <sect2 id="gthumb-find-dup">
+ <title>To Find Duplicated Images</title>
+ <para>
+ To find duplicated images, choose
+ <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find
+ Duplicates</guimenuitem></menuchoice>.
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Slideshow ================================== -->
+
+ <sect1 id="slideshow">
+ <title>Slide Shows</title>
+ <para>
+ You can start a slide show of the images in the current folder by
+ pressing <keycombo action="simul"><keycap>s</keycap></keycombo> or
+ selecting the <menuchoice><guimenu>View
+ </guimenu><guimenuitem>Slide Show</guimenuitem></menuchoice> menu item.
+ To stop the slide show press <keycombo action="simul">
+ <keycap>S</keycap></keycombo> again.
+ </para>
+ <para>
+ If the current selection contains two or more images the slide show will
+ be done only with the selected images, otherwise all of the images in
+ the current folder or catalog will be showed.
+ </para>
+ <para>
+ Switching on/off the full screen mode does not stop the
+ slide show. If the <guilabel>Switch to full screen</guilabel> option
+ is on then the slide show is started in
+ fullscreen mode and exiting from the fullscreen mode will stop the
+ slide show.
+ </para>
+ <para>
+ The slide show is interrupted when you change folder or re-load the
+ current one.
+ </para>
+ <para>
+ With the slideshow tool and the fullscreen mode you can do
+ presentations. There are two types of presentations: automatic
+ presentations and manual presentations.
+ </para>
+ <sect2 id="gthumb-auto-presentation">
+ <title>How To Do an Automatic Presentation</title>
+ <para>To do an automatic presentation, perform the following
+ steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog containing the images you
+ want to present.</para>
+ </listitem>
+ <listitem>
+ <para>Select the images you want to view in the slideshow, or select
+ none to view all the images in the current folder or catalog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Press <keycombo action="simul">
+ <keycap>S</keycap></keycombo> or choose
+ <menuchoice><guimenu>View</guimenu><guimenuitem>Slide Show
+ </guimenuitem></menuchoice>. &app; starts an automatic
+ presentation of the images.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ To stop the presentation press <keycombo action="simul">
+ <keycap>S</keycap></keycombo> or <keycombo action="simul">
+ <keycap>Q</keycap></keycombo> or <keycombo action="simul">
+ <keycap>Esc</keycap></keycombo>.
+ </para>
+ <para>
+ The slide show behaviour can be personalized from the
+ <guilabel>Preferences</guilabel> dialog in the <xref
+ linkend="preferences-slideshow"/>
+ </para>
+ </sect2>
+ <sect2 id="gthumb-manual-presentation">
+ <title>How To Do a Manual Presentation</title>
+ <para>To do a manual presentation, perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Go to the folder or catalog containing the images you
+ want to present.</para>
+ </listitem>
+ <listitem>
+ <para>Select the image from which you want to start the presentation.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Press <keycombo action="simul">
+ <keycap>F</keycap></keycombo>. &app; displays the image
+ in fullscreen mode.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Press <keycombo action="simul">
+ <keycap>Space</keycap></keycombo> or <keycombo action="simul">
+ <keycap>N</keycap></keycombo>. &app; displays the next image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Press <keycombo action="simul">
+ <keycap>BackSpace</keycap></keycombo> or <keycombo action="simul">
+ <keycap>B</keycap></keycombo>. &app; displays the previous image.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ To stop the presentation press <keycombo action="simul">
+ <keycap>Q</keycap></keycombo> or <keycombo action="simul">
+ <keycap>Esc</keycap></keycombo>.
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Tools ================================== -->
+ <sect1 id="gthumb-tools">
+ <title>Advanced Tools</title>
+
+ <sect2 id="gthumb-wallpaper">
+ <title>To Set the Desktop Wallpaper</title>
+ <para>
+ If you want to set an image as desktop wallpaper, select the
+ image and choose the
+ menu <menuchoice><guimenu>Tools</guimenu><guisubmenu>Set Image
+ as Wallpaper</guisubmenu></menuchoice>. This menu contains
+ the following items:
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Centered</guilabel>: The image will be centered on
+ the screen.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Tiled</guilabel>: The image will be duplicated on
+ the screen as tiles on the floor.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Scaled</guilabel>: The image will be scaled to fill
+ the screen mantaining the aspect ratio.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Stretched</guilabel>: The image will be scaled to
+ fill the screen changing proportions if needed.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ If you want to restore the old wallpaper choose
+ <menuchoice>
+ <guimenu>Tools</guimenu>
+ <guisubmenu>Set Image as Wallpaper</guisubmenu>
+ <guimenuitem>Restore</guimenuitem>
+ </menuchoice>.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-rotate-jpeg">
+ <title>To Rotate Images Without Loss of Quality</title>
+ <para>
+ Usually if you want to rotate an image you have to open the image with
+ an editor, rotate the image, and then save it. This works well for
+ image formats such as PNG or GIF, but results in a loss of
+ quality for JPEG images. (The rotation functions in
+ <menuchoice><guimenu>Image</guimenu><guimenuitem>Transform</guimenuitem>
+ </menuchoice> operate this way - with loss.)
+ </para>
+ <para>
+ If you want to rotate JPEG images without losing image quality,
+ select the images you want to rotate and choose
+ <menuchoice><guimenu>Tools</guimenu><guimenuitem>Rotate
+ Images</guimenuitem></menuchoice>. &app; displays the
+ <guilabel>Rotate Images</guilabel> dialog.
+ </para>
+ <para>
+ Click on <guibutton>Apply</guibutton> to apply the changes.
+ The files are automatically saved after clicking <guibutton>Apply</guibutton>.
+ </para>
+ <para>
+ If you check the <guilabel>Apply to all images</guilabel>
+ option, the rotation is applied to the
+ currently displayed image as well as to all the remaining
+ images you have selected;
+ otherwise, once the rotation has been performed on the current
+ image, the next image in the selection is displayed, and you can
+ choose another type of rotation.
+ <note>
+ <title>NOTE</title>
+ <para>
+ If the selection contains some non-JPEG images, they are
+ rotated as well. (Not all file formats are supported, however.)
+ </para>
+ </note>
+ </para>
+ <para>
+ In general, there are two ways to rotate a JPEG image. The first way
+ is to re-arrange the pixels inside the image file, using a "physical"
+ transform. The second way is to leave the image data alone, and simply
+ change the value of the Exif orientation tag inside the header of the JPEG file.
+ Not all JPEG files have Exif tags however, and not all applications
+ support them. If your image does not have Exif tags, the pixels will
+ be re-arranged inside the image file automatically, since that is the only
+ possible method.
+ </para>
+ <para>
+ If your image has an Exif orientation tag, and the <guilabel>Apply physical transform</guilabel>
+ checkbox is enabled, the physical transform will be used to re-arrange the image
+ data, and the Exif orientation tag will be reset to its default value
+ of "top left".
+ </para>
+ <para>
+ If your image has an Exif orientation tag, and the <guilabel>Apply physical transform</guilabel>
+ checkbox is not enabled, then only the orientation tag will be changed. The
+ raw image data itself will not be transformed.
+ <note>
+ <title>NOTE</title>
+ <para>
+ For maximum compatibility with other applications, it is recommended that
+ the <guilabel>Apply physical transform</guilabel> checkbox normally be enabled
+ in both the rotation and import dialogs.
+ </para>
+ </note>
+ </para>
+ <para>The physical transform of pixel data inside the JPEG file will not
+ degrade image quality (that is, it is lossless) under most conditions.
+ However, if the image dimensions (height and width) are not both multiples
+ of 8, some data corruption will occur along one or two of the edges of the
+ image. If there is an Exif orientation tag, you can avoid this problem
+ by disabling the <guilabel>Apply physical transform</guilabel> checkbox.
+ If you must use the physical transform approach with
+ images whose dimensions are not multiples of 8, &app; will allow you to
+ proceed despite possible image distortion, but it will also ask if you
+ would like to trim the image slightly (by up to 7 columns and/or rows
+ of pixels) to remove the problem areas.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-reset-exif">
+ <title>Resetting the Exif Orientation Tag</title>
+ <para>
+ The previous section describes how JPEG images can be rotated using two
+ methods (physical transforms or Exif orientation tag changes). &app; supports
+ both methods properly as of version 2.9.0. Some previous versions
+ of &app; auto-rotated images improperly when importing, by performing
+ a physical transformation without resetting the Exif orientation tag
+ to "top-left". These previous versions ignored the orientation tag when
+ displaying the images, so no problem was apparent (although the problem
+ was visible if other image viewers were used to view the same images).
+ Versions 2.9.0 and later respect this tag, so the incorrect rotation will be visible.
+ </para>
+ <para>
+ The <guilabel>Reset Exif orientation tag</guilabel> tool is provided to fix
+ this problem. Simply select the affected images, and apply the
+ <guilabel>Reset Exif orientation tag</guilabel> tool. This will reset
+ the Exif orientation tag to "top-left".
+ </para>
+ </sect2>
+ <sect2 id="gthumb-convert-format">
+ <title>To Convert the Image Format</title>
+ <para>
+ To convert the image format,
+ select the images you want to convert and choose
+ <menuchoice><guimenu>Tools</guimenu><guimenuitem>Convert
+ Format</guimenuitem></menuchoice>.
+ </para>
+ <para>
+ The <guilabel>Convert Format</guilabel> dialog offers you the
+ following options:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Image type</guilabel>: this is the format you want to
+ convert images into.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Overwrite mode</guilabel>: a converted image has the
+ same name of the original image except for the extension which is
+ determined by the new format, so an image with the new name
+ can already exist in the destination folder. This option lets you
+ decide what to do when such a case occurs. If you choose
+ <guilabel>skip</guilabel> the new image won't be created;
+ <guilabel>rename</guilabel> will ask you to specify a new name;
+ <guilabel>ask</guilabel> will ask you whether to overwrite the
+ old image or not and <guilabel>overwrite</guilabel> will
+ overwrite the old image without asking.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Remove original</guilabel>: lets you remove the
+ original image. If an image is not converted because of an
+ error it will not be removed.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ To perform the conversion click on <guibutton>Convert</guibutton>.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-scale-series">
+ <title>To Scale a Series of Images</title>
+ <para>
+ To scale multiple images downwards in size,
+ select the images you want to scale and choose
+ <menuchoice><guimenu>Tools</guimenu><guimenuitem>Scale
+ Images</guimenuitem></menuchoice>.
+ </para>
+ <para>
+ The <guilabel>Scale Images</guilabel> dialog offers you the
+ following options:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Width</guilabel>: The desired maximum width of the scaled
+ images.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Height</guilabel>: The desired maximum height of the scaled
+ images.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Keep aspect ratio</guilabel>: If this checkbox is not
+ enabled, the image may be stretched by different factors in the
+ horizontal and vertical directions, in order to achieve both
+ the specified width and height. This may result in a distorted
+ image. If this checkbox is enabled, the image will be scaled
+ by the same factor in both directions. The scaling factor will
+ be calculated such that the output width and height are both
+ equal to or less than the values specified in the <guilabel>Width</guilabel>
+ and <guilabel>Height</guilabel> boxes, respectively.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Image type</guilabel>: this is the format you want to
+ save the scaled images as.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Overwrite mode</guilabel>: a scaled image has the
+ same name of the original image except for the extension which is
+ determined by the new format, so an image with the new name
+ can already exist in the destination folder. This option lets you
+ decide what to do when such a case occurs. If you choose
+ <guilabel>skip</guilabel> the new image won't be created;
+ <guilabel>rename</guilabel> will ask you to specify a new name;
+ <guilabel>ask</guilabel> will ask you whether to overwrite the
+ old image or not and <guilabel>overwrite</guilabel> will
+ overwrite the old image without asking.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Remove original</guilabel>: lets you remove the
+ original image. If an image is not converted because of an
+ error it will not be removed.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ To perform the scaling click on <guibutton>Scale</guibutton>.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-change-date">
+ <title>To Change Images Date</title>
+ <para>
+ If you want to change the last modified date of a series of
+ images, select the images and choose <menuchoice><guimenu>
+ Tools</guimenu><guimenuitem>Change Date</guimenuitem></menuchoice>.
+ </para>
+ <para>
+ Select the new date.
+ </para>
+ <para>
+ Click on <guibutton>Ok</guibutton>. &app; changes the date.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-index-image">
+ <title>To Create an Index Image</title>
+ <para>
+ An index image is an image that contains small previews of a series of
+ images. If you want to create an index image select the images you
+ want to insert and choose
+ <menuchoice><guimenu>Tools</guimenu><guimenuitem>Create Index
+ Image</guimenuitem></menuchoice>.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-web-album">
+ <title>To Create a Web Album</title>
+ <para>
+ To create a web album, view a folder or a catalog and select the images
+ that you want to include in your album. (The usual selection methods apply -
+ you can click to select one image, shift+click or shift+arrow to expand
+ the selection continuously, ctrl+click to add images one at time, ctrl+A
+ to select everything.) Then use the <menuchoice><guimenu>Tools</guimenu>
+ <guimenuitem>Create Web Album</guimenuitem></menuchoice> function.
+ </para>
+ <para>
+ The web album will be generated in the <guilabel>Destination</guilabel>
+ folder. The starting page of the album (index.html) will be stored in this
+ folder. If the <guilabel>Use subfolders to organize files</guilabel>
+ checkbox is enabled, all other album files (such as images, thumbnails,
+ and html pages) will be stored in subfolders of the the Destination
+ folder. If it is not enabled, all files will be stored in the Destination
+ folder, and no subfolders will be created.
+ </para>
+ <note>
+ <title>Old Custom Themes</title>
+ <para>
+ The <guilabel>Use subfolders to organize files</guilabel> option
+ was added in &app; version 2.11.0. If you created a custom theme for
+ use with an earlier version of &app; and wish to continue using it
+ without modification, make sure that
+ <guilabel>Use subfolders to organize files</guilabel> is disabled.
+ Otherwise, modifications will be required to the custom theme.
+ </para>
+ </note>
+ <para>
+ All web albums will consist of one or more "index pages" (which show
+ a series of small thumbnail images) and one or more "image pages"
+ (which show a single image at a time). If the <guilabel>Copy originals
+ to destination</guilabel> checkbox is enabled, the photo shown in the
+ image pages will link to a copy of the original image. If you
+ click this link, the raw image will be loaded in your browser (with
+ no accompanying HTML).
+ </para>
+ <para>
+ If desired, images can be scaled down if they exceed a certain size
+ defined in the <guilabel>Resize if larger than</guilabel> box.
+ </para>
+ <para>
+ The number of thumbnail images shown on each index page of the web
+ album is controlled by the <guilabel>Size</guilabel> row and column
+ boxes. Alternatively, all images can be forced onto a single index
+ page by enabling the <guilabel>use a single index page</guilabel>
+ checkbox.
+ </para>
+ <para>
+ Most themes will respect the row and column settings that you specify,
+ because they are based on HTML tables. However other themes (the BestFit
+ theme for example) use Cascading Style Sheets that automatically space
+ the images to make the best possible use of space. (If you resize the
+ browser window, the images will re-position themselves!) These themes
+ will not respect the row and column settings, but they will keep the
+ total number of images per index page to a maximum of ROW x COLUMNS
+ (unless the <guilabel>use a single index page</guilabel> checkbox is
+ enabled).
+ </para>
+ <para>
+ A <guilabel>Header</guilabel> and <guilabel>Footer</guilabel> may be
+ defined. These labels will appear at the top and bottom of every page
+ in the album. HTML markup may be used in headers and footers, as long
+ every '>', '<', and '&' character is preceeded by a
+ backslash. For example, "<hr/>" must be written as
+ "\<hr/\>". Also, the sequence "%d" will be replaced by the
+ current date. To make a literal backslash ('\') or percent symbol
+ ('%') appear in the output, it must be entered as "\\" or "%%" in the
+ header or footer fields.
+ </para>
+ <para>
+ A <guilabel>Theme</guilabel> must be specified. The <guilabel>Theme</guilabel>
+ controls the overall appearance of your web album. To select a
+ <guilabel>Theme</guilabel>, press the <guibutton>...</guibutton> button
+ and select one from the list. The <guilabel>Thumbnail Caption</guilabel>
+ and <guilabel>Image Caption</guilabel> dialogs allow you to specify
+ what textual information (photo date, image size, camera model, etc)
+ will be displayed next to each image in the index and image pages,
+ respectively.
+ </para>
+ </sect2>
+ <sect2 id="gthumb-import-photos">
+ <title>To Import Photos from a Digital Camera</title>
+ <para>
+ To import photos from a digital camera, choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
+ </guimenuitem></menuchoice>.
+ </para>
+ <para>
+ Several options are presented in the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
+ </guimenuitem></menuchoice> dialog.
+ </para>
+ <para>
+ The destination folder can be selected through the
+ <guilabel>Destination folder</guilabel> box. The photos
+ can be imported directly into this folder, or into subfolders
+ of this main destination folder, depending on the setting of
+ the <guilabel>Group into subfolders</guilabel> box.
+ </para>
+ <para>
+ If the <guilabel>Group into subfolders</guilabel> box is set to
+ <guilabel>No grouping</guilabel>, no subfolders will be used. All photos
+ will go into the <guilabel>Destination folder</guilabel> directly.
+ </para>
+ <para>
+ If the <guilabel>Group into subfolders</guilabel> box is set to
+ <guilabel>By day photo taken</guilabel>, each photo will be examined to
+ determine what date it was taken, and a subfolder will be created for
+ every day that a photo was taken. The photos will be placed automatically
+ in the correct subfolder.
+ </para>
+ <para>
+ If the <guilabel>Group into subfolders</guilabel> box is set to
+ <guilabel>By month photo taken</guilabel>, each photo will be examined to
+ determine what date it was taken, and a subfolder will be created for
+ every month that a photo was taken. The photos will be placed automatically
+ in the correct subfolder.
+ </para>
+ <para>
+ If the <guilabel>Group into subfolders</guilabel> box is set to
+ <guilabel>By current date and time</guilabel> a single subfolder
+ will be created, based on the date and time of importing. This is
+ different than the dates when the photos were taken.
+ </para>
+ <para>
+ Lastly, subfolders names can be generated using a custom user-specified
+ format, if the <guilabel>Group into subfolders</guilabel> box is set to
+ <guilabel>Custom subfolder</guilabel>. The subfolder name will be determined
+ by the format string entered into the text box below the
+ <guilabel>Group into subfolders</guilabel> box. This string can contain
+ a combination of text and/or date codes. Any date code supported by the
+ standard C strftime function is supported. For instance, if you
+ enter "Vacation %B", the "%B" will be replaced by the full month name
+ according to the current locale ("Vacation September", for example).
+ The date is based on the date the photo
+ was taken. This date is read from the Exif data in the photo, if available.
+ If it is not, the file modification time is used instead. Here is a summary
+ of valid format codes:
+ </para>
+ <table id="gthumb-TBL-strftime" frame="topbot">
+ <title>Valid format codes for custom subfolders</title>
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Code</para></entry>
+ <entry colname="COLSPEC1">
+ <para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %a
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The abbreviated weekday name according to the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %A
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The full weekday name according to the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %b
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The abbreviated month name according to the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %B
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The full month name according to the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %c
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The preferred date and time representation for the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %C
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The century number (year/100) as a 2-digit integer.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %d
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The day of the month as a decimal number (range 01 to 31).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %D
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Equivalent to %m/%d/%y. (Yecch -- for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.)
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %e
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %E
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Modifier: use alternative format, see below.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %F
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99)
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %G
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %g
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Like %G, but without century, i.e., with a 2-digit year (00-99).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %h
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Equivalent to %b.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %H
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The hour as a decimal number using a 24-hour clock (range 00 to 23).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %I
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The hour as a decimal number using a 12-hour clock (range 01 to 12).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %j
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The day of the year as a decimal number (range 001 to 366).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %k
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.)
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %l
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.)
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %m
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The month as a decimal number (range 01 to 12).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %M
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The minute as a decimal number (range 00 to 59).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %O
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Modifier: use alternative format, see below.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %p
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Either 'AM' or 'PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as 'pm' and midnight as 'am'.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %P
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Like %p but in lowercase: 'am' or 'pm' or a corresponding string for the current locale.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %r
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to '%I:%M:%S %p'.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %R
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The time in 24-hour notation (%H:%M). For a version including the seconds, see %T below.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %s
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %S
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %T
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The time in 24-hour notation (%H:%M:%S).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %u
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The day of the week as a decimal number, range 1 to 7, Monday being 1. See also %w.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %U
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %V
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %w
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %W
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %x
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The preferred date representation for the current locale without the time.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %X
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The preferred time representation for the current locale without the date.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %y
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The year as a decimal number without a century (range 00 to 99).
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %Y
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The year as a decimal number including the century.
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %z
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z").
+ </para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ %Z
+ </para>
+ </entry>
+ <entry>
+ <para>
+ The time zone or name or abbreviation.
+ </para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ Some conversion specifications can be modified by preceding the conversion specifier character by the E or O modifier
+ to indicate that an alternative format should be used. If the alternative format or specification does not exist for
+ the current locale, the behaviour will be as if the unmodified conversion specification were used. The Single
+ Unix Specification mentions %Ec, %EC, %Ex, %EX, %Ey, %EY, %Od, %Oe, %OH, %OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow,
+ %OW, %Oy, where the effect of the O modifier is to use alternative numeric symbols (say, roman numerals), and that
+ of the E modifier is to use a locale-dependent alternative representation.
+ </para>
+ <para>
+ <guilabel>Tags</guilabel> can be specified for the imported
+ photos using the <guilabel>Tags</guilabel> box.
+ </para>
+ <para>
+ If the <guilabel>Delete imported images from the camera</guilabel>
+ checkbox is enabled, the photos will be deleted from the camera
+ after they have been imported.
+ </para>
+ <para>
+ If the <guilabel>Rotate images physically</guilabel> checkbox is selected,
+ and the imported photo contains an Exif orientation tag, the image data
+ will be physically transformed (losslessly) so that the viewed image
+ looks the same as before but the orientation tag is reset to "top left".
+ If this checkbox is not enabled, the image data and the orientation tag
+ are both left unchanged. The image will be displayed identically by
+ <application>gThumb</application> for both possibilities, but for maximum compatibility with other
+ applications this checkbox should be enabled.
+ </para>
+ <sect3 id="gthumb-select-camera">
+ <title>Selecting the Camera Model</title>
+ <para>
+ &app; should auto-detect your camera (if it is connected and turned on) when you
+ launch the <menuchoice><guimenu>File</guimenu><guimenuitem>Import Photos
+ </guimenuitem></menuchoice> dialog. If it does, a camera icon will be
+ displayed in the dialog box. If not, a camera with an "X" through it
+ will be shown.
+ </para>
+ <para>
+ If the wrong camera has been detected, click the camera icon to select
+ the correct one. A drop-down box listing all auto-detected cameras will
+ be shown. If the <guilabel>Use manual selection instead</guilabel> checkbox
+ is enabled, the user can manually set the camera model and port.
+ </para>
+ </sect3>
+ </sect2>
+ <sect2 id="gthumb-write-to-cd">
+ <title>To Write Images to a CD or DVD</title>
+ <para>To write a series of images to a CD or DVD, perform the following steps:
+ <orderedlist>
+ <listitem>
+ <para>Select the images you want to write to and choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
+ </guimenuitem></menuchoice>, &app; displays the
+ <guilabel>Write to CD</guilabel> dialog.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guilabel>Current folder</guilabel> if you want to
+ write all of the images in the current folder and its subfolders.
+ Click on <guilabel>Selected images</guilabel> to write the current
+ selection only.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Ok</guibutton>. &app;, after preparing the
+ images for CD/DVD writing, displays the <filename>burn:///</filename>
+ location with <guilabel>Nautilus</guilabel>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Click on the <guilabel>Write to CD</guilabel> toolbar button or
+ choose
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Write to CD
+ </guimenuitem></menuchoice>. Images are written to the CD or DVD.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </sect2>
+ </sect1>
+ <sect1 id="scripts">
+ <title>External Scripts and Hot Keys</title>
+ <para>
+ This dialog contains the shell script definitions that control the
+ hot keys 0-9 on the numeric keypad. These scripts can also be
+ launched from the <guimenu>Scripts</guimenu>
+ menu.
+ <note>
+ <title>Numeric Keypad on Laptops</title>
+ <para>
+ Laptop computers may not have a numeric keypad, but most laptops
+ provide a way of emulating the numeric keypad, typically using
+ the <keycap>Fn</keycap> key. This feature may need to be enabled
+ in the BIOS.
+ </para>
+ </note>
+ </para>
+ <para>
+ When a user presses one of these keys, an external shell script
+ will be launched. Certain codes can be included in the script.
+ These codes will be replaced by &app; when a script is actually
+ launched, as follows:
+ </para>
+ <informaltable frame="all">
+ <tgroup cols="2" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="20.00*"/>
+ <colspec colname="COLSPEC1" colwidth="80.00*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Code</para></entry>
+ <entry colname="COLSPEC1" align="left">
+ <para>Explanation</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry><para>%F</para></entry>
+ <entry align="left"><para>All selected filenames on one line, space delimited.
+ This code can not be combined with any of the other codes listed below.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%f</para></entry>
+ <entry align="left"><para>A single filename, including path.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%b</para></entry>
+ <entry align="left"><para>A single filename, excluding path.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%n</para></entry>
+ <entry align="left"><para>A single filename, including path, with no extension.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%m</para></entry>
+ <entry align="left"><para>A single filename, excluding path, with no extension.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%e</para></entry>
+ <entry align="left"><para>A single extension (starting with a period).</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>%p</para></entry>
+ <entry align="left"><para>The parent folder of the single file.</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>[text]</para></entry>
+ <entry align="left"><para>A user prompt, refreshed for each iteration. If the %F code is not
+ used, then a prompt dialog will appear for every file that is selected. This code
+ consists of lower-case text (only) enclosed in square brackets. The text supplied
+ by the user through the prompt dialog will replace this code. (To treat a
+ bracket-enclosed block of text literally, precede the opening bracket with
+ a backslash.)</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>[TEXT]</para></entry>
+ <entry align="left"><para>A user prompt, used for all iterations. That is, the
+ prompt dialog will only appear once, no matter how many files are selected. This code
+ consists of upper-case text (only) enclosed in square brackets. The text supplied
+ by the user through the prompt dialog will replace this code. (To treat a
+ bracket-enclosed block of text literally, precede the opening bracket with
+ a backslash.)</para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>{..strftime format code..}</para></entry>
+ <entry align="left"><para>A date format string.
+ The text inside the curly brackets will be interpreted by the standard C "strftime" function.
+ (The brackets will not appear in the output. To treat a
+ bracket-enclosed block of text literally, precede the opening bracket with
+ a backslash.) The date will be determined from the metadata embedded in the photo, if available
+ (for example, the Exif DateTime tag). If the photo has no embedded date metadata, the
+ file modification date will be used. Ordinary text can be mixed with the date codes.
+ If the format code starts with a "#" sign, then the text will not be replaced, but
+ the value will be remembered for date prompts (see below).
+ Example:
+ <command>mkdir -p %p/{%A photos}; cp %f %p/{%A photos}/</command>
+ This script will create a subfolder prefixed with the weekday name
+ (like "/home/user/Sunday photos") and copy photos to it.
+ Refer to your system's documentation for a list of strftime format codes that you can use.
+ </para></entry>
+ </row>
+ <row valign="top">
+ <entry><para>{TEXT}</para></entry>
+ <entry align="left">
+ <para>A user prompt dependent on the previous date format string.
+ The prompt will be used once for each different result of the date. All future
+ prompts with the same name will use the same value.The text supplied by the user
+ through the prompt dialog will replace this code. You can put a "#" sign at the
+ beginning of the prompt name to prevent the replacement. This can be used to store
+ a prompted value to insert later on. (To treat a bracket-enclosed block of text
+ literally, precede the opening bracket with a backslash.)
+ Examples:
+ <command>mkdir -p %p/{%Y-%m-%d_}{COMMENT}; cp %f %p/{%Y-%m-%d_}{COMMENT}/</command>
+ This script will create a subfolder prefixed with the date of the picture and a user comment
+ (like "/home/user/2007-05-04_MyBirthday" or "/home/user/2007-03-17_St. Patrick's Day") and
+ copy photos to it.
+ <command>mkdir -p %p/{#%B}{FOLDER}; cp %f %p/{FOLDER}/</command>
+ This script will create a series of subfolders based on the month the picture was taken,
+ but they will be named according to the user's comments on the date. So if you enter
+ the word 'Ides' for March, all the photos taken in March will be copied to
+ "/home/user/photos/Ides/".
+ </para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ <para>
+ Scripts with the %F code will be executed just once, regardless of the number of files selected.
+ All other scripts will be executed once per selected file.
+ </para>
+ <para>
+ Several default scripts are provided. These can be replaced by the user, if desired.
+ The default scripts are explained below:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <command>gimp %F &</command>
+ </para>
+ <para>
+ This script tells the GNU Image Manipulation Program (gimp) to open
+ all of the select files. This is most efficient if we include all of
+ the filenames on one line, rather than calling <command>gimp</command>
+ once for each file, so we have used the %F code.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <command>convert %f -font Helvetica -pointsize 20 -fill white -box '#00000080' -gravity South -annotate +0+5 ' Copyright 2007, Your Name Here ' %n-copyright%e</command>
+ </para>
+ <para>
+ This script makes a copy of your image file, and adds a copyright notice
+ to it. The "convert" command is part of the ImageMagick package. If the
+ original file is named sample.jpg, the new file will be named sample-copyright.jpg.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <command>mkdir -p %p/approved ; cp %f %p/approved/</command>
+ </para>
+ <para>
+ This script creates a new sub-folder called "approved", if it does not
+ exist already. It then copies the select files to the "approved" sub-folder.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <command>uuencode %f %f | mail -s Photos your emailaddress com</command>
+ </para>
+ <para>
+ This script encodes images files in a format suitable for email attachments,
+ and then emails each photo to the specified address. One email per photo is sent.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <command>rm ~/myarchive.zip; zip -j ~/myarchive %F</command>
+ </para>
+ <para>
+ This script overwrites an existing zip file, if present, with a new zip file
+ containing the selected images.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <command>rm ~/myarchive.zip; zip -j ~/myarchive %F; uuencode ~/myarchive.zip ~/myarchive.zip | mail -s Photos your emailaddress com</command>
+ </para>
+ <para>
+ This combines the previous two scripts, so that the selected images are compressed into
+ a single zip file, which is then emailed.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ <note>
+ <title>Foreground / Background Issues</title>
+ <para>
+ If you use a script to launch a long-running program, you should probably
+ add the background character '&' to the end of the script, to ensure that it
+ does not block further script iterations and the operation of gthumb itself.
+ </para>
+ </note>
+ </para>
+ <para>
+ <note>
+ <title>Password Security</title>
+ <para>
+ &appname; saves the most recent user prompt responses in the gconf database,
+ unless the name of the prompt is "password" or "PASSWORD".
+ </para>
+ </note>
+ </para>
+
+
+ </sect1>
+ <!-- ============= Preferences ================================== -->
+ <sect1 id="preferences">
+ <title>Preferences</title>
+ <para>
+ To configure &app;, open the
+ <guilabel>Preferences</guilabel> dialog by choosing
+ <menuchoice><guimenu>Edit</guimenu><guisubmenu>Preferences</guisubmenu>
+ </menuchoice>.
+ </para>
+ <para>
+ This dialog contains four tabs described in detail below.
+ At the bottom of the dialog window, you'll find the following buttons:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para><guibutton>Help</guibutton>: shows this manual.
+ </para>
+ </listitem>
+ <listitem>
+ <para><guibutton>Close</guibutton>: closes the dialog.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Keep in mind that when you change an option it will automatically
+ applied. This is why there is no <guibutton>Ok</guibutton> or
+ <guibutton>Apply</guibutton> button.
+ </para>
+
+<!-- ########### General Tab ################## -->
+ <sect2 id="preferences-general">
+ <title>General Tab</title>
+ <para>
+ This tab allows you to set the following
+ options:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>Select the layout of
+ &app; main window, i.e. the
+ positions of directory list window, the image (thumbnail) list
+ window, and the main image viewer window.
+ </para>
+ </listitem>
+ <listitem>
+ <para>The toolbar style
+ </para>
+ </listitem>
+ <listitem>
+ <para>Directory to show on startup
+ </para>
+ </listitem>
+ <listitem>
+ <para>Whether to ask confirmation when an image or a catalog
+ will be deleted.</para>
+ </listitem>
+ <listitem>
+ <para>Whether to ask to save a modified image.</para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+<!-- ########### Browser Tab ################## -->
+ <sect2 id="preferences-browser">
+ <title>Browser Tab</title>
+ <para>
+ In this tab, you can configure the following options:
+ </para>
+ <variablelist>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Show filenames</guilabel></term>
+ <listitem>
+ <para>This option controls whether &app; should show
+ image filenames.
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Show comments</guilabel></term>
+ <listitem>
+ <para>This option controls whether
+ &app; should show comments
+ (including date and place) in the image list. By default,
+ &app; shows the comment as a caption under the
+ thumbnail.
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Show thumbnails</guilabel></term>
+ <listitem>
+ <para>This option (which you can activate simply pressing
+ <keycombo><keycap>T</keycap></keycombo>) controls whether
+ &app; should show thumbnails.
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Other</guilabel></term>
+ <listitem>
+ <para>Here you can choose whether to change folder by
+ doing a single or a double click on the folder name. The
+ single click can be useful if you are used to quickly browse your
+ hard disk searching for images. The default behaviour is to
+ follow the Nautilus file manager policy.
+ Furthermore you can select whether
+ &app; should determine image
+ type by looking at the file extension or by looking at the
+ file content. Determining file type from the content is
+ more reliable (some applications may create files with
+ extension not matching the actual file type) but
+ slower. If you have a fast system, select <guilabel>Determine
+ image type from content</guilabel>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ </sect2>
+<!-- ########### Viewer Tab ################## -->
+ <sect2 id="preferences-viewer">
+ <title>Viewer Tab</title>
+ <para>This tab contains options for viewer window:
+ </para>
+ <variablelist>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>After loading an image</guilabel></term>
+ <listitem>
+ <para>Controls initial zoom level to use for an
+ image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Transparency type</guilabel></term>
+ <listitem>
+ <para>Controls the background used for partly transparent
+ images. By default the transparent part of the image is
+ replaced by the window background color, that is the
+ <guilabel>none</guilabel> option.
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Zoom quality</guilabel></term>
+ <listitem>
+ <para>This controls the method used for showing rescaled
+ image. Possible choices are high quality (slow on old
+ machines or when viewing big images) and low
+ quality (always fast).
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- ########### -->
+ <varlistentry>
+ <term><guilabel>Scrollbar positions after using Next/Previous</guilabel></term>
+ <listitem>
+ <para>
+ Depending on the selected zoom level, your images may be larger than the
+ display window. If this happens, vertical and/or horizontal scrollbars will
+ be present, allowing you to view different areas of your image.
+ </para>
+ <para>
+ When you navigate from one image to another using the Next/Previous
+ controls, the positions of the scrollbars can be retained, or they can be
+ reset to the default position.
+ </para>
+ <para>
+ If you are viewing pages of scanned text, for example, you will probably want to
+ set this to <guilabel>Reset to top-left of image</guilabel>, so that the
+ top of the page is shown when you move to a new image.
+ </para>
+ <para>
+ If you are trying to compare small areas on several large images
+ (perhaps to compare similar images taken at different times, such
+ as photos taken in a "continuous" mode on a digital camera, or
+ satellite images of the same area at different dates)
+ then the <guilabel>Keep same position</guilabel> mode is probably more
+ appropriate for you.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ </sect2>
+<!-- ########### Slide Show Tab ################## -->
+ <sect2 id="preferences-slideshow">
+ <title>Slide Show Tab</title>
+ <para>
+ This tab contains the options controlling slide show mode
+ (which you can start by selecting
+ <menuchoice><guimenu>Tools</guimenu>
+ <guisubmenu>Slide Show</guisubmenu></menuchoice> or by using
+ <keycombo><keycap>S</keycap></keycombo>
+ shortcut). The options include direction (forward/backwards/random),
+ and delay between images. You can also specify whether the
+ slide show should wrap around (i.e., after showing the last
+ image start again form the beginning) and automatically switch
+ to fullscreen mode.
+ </para>
+ </sect2>
+ </sect1>
+
+ <!-- ============= Keyboard Shortcuts ================================== -->
+ <sect1 id="shortcuts">
+ <title>Quick Reference: Keyboard Shortcuts</title>
+ <para><xref linkend="gthumb-TBL-keyword-shortcuts-browser"/>, <xref
+ linkend="gthumb-TBL-keyword-shortcuts-viewer"/>, <xref
+ linkend="gthumb-TBL-keyword-shortcuts-other"/> and <xref
+ linkend="gthumb-TBL-keyword-shortcuts-fullscreen"/> provide a quick
+ reference for all of the &app; keyword shortcuts. Look in the
+ menus for other shortcuts.</para>
+ <para>
+ <table id="gthumb-TBL-keyword-shortcuts-browser" frame="topbot">
+ <title>Keyboard shortcuts to navigate folders</title>
+ <tgroup cols="3" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <colspec colname="COLSPEC2" colwidth="50*"/>
+ <thead>
+ <row valign="top" rowsep="1">
+ <entry colname="COLSPEC0">
+ <para>Keyboard Shortcut</para></entry>
+ <entry colname="COLSPEC1">
+ <para>Description</para></entry>
+ <entry colname="COLSPEC2">
+ <para>Available in Fullscreen Mode</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry>
+ <para>
+ <keycombo><keycap>n</keycap></keycombo> or
+ <keycombo action="simul"><keycap>Space</keycap></keycombo> or
+ <keycombo action="simul"><keycap>Page Down</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View the next image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>b</keycap></keycombo> or
+ <keycombo><keycap>Backspace</keycap></keycombo> or
+ <keycombo action="simul"><keycap>Page Up</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View the previous image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Home</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View the first image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>End</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View the last image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Alt</keycap><keycap>Home
+ </keycap></keycombo> or
+ <keycombo action="simul"><keycap>h</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Go to your Home folder.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Alt</keycap><keycap>Left
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Go to the previously visited folder.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Alt</keycap><keycap>Up
+ </keycap></keycombo> or
+ <keycombo action="simul"><keycap>u</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Go up one level.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>Esc</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Interrupt thumbnails creation.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Ctrl</keycap><keycap>D
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Add the current location to the bookmarks.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Return</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View/Hide the browser.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>q</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Change the image properties pane content or
+ display the pane if it is not visible.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Ctrl</keycap><keycap>1
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Set the image preview as the image properties pane
+ content or hide the pane if this content type is already
+ visible.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Ctrl</keycap><keycap>2
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Set the image exif data as the image properties pane
+ content or hide the pane if this content type is already
+ visible.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Ctrl</keycap><keycap>3
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Set the image comment as the image properties pane
+ content or hide the pane if this content type is already
+ visible.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>t</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View/Hide the thumbnails.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>F2</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Rename the current image.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>o</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Open the selected images with an application.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>g</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Open the selected images with the GIMP, if installed.</para>
+ </entry>
+ <entry>
+ <para>no</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>Delete</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Delete the selected images.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+
+ <para>
+ </para>
+
+ <table id="gthumb-TBL-keyword-shortcuts-viewer" frame="topbot">
+ <title>Keyboard shortcuts to view images</title>
+ <tgroup cols="3" colsep="1" rowsep="1">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <colspec colname="COLSPEC2" colwidth="50*"/>
+ <thead>
+ <row valign="top">
+ <entry colname="COLSPEC0">
+ <para>Keyboard Shortcut</para></entry>
+ <entry colname="COLSPEC1">
+ <para>Description</para></entry>
+ <entry colname="COLSPEC2">
+ <para>Available in Fullscreen Mode</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry>
+ <para>
+ <keycombo><keycap>v</keycap></keycombo> or
+ <keycombo><keycap>f</keycap></keycombo> or
+ <keycombo><keycap>F11</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Set/Unset the full screen mode.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>+</keycap></keycombo> or
+ <keycombo><keycap>=</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Zoom in.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>-</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Zoom out.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>1</keycap></keycombo> or
+ <keycombo><keycap>z</keycap></keycombo> or
+ <keycombo><keycap>/ (numeric keypad)</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Actual size.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>x</keycap></keycombo> or
+ <keycombo><keycap>* (numeric keypad)</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Zoom to fit (scales down only, does not magnify)</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>Shift</keycap><keycap>x</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Zoom to fit (scale down or magnify, as required)</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>l</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Flip the image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>m</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Mirror the image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>r</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Rotate the image clockwise of 90 degrees without saving.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>e</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Rotate the image counter-clockwise of 90 degrees without saving.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>]</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Rotate and save the image clockwise of 90 degrees. The rotation is lossless for jpeg images.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>[</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Rotate and save the image counter-clockwise of 90 degrees. The rotation is lossless for jpeg images.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>a</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Start/Stop the animation</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>j</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>View the next frame of a stopped animation.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>Arrows</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Scroll the image.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <keycombo action="simul"><keycap>Shift</keycap><keycap>Arrows
+ </keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Scroll the image faster.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>
+ </para>
+
+ <table id="gthumb-TBL-keyword-shortcuts-other" frame="topbot">
+ <title>Other keyboard shortcuts.</title>
+ <tgroup cols="3" colsep="0" rowsep="0">
+ <colspec colname="COLSPEC0" colwidth="50*"/>
+ <colspec colname="COLSPEC1" colwidth="50*"/>
+ <colspec colname="COLSPEC2" colwidth="50*"/>
+ <thead>
+ <row valign="top" rowsep="1">
+ <entry colname="COLSPEC0">
+ <para>Keyboard Shortcut</para></entry>
+ <entry colname="COLSPEC1">
+ <para>Description</para></entry>
+ <entry colname="COLSPEC2">
+ <para>Available in Fullscreen Mode</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row valign="top">
+ <entry>
+ <para>
+ <keycombo><keycap>s</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Start/Stop the slideshow.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>c</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Add a comment to the selected images.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>k</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Assign tags to the selected images.</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>i</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Hide/Show the image comment and properties</para>
+ </entry>
+ <entry>
+ <para>yes</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ </para>
+ <table id="gthumb-TBL-keyword-shortcuts-fullscreen" frame="topbot">
+ <title>Keyboard shortcuts available exclusively in fullscreen mode</title>
+ <tgroup cols="2" colsep="0" rowsep="0">
+ <colspec colwidth="20.00*"/>
+ <colspec colwidth="20.00*"/>
+ <thead>
+ <row rowsep="1">
+ <entry><para>Keyboard Shortcut</para></entry>
+ <entry><para>Description</para></entry>
+ </row>
+ </thead>
+ <tbody>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>p</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Pause/Resume a slideshow.</para>
+ </entry>
+ </row>
+ <row rowsep="0">
+ <entry>
+ <para>
+ <keycombo><keycap>Escape</keycap></keycombo> or
+ <keycombo><keycap>f</keycap></keycombo> or
+ <keycombo><keycap>v</keycap></keycombo> or
+ <keycombo><keycap>F11</keycap></keycombo> or
+ <keycombo><keycap>q</keycap></keycombo>
+ </para>
+ </entry>
+ <entry>
+ <para>Exit the fullscreen mode.</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect1>
+
+</article>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..d6906f9
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,76 @@
+ <legalnotice id="legalnotice">
+ <para>
+ Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU Free Documentation
+ License (GFDL), Version 1.1 or any later version published
+ by the Free Software Foundation with no Invariant Sections,
+ no Front-Cover Texts, and no Back-Cover Texts. You can find
+ a copy of the GFDL at this <ulink type="help"
+ url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+ distributed with this manual.
+ </para>
+ <para> This manual is part of a collection of GNOME manuals
+ distributed under the GFDL. If you want to distribute this
+ manual separately from the collection, you can do so by
+ adding a copy of the license to the manual, as described in
+ section 6 of the license.
+ </para>
+
+ <para>
+ Many of the names used by companies to distinguish their
+ products and services are claimed as trademarks. Where those
+ names appear in any GNOME documentation, and the members of
+ the GNOME Documentation Project are made aware of those
+ trademarks, then the names are in capital letters or initial
+ capital letters.
+ </para>
+
+ <para>
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+ UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+ WITH THE FURTHER UNDERSTANDING THAT:
+
+ <orderedlist>
+ <listitem>
+ <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+ IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+ THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+ A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+ RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+ OF THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+ MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+ YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+ CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+ SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+ OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+ LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+ VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+ EXCEPT UNDER THIS DISCLAIMER; AND
+ </para>
+ </listitem>
+ <listitem>
+ <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+ THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+ CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+ INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+ DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+ OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+ PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+ DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+ CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+ INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+ OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+ MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+ LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+ EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+ THE POSSIBILITY OF SUCH DAMAGES.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </legalnotice>
+
\ No newline at end of file
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
